Wrappers to translate Napoleon/Sphinx docstrings to HTML.
Project description
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.
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
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 |