antsibull-nox 0.3.0__tar.gz → 0.5.0__tar.gz

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/.flake8

@@ -10,7 +10,7 @@ max-complexity = 20
 max-line-length = 100
 statistics = True
 # These rules conflict with black
-ignore = E203, W503
+ignore = E203, E704, W503
 
 # Line in multi-line string is too long:
 per-file-ignores =

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/.github/workflows/nox.yml

@@ -60,7 +60,7 @@ jobs:
         run: |
           sudo apt-get install -y ${{ matrix.packages }}
       - name: Setup nox
-        uses: wntrblm/nox@2025.02.09
+        uses: wntrblm/nox@2025.05.01
         with:
           python-versions: "${{ matrix.python-versions }}"
       - name: Run nox

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/.pylintrc.automated

@@ -71,6 +71,7 @@ disable=
     too-many-lines,
     too-many-locals,
     too-many-positional-arguments,
+    too-many-statements,
 
 # Enable the message, report, category or checker with the given id(s). You can
 # either give multiple identifier separated by comma (,) or put this option

antsibull_nox-0.3.0/docs/changelog.md → antsibull_nox-0.5.0/CHANGELOG.md

@@ -1,9 +1,83 @@
 # Antsibull Nox Helper Release Notes
 
+**Topics**
+
+- <a href="#v0-5-0">v0\.5\.0</a>
+    - <a href="#release-summary">Release Summary</a>
+    - <a href="#minor-changes">Minor Changes</a>
+    - <a href="#bugfixes">Bugfixes</a>
+- <a href="#v0-4-0">v0\.4\.0</a>
+    - <a href="#release-summary-1">Release Summary</a>
+    - <a href="#major-changes">Major Changes</a>
+    - <a href="#minor-changes-1">Minor Changes</a>
+    - <a href="#bugfixes-1">Bugfixes</a>
+- <a href="#v0-3-0">v0\.3\.0</a>
+    - <a href="#release-summary-2">Release Summary</a>
+    - <a href="#minor-changes-2">Minor Changes</a>
+    - <a href="#removed-features-previously-deprecated">Removed Features \(previously deprecated\)</a>
+    - <a href="#bugfixes-2">Bugfixes</a>
+- <a href="#v0-2-0">v0\.2\.0</a>
+    - <a href="#release-summary-3">Release Summary</a>
+    - <a href="#major-changes-1">Major Changes</a>
+    - <a href="#minor-changes-3">Minor Changes</a>
+    - <a href="#deprecated-features">Deprecated Features</a>
+- <a href="#v0-1-0">v0\.1\.0</a>
+    - <a href="#release-summary-4">Release Summary</a>
+    - <a href="#minor-changes-4">Minor Changes</a>
+    - <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a>
+    - <a href="#bugfixes-3">Bugfixes</a>
+- <a href="#v0-0-1">v0\.0\.1</a>
+    - <a href="#release-summary-5">Release Summary</a>
+
+<a id="v0-5-0"></a>
+## v0\.5\.0
+
+<a id="release-summary"></a>
+### Release Summary
+
+Feature and bugfix release\.
+
+<a id="minor-changes"></a>
+### Minor Changes
+
+* Allow to pass environment variables as Ansible variables for integration tests with the new <code>ansible\_vars\_from\_env\_vars</code> option for <code>sessions\.ansible\_test\_integration\_w\_default\_container</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/78](https\://github\.com/ansible\-community/antsibull\-nox/pull/78)\)\.
+
+<a id="bugfixes"></a>
+### Bugfixes
+
+* Fix action group test\. No errors were reported due to a bug in the test \([https\://github\.com/ansible\-community/antsibull\-nox/pull/80](https\://github\.com/ansible\-community/antsibull\-nox/pull/80)\)\.
+
+<a id="v0-4-0"></a>
+## v0\.4\.0
+
+<a id="release-summary-1"></a>
+### Release Summary
+
+Feature and bugfix release\.
+
+<a id="major-changes"></a>
+### Major Changes
+
+* Required collections can now be installed from different sources per depending on the ansible\-core version \([https\://github\.com/ansible\-community/antsibull\-nox/pull/76](https\://github\.com/ansible\-community/antsibull\-nox/pull/76)\)\.
+
+<a id="minor-changes-1"></a>
+### Minor Changes
+
+* Capture mypy and pylint errors to report paths of files relative to collection\'s root\, instead of relative to the virtual <code>ansible\_collections</code> directory \([https\://github\.com/ansible\-community/antsibull\-nox/pull/75](https\://github\.com/ansible\-community/antsibull\-nox/pull/75)\)\.
+* Make yamllint plugin check also check doc fragments \([https\://github\.com/ansible\-community/antsibull\-nox/pull/73](https\://github\.com/ansible\-community/antsibull\-nox/pull/73)\)\.
+* Positional arguments passed to nox are now forwarded to <code>ansible\-lint</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/74](https\://github\.com/ansible\-community/antsibull\-nox/pull/74)\)\.
+* The yamllint session now ignores <code>RETURN</code> documentation with values <code>\#</code> and \`\` \# \`\` \([https\://github\.com/ansible\-community/antsibull\-nox/pull/71](https\://github\.com/ansible\-community/antsibull\-nox/pull/71)\)\.
+* The yamllint test no longer shows all filenames in the command line \([https\://github\.com/ansible\-community/antsibull\-nox/pull/72](https\://github\.com/ansible\-community/antsibull\-nox/pull/72)\)\.
+
+<a id="bugfixes-1"></a>
+### Bugfixes
+
+* Adjust yamllint test to no longer use the user\'s global config\, but only the project\'s config \([https\://github\.com/ansible\-community/antsibull\-nox/pull/72](https\://github\.com/ansible\-community/antsibull\-nox/pull/72)\)\.
+
 <a id="v0-3-0"></a>
 ## v0\.3\.0
 
-<a id="release-summary"></a>
+<a id="release-summary-2"></a>
 ### Release Summary
 
 Feature release that is stabilizing the API\.
@@ -11,7 +85,7 @@ Feature release that is stabilizing the API\.
 All noxfiles and configs using this version should still work with antsibull\-nox 1\.0\.0\,
 unless a critical problem is found that cannot be solved in any other way\.
 
-<a id="minor-changes"></a>
+<a id="minor-changes-2"></a>
 ### Minor Changes
 
 * Add <code>antsibull\-nox init</code> command that creates a <code>noxfile\.py</code> and <code>antsibull\-nox\.tomll</code> to get started \([https\://github\.com/ansible\-community/antsibull\-nox/pull/58](https\://github\.com/ansible\-community/antsibull\-nox/pull/58)\)\.
@@ -30,7 +104,7 @@ unless a critical problem is found that cannot be solved in any other way\.
 
 * Removed all deprecated functions from <code>antsibull\_nox\.\*\*</code> that generate sessions\. The only functions left that are public API are <code>antsibull\_nox\.load\_antsibull\_nox\_toml\(\)</code>\, <code>antsibull\_nox\.add\_ansible\_test\_session\(\)</code>\, and <code>antsibull\_nox\.sessions\.prepare\_collections\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/54](https\://github\.com/ansible\-community/antsibull\-nox/pull/54)\)\.
 
-<a id="bugfixes"></a>
+<a id="bugfixes-2"></a>
 ### Bugfixes
 
 * Action groups extra test no longer fails if <code>action\_groups</code> does not exist in <code>meta/runtime\.yml</code>\. It can now be used to ensure that there is no action group present in <code>meta/runtime\.yml</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/60](https\://github\.com/ansible\-community/antsibull\-nox/pull/60)\)\.
@@ -41,17 +115,17 @@ unless a critical problem is found that cannot be solved in any other way\.
 <a id="v0-2-0"></a>
 ## v0\.2\.0
 
-<a id="release-summary-1"></a>
+<a id="release-summary-3"></a>
 ### Release Summary
 
 Major extension and overhaul with many breaking changes\. The next minor release is expected to bring more stabilization\.
 
-<a id="major-changes"></a>
+<a id="major-changes-1"></a>
 ### Major Changes
 
 * There is now a new function <code>antsibull\_nox\.load\_antsibull\_nox\_toml\(\)</code> which loads <code>antsibull\-nox\.toml</code> and creates configuration and sessions from it\. Calling other functionality from <code>antsibull\_nox</code> in <code>noxfile\.py</code> is only necessary for creating own specialized sessions\, or ansible\-test sessions that cannot be created with the <code>antsibull\_nox\.add\_all\_ansible\_test\_\*\_test\_sessions\*\(\)</code> type functions \([https\://github\.com/ansible\-community/antsibull\-nox/pull/50](https\://github\.com/ansible\-community/antsibull\-nox/pull/50)\, [https\://github\.com/ansible\-community/antsibull\-nox/issues/34](https\://github\.com/ansible\-community/antsibull\-nox/issues/34)\)\.
 
-<a id="minor-changes-1"></a>
+<a id="minor-changes-3"></a>
 ### Minor Changes
 
 * Add descriptions to generated sessions that are shown when running <code>nox \-\-list</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/31](https\://github\.com/ansible\-community/antsibull\-nox/pull/31)\)\.
@@ -77,12 +151,12 @@ Major extension and overhaul with many breaking changes\. The next minor release
 <a id="v0-1-0"></a>
 ## v0\.1\.0
 
-<a id="release-summary-2"></a>
+<a id="release-summary-4"></a>
 ### Release Summary
 
 Feature release\.
 
-<a id="minor-changes-2"></a>
+<a id="minor-changes-4"></a>
 ### Minor Changes
 
 * A <code>build\-import\-check</code> session that builds and tries to import the collection with Galaxy Importer can be added with <code>add\_build\_import\_check\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/issues/15](https\://github\.com/ansible\-community/antsibull\-nox/issues/15)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/17](https\://github\.com/ansible\-community/antsibull\-nox/pull/17)\)\.
@@ -101,7 +175,7 @@ Feature release\.
 
 * The nox workflow now by default runs all sessions\, unless restricted with the <code>sessions</code> parameter \([https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
 
-<a id="bugfixes-1"></a>
+<a id="bugfixes-3"></a>
 ### Bugfixes
 
 * Make sure that black in CI checks formatting instead of just reformatting \([https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
@@ -109,7 +183,7 @@ Feature release\.
 <a id="v0-0-1"></a>
 ## v0\.0\.1
 
-<a id="release-summary-3"></a>
+<a id="release-summary-5"></a>
 ### Release Summary
 
 Initial alpha release\.

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/CHANGELOG.rst

@@ -4,6 +4,51 @@ Antsibull Nox Helper Release Notes
 
 .. contents:: Topics
 
+v0.5.0
+======
+
+Release Summary
+---------------
+
+Feature and bugfix release.
+
+Minor Changes
+-------------
+
+- Allow to pass environment variables as Ansible variables for integration tests with the new ``ansible_vars_from_env_vars`` option for ``sessions.ansible_test_integration_w_default_container`` (https://github.com/ansible-community/antsibull-nox/pull/78).
+
+Bugfixes
+--------
+
+- Fix action group test. No errors were reported due to a bug in the test (https://github.com/ansible-community/antsibull-nox/pull/80).
+
+v0.4.0
+======
+
+Release Summary
+---------------
+
+Feature and bugfix release.
+
+Major Changes
+-------------
+
+- Required collections can now be installed from different sources per depending on the ansible-core version (https://github.com/ansible-community/antsibull-nox/pull/76).
+
+Minor Changes
+-------------
+
+- Capture mypy and pylint errors to report paths of files relative to collection's root, instead of relative to the virtual ``ansible_collections`` directory (https://github.com/ansible-community/antsibull-nox/pull/75).
+- Make yamllint plugin check also check doc fragments (https://github.com/ansible-community/antsibull-nox/pull/73).
+- Positional arguments passed to nox are now forwarded to ``ansible-lint`` (https://github.com/ansible-community/antsibull-nox/pull/74).
+- The yamllint session now ignores ``RETURN`` documentation with values ``#`` and `` # `` (https://github.com/ansible-community/antsibull-nox/pull/71).
+- The yamllint test no longer shows all filenames in the command line (https://github.com/ansible-community/antsibull-nox/pull/72).
+
+Bugfixes
+--------
+
+- Adjust yamllint test to no longer use the user's global config, but only the project's config (https://github.com/ansible-community/antsibull-nox/pull/72).
+
 v0.3.0
 ======
 

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: antsibull-nox
-Version: 0.3.0
+Version: 0.5.0
 Summary: Changelog tool for Ansible-core and Ansible collections
 Project-URL: Documentation, https://ansible.readthedocs.io/projects/antsibull-nox/
 Project-URL: Source code, https://github.com/ansible-community/antsibull-nox/

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/changelogs/changelog.yaml

@@ -176,3 +176,46 @@ releases:
       - 65-fix.yml
       - 67-galaxy-importer.yml
     release_date: '2025-04-21'
+  0.4.0:
+    changes:
+      bugfixes:
+        - Adjust yamllint test to no longer use the user's global config, but only
+          the project's config (https://github.com/ansible-community/antsibull-nox/pull/72).
+      major_changes:
+        - Required collections can now be installed from different sources per depending
+          on the ansible-core version (https://github.com/ansible-community/antsibull-nox/pull/76).
+      minor_changes:
+        - Capture mypy and pylint errors to report paths of files relative to collection's
+          root, instead of relative to the virtual ``ansible_collections`` directory
+          (https://github.com/ansible-community/antsibull-nox/pull/75).
+        - Make yamllint plugin check also check doc fragments (https://github.com/ansible-community/antsibull-nox/pull/73).
+        - Positional arguments passed to nox are now forwarded to ``ansible-lint``
+          (https://github.com/ansible-community/antsibull-nox/pull/74).
+        - 'The yamllint session now ignores ``RETURN`` documentation with values ``#``
+          and `` # `` (https://github.com/ansible-community/antsibull-nox/pull/71).'
+        - The yamllint test no longer shows all filenames in the command line (https://github.com/ansible-community/antsibull-nox/pull/72).
+      release_summary: Feature and bugfix release.
+    fragments:
+      - 0.4.0.yml
+      - 71-yamllint-return.yml
+      - 72-yamllint-config.yml
+      - 73-yamllint-doc-fragments.yml
+      - 74-ansible-lint-args.yml
+      - 75-mypy-pylint-errors.yml
+      - 76-collection-per-ansible-core-version.yml
+    release_date: '2025-05-06'
+  0.5.0:
+    changes:
+      bugfixes:
+        - Fix action group test. No errors were reported due to a bug in the test
+          (https://github.com/ansible-community/antsibull-nox/pull/80).
+      minor_changes:
+        - Allow to pass environment variables as Ansible variables for integration
+          tests with the new ``ansible_vars_from_env_vars`` option for ``sessions.ansible_test_integration_w_default_container``
+          (https://github.com/ansible-community/antsibull-nox/pull/78).
+      release_summary: Feature and bugfix release.
+    fragments:
+      - 0.5.0.yml
+      - 78-env-vars-integration-tests.yml
+      - 80-action-groups.yml
+    release_date: '2025-05-18'

antsibull_nox-0.3.0/CHANGELOG.md → antsibull_nox-0.5.0/docs/changelog.md

@@ -1,29 +1,54 @@
 # Antsibull Nox Helper Release Notes
 
-**Topics**
-
-- <a href="#v0-3-0">v0\.3\.0</a>
-    - <a href="#release-summary">Release Summary</a>
-    - <a href="#minor-changes">Minor Changes</a>
-    - <a href="#removed-features-previously-deprecated">Removed Features \(previously deprecated\)</a>
-    - <a href="#bugfixes">Bugfixes</a>
-- <a href="#v0-2-0">v0\.2\.0</a>
-    - <a href="#release-summary-1">Release Summary</a>
-    - <a href="#major-changes">Major Changes</a>
-    - <a href="#minor-changes-1">Minor Changes</a>
-    - <a href="#deprecated-features">Deprecated Features</a>
-- <a href="#v0-1-0">v0\.1\.0</a>
-    - <a href="#release-summary-2">Release Summary</a>
-    - <a href="#minor-changes-2">Minor Changes</a>
-    - <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a>
-    - <a href="#bugfixes-1">Bugfixes</a>
-- <a href="#v0-0-1">v0\.0\.1</a>
-    - <a href="#release-summary-3">Release Summary</a>
+<a id="v0-5-0"></a>
+## v0\.5\.0
+
+<a id="release-summary"></a>
+### Release Summary
+
+Feature and bugfix release\.
+
+<a id="minor-changes"></a>
+### Minor Changes
+
+* Allow to pass environment variables as Ansible variables for integration tests with the new <code>ansible\_vars\_from\_env\_vars</code> option for <code>sessions\.ansible\_test\_integration\_w\_default\_container</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/78](https\://github\.com/ansible\-community/antsibull\-nox/pull/78)\)\.
+
+<a id="bugfixes"></a>
+### Bugfixes
+
+* Fix action group test\. No errors were reported due to a bug in the test \([https\://github\.com/ansible\-community/antsibull\-nox/pull/80](https\://github\.com/ansible\-community/antsibull\-nox/pull/80)\)\.
+
+<a id="v0-4-0"></a>
+## v0\.4\.0
+
+<a id="release-summary-1"></a>
+### Release Summary
+
+Feature and bugfix release\.
+
+<a id="major-changes"></a>
+### Major Changes
+
+* Required collections can now be installed from different sources per depending on the ansible\-core version \([https\://github\.com/ansible\-community/antsibull\-nox/pull/76](https\://github\.com/ansible\-community/antsibull\-nox/pull/76)\)\.
+
+<a id="minor-changes-1"></a>
+### Minor Changes
+
+* Capture mypy and pylint errors to report paths of files relative to collection\'s root\, instead of relative to the virtual <code>ansible\_collections</code> directory \([https\://github\.com/ansible\-community/antsibull\-nox/pull/75](https\://github\.com/ansible\-community/antsibull\-nox/pull/75)\)\.
+* Make yamllint plugin check also check doc fragments \([https\://github\.com/ansible\-community/antsibull\-nox/pull/73](https\://github\.com/ansible\-community/antsibull\-nox/pull/73)\)\.
+* Positional arguments passed to nox are now forwarded to <code>ansible\-lint</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/74](https\://github\.com/ansible\-community/antsibull\-nox/pull/74)\)\.
+* The yamllint session now ignores <code>RETURN</code> documentation with values <code>\#</code> and \`\` \# \`\` \([https\://github\.com/ansible\-community/antsibull\-nox/pull/71](https\://github\.com/ansible\-community/antsibull\-nox/pull/71)\)\.
+* The yamllint test no longer shows all filenames in the command line \([https\://github\.com/ansible\-community/antsibull\-nox/pull/72](https\://github\.com/ansible\-community/antsibull\-nox/pull/72)\)\.
+
+<a id="bugfixes-1"></a>
+### Bugfixes
+
+* Adjust yamllint test to no longer use the user\'s global config\, but only the project\'s config \([https\://github\.com/ansible\-community/antsibull\-nox/pull/72](https\://github\.com/ansible\-community/antsibull\-nox/pull/72)\)\.
 
 <a id="v0-3-0"></a>
 ## v0\.3\.0
 
-<a id="release-summary"></a>
+<a id="release-summary-2"></a>
 ### Release Summary
 
 Feature release that is stabilizing the API\.
@@ -31,7 +56,7 @@ Feature release that is stabilizing the API\.
 All noxfiles and configs using this version should still work with antsibull\-nox 1\.0\.0\,
 unless a critical problem is found that cannot be solved in any other way\.
 
-<a id="minor-changes"></a>
+<a id="minor-changes-2"></a>
 ### Minor Changes
 
 * Add <code>antsibull\-nox init</code> command that creates a <code>noxfile\.py</code> and <code>antsibull\-nox\.tomll</code> to get started \([https\://github\.com/ansible\-community/antsibull\-nox/pull/58](https\://github\.com/ansible\-community/antsibull\-nox/pull/58)\)\.
@@ -50,7 +75,7 @@ unless a critical problem is found that cannot be solved in any other way\.
 
 * Removed all deprecated functions from <code>antsibull\_nox\.\*\*</code> that generate sessions\. The only functions left that are public API are <code>antsibull\_nox\.load\_antsibull\_nox\_toml\(\)</code>\, <code>antsibull\_nox\.add\_ansible\_test\_session\(\)</code>\, and <code>antsibull\_nox\.sessions\.prepare\_collections\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/54](https\://github\.com/ansible\-community/antsibull\-nox/pull/54)\)\.
 
-<a id="bugfixes"></a>
+<a id="bugfixes-2"></a>
 ### Bugfixes
 
 * Action groups extra test no longer fails if <code>action\_groups</code> does not exist in <code>meta/runtime\.yml</code>\. It can now be used to ensure that there is no action group present in <code>meta/runtime\.yml</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/60](https\://github\.com/ansible\-community/antsibull\-nox/pull/60)\)\.
@@ -61,17 +86,17 @@ unless a critical problem is found that cannot be solved in any other way\.
 <a id="v0-2-0"></a>
 ## v0\.2\.0
 
-<a id="release-summary-1"></a>
+<a id="release-summary-3"></a>
 ### Release Summary
 
 Major extension and overhaul with many breaking changes\. The next minor release is expected to bring more stabilization\.
 
-<a id="major-changes"></a>
+<a id="major-changes-1"></a>
 ### Major Changes
 
 * There is now a new function <code>antsibull\_nox\.load\_antsibull\_nox\_toml\(\)</code> which loads <code>antsibull\-nox\.toml</code> and creates configuration and sessions from it\. Calling other functionality from <code>antsibull\_nox</code> in <code>noxfile\.py</code> is only necessary for creating own specialized sessions\, or ansible\-test sessions that cannot be created with the <code>antsibull\_nox\.add\_all\_ansible\_test\_\*\_test\_sessions\*\(\)</code> type functions \([https\://github\.com/ansible\-community/antsibull\-nox/pull/50](https\://github\.com/ansible\-community/antsibull\-nox/pull/50)\, [https\://github\.com/ansible\-community/antsibull\-nox/issues/34](https\://github\.com/ansible\-community/antsibull\-nox/issues/34)\)\.
 
-<a id="minor-changes-1"></a>
+<a id="minor-changes-3"></a>
 ### Minor Changes
 
 * Add descriptions to generated sessions that are shown when running <code>nox \-\-list</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/31](https\://github\.com/ansible\-community/antsibull\-nox/pull/31)\)\.
@@ -97,12 +122,12 @@ Major extension and overhaul with many breaking changes\. The next minor release
 <a id="v0-1-0"></a>
 ## v0\.1\.0
 
-<a id="release-summary-2"></a>
+<a id="release-summary-4"></a>
 ### Release Summary
 
 Feature release\.
 
-<a id="minor-changes-2"></a>
+<a id="minor-changes-4"></a>
 ### Minor Changes
 
 * A <code>build\-import\-check</code> session that builds and tries to import the collection with Galaxy Importer can be added with <code>add\_build\_import\_check\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/issues/15](https\://github\.com/ansible\-community/antsibull\-nox/issues/15)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/17](https\://github\.com/ansible\-community/antsibull\-nox/pull/17)\)\.
@@ -121,7 +146,7 @@ Feature release\.
 
 * The nox workflow now by default runs all sessions\, unless restricted with the <code>sessions</code> parameter \([https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
 
-<a id="bugfixes-1"></a>
+<a id="bugfixes-3"></a>
 ### Bugfixes
 
 * Make sure that black in CI checks formatting instead of just reformatting \([https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
@@ -129,7 +154,7 @@ Feature release\.
 <a id="v0-0-1"></a>
 ## v0\.0\.1
 
-<a id="release-summary-3"></a>
+<a id="release-summary-5"></a>
 ### Release Summary
 
 Initial alpha release\.

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/docs/config-file.md

@@ -19,10 +19,22 @@ A basic `antsibull-nox.toml` looks as follows:
 
 [collection_sources]
 # This section tells antsibull-nox how to install collections.
-# We want to install community.internal_test_tools and community.general
+# We want to install community.internal_test_tools, community.general, and community.crypto
 # from Git and not from Galaxy.
 "community.internal_test_tools" = "git+https://github.com/ansible-collections/community.internal_test_tools.git,main"
 "community.general" = "git+https://github.com/ansible-collections/community.general.git,main"
+"community.crypto" = "git+https://github.com/ansible-collections/community.crypto.git,main"
+
+[collection_sources_per_ansible.'2.16']
+# This section tells antsibull-nox how to install collections for ansible-core 2.16.
+# (Note that we have to quote the ansible-core version in the section name!)
+#
+# If a collection is not mentioned here, the above generic section will be used.
+# (And if it cannot be found there, antsibull-nox will simply get it from ansible-galaxy's default source.)
+#
+# We want to install community.crypto from its stable-2 branch from Git
+# (the main branch only works with ansible-core 2.17+).
+"community.crypto" = "git+https://github.com/ansible-collections/community.crypto.git,stable-2"
 
 [sessions]
 # The sub-sections of 'sessions' configure sessions to add.
@@ -88,6 +100,42 @@ The section `[collection_sources]` allows to configure this:
 The syntax used is explained in [the Ansible documentation on installation of collections from Git repositories](https://docs.ansible.com/ansible-core/devel/collections_guide/collections_installing.html#installing-a-collection-from-a-git-repository-at-the-command-line)
 and [the Ansible documentation on installation of older versions of a collection](https://docs.ansible.com/ansible-core/devel/collections_guide/collections_installing.html#installing-an-older-version-of-a-collection).
 
+### Specific collection sources per ansible-core version
+
+Sometimes it is necessary to use different sources for different ansible-core versions.
+
+For example, your collection might support ansible-core 2.16+.
+For testing, you need a collection that you want to install from Git.
+Unfortunately, the `main` branch only works with ansible-core 2.17+,
+so you need to use another branch for ansible-core 2.16.
+
+In the following example, community.crypto is such a collection.
+Its `main` branch needs ansible-core 2.17+,
+but its `stable-2` branch also supports ansible-core 2.16 and before.
+
+You can tell antsibull-nox to use the `stable-2` branch with ansible-core 2.16
+by adding a `[collection_sources_per_ansible.'2.16']` section (note the quotes!).
+```toml
+[collection_sources]
+# This section tells antsibull-nox how to install collections.
+# We want to install community.internal_test_tools, community.general, and community.crypto
+# from Git and not from Galaxy.
+"community.internal_test_tools" = "git+https://github.com/ansible-collections/community.internal_test_tools.git,main"
+"community.general" = "git+https://github.com/ansible-collections/community.general.git,main"
+"community.crypto" = "git+https://github.com/ansible-collections/community.crypto.git,main"
+
+[collection_sources_per_ansible.'2.16']
+# This section tells antsibull-nox how to install collections for ansible-core 2.16.
+# (Note that we have to quote the ansible-core version in the section name!)
+#
+# If a collection is not mentioned here, the above generic section will be used.
+# (And if it cannot be found there, antsibull-nox will simply get it from ansible-galaxy's default source.)
+#
+# We want to install community.crypto from its stable-2 branch from Git
+# (the main branch only works with ansible-core 2.17+).
+"community.crypto" = "git+https://github.com/ansible-collections/community.crypto.git,stable-2"
+```
+
 ## Basic linting sessions
 
 The basic linting session, `lint`, comes with three sessions it depends on:
@@ -384,9 +432,9 @@ It accepts the following options:
 * `run_license_check: bool` (default `true`):
   Whether a custom check script should be run that validates the following conditions:
 
-  1. All Python code in `plugins/` except module utils, modules, and docs fragments must be `GPL-3.0-or-later` licensed.
+    1. All Python code in `plugins/` except module utils, modules, and docs fragments must be `GPL-3.0-or-later` licensed.
 
-  2. Every non-empty file has an allowed license. (This is similar to what `reuse lint` checks.)
+    2. Every non-empty file has an allowed license. (This is similar to what `reuse lint` checks.)
 
 * `license_check_extra_ignore_paths: list[str]` (default `[]`):
   Allows to specify more paths that are ignored.
@@ -826,6 +874,11 @@ It is possible to restrict the Python versions used to run the tests per ansible
   usually all Python versions supported on the remote side are used.
   If this is set to `true`, only all Python versions uspported on the controller side are used.
 
+* `ansible_vars_from_env_vars: dict[str, str]` (default `{}`):
+  If given, will create an integration test config file which for every `key=value` pair,
+  contains an Ansible variable `key` with the value of the environment variable `value`.
+  If the environment variable is not defined, the Ansible variable will not be defined either.
+
 #### Example code
 
 This example is from `community.dns`.
@@ -842,6 +895,28 @@ include_devel = true
 "2.18" = ["3.8", "3.13"]
 ```
 
+The following example is from `felixfontein.acme`.
+
+```toml
+[sessions.ansible_test_integration_w_default_container]
+include_devel = true
+
+[sessions.ansible_test_integration_w_default_container.ansible_vars_from_env_vars]
+"github_token" = "GITHUB_TOKEN"
+```
+
+It passes the `GITHUB_TOKEN` environment variable on as `github_token`.
+This allows to download files from other GitHub repositories while avoiding strict rate limiting:
+
+```yaml
+- name: Download SOPS test GPG key
+  ansible.builtin.get_url:
+    headers:
+      Authorization: "{{ ('Bearer ' ~ github_token) if github_token is defined and github_token else '' }}"
+    url: https://raw.githubusercontent.com/getsops/sops/master/pgp/sops_functional_tests_key.asc
+    dest: "{{ _tempfile.path }}"
+```
+
 ### Run ansible-lint
 
 The [ansible-lint](https://ansible.readthedocs.io/projects/lint/) session is added with the `[sessions.ansible_lint]` section in `antsibull-nox.toml`.
@@ -861,6 +936,14 @@ The added session is called `ansible-lint`. The section can contain the followin
   Whether the `--strict` parameter should be passed to ansible-lint.
   This treats warnings as errors.
 
+It is a good idea to add
+```yaml
+exclude_paths:
+  - .nox/
+```
+to your ansible-lint configuration file.
+Otherwise ansible-lint might try to lint collection dependencies that antsibull-nox installed.
+
 #### Example code
 
 This example is from `felixfontein.acme`.

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/pyproject.toml

@@ -113,6 +113,7 @@ module = [
     "pytest",
     "semantic_version",
     "yamllint",
+    "yamllint.cli",
     "yamllint.config",
     "yamllint.linter",
 ]

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/src/antsibull_nox/__init__.py

@@ -17,7 +17,7 @@ from .config import (
 from .interpret_config import interpret_config
 from .sessions.ansible_test import add_ansible_test_session
 
-__version__ = "0.3.0"
+__version__ = "0.5.0"
 
 
 def load_antsibull_nox_toml() -> None:

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/src/antsibull_nox/ansible.py

@@ -253,8 +253,23 @@ def get_supported_core_versions(
     return result
 
 
+def parse_ansible_core_version(
+    version: str | AnsibleCoreVersion,
+) -> AnsibleCoreVersion:
+    """
+    Coerce a string or a AnsibleCoreVersion to a AnsibleCoreVersion.
+    """
+    if version in ("devel", "milestone"):
+        # For some reason mypy doesn't notice that
+        return t.cast(AnsibleCoreVersion, version)
+    if isinstance(version, Version):
+        return version
+    return Version.parse(version)
+
+
 __all__ = [
     "AnsibleCoreInfo",
     "get_ansible_core_info",
     "get_ansible_core_package_name",
+    "parse_ansible_core_version",
 ]

{antsibull_nox-0.3.0 → antsibull_nox-0.5.0}/src/antsibull_nox/collection/data.py

@@ -10,6 +10,8 @@ Data types for collections.
 
 from __future__ import annotations
 
+import base64
+import hashlib
 from dataclasses import dataclass
 from pathlib import Path
 
@@ -98,6 +100,16 @@ class CollectionSource:
             )
         return source
 
+    def identifier(self) -> str:
+        """
+        Compute a source identifier.
+        """
+        hasher = hashlib.sha256()
+        hasher.update(self.name.encode("utf-8"))
+        hasher.update(b"::")
+        hasher.update(self.source.encode("utf-8"))
+        return base64.b32encode(hasher.digest())[:16].decode("ascii")
+
 
 __all__ = [
     "CollectionData",