Added CHANGELOG.rst file and changed to fragments based change log

Signed-off-by: Andreas Maier <maiera@de.ibm.com>

.github/workflows/test.yml

@@ -194,6 +194,12 @@ jobs:
           echo 'Error: Module .rst files are not up to date in this PR. Run make docslocal to update.';
           exit 1;
         fi"
+    - name: Run check_frag
+      env:
+        PACKAGE_LEVEL: ${{ matrix.package_level }}
+        RUN_TYPE: ${{ steps.set-run-type.outputs.result }}
+      run: |
+        make check_frag
     - name: Run check
       env:
         PACKAGE_LEVEL: ${{ matrix.package_level }}

.gitignore

@@ -24,6 +24,7 @@ tmp_*
 /tests/output/
 /AUTHORS
 /ChangeLog
+/changelogs/.plugin-cache.yaml
 /build/
 /gh-pages/
 /docs_local

Makefile

@@ -132,13 +132,13 @@ safety_all_policy_file := .safety-policy-all.yml
 # Packages whose dependencies are checked using pip-missing-reqs
 # ansible_test and pylint are checked only on officially supported Python versions
 ifeq ($(python_m_n_version),3.8)
-  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor
+  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor antsibull_changelog
 else ifeq ($(python_m_n_version),3.9)
-  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor ansible_test pylint
+  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor antsibull_changelog ansible_test pylint
 else ifeq ($(python_m_n_version),3.10)
-  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor ansible_test ansiblelint pylint
+  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor antsibull_changelog ansible_test ansiblelint pylint
 else ifeq ($(python_m_n_version),3.11)
-  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor ansible_test ansiblelint pylint
+  check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 sphinx ansible_doc_extractor antsibull_changelog ansible_test ansiblelint pylint
 else
 # sphinx is excluded because pip-missing-reqs 2.5 reports missing sphinx-versions package (rightfully)
   check_reqs_packages := ansible pip_check_reqs pytest coverage coveralls flake8 ansible_doc_extractor ansible_test ansiblelint pylint
@@ -204,6 +204,7 @@ help:
 	@echo '  safety     - Run safety for install and all'
 	@echo '  bandit     - Run bandit checker'
 	@echo '  check_reqs - Perform missing dependency checks'
+	@echo '  check_frag - Run antsibull-changelog lint on change log fragments'
 	@echo '  docs       - Build the documentation for all enabled (docs/source/conf.py) versions in: $(doc_build_dir) using remote repo'
 	@echo '  docslocal  - Build the documentation from local repo contents in: $(doc_build_local_dir)'
 	@echo '  linkcheck  - Check links in documentation'
@@ -237,7 +238,7 @@ help:
 	@echo '  ansible-playbook playbooks/....'
 
 .PHONY: all
-all: install develop dist safety bandit check sanity ansible_lint check_reqs docs docslocal linkcheck test end2end_mocked
+all: install develop dist safety bandit check check_frag sanity ansible_lint check_reqs docs docslocal linkcheck test end2end_mocked
 	@echo '$@ done.'
 
 .PHONY: install
@@ -350,6 +351,16 @@ endif
 endif
 	@echo "Makefile: $@ done."
 
+.PHONY: check_frag
+check_frag: _check_version develop_$(pymn).done
+ifneq ($(doc_build),true)
+	@echo "Makefile: Warning: Skipping the checking of changelog fragments on Python $(python_m_n_version)"
+else
+	@echo "Makefile: Checking changelog fragments"
+	antsibull-changelog lint -vv
+endif
+	@echo "Makefile: $@ done."
+
 .PHONY:	end2end
 end2end: _check_version $(done_dir)/develop_$(pymn)_$(PACKAGE_LEVEL).done
 	bash -c 'PYTHONWARNINGS=default ANSIBLE_LIBRARY=$(module_py_dir) PYTHONPATH=. TESTEND2END_LOAD=true pytest -v $(pytest_cov_opts) $(pytest_opts) $(test_dir)/end2end'
@@ -481,11 +492,13 @@ $(module_rst_dir)/%.rst: $(module_py_dir)/%.py $(module_rst_dir) $(doc_templates
 
 # .nojekyll file disables GitHub pages jekyll pre-processing
 $(doc_build_dir)/index.html: $(doc_rst_files) $(doc_source_dir)/conf.py
+	antsibull-changelog generate --reload-plugins -vv
 	sphinx-versioning -l $(doc_source_dir)/conf.py build $(doc_source_dir) $(doc_build_dir) -- $(sphinx_opts)
 	touch $(doc_build_dir)/.nojekyll
 
 .PHONY: docslocal
 docslocal: _check_version $(done_dir)/develop_$(pymn)_$(PACKAGE_LEVEL).done $(doc_rst_files) $(doc_source_dir)/conf.py
 	rm -rf $(doc_build_local_dir)
+	antsibull-changelog generate --reload-plugins -vv
 	sphinx-build -b html $(sphinx_opts) $(doc_source_dir) $(doc_build_local_dir)
 #	open $(doc_build_local_dir)/index.html