Name | mkdocstrings-python-legacy JSON |
Version |
0.2.3
JSON |
| download |
home_page | |
Summary | A legacy Python handler for mkdocstrings. |
upload_time | 2022-05-28 16:02:50 |
maintainer | |
docs_url | None |
author | |
requires_python | >=3.7 |
license | ISC |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
<h1 align="center">mkdocstrings-python-legacy</h1>
<p align="center">The legacy Python handler for <a href="https://github.com/mkdocstrings/mkdocstrings"><i>mkdocstrings</i></a>.</p>
<p align="center">
<a href="https://github.com/mkdocstrings/python-legacy/actions?query=workflow%3Aci">
<img alt="ci" src="https://github.com/mkdocstrings/python-legacy/workflows/ci/badge.svg" />
</a>
<a href="https://mkdocstrings.github.io/python-legacy/">
<img alt="documentation" src="https://img.shields.io/badge/docs-mkdocs%20material-blue.svg?style=flat" />
</a>
<a href="https://pypi.org/project/mkdocstrings-python-legacy/">
<img alt="pypi version" src="https://img.shields.io/pypi/v/mkdocstrings-python-legacy.svg" />
</a>
<a href="https://gitpod.io/#https://github.com/mkdocstrings/python-legacy">
<img alt="gitpod" src="https://img.shields.io/badge/gitpod-workspace-blue.svg?style=flat" />
</a>
<a href="https://gitter.im/mkdocstrings/python-legacy">
<img alt="gitter" src="https://badges.gitter.im/join%20chat.svg" />
</a>
</p>
---
<p align="center"><img src="logo.png"></p>
WARNING: We suggest using the new handler instead:
[mkdocstrings-python](https://mkdocstrings.github.io/python/).
## Installation
You can install this handler as a *mkdocstrings* extra:
```toml title="pyproject.toml"
# PEP 621 dependencies declaration
# adapt to your dependencies manager
[project]
dependencies = [
"mkdocstrings[python-legacy]>=0.18",
]
```
You can also explicitely depend on the handler:
```toml title="pyproject.toml"
# PEP 621 dependencies declaration
# adapt to your dependencies manager
[project]
dependencies = [
"mkdocstrings-python-legacy",
]
```
## Preview
<!-- TODO: update the GIF with a more recent screen capture. Maybe use mp4 instead -->
![mkdocstrings_python_gif](https://user-images.githubusercontent.com/3999221/77157838-7184db80-6aa2-11ea-9f9a-fe77405202de.gif)
## Features
- **Data collection from source code**: collection of the object-tree and the docstrings is done thanks to
[pytkdocs](https://github.com/mkdocstrings/pytkdocs).
- **Support for type annotations:** pytkdocs collects your type annotations and *mkdocstrings* uses them
to display parameters types or return types.
- **Recursive documentation of Python objects:** just use the module dotted-path as identifier, and you get the full
module docs. You don't need to inject documentation for each class, function, etc.
- **Support for documented attributes:** attributes (variables) followed by a docstring (triple-quoted string) will
be recognized by Griffe in modules, classes and even in `__init__` methods.
- **Multiple docstring-styles support:** common support for Google-style, Numpydoc-style,
and Sphinx-style docstrings.
- **Admonition support in Google docstrings:** blocks like `Note:` or `Warning:` will be transformed
to their [admonition](https://squidfunk.github.io/mkdocs-material/reference/admonitions/) equivalent.
*We do not support nested admonitions in docstrings!*
- **Every object has a TOC entry:** we render a heading for each object, meaning *MkDocs* picks them into the Table
of Contents, which is nicely display by the Material theme. Thanks to *mkdocstrings* cross-reference ability,
you can reference other objects within your docstrings, with the classic Markdown syntax:
`[this object][package.module.object]` or directly with `[package.module.object][]`
- **Source code display:** *mkdocstrings* can add a collapsible div containing the highlighted source code
of the Python object.
Raw data
{
"_id": null,
"home_page": "",
"name": "mkdocstrings-python-legacy",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "",
"author_email": "Timoth\u00e9e Mazzucotelli <pawamoy@pm.me>",
"download_url": "https://files.pythonhosted.org/packages/c4/44/fdf5e9902e3ea8af04d45d80aef2f34140d1c13c2707bea9c2b69a74e063/mkdocstrings-python-legacy-0.2.3.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">mkdocstrings-python-legacy</h1>\n\n<p align=\"center\">The legacy Python handler for <a href=\"https://github.com/mkdocstrings/mkdocstrings\"><i>mkdocstrings</i></a>.</p>\n\n<p align=\"center\">\n <a href=\"https://github.com/mkdocstrings/python-legacy/actions?query=workflow%3Aci\">\n <img alt=\"ci\" src=\"https://github.com/mkdocstrings/python-legacy/workflows/ci/badge.svg\" />\n </a>\n <a href=\"https://mkdocstrings.github.io/python-legacy/\">\n <img alt=\"documentation\" src=\"https://img.shields.io/badge/docs-mkdocs%20material-blue.svg?style=flat\" />\n </a>\n <a href=\"https://pypi.org/project/mkdocstrings-python-legacy/\">\n <img alt=\"pypi version\" src=\"https://img.shields.io/pypi/v/mkdocstrings-python-legacy.svg\" />\n </a>\n <a href=\"https://gitpod.io/#https://github.com/mkdocstrings/python-legacy\">\n <img alt=\"gitpod\" src=\"https://img.shields.io/badge/gitpod-workspace-blue.svg?style=flat\" />\n </a>\n <a href=\"https://gitter.im/mkdocstrings/python-legacy\">\n <img alt=\"gitter\" src=\"https://badges.gitter.im/join%20chat.svg\" />\n </a>\n</p>\n\n---\n\n<p align=\"center\"><img src=\"logo.png\"></p>\n\nWARNING: We suggest using the new handler instead:\n[mkdocstrings-python](https://mkdocstrings.github.io/python/).\n\n## Installation\n\nYou can install this handler as a *mkdocstrings* extra:\n\n```toml title=\"pyproject.toml\"\n# PEP 621 dependencies declaration\n# adapt to your dependencies manager\n[project]\ndependencies = [\n \"mkdocstrings[python-legacy]>=0.18\",\n]\n```\n\nYou can also explicitely depend on the handler:\n\n```toml title=\"pyproject.toml\"\n# PEP 621 dependencies declaration\n# adapt to your dependencies manager\n[project]\ndependencies = [\n \"mkdocstrings-python-legacy\",\n]\n```\n\n## Preview\n\n<!-- TODO: update the GIF with a more recent screen capture. Maybe use mp4 instead -->\n![mkdocstrings_python_gif](https://user-images.githubusercontent.com/3999221/77157838-7184db80-6aa2-11ea-9f9a-fe77405202de.gif)\n\n## Features\n\n- **Data collection from source code**: collection of the object-tree and the docstrings is done thanks to\n [pytkdocs](https://github.com/mkdocstrings/pytkdocs).\n\n- **Support for type annotations:** pytkdocs collects your type annotations and *mkdocstrings* uses them\n to display parameters types or return types. \n\n- **Recursive documentation of Python objects:** just use the module dotted-path as identifier, and you get the full\n module docs. You don't need to inject documentation for each class, function, etc.\n\n- **Support for documented attributes:** attributes (variables) followed by a docstring (triple-quoted string) will\n be recognized by Griffe in modules, classes and even in `__init__` methods.\n\n- **Multiple docstring-styles support:** common support for Google-style, Numpydoc-style,\n and Sphinx-style docstrings.\n\n- **Admonition support in Google docstrings:** blocks like `Note:` or `Warning:` will be transformed\n to their [admonition](https://squidfunk.github.io/mkdocs-material/reference/admonitions/) equivalent.\n *We do not support nested admonitions in docstrings!*\n\n- **Every object has a TOC entry:** we render a heading for each object, meaning *MkDocs* picks them into the Table\n of Contents, which is nicely display by the Material theme. Thanks to *mkdocstrings* cross-reference ability,\n you can reference other objects within your docstrings, with the classic Markdown syntax:\n `[this object][package.module.object]` or directly with `[package.module.object][]`\n\n- **Source code display:** *mkdocstrings* can add a collapsible div containing the highlighted source code\n of the Python object.\n\n",
"bugtrack_url": null,
"license": "ISC",
"summary": "A legacy Python handler for mkdocstrings.",
"version": "0.2.3",
"project_urls": {
"Changelog": "https://mkdocstrings.github.io/python-legacy/changelog",
"Discussions": "https://github.com/mkdocstrings/python-legacy/discussions",
"Documentation": "https://mkdocstrings.github.io/python-legacy",
"Funding": "https://github.com/sponsors/pawamoy",
"Gitter": "https://gitter.im/mkdocstrings/community",
"Homepage": "https://mkdocstrings.github.io/python-legacy",
"Issues": "https://github.com/mkdocstrings/python-legacy/issues",
"Repository": "https://github.com/mkdocstrings/python-legacy"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4e8224628a430d36ca0047d5582e2ce54644b52a1af618ef6db67ffcd413c6a5",
"md5": "9294f91ae1d62dc7949bb44860ff8d35",
"sha256": "1b04d71a4064b0bb8ea9448debab89868a752c7e7bfdd11de480dfbcb9751a00"
},
"downloads": -1,
"filename": "mkdocstrings_python_legacy-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9294f91ae1d62dc7949bb44860ff8d35",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 26498,
"upload_time": "2022-05-28T16:02:48",
"upload_time_iso_8601": "2022-05-28T16:02:48.032958Z",
"url": "https://files.pythonhosted.org/packages/4e/82/24628a430d36ca0047d5582e2ce54644b52a1af618ef6db67ffcd413c6a5/mkdocstrings_python_legacy-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c444fdf5e9902e3ea8af04d45d80aef2f34140d1c13c2707bea9c2b69a74e063",
"md5": "7ad90163e8355f8b856aa6acf32edc97",
"sha256": "3fb58fdabe19c6b52b8bb1d3bb1540b1cd527b562865468d6754e8cd1201050c"
},
"downloads": -1,
"filename": "mkdocstrings-python-legacy-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "7ad90163e8355f8b856aa6acf32edc97",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 18779,
"upload_time": "2022-05-28T16:02:50",
"upload_time_iso_8601": "2022-05-28T16:02:50.123898Z",
"url": "https://files.pythonhosted.org/packages/c4/44/fdf5e9902e3ea8af04d45d80aef2f34140d1c13c2707bea9c2b69a74e063/mkdocstrings-python-legacy-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-05-28 16:02:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mkdocstrings",
"github_project": "python-legacy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mkdocstrings-python-legacy"
}