.. note that this README gets 'include'ed into the main documentation
sphinxcontrib-trio
==================
This sphinx extension helps you document Python code that uses
async/await, or abstract methods, or context managers, or generators,
or ... you get the idea. It works by making sphinx's regular
directives for documenting Python functions and methods smarter and
more powerful. The name is because it was originally written for the
`Trio <https://trio.readthedocs.io>`__ project, and I'm not very
creative. But don't be put off – there's nothing Trio- or
async-specific about this extension; any Python project can
benefit. (Though projects using async/await probably benefit the most,
since sphinx's built-in tools are especially inadequate in this case.)
Vital statistics
----------------
**Requirements:** This extension currently assumes you're using Python
3.5+ to build your docs. This could be relaxed if anyone wants to send
a patch.
**Documentation:** https://sphinxcontrib-trio.readthedocs.io
**Bug tracker and source code:**
https://github.com/python-trio/sphinxcontrib-trio
**License:** MIT or Apache 2, your choice.
**Usage:** ``pip install -U sphinxcontrib-trio`` in the same
environment where you installed sphinx, and then add
``"sphinxcontrib_trio"`` to the list of ``extensions`` in your
project's ``conf.py``. (Notice that ``"sphinxcontrib_trio"`` has an
underscore in it, NOT a dot. This is because I don't understand
namespace packages, and I fear things that I don't understand.)
**Code of conduct:** Contributors are requested to follow our `code of
conduct
<https://github.com/python-trio/sphinxcontrib-trio/blob/master/CODE_OF_CONDUCT.md>`__
in all project spaces.
Raw data
{
"_id": null,
"home_page": "https://github.com/python-trio/sphinxcontrib-trio",
"name": "sphinxcontrib-trio",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Nathaniel J. Smith",
"author_email": "njs@pobox.com",
"download_url": "https://files.pythonhosted.org/packages/ca/33/ee48d86e30bb3c5d72a47f49b1ebf5c23dd253b04d8d5fc3e6c68407a03e/sphinxcontrib-trio-1.1.2.tar.gz",
"platform": "",
"description": ".. note that this README gets 'include'ed into the main documentation\n\nsphinxcontrib-trio\n==================\n\nThis sphinx extension helps you document Python code that uses\nasync/await, or abstract methods, or context managers, or generators,\nor ... you get the idea. It works by making sphinx's regular\ndirectives for documenting Python functions and methods smarter and\nmore powerful. The name is because it was originally written for the\n`Trio <https://trio.readthedocs.io>`__ project, and I'm not very\ncreative. But don't be put off \u2013 there's nothing Trio- or\nasync-specific about this extension; any Python project can\nbenefit. (Though projects using async/await probably benefit the most,\nsince sphinx's built-in tools are especially inadequate in this case.)\n\n\nVital statistics\n----------------\n\n**Requirements:** This extension currently assumes you're using Python\n3.5+ to build your docs. This could be relaxed if anyone wants to send\na patch.\n\n**Documentation:** https://sphinxcontrib-trio.readthedocs.io\n\n**Bug tracker and source code:**\nhttps://github.com/python-trio/sphinxcontrib-trio\n\n**License:** MIT or Apache 2, your choice.\n\n**Usage:** ``pip install -U sphinxcontrib-trio`` in the same\nenvironment where you installed sphinx, and then add\n``\"sphinxcontrib_trio\"`` to the list of ``extensions`` in your\nproject's ``conf.py``. (Notice that ``\"sphinxcontrib_trio\"`` has an\nunderscore in it, NOT a dot. This is because I don't understand\nnamespace packages, and I fear things that I don't understand.)\n\n**Code of conduct:** Contributors are requested to follow our `code of\nconduct\n<https://github.com/python-trio/sphinxcontrib-trio/blob/master/CODE_OF_CONDUCT.md>`__\nin all project spaces.\n\n\n",
"bugtrack_url": null,
"license": "MIT -or- Apache License 2.0",
"summary": "Make Sphinx better at documenting Python functions and methods",
"version": "1.1.2",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a74d6e1598531046c272730501337d5303ce3958387a4fde1da8875580f5c41b",
"md5": "6dc478155143dce8106c4f608081a0dd",
"sha256": "1b849be08a147ef4113e35c191a51c5792613a9a54697b497cd91656d906a232"
},
"downloads": -1,
"filename": "sphinxcontrib_trio-1.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6dc478155143dce8106c4f608081a0dd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 12185,
"upload_time": "2020-05-04T16:44:35",
"upload_time_iso_8601": "2020-05-04T16:44:35.184849Z",
"url": "https://files.pythonhosted.org/packages/a7/4d/6e1598531046c272730501337d5303ce3958387a4fde1da8875580f5c41b/sphinxcontrib_trio-1.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ca33ee48d86e30bb3c5d72a47f49b1ebf5c23dd253b04d8d5fc3e6c68407a03e",
"md5": "55d12f8888ee0207c41ffc90cfe51e87",
"sha256": "9f1ba9c1d5965b534e85258d8b677dd94e9b1a9a2e918b85ccd42590596b47c0"
},
"downloads": -1,
"filename": "sphinxcontrib-trio-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "55d12f8888ee0207c41ffc90cfe51e87",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 24131,
"upload_time": "2020-05-04T16:44:36",
"upload_time_iso_8601": "2020-05-04T16:44:36.514575Z",
"url": "https://files.pythonhosted.org/packages/ca/33/ee48d86e30bb3c5d72a47f49b1ebf5c23dd253b04d8d5fc3e6c68407a03e/sphinxcontrib-trio-1.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2020-05-04 16:44:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "python-trio",
"github_project": "sphinxcontrib-trio",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "sphinxcontrib-trio"
}
JSON
