# 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/3c/c2/7e379c837d00ae1ab4441aa4f97246d73434ef4af3346a8546d5bd452336/ansible_doctor-7.0.0.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.0",
"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": "8e9e7853ea88edfc48ef54c86d90fd31e6f37624dba46254b1948fa38f227e40",
"md5": "d1d621f2e649c0e976ca01964e66ba1a",
"sha256": "6fe6ac69b17a6ceb33b690922e421a3897866d48044e1308dcd9807894e14003"
},
"downloads": -1,
"filename": "ansible_doctor-7.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1d621f2e649c0e976ca01964e66ba1a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.10.0",
"size": 47801,
"upload_time": "2024-11-08T22:30:40",
"upload_time_iso_8601": "2024-11-08T22:30:40.673316Z",
"url": "https://files.pythonhosted.org/packages/8e/9e/7853ea88edfc48ef54c86d90fd31e6f37624dba46254b1948fa38f227e40/ansible_doctor-7.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3cc27e379c837d00ae1ab4441aa4f97246d73434ef4af3346a8546d5bd452336",
"md5": "30f295ac1429b294f30ac9a4f1fde9c2",
"sha256": "abae90936da122d1ef7198d3ce37a6a5e74d53c1d8d1b401b4e54a24dfde5365"
},
"downloads": -1,
"filename": "ansible_doctor-7.0.0.tar.gz",
"has_sig": false,
"md5_digest": "30f295ac1429b294f30ac9a4f1fde9c2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.10.0",
"size": 28386,
"upload_time": "2024-11-08T22:30:42",
"upload_time_iso_8601": "2024-11-08T22:30:42.518459Z",
"url": "https://files.pythonhosted.org/packages/3c/c2/7e379c837d00ae1ab4441aa4f97246d73434ef4af3346a8546d5bd452336/ansible_doctor-7.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-08 22:30:42",
"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
