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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
napoleon2html-0.2.0.tar.gz
(3.7 kB
view details)
File details
Details for the file napoleon2html-0.2.0.tar.gz.
File metadata
- Download URL: napoleon2html-0.2.0.tar.gz
- Upload date:
- Size: 3.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e55049de7fe5302fe3c853be72e0a87b9ed0ba2993d8dbdf7a08a52f83c0d2f
|
|
| MD5 |
ca1bc26bd4b79447370e43f4bbf3559c
|
|
| BLAKE2b-256 |
c95f0c3c85456d1615a606fef7ac5e8637c90710ba589e1a34833c9471b33427
|