This is a Python library for processing Ansible documentation markup. It is named after antsibull-docs where this code originates from. It was moved out to make it easier to reuse the markup code in other projects without having to depend on all of antsibull-docs's dependencies.
Install and run nox to run all tests. nox will create virtual environments in .nox inside the checked out project and install the requirements needed to run the tests there.
To run specific tests:
nox -e testto only run unit tests;nox -e lintto run all linters and formatters at once;nox -e formattersto runisortandblack;nox -e codeqato runflake8,pylint,reuse lint, andantsibull-changelog lint;nox -e typingto runmypyandpyre;nox -e create_vectorsto update thetest-vectors.ymlfile. Please note that this file should be synchronized with the corresponding file in the antsibull-docs-ts project.
- Run
nox -e bump -- <version> <release_summary_message>. This:- Bumps the package version in
src/antsibull_docs_parser/__init__.py. - Creates
changelogs/fragments/<version>.ymlwith arelease_summarysection. - Runs
antsibull-changelog releaseand adds the changed files to git. - Commits with message
Release <version>.and runsgit tag -a -m 'antsibull-docs-parser <version>' <version>. - Runs
hatch build --clean.
- Bumps the package version in
- Run
git pushto the appropriate remotes. - Once CI passes on GitHub, run
nox -e publish. This:- Runs
hatch publish; - Bumps the version to
<version>.post0; - Adds the changed file to git and run
git commit -m 'Post-release version bump.';
- Runs
- Run
git push --follow-tagsto the appropriate remotes and create a GitHub release.