Skip to main content

On the fly conversion of Python docstrings to markdown

Project description

docstring-to-markdown

On the fly conversion of Python docstrings to markdown

  • Python 3.6+
  • currently can recognise reStructuredText and convert multiple of its features to Markdown
  • in the future will be able to convert Google docstrings too

Installation

pip install docstring-to-markdown

Example

Convert reStructuredText:

>>> import docstring_to_markdown
>>> docstring_to_markdown.convert(':math:`\\sum`')
$\\sum$

When given the format cannot be recognised an exception will be raised:

>>> docstring_to_markdown.convert('\\sum')
UnknownFormatError()

Development

pip install -e .
pytest

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

docstring_to_markdown-0.2-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

Details for the file docstring_to_markdown-0.2-py3-none-any.whl.

File metadata

  • Download URL: docstring_to_markdown-0.2-py3-none-any.whl
  • Upload date:
  • Size: 15.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.6.9

File hashes

Hashes for docstring_to_markdown-0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4a54d9067dd45352bafdffcd29a9a9f4fc843137bd44e26cc085cb82ae7e2b9a
MD5 0de623693ae8502bd525cbf84a0412d1
BLAKE2b-256 0ea6ca0442bdf196b7a1608badce67491c9fe169c51bc9856670448eb6754ec4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page