No project description provided
Project description
quivr-sphinx-autodoc
This is a Sphinx extension for autodoc of Quivr Tables.
Installation
Install with pip:
pip install quivr-sphinx-autodoc
Then enable by adding to the sphinx extensions in your conf.py
sphinx configuration file:
extensions = [
"sphinx.ext.autodoc",
"quivr_sphinx_autodoc",
]
Usage
Once installed, documentation for quivr.Table
subclasses will
include tables which list the columnar schema and any scalar
attributes.
This will automatically be enabled for any class declarations found
with a .. automod::
directive.
If you're manually specifying classes, use .. autoqvtable:: <tablename>
:
.. currentmodule:: adam_core.coordinates
.. autoqvtable:: CartesianCoordinates
:members:
To add documentation for table columns or attributes, use the
attribute docstring syntax, which is to lead with #:
:
class MyTable(qv.Table):
x = qv.Float64Column()
#: Example of a documented y field
y = qv.Int64Column()
#: this one is documented
#: on multiple lines
#: and has inline ReST text, which works
#:
#: .. warning::
#: Do not use
z = qv.ListColumn(pa.int32())
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for quivr_sphinx_autodoc-0.2.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0164ea2908f580a630fbbf26afab0dc745d8ff8cd92a0ca3924ef401eb388141 |
|
MD5 | f7f6d5255a7dcb2c1664c895b63c70b5 |
|
BLAKE2b-256 | 4f0afea6889f24436b33b56dda5d1ed5948ffbadffa7f75084a8edd840b0d598 |
Close
Hashes for quivr_sphinx_autodoc-0.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 597de358f56b2eb247881561700ee51ef474fd8a61541cf46d759a34dc0191b6 |
|
MD5 | 0a0ef45eef44a26dd83d1de8e2b6d19b |
|
BLAKE2b-256 | 973abcbfee2985fe60fb7ae9e24fb6800fe35f7dc74d64aea89bdef24858c152 |