A python library to template documentation from docstrings.
Project description
Docdocdoc
A python library to template documentation from docstrings.
Installation
You can install docdocdoc
with pip with the following command:
pip install docdocdoc
Usage
build
build_fn
Function returning the function or class documentation written in Markdown.
Arguments
- fn str - str of the function or class name".
Returns
str - function or class documentation written in Markdown.
build_toc
Function returning the table of content written in Markdown.
Arguments
- data list - list of dicts with the keys "title" and "fns". "title" contains the name of the section and "fns" contains the name of the functions in the section.
Returns
str - table of content written in Markdown.
build_docs
Function returning the documentation written in Markdown.
Arguments
- data list - list of dicts with the keys "title" and "fns". "title" contains the name of the section and "fns" contains the name of the functions in the section.
Returns
StringIO - documentation written in Markdown.
generate_readme
Function printing readme.
Arguments
- data list - list of dicts with the keys "title" and "fns". "title" contains the name of the section and "fns" contains the name of the fonctions in the section.
parts
assembling_description
Function returning the short description of the docstring, aggregated with the long description.
Arguments
- docstring DocstringStyle.GOOGLE - a google docstring.
Returns
string - description of the docstring.
get_article
Function returning the article if the docstring has one, None otherwise.
Arguments
- docstring DocstringStyle.GOOGLE - a google docstring.
Returns
string - string containing the description of the article.
get_function
Function returning a dict with the different part for a function (or class) documentation (i.e. name, description, article.).
Arguments
- fn function - a function you defined.
Returns
dict - dict with the different part of the documentation.
get_references
Function returning the references if the docstring has some, None otherwise.
Arguments
- docstring DocstringStyle.GOOGLE - a google docstring.
Returns
list - list containing the strings with the references.
template_params
Function returning templated arguments.
Arguments
- fn_doc dict - a dict with the function documentation parts (returned by get_function).
Returns
string - templated arguments.
template_references
Function returning templated references.
Arguments
- fn_doc dict - a dict with the function documentation parts (returned by get_function).
Returns
string - templated references.
template_return
Function returning templated arguments.
Arguments
- fn_doc dict - a dict with the function documentation parts (returned by get_function).
Returns
string - templated returns.
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
Hashes for docdocdoc-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 005862cc659426f8847ff5b12e46b3a15724f5bb8081c24c4363bd9e49e8e02c |
|
MD5 | bab05276aecbc67c8161e642437acc1a |
|
BLAKE2b-256 | 3a1472485b98b3621e3344ace4ab2baed93f38ff8e2282ce220a1f9e7347ccbb |