| Name | docstring-parser-fork JSON |
| Version |
0.0.14
JSON |
| download |
| home_page | None |
| Summary | Parse Python docstrings in reST, Google and Numpydoc format |
| upload_time | 2025-09-07 17:27:38 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
docstring_parser_fork
================
This is a fork of [docstring_parser](https://github.com/rr-/docstring_parser).
This fork fixes bugs that the upstream library has not fixed, and it also
offers additional functionalities. To inspect the difference between this
fort and the upstream, go to [CHANGELOG.md](./CHANGELOG.md) and read the
entries that start with "(Fork)".
------
[](https://github.com/rr-/docstring_parser/actions/workflows/build.yml)
Parse Python docstrings. Currently support ReST, Google, Numpydoc-style and
Epydoc docstrings.
Example usage:
```python
>>> from docstring_parser import parse
>>>
>>>
>>> docstring = parse(
... '''
... Short description
...
... Long description spanning multiple lines
... - First line
... - Second line
... - Third line
...
... :param name: description 1
... :param int priority: description 2
... :param str sender: description 3
... :raises ValueError: if name is invalid
... ''')
>>>
>>> docstring.long_description
'Long description spanning multiple lines\n- First line\n- Second line\n- Third line'
>>> docstring.params[1].arg_name
'priority'
>>> docstring.raises[0].type_name
'ValueError'
```
Read [API Documentation](https://rr-.github.io/docstring_parser/).
# Installation
Installation using pip
```shell
pip install docstring_parser_fork
# or if you want to install it in a virtual environment
python -m venv venv # create environment
source venv/bin/activate # activate environment
python -m pip install docstring_parser_fork
```
Installation using conda
1. Download and install miniconda or anaconda
2. Install the package from the conda-forge channel via:
- `conda install -c conda-forge docstring_parser`
- or create a new conda environment via `conda create -n my-new-environment -c conda-forge docstring_parser`
# Contributing
To set up the project:
```sh
git clone https://github.com/rr-/docstring_parser.git
cd docstring_parser
python -m venv venv # create environment
source venv/bin/activate # activate environment
pip install -e ".[dev]" # install as editable
pre-commit install # make sure pre-commit is setup
```
To run tests:
```
source venv/bin/activate
pytest
```
Raw data
{
"_id": null,
"home_page": null,
"name": "docstring-parser-fork",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Marcin Kurczewski <dash@wind.garden>",
"download_url": "https://files.pythonhosted.org/packages/66/bf/27f9cab2f0cd1d17a4420572088bbc19f36d726fbcf165edf226a8926dbc/docstring_parser_fork-0.0.14.tar.gz",
"platform": null,
"description": "docstring_parser_fork\n================\n\nThis is a fork of [docstring_parser](https://github.com/rr-/docstring_parser).\n\nThis fork fixes bugs that the upstream library has not fixed, and it also\noffers additional functionalities. To inspect the difference between this\nfort and the upstream, go to [CHANGELOG.md](./CHANGELOG.md) and read the\nentries that start with \"(Fork)\".\n\n------\n\n[](https://github.com/rr-/docstring_parser/actions/workflows/build.yml)\n\nParse Python docstrings. Currently support ReST, Google, Numpydoc-style and\nEpydoc docstrings.\n\nExample usage:\n\n```python\n>>> from docstring_parser import parse\n>>>\n>>>\n>>> docstring = parse(\n... '''\n... Short description\n...\n... Long description spanning multiple lines\n... - First line\n... - Second line\n... - Third line\n...\n... :param name: description 1\n... :param int priority: description 2\n... :param str sender: description 3\n... :raises ValueError: if name is invalid\n... ''')\n>>>\n>>> docstring.long_description\n'Long description spanning multiple lines\\n- First line\\n- Second line\\n- Third line'\n>>> docstring.params[1].arg_name\n'priority'\n>>> docstring.raises[0].type_name\n'ValueError'\n```\n\nRead [API Documentation](https://rr-.github.io/docstring_parser/).\n\n# Installation\n\nInstallation using pip\n\n```shell\npip install docstring_parser_fork\n\n# or if you want to install it in a virtual environment\n\npython -m venv venv # create environment\nsource venv/bin/activate # activate environment\npython -m pip install docstring_parser_fork\n```\n\nInstallation using conda\n\n\n1. Download and install miniconda or anaconda\n2. Install the package from the conda-forge channel via:\n - `conda install -c conda-forge docstring_parser`\n - or create a new conda environment via `conda create -n my-new-environment -c conda-forge docstring_parser`\n\n\n# Contributing\n\nTo set up the project:\n```sh\ngit clone https://github.com/rr-/docstring_parser.git\ncd docstring_parser\n\npython -m venv venv # create environment\nsource venv/bin/activate # activate environment\n\npip install -e \".[dev]\" # install as editable\npre-commit install # make sure pre-commit is setup\n```\n\nTo run tests:\n```\nsource venv/bin/activate\npytest\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Parse Python docstrings in reST, Google and Numpydoc format",
"version": "0.0.14",
"project_urls": {
"changelog": "https://github.com/rr-/docstring_parser/blob/master/CHANGELOG.md",
"homepage": "https://github.com/rr-/docstring_parser",
"repository": "https://github.com/rr-/docstring_parser"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bf5098b146aea0f1cd7531d25f12bea69fa9ce8d1662124f93fb30dc4511b65e",
"md5": "5b54e92edb0dfa64e8f6a7e8bea341a9",
"sha256": "4c544f234ef2cc2749a3df32b70c437d77888b1099143a1ad5454452c574b9af"
},
"downloads": -1,
"filename": "docstring_parser_fork-0.0.14-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5b54e92edb0dfa64e8f6a7e8bea341a9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 43063,
"upload_time": "2025-09-07T17:27:37",
"upload_time_iso_8601": "2025-09-07T17:27:37.012724Z",
"url": "https://files.pythonhosted.org/packages/bf/50/98b146aea0f1cd7531d25f12bea69fa9ce8d1662124f93fb30dc4511b65e/docstring_parser_fork-0.0.14-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "66bf27f9cab2f0cd1d17a4420572088bbc19f36d726fbcf165edf226a8926dbc",
"md5": "fc4af1cd2ed33e0a4ddc8131457fd02b",
"sha256": "a2743a63d8d36c09650594f7b4ab5b2758fee8629dcf794d1b221b23179baa5c"
},
"downloads": -1,
"filename": "docstring_parser_fork-0.0.14.tar.gz",
"has_sig": false,
"md5_digest": "fc4af1cd2ed33e0a4ddc8131457fd02b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 34551,
"upload_time": "2025-09-07T17:27:38",
"upload_time_iso_8601": "2025-09-07T17:27:38.272564Z",
"url": "https://files.pythonhosted.org/packages/66/bf/27f9cab2f0cd1d17a4420572088bbc19f36d726fbcf165edf226a8926dbc/docstring_parser_fork-0.0.14.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-07 17:27:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rr-",
"github_project": "docstring_parser",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "docstring-parser-fork"
}
