# ansible-doctor
Annotation based documentation for your Ansible roles
[](https://ci.thegeeklab.de/repos/thegeeklab/ansible-doctor)
[](https://hub.docker.com/r/thegeeklab/ansible-doctor)
[](https://quay.io/repository/thegeeklab/ansible-doctor)
[](https://pypi.org/project/ansible-doctor/)
[](https://pypi.org/project/ansible-doctor/)
[](https://pypi.org/project/ansible-doctor/)
[](https://github.com/thegeeklab/ansible-doctor/graphs/contributors)
[](https://github.com/thegeeklab/ansible-doctor)
[](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE)
This project is based on the idea (and at some parts on the code) of [ansible-autodoc](https://github.com/AndresBott/ansible-autodoc) by Andres Bott so credits goes to him for his work.
_ansible-doctor_ is a simple annotation like documentation generator based on Jinja2 templates. While _ansible-doctor_ comes with a default template called `readme`, it is also possible to write custom templates to customize the output or render the data to other formats like HTML or XML as well.
_ansible-doctor_ is designed to work within a CI pipeline to complete the existing testing and deployment workflow. Releases are available as Python Packages on [GitHub](https://github.com/thegeeklab/ansible-doctor/releases) or [PyPI](https://pypi.org/project/ansible-doctor/) and as Docker Image on [Docker Hub](https://hub.docker.com/r/thegeeklab/ansible-doctor).
The full documentation is available at [https://ansible-doctor.geekdocs.de](https://ansible-doctor.geekdocs.de/).
## Contributors
Special thanks to all [contributors](https://github.com/thegeeklab/ansible-doctor/graphs/contributors). If you would like to contribute,
please see the [instructions](https://github.com/thegeeklab/ansible-doctor/blob/main/CONTRIBUTING.md).
## License
This project is licensed under the GPL-3.0 License - see the [LICENSE](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": "https://ansible-doctor.geekdocs.de/",
"name": "ansible-doctor",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0.0,>=3.10.0",
"maintainer_email": null,
"keywords": "ansible, role, documentation",
"author": "Robert Kaussow",
"author_email": "mail@thegeeklab.de",
"download_url": "https://files.pythonhosted.org/packages/90/53/8c3d3a91c15205f323bf77ad4f0f375a135b5fce416d2f6c57b9fdbf28b4/ansible_doctor-7.0.2.tar.gz",
"platform": null,
"description": "# ansible-doctor\n\nAnnotation based documentation for your Ansible roles\n\n[](https://ci.thegeeklab.de/repos/thegeeklab/ansible-doctor)\n[](https://hub.docker.com/r/thegeeklab/ansible-doctor)\n[](https://quay.io/repository/thegeeklab/ansible-doctor)\n[](https://pypi.org/project/ansible-doctor/)\n[](https://pypi.org/project/ansible-doctor/)\n[](https://pypi.org/project/ansible-doctor/)\n[](https://github.com/thegeeklab/ansible-doctor/graphs/contributors)\n[](https://github.com/thegeeklab/ansible-doctor)\n[](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE)\n\nThis project is based on the idea (and at some parts on the code) of [ansible-autodoc](https://github.com/AndresBott/ansible-autodoc) by Andres Bott so credits goes to him for his work.\n\n_ansible-doctor_ is a simple annotation like documentation generator based on Jinja2 templates. While _ansible-doctor_ comes with a default template called `readme`, it is also possible to write custom templates to customize the output or render the data to other formats like HTML or XML as well.\n\n_ansible-doctor_ is designed to work within a CI pipeline to complete the existing testing and deployment workflow. Releases are available as Python Packages on [GitHub](https://github.com/thegeeklab/ansible-doctor/releases) or [PyPI](https://pypi.org/project/ansible-doctor/) and as Docker Image on [Docker Hub](https://hub.docker.com/r/thegeeklab/ansible-doctor).\n\nThe full documentation is available at [https://ansible-doctor.geekdocs.de](https://ansible-doctor.geekdocs.de/).\n\n## Contributors\n\nSpecial thanks to all [contributors](https://github.com/thegeeklab/ansible-doctor/graphs/contributors). If you would like to contribute,\nplease see the [instructions](https://github.com/thegeeklab/ansible-doctor/blob/main/CONTRIBUTING.md).\n\n## License\n\nThis project is licensed under the GPL-3.0 License - see the [LICENSE](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Generate documentation from annotated Ansible roles using templates.",
"version": "7.0.2",
"project_urls": {
"Documentation": "https://ansible-doctor.geekdocs.de/",
"Homepage": "https://ansible-doctor.geekdocs.de/",
"Repository": "https://github.com/thegeeklab/ansible-doctor/"
},
"split_keywords": [
"ansible",
" role",
" documentation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a712fea773a7c6399c6533ad50425389d5fd5b4d494f6b2a8855be43ac40f044",
"md5": "36c5e501ba83c09d2f166c53bd087e58",
"sha256": "d3f32adeadf4b7261957b02d3af5831d18ad24869e4c586e867e08ee07385394"
},
"downloads": -1,
"filename": "ansible_doctor-7.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "36c5e501ba83c09d2f166c53bd087e58",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.10.0",
"size": 47808,
"upload_time": "2024-12-18T08:10:54",
"upload_time_iso_8601": "2024-12-18T08:10:54.387731Z",
"url": "https://files.pythonhosted.org/packages/a7/12/fea773a7c6399c6533ad50425389d5fd5b4d494f6b2a8855be43ac40f044/ansible_doctor-7.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "90538c3d3a91c15205f323bf77ad4f0f375a135b5fce416d2f6c57b9fdbf28b4",
"md5": "73901d8e362a3218a2824f51f7207813",
"sha256": "ad88b0754756cc9d618384870aa07123e2110c19b8be1be3be79c909d293a33d"
},
"downloads": -1,
"filename": "ansible_doctor-7.0.2.tar.gz",
"has_sig": false,
"md5_digest": "73901d8e362a3218a2824f51f7207813",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.10.0",
"size": 28393,
"upload_time": "2024-12-18T08:10:57",
"upload_time_iso_8601": "2024-12-18T08:10:57.524272Z",
"url": "https://files.pythonhosted.org/packages/90/53/8c3d3a91c15205f323bf77ad4f0f375a135b5fce416d2f6c57b9fdbf28b4/ansible_doctor-7.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-18 08:10:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "thegeeklab",
"github_project": "ansible-doctor",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ansible-doctor"
}
JSON
