Metadata-Version: 2.1
Name: docstring-to-markdown
Version: 0.15
Summary: On the fly conversion of Python docstrings to markdown
Home-page: UNKNOWN
Author: Michał Krassowski
Author-email: krassowski.michal+pypi@gmail.com
License: LGPL-2.1-or-later
Project-URL: Bug Tracker, https://github.com/python-lsp/docstring-to-markdown/issues
Project-URL: Source Code, https://github.com/python-lsp/docstring-to-markdown
Description: # docstring-to-markdown
        
        [![tests](https://github.com/python-lsp/docstring-to-markdown/workflows/tests/badge.svg)](https://github.com/python-lsp/docstring-to-markdown/actions?query=workflow%3A%22tests%22)
        ![CodeQL](https://github.com/python-lsp/docstring-to-markdown/workflows/CodeQL/badge.svg)
        [![pypi-version](https://img.shields.io/pypi/v/docstring-to-markdown.svg)](https://python.org/pypi/docstring-to-markdown)
        
        On the fly conversion of Python docstrings to markdown
        
        - Python 3.6+ (tested on 3.7 up to 3.11)
        - can recognise reStructuredText and convert multiple of its features to Markdown
        - since v0.13 includes initial support for Google-formatted docstrings
        
        ### Installation
        
        ```bash
        pip install docstring-to-markdown
        ```
        
        ### Example
        
        Convert reStructuredText:
        
        ```python
        >>> import docstring_to_markdown
        >>> docstring_to_markdown.convert(':math:`\\sum`')
        '$\\sum$'
        ```
        
        When given the format cannot be recognised an exception will be raised:
        
        ```python
        >>> docstring_to_markdown.convert('\\sum')
        Traceback (most recent call last):
            raise UnknownFormatError()
        docstring_to_markdown.UnknownFormatError
        ```
        
        ### Development
        
        ```bash
        pip install -e .
        pytest
        ```
        
Keywords: Docstring,conversion,markdown
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
Classifier: Programming Language :: Python
Classifier: Topic :: Text Processing :: Markup
Classifier: Topic :: Documentation :: Sphinx
Requires-Python: >=3.6
Description-Content-Type: text/markdown
