napoleon2html
This project contains functions that encapsulate tranlation of Sphinx or Napoleon docstrings to HTML.
Documentation
There are three function, that can be used: napoleon_to_sphinx(), sphinx_to_html() and napoleon_to_html().
napoleon_to_sphinx()
This function can take documentation in Napoleon format and translate it to Sphinx.
Usage:
napoleon2html.napoleon_to_sphinx("""
Description of function
Args:
argument (str): Description of argument.
Returns:
int: Description of return.
""")
Output:
Description of function
:Parameters: **argument** (*str*) --
Description of argument.
:returns: *int* --
Description of return.
sphinx_to_html()
Then there is the sphinx_to_html(), which converts string in Sphinx format to HTML:
napoleon2html.sphinx_to_html("""
Description of function
:Parameters: **argument** (*str*) --
Description of argument.
:returns: *int* --
Description of return.
""")
Output:
<blockquote> <p>Description of function</p> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field"><th class="field-name">Parameters:</th><td class="field-body"><strong>argument</strong> (<em>str</em>) -- Description of argument.</td> </tr> <tr class="field"><th class="field-name">returns:</th><td class="field-body"><em>int</em> -- Description of return.</td> </tr> </tbody> </table> </blockquote>
napoleon_to_html()
Last function is napoleon_to_html(), which wraps the previous two.
Changelog
0.2.0
Fixed bug in MANIFEST.in.
0.1.0
Project created.
Metadata
Release files for napoleon2html 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| napoleon2html-0.2.0.tar.gz | 3.7 kB | Details |
Release files / napoleon2html-0.2.0.tar.gz
| Download URL | napoleon2html-0.2.0.tar.gz |
|---|---|
| Size | 3.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e55049de7fe5302fe3c853be72e0a87b9ed0ba2993d8dbdf7a08a52f83c0d2f
|
|
BLAKE2b-256 checksum How to use checksums |
c95f0c3c85456d1615a606fef7ac5e8637c90710ba589e1a34833c9471b33427
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |