Go to file
Robert Kaussow 8e22e87a31
refactor: replace logger by structlog (#718)
BREAKING CHANGE: Replace the custom logger and `python-json-logger` with
`structlog`. This will also change the layout and general structure of
the log messages.

The original `python-json-logger` package is unmaintained and has caused
some issues. Using https://github.com/nhairs/python-json-logger.git
instead has fixed the logging issues but prevents PyPI package
uploads...

```
HTTP Error 400: Can't have direct dependency: python-json-logger@ git+https://github.com/nhairs/python-json-logger.git@v3.1.0. See https://packaging.python.org/specifications/core-metadata for more information.
```
2024-06-17 13:51:03 +02:00
.github use list style synatx and cleanup (#619) 2023-12-23 23:24:56 +01:00
.gitsv chore: replace git-chglog by git-sv (#574) 2023-10-16 15:43:04 +02:00
.woodpecker chore(deps): update quay.io/thegeeklab/hugo docker tag to v0.127.0 (#713) 2024-06-10 07:27:41 +02:00
ansibledoctor refactor: replace logger by structlog (#718) 2024-06-17 13:51:03 +02:00
docs feat: add option to load templates from remote git sources (#717) 2024-06-12 20:59:55 +02:00
example feat: add option to load templates from remote git sources (#717) 2024-06-12 20:59:55 +02:00
.dictionary feat: add pre-commit support (#449) 2023-02-10 19:56:00 +01:00
.gitignore refctor: migrate flake8 to ruff python linter (#429) 2023-01-20 11:56:12 +01:00
.lycheeignore ci: exclude dockerhub from linkcheck due to rate limiting 2023-12-07 09:08:22 +01:00
.markdownlint.yml chore: unifi jinja template syntax and add linting (#704) 2024-06-02 09:00:07 +02:00
.pre-commit-hooks.yaml fix: install extra group when using pre-commit (#687) 2024-04-24 08:54:48 +02:00
.prettierignore ci: migrate to woodpecker (#543) 2023-08-25 00:02:01 +02:00
Containerfile.multiarch chore(docker): update python:3.12-alpine docker digest to a982997 2024-06-15 04:27:03 +02:00
CONTRIBUTING.md fix bare url in contribution file (#488) 2023-05-03 09:31:07 +02:00
LICENSE chore: end of the year maintenance 2021-12-21 10:15:38 +01:00
Makefile chore(deps): update dependency thegeeklab/hugo-geekdoc to v0.46.0 2024-06-10 03:08:33 +02:00
poetry.lock refactor: replace logger by structlog (#718) 2024-06-17 13:51:03 +02:00
pyproject.toml refactor: replace logger by structlog (#718) 2024-06-17 13:51:03 +02:00
README.md ci: migrate to woodpecker (#543) 2023-08-25 00:02:01 +02:00
renovate.json separate minor-patch for ansible deps 2024-04-12 09:23:00 +02:00

ansible-doctor

Annotation based documentation for your Ansible roles

Build Status Docker Hub Quay.io Python Version PyPI Status PyPI Release GitHub contributors Source: GitHub License: GPL-3.0

This project is based on the idea (and at some parts on the code) of 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 or PyPI and as Docker Image on Docker Hub.

The full documentation is available at https://ansible-doctor.geekdocs.de.

Contributors

Special thanks to all contributors. If you would like to contribute, please see the instructions.

License

This project is licensed under the GPL-3.0 License - see the LICENSE file for details.