# 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.9.0",
"maintainer_email": null,
"keywords": "ansible, role, documentation",
"author": "Robert Kaussow",
"author_email": "mail@thegeeklab.de",
"download_url": "https://files.pythonhosted.org/packages/26/ae/941dfc72c98b23fd344fea370e5b31f946f582163efddf5b092dbde7b841/ansible_doctor-4.0.5.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": "4.0.5",
"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": "f4c2a89d6eaa0cef1c75c4337786f24f519d3da9c5aac49cb6cc297ee9086327",
"md5": "aef246756eea12b8048d9663930083c0",
"sha256": "c0afbc34b9a6a98e8db15f5e5ba65bfe580b10fa63a060d2a7601875949585f8"
},
"downloads": -1,
"filename": "ansible_doctor-4.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aef246756eea12b8048d9663930083c0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.9.0",
"size": 46535,
"upload_time": "2024-04-25T08:28:11",
"upload_time_iso_8601": "2024-04-25T08:28:11.279555Z",
"url": "https://files.pythonhosted.org/packages/f4/c2/a89d6eaa0cef1c75c4337786f24f519d3da9c5aac49cb6cc297ee9086327/ansible_doctor-4.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "26ae941dfc72c98b23fd344fea370e5b31f946f582163efddf5b092dbde7b841",
"md5": "348f5920430653c001ac6e74394f2eea",
"sha256": "47532511e0691348da80d74c5041250efaa96c52ad3e2f37ceb68edc7d2cd942"
},
"downloads": -1,
"filename": "ansible_doctor-4.0.5.tar.gz",
"has_sig": false,
"md5_digest": "348f5920430653c001ac6e74394f2eea",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.9.0",
"size": 28295,
"upload_time": "2024-04-25T08:28:14",
"upload_time_iso_8601": "2024-04-25T08:28:14.286115Z",
"url": "https://files.pythonhosted.org/packages/26/ae/941dfc72c98b23fd344fea370e5b31f946f582163efddf5b092dbde7b841/ansible_doctor-4.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-25 08:28:14",
"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
