[![REUSE status](https://api.reuse.software/badge/github.com/SAP/invoke-plugin-for-sphinx)](https://api.reuse.software/info/github.com/SAP/invoke-plugin-for-sphinx)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)
[![PyPI version](https://badge.fury.io/py/invoke-plugin-for-sphinx.svg)](https://badge.fury.io/py/invoke-plugin-for-sphinx)
# Invoke Plugin for Sphinx
This is a plugin which allows the documentation of invoke tasks with sphinx `autodoc`.
An invoke task looks like a normal function but the `@task` decorator creates a `Task` object behind the scenes.
Documenting these with `autodoc` can lead to errors or unexpected results.
## Installation
`pip install invoke-plugin-for-sphinx`, that's it.
## Usage
Add the plugin to the extensions list:
```py
extensions = ["invoke_plugin_for_sphinx"]
```
Then you can use `.. automodule::` as usual.
Behind the scenes, the function documenter of `autodoc` is extended to also handle tasks equal to functions.
Therefore the same configurations, limitations and features apply.
## Build and Publish
This project uses `setuptools` as the dependency management and build tool.
To publish a new release, follow these steps:
* Update the version in the `pyproject.toml`
* Add an entry in the changelog
* Push a new tag like `vX.X.X` to trigger the release
## Support, Feedback, Contributing
This project is open to feature requests/suggestions, bug reports etc. via [GitHub issues](https://github.com/SAP/invoke-plugin-for-sphinx/issues). Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](CONTRIBUTING.md).
## Code of Conduct
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its [Code of Conduct](CODE_OF_CONDUCT.md) at all times.
## Licensing
Copyright 2023 SAP SE or an SAP affiliate company and invoke-plugin-for-sphinx contributors. Please see our [LICENSE](LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/SAP/invoke-plugin-for-sphinx).
Raw data
{
"_id": null,
"home_page": "",
"name": "invoke-plugin-for-sphinx",
"maintainer": "",
"docs_url": null,
"requires_python": "<4,>=3.7",
"maintainer_email": "",
"keywords": "sphinx,invoke,plugin,inv,documentation",
"author": "",
"author_email": "Kai Mueller <kai.mueller01@sap.com>",
"download_url": "https://files.pythonhosted.org/packages/d8/a6/78109d841aa8bf9f52b4b9828e0da35a9d845b0404b946308cdcc20b1607/invoke-plugin-for-sphinx-1.1.0.tar.gz",
"platform": null,
"description": "[![REUSE status](https://api.reuse.software/badge/github.com/SAP/invoke-plugin-for-sphinx)](https://api.reuse.software/info/github.com/SAP/invoke-plugin-for-sphinx)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336)](https://pycqa.github.io/isort/)\n[![PyPI version](https://badge.fury.io/py/invoke-plugin-for-sphinx.svg)](https://badge.fury.io/py/invoke-plugin-for-sphinx)\n\n# Invoke Plugin for Sphinx\nThis is a plugin which allows the documentation of invoke tasks with sphinx `autodoc`.\nAn invoke task looks like a normal function but the `@task` decorator creates a `Task` object behind the scenes.\nDocumenting these with `autodoc` can lead to errors or unexpected results.\n\n## Installation\n`pip install invoke-plugin-for-sphinx`, that's it.\n\n## Usage\nAdd the plugin to the extensions list:\n\n```py\nextensions = [\"invoke_plugin_for_sphinx\"]\n```\n\nThen you can use `.. automodule::` as usual.\nBehind the scenes, the function documenter of `autodoc` is extended to also handle tasks equal to functions.\nTherefore the same configurations, limitations and features apply.\n\n## Build and Publish\n\nThis project uses `setuptools` as the dependency management and build tool.\nTo publish a new release, follow these steps:\n* Update the version in the `pyproject.toml`\n* Add an entry in the changelog\n* Push a new tag like `vX.X.X` to trigger the release\n\n## Support, Feedback, Contributing\n\nThis project is open to feature requests/suggestions, bug reports etc. via [GitHub issues](https://github.com/SAP/invoke-plugin-for-sphinx/issues). Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our [Contribution Guidelines](CONTRIBUTING.md).\n\n## Code of Conduct\n\nWe as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its [Code of Conduct](CODE_OF_CONDUCT.md) at all times.\n\n## Licensing\n\nCopyright 2023 SAP SE or an SAP affiliate company and invoke-plugin-for-sphinx contributors. Please see our [LICENSE](LICENSE) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/SAP/invoke-plugin-for-sphinx).\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Sphinx plugin which can render invoke tasks with autodoc",
"version": "1.1.0",
"project_urls": {
"Changelog": "https://github.com/SAP/invoke-plugin-for-sphinx/blob/main/CHANGELOG.md",
"Issue Tracker": "https://github.com/SAP/invoke-plugin-for-sphinx/issues"
},
"split_keywords": [
"sphinx",
"invoke",
"plugin",
"inv",
"documentation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f50792159ac3754c165bcc88562b07654ef1bae3a0c2af5cef7d7b149b4db669",
"md5": "e6178f0b29ed27ae78d2d11da1ee9a16",
"sha256": "321c8788d65beff510f1e9e9dcd85ec0f1bc2648dab7b86bad49f02516855c44"
},
"downloads": -1,
"filename": "invoke_plugin_for_sphinx-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e6178f0b29ed27ae78d2d11da1ee9a16",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.7",
"size": 8296,
"upload_time": "2023-07-24T08:19:14",
"upload_time_iso_8601": "2023-07-24T08:19:14.524600Z",
"url": "https://files.pythonhosted.org/packages/f5/07/92159ac3754c165bcc88562b07654ef1bae3a0c2af5cef7d7b149b4db669/invoke_plugin_for_sphinx-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d8a678109d841aa8bf9f52b4b9828e0da35a9d845b0404b946308cdcc20b1607",
"md5": "11b3675c1f1cf47f89532febb89bd72e",
"sha256": "a8bbddd0651365d1ed2d9e3ef5b1a90ca2cb77d9f5387c02ae307d323ad1ac54"
},
"downloads": -1,
"filename": "invoke-plugin-for-sphinx-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "11b3675c1f1cf47f89532febb89bd72e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.7",
"size": 8558,
"upload_time": "2023-07-24T08:19:15",
"upload_time_iso_8601": "2023-07-24T08:19:15.978456Z",
"url": "https://files.pythonhosted.org/packages/d8/a6/78109d841aa8bf9f52b4b9828e0da35a9d845b0404b946308cdcc20b1607/invoke-plugin-for-sphinx-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-24 08:19:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SAP",
"github_project": "invoke-plugin-for-sphinx",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "invoke-plugin-for-sphinx"
}