Skip to content

Commit d60a834

Browse files
committed
Update Readme
1 parent 33c7e35 commit d60a834

3 files changed

Lines changed: 12 additions & 4 deletions

File tree

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,3 +2,6 @@
22
__pycache__
33
*.egg-info
44
poetry.lock
5+
dist
6+
build
7+
.vscode

README.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,6 @@
11
The project is a fork from the original project - https://github.com/rr-/docstring_parser/
22

3-
Based on the provided document, here is a README outline for the Python package it describes:
4-
5-
---
3+
I have updated it based on use case for - https://www.snorkell.ai/
64

75
# PyDocSmith
86

@@ -66,6 +64,13 @@ print(docstring_text)
6664
- **Parse From Object:** PyDocSmith can parse docstrings directly from Python objects, including classes and modules, incorporating attribute docstrings into the structured representation.
6765
- **Custom Rendering Styles:** Customize the rendering of docstrings with compact or detailed styles, and specify custom indentation for the generated docstring text.
6866

67+
## Things that have been modified wrt to docstring_parser
68+
69+
1. Better heuristics to detect docstring style
70+
2. Google Docstring has been modified to accommodate Notes, Examples
71+
3. Sometime GoogleDoc string doesn't have proper indentation specially when generated from LLMs like GPT or Mistral. PyDocSmith can fix those bad docstrings.
72+
4. Additional test-cases were added to accommodate a different style of GoogleDocstring
73+
6974
## Contributing
7075

7176
Contributions are welcome! Please submit pull requests or report issues on the project's GitHub page.

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
setup(
44
name="PyDocSmith",
5-
version="0.1",
5+
version="0.1.1",
66
description="It parses and composes docstrings in Google, Numpydoc, ReST and Epydoc.",
77
long_description=open("README.md").read(),
88
long_description_content_type="text/markdown",

0 commit comments

Comments
 (0)