It parses and composes docstrings in Google, Numpydoc, ReST and Epydoc.
Project description
The project is a fork from the original project - https://github.com/rr-/docstring_parser/
PyDocSmith
PyDocSmith is a versatile Python package designed for parsing, detecting, and composing docstrings in various styles. It supports multiple docstring conventions, including reStructuredText (reST), Google, NumPydoc, and Epydoc, providing flexibility in documentation practices for Python developers.
Features
- Docstring Style Detection: Automatically detect the style of docstrings (e.g., reST, Google, NumPydoc, Epydoc) using simple heuristics.
- Docstring Parsing: Convert docstrings into structured representations, making it easier to analyze and manipulate documentation.
- Docstring Composition: Render structured docstrings back into text, allowing for automated docstring generation and modification.
- Attribute Docstrings: Parse attribute docstrings defined at class and module levels, enhancing the documentation of class properties and module-level variables.
Installation
pip install PyDocSmith
Usage
Detecting Docstring Style
Detect the docstring style of a given text:
from PyDocSmith import detect_docstring_style, DocstringStyle
docstring = """
This is an example docstring.
:param param1: Description of param1
:return: Description of return value
"""
style = detect_docstring_style(docstring)
print(style) # Outputs: DocstringStyle.EPYDOC
Parsing Docstrings
Parse a docstring into its components:
from PyDocSmith import parse, DocstringStyle
parsed_docstring = parse(docstring, style=DocstringStyle.AUTO)
print(parsed_docstring)
Composing Docstrings
Render a parsed docstring back into text:
from PyDocSmith import compose
docstring_text = compose(parsed_docstring, style=DocstringStyle.REST)
print(docstring_text)
Advanced Features
- Parse From Object: PyDocSmith can parse docstrings directly from Python objects, including classes and modules, incorporating attribute docstrings into the structured representation.
- Custom Rendering Styles: Customize the rendering of docstrings with compact or detailed styles, and specify custom indentation for the generated docstring text.
Things that have been modified wrt to docstring_parser
- Better heuristics to detect docstring style
- Google Docstring has been modified to accommodate Notes, Examples
- Sometime GoogleDoc string doesn't have proper indentation specially when generated from LLMs like GPT or Mistral. PyDocSmith can fix those bad docstrings.
- Additional test-cases were added to accommodate a different style of GoogleDocstring
I have updated it based on use case for - https://www.penify.dev
Contributing
Contributions are welcome! Please submit pull requests or report issues on the project's GitHub page.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for PyDocSmith-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | db0c14bca3e5475fd2749bd63ec53bfb187fce3d766c58195013176b9a83bdce |
|
MD5 | 86a34bc3bf8dace62fcf5160de9b148b |
|
BLAKE2b-256 | 8a6f5a00009017dfca808ba58e21b56daf19556f4b19f831f861189f69db2356 |