antsibull-nox 0.6.0__tar.gz → 0.7.0__tar.gz

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/CHANGELOG.md

@@ -2,46 +2,63 @@
 
 **Topics**
 
-- <a href="#v0-6-0">v0\.6\.0</a>
+- <a href="#v0-7-0">v0\.7\.0</a>
     - <a href="#release-summary">Release Summary</a>
     - <a href="#minor-changes">Minor Changes</a>
-    - <a href="#bugfixes">Bugfixes</a>
-- <a href="#v0-5-0">v0\.5\.0</a>
+- <a href="#v0-6-0">v0\.6\.0</a>
     - <a href="#release-summary-1">Release Summary</a>
     - <a href="#minor-changes-1">Minor Changes</a>
+    - <a href="#bugfixes">Bugfixes</a>
+- <a href="#v0-5-0">v0\.5\.0</a>
+    - <a href="#release-summary-2">Release Summary</a>
+    - <a href="#minor-changes-2">Minor Changes</a>
     - <a href="#bugfixes-1">Bugfixes</a>
 - <a href="#v0-4-0">v0\.4\.0</a>
-    - <a href="#release-summary-2">Release Summary</a>
+    - <a href="#release-summary-3">Release Summary</a>
     - <a href="#major-changes">Major Changes</a>
-    - <a href="#minor-changes-2">Minor Changes</a>
+    - <a href="#minor-changes-3">Minor Changes</a>
     - <a href="#bugfixes-2">Bugfixes</a>
 - <a href="#v0-3-0">v0\.3\.0</a>
-    - <a href="#release-summary-3">Release Summary</a>
-    - <a href="#minor-changes-3">Minor Changes</a>
+    - <a href="#release-summary-4">Release Summary</a>
+    - <a href="#minor-changes-4">Minor Changes</a>
     - <a href="#removed-features-previously-deprecated">Removed Features \(previously deprecated\)</a>
     - <a href="#bugfixes-3">Bugfixes</a>
 - <a href="#v0-2-0">v0\.2\.0</a>
-    - <a href="#release-summary-4">Release Summary</a>
+    - <a href="#release-summary-5">Release Summary</a>
     - <a href="#major-changes-1">Major Changes</a>
-    - <a href="#minor-changes-4">Minor Changes</a>
+    - <a href="#minor-changes-5">Minor Changes</a>
     - <a href="#deprecated-features">Deprecated Features</a>
 - <a href="#v0-1-0">v0\.1\.0</a>
-    - <a href="#release-summary-5">Release Summary</a>
-    - <a href="#minor-changes-5">Minor Changes</a>
+    - <a href="#release-summary-6">Release Summary</a>
+    - <a href="#minor-changes-6">Minor Changes</a>
     - <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a>
     - <a href="#bugfixes-4">Bugfixes</a>
 - <a href="#v0-0-1">v0\.0\.1</a>
-    - <a href="#release-summary-6">Release Summary</a>
+    - <a href="#release-summary-7">Release Summary</a>
+
+<a id="v0-7-0"></a>
+## v0\.7\.0
+
+<a id="release-summary"></a>
+### Release Summary
+
+Feature release\.
+
+<a id="minor-changes"></a>
+### Minor Changes
+
+* Antsibull\-nox\'s ansible\-core <code>devel</code> and <code>milestone</code> branch versions have been updated to 2\.20\. This means that <code>stable\-2\.19</code> will now be added to CI matrices if <code>max\_version</code> has not been explicitly specified \([https\://github\.com/ansible\-community/antsibull\-nox/pull/91](https\://github\.com/ansible\-community/antsibull\-nox/pull/91)\)\.
+* The <code>docs\-check</code> session now also passes the new <code>\-\-check\-extra\-docs\-refs</code> parameter to <code>antsibull\-docs lint\-collection\-docs</code> for antsibull\-docs \>\= 2\.18\.0 \([https\://github\.com/ansible\-community/antsibull\-nox/pull/90](https\://github\.com/ansible\-community/antsibull\-nox/pull/90)\)\.
 
 <a id="v0-6-0"></a>
 ## v0\.6\.0
 
-<a id="release-summary"></a>
+<a id="release-summary-1"></a>
 ### Release Summary
 
 Bugfix and feature release\.
 
-<a id="minor-changes"></a>
+<a id="minor-changes-1"></a>
 ### Minor Changes
 
 * Add new extra check <code>no\-trailing\-whitespace</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/85](https\://github\.com/ansible\-community/antsibull\-nox/pull/85)\)\.
@@ -62,12 +79,12 @@ Bugfix and feature release\.
 <a id="v0-5-0"></a>
 ## v0\.5\.0
 
-<a id="release-summary-1"></a>
+<a id="release-summary-2"></a>
 ### Release Summary
 
 Feature and bugfix release\.
 
-<a id="minor-changes-1"></a>
+<a id="minor-changes-2"></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)\)\.
@@ -80,7 +97,7 @@ Feature and bugfix release\.
 <a id="v0-4-0"></a>
 ## v0\.4\.0
 
-<a id="release-summary-2"></a>
+<a id="release-summary-3"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -90,7 +107,7 @@ Feature and bugfix release\.
 
 * 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-2"></a>
+<a id="minor-changes-3"></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)\)\.
@@ -107,7 +124,7 @@ Feature and bugfix release\.
 <a id="v0-3-0"></a>
 ## v0\.3\.0
 
-<a id="release-summary-3"></a>
+<a id="release-summary-4"></a>
 ### Release Summary
 
 Feature release that is stabilizing the API\.
@@ -115,7 +132,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-3"></a>
+<a id="minor-changes-4"></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)\)\.
@@ -145,7 +162,7 @@ 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-4"></a>
+<a id="release-summary-5"></a>
 ### Release Summary
 
 Major extension and overhaul with many breaking changes\. The next minor release is expected to bring more stabilization\.
@@ -155,7 +172,7 @@ Major extension and overhaul with many breaking changes\. The next minor release
 
 * 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-4"></a>
+<a id="minor-changes-5"></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)\)\.
@@ -181,12 +198,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-5"></a>
+<a id="release-summary-6"></a>
 ### Release Summary
 
 Feature release\.
 
-<a id="minor-changes-5"></a>
+<a id="minor-changes-6"></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)\)\.
@@ -213,7 +230,7 @@ Feature release\.
 <a id="v0-0-1"></a>
 ## v0\.0\.1
 
-<a id="release-summary-6"></a>
+<a id="release-summary-7"></a>
 ### Release Summary
 
 Initial alpha release\.

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/CHANGELOG.rst

@@ -4,6 +4,20 @@ Antsibull Nox Helper Release Notes
 
 .. contents:: Topics
 
+v0.7.0
+======
+
+Release Summary
+---------------
+
+Feature release.
+
+Minor Changes
+-------------
+
+- Antsibull-nox's ansible-core ``devel`` and ``milestone`` branch versions have been updated to 2.20. This means that ``stable-2.19`` will now be added to CI matrices if ``max_version`` has not been explicitly specified (https://github.com/ansible-community/antsibull-nox/pull/91).
+- The ``docs-check`` session now also passes the new ``--check-extra-docs-refs`` parameter to ``antsibull-docs lint-collection-docs`` for antsibull-docs >= 2.18.0 (https://github.com/ansible-community/antsibull-nox/pull/90).
+
 v0.6.0
 ======
 

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: antsibull-nox
-Version: 0.6.0
+Version: 0.7.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.6.0 → antsibull_nox-0.7.0}/changelogs/changelog.yaml

@@ -253,3 +253,18 @@ releases:
       - 87-yamllint-rst.yml
       - 88-docs-check.yml
     release_date: '2025-06-18'
+  0.7.0:
+    changes:
+      minor_changes:
+        - Antsibull-nox's ansible-core ``devel`` and ``milestone`` branch versions
+          have been updated to 2.20. This means that ``stable-2.19`` will now be added
+          to CI matrices if ``max_version`` has not been explicitly specified (https://github.com/ansible-community/antsibull-nox/pull/91).
+        - The ``docs-check`` session now also passes the new ``--check-extra-docs-refs``
+          parameter to ``antsibull-docs lint-collection-docs`` for antsibull-docs
+          >= 2.18.0 (https://github.com/ansible-community/antsibull-nox/pull/90).
+      release_summary: Feature release.
+    fragments:
+      - 0.7.0.yml
+      - 90-antsibull-docs-lint.yml
+      - 91-ansible-core-2.19.yml
+    release_date: '2025-07-01'

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/docs/changelog.md

@@ -1,14 +1,28 @@
 # Antsibull Nox Helper Release Notes
 
+<a id="v0-7-0"></a>
+## v0\.7\.0
+
+<a id="release-summary"></a>
+### Release Summary
+
+Feature release\.
+
+<a id="minor-changes"></a>
+### Minor Changes
+
+* Antsibull\-nox\'s ansible\-core <code>devel</code> and <code>milestone</code> branch versions have been updated to 2\.20\. This means that <code>stable\-2\.19</code> will now be added to CI matrices if <code>max\_version</code> has not been explicitly specified \([https\://github\.com/ansible\-community/antsibull\-nox/pull/91](https\://github\.com/ansible\-community/antsibull\-nox/pull/91)\)\.
+* The <code>docs\-check</code> session now also passes the new <code>\-\-check\-extra\-docs\-refs</code> parameter to <code>antsibull\-docs lint\-collection\-docs</code> for antsibull\-docs \>\= 2\.18\.0 \([https\://github\.com/ansible\-community/antsibull\-nox/pull/90](https\://github\.com/ansible\-community/antsibull\-nox/pull/90)\)\.
+
 <a id="v0-6-0"></a>
 ## v0\.6\.0
 
-<a id="release-summary"></a>
+<a id="release-summary-1"></a>
 ### Release Summary
 
 Bugfix and feature release\.
 
-<a id="minor-changes"></a>
+<a id="minor-changes-1"></a>
 ### Minor Changes
 
 * Add new extra check <code>no\-trailing\-whitespace</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/85](https\://github\.com/ansible\-community/antsibull\-nox/pull/85)\)\.
@@ -29,12 +43,12 @@ Bugfix and feature release\.
 <a id="v0-5-0"></a>
 ## v0\.5\.0
 
-<a id="release-summary-1"></a>
+<a id="release-summary-2"></a>
 ### Release Summary
 
 Feature and bugfix release\.
 
-<a id="minor-changes-1"></a>
+<a id="minor-changes-2"></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)\)\.
@@ -47,7 +61,7 @@ Feature and bugfix release\.
 <a id="v0-4-0"></a>
 ## v0\.4\.0
 
-<a id="release-summary-2"></a>
+<a id="release-summary-3"></a>
 ### Release Summary
 
 Feature and bugfix release\.
@@ -57,7 +71,7 @@ Feature and bugfix release\.
 
 * 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-2"></a>
+<a id="minor-changes-3"></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)\)\.
@@ -74,7 +88,7 @@ Feature and bugfix release\.
 <a id="v0-3-0"></a>
 ## v0\.3\.0
 
-<a id="release-summary-3"></a>
+<a id="release-summary-4"></a>
 ### Release Summary
 
 Feature release that is stabilizing the API\.
@@ -82,7 +96,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-3"></a>
+<a id="minor-changes-4"></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)\)\.
@@ -112,7 +126,7 @@ 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-4"></a>
+<a id="release-summary-5"></a>
 ### Release Summary
 
 Major extension and overhaul with many breaking changes\. The next minor release is expected to bring more stabilization\.
@@ -122,7 +136,7 @@ Major extension and overhaul with many breaking changes\. The next minor release
 
 * 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-4"></a>
+<a id="minor-changes-5"></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)\)\.
@@ -148,12 +162,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-5"></a>
+<a id="release-summary-6"></a>
 ### Release Summary
 
 Feature release\.
 
-<a id="minor-changes-5"></a>
+<a id="minor-changes-6"></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)\)\.
@@ -180,7 +194,7 @@ Feature release\.
 <a id="v0-0-1"></a>
 ## v0\.0\.1
 
-<a id="release-summary-6"></a>
+<a id="release-summary-7"></a>
 ### Release Summary
 
 Initial alpha release\.

{antsibull_nox-0.6.0 → antsibull_nox-0.7.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.6.0"
+__version__ = "0.7.0"
 
 
 def load_antsibull_nox_toml() -> None:

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/src/antsibull_nox/ansible.py

@@ -87,13 +87,13 @@ _SUPPORTED_CORE_VERSIONS: dict[Version, AnsibleCoreInfo] = {
             ["3.11", "3.12", "3.13"],
             ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"],
         ],
+        "2.20": [
+            ["3.11", "3.12", "3.13"],
+            ["3.9", "3.10", "3.11", "3.12", "3.13"],
+        ],
         # The following might need updates. Look for the "``ansible-core`` support matrix" table in:
         # https://github.com/ansible/ansible-documentation/blob/devel/docs/docsite/rst/reference_appendices/release_and_maintenance.rst?plain=1
         # It contains commented-out entries for future ansible-core versions.
-        "2.20": [
-            ["3.12", "3.13", "3.14"],
-            ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"],
-        ],
         "2.21": [
             ["3.12", "3.13", "3.14"],
             ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"],
@@ -118,8 +118,8 @@ _SUPPORTED_CORE_VERSIONS: dict[Version, AnsibleCoreInfo] = {
 }
 
 _MIN_SUPPORTED_VERSION = Version.parse("2.9")
-_CURRENT_DEVEL_VERSION = Version.parse("2.19")
-_CURRENT_MILESTONE_VERSION = Version.parse("2.19")
+_CURRENT_DEVEL_VERSION = Version.parse("2.20")
+_CURRENT_MILESTONE_VERSION = Version.parse("2.20")
 
 
 def get_ansible_core_info(

antsibull_nox-0.7.0/src/antsibull_nox/data/get-package-versions.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python
+
+# Copyright (c) 2025, Felix Fontein <felix@fontein.de>
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt
+# or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+"""Retrieve the version of one or more packages."""
+
+from __future__ import annotations
+
+import json
+import sys
+from importlib.metadata import PackageNotFoundError, version
+
+from antsibull_nox_data_util import get_list_of_strings, setup  # type: ignore
+
+
+def main() -> int:
+    """Main entry point."""
+    paths, extra_data = setup()
+
+    packages = get_list_of_strings(extra_data, "packages", default=[])
+
+    result: dict[str, str | None] = {}
+    for package in packages:
+        try:
+            result[package] = version(package)
+        except PackageNotFoundError:
+            result[package] = None
+    print(json.dumps(result))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/src/antsibull_nox/sessions/docs_check.py

@@ -23,7 +23,9 @@ from .collections import (
     prepare_collections,
 )
 from .utils import (
+    get_package_version,
     install,
+    is_new_enough,
     run_bare_script,
 )
 
@@ -93,6 +95,9 @@ def add_docs_check(
     def execute_antsibull_docs(
         session: nox.Session, prepared_collections: CollectionSetup
     ) -> None:
+        antsibull_docs_version = get_package_version(session, "antsibull-docs")
+        if antsibull_docs_version is not None:
+            session.log(f"Detected antsibull-docs version {antsibull_docs_version}")
         with session.chdir(prepared_collections.current_path):
             collections_path = f"{prepared_collections.current_place}"
             command = [
@@ -104,6 +109,8 @@ def add_docs_check(
             ]
             if validate_collection_refs:
                 command.extend(["--validate-collection-refs", validate_collection_refs])
+            if is_new_enough(antsibull_docs_version, min_version="2.18.0"):
+                command.append("--check-extra-docs-refs")
             session.run(*command, env={"ANSIBLE_COLLECTIONS_PATH": collections_path})
 
     def docs_check(session: nox.Session) -> None:

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/src/antsibull_nox/sessions/utils.py

@@ -10,6 +10,7 @@ Utils for creating nox sessions.
 
 from __future__ import annotations
 
+import json
 import logging
 import os
 import sys
@@ -19,6 +20,8 @@ from pathlib import Path
 
 import nox
 from nox.logger import OUTPUT as nox_OUTPUT
+from packaging.version import InvalidVersion
+from packaging.version import parse as parse_version
 
 from ..data_util import prepare_data_script
 from ..paths import (
@@ -151,6 +154,86 @@ def run_bare_script(
     )
 
 
+def get_package_versions(
+    session: nox.Session,
+    /,
+    packages: list[str] | str,
+    *,
+    use_session_python: bool = True,
+) -> None | dict[str, str | None]:
+    """
+    Retrieve the versions of one or more Python packages.
+    """
+    name = "get-package-versions"
+    if isinstance(packages, str):
+        packages = [packages]
+    if not packages:
+        return {}
+    data = prepare_data_script(
+        session,
+        base_name=name,
+        paths=[],
+        extra_data={
+            "packages": packages,
+        },
+    )
+    python = sys.executable
+    env = {}
+    if use_session_python:
+        python = "python"
+        env["PYTHONPATH"] = str(find_data_directory())
+    result = session.run(
+        python,
+        find_data_directory() / f"{name}.py",
+        "--data",
+        data,
+        external=True,
+        silent=True,
+        env=env,
+    )
+    if result is None:
+        return None
+    return json.loads(result)
+
+
+def get_package_version(
+    session: nox.Session,
+    /,
+    package: str,
+    *,
+    use_session_python: bool = True,
+) -> str | None:
+    """
+    Retrieve a Python package's version.
+    """
+    result = get_package_versions(
+        session, package, use_session_python=use_session_python
+    )
+    return None if result is None else result.get(package)
+
+
+def is_new_enough(actual_version: str | None, *, min_version: str) -> bool:
+    """
+    Given a program version, compares it to the min_version.
+    If the program version is not given, it is assumed to be "new enough".
+    """
+    if actual_version is None:
+        return True
+    try:
+        act_v = parse_version(actual_version)
+    except InvalidVersion as exc:
+        raise ValueError(
+            f"Cannot parse actual version {actual_version!r}: {exc}"
+        ) from exc
+    try:
+        min_v = parse_version(min_version)
+    except InvalidVersion as exc:
+        raise ValueError(
+            f"Cannot parse minimum version {min_version!r}: {exc}"
+        ) from exc
+    return act_v >= min_v
+
+
 def compose_description(
     *,
     prefix: str | dict[t.Literal["one", "other"], str] | None = None,
@@ -197,8 +280,11 @@ def compose_description(
 __all__ = [
     "ci_group",
     "compose_description",
+    "get_package_version",
+    "get_package_versions",
     "get_registered_sessions",
     "install",
+    "is_new_enough",
     "nox_has_verbosity",
     "register",
     "run_bare_script",

{antsibull_nox-0.6.0 → antsibull_nox-0.7.0}/tests/unit/test_ansible.py

@@ -178,6 +178,7 @@ GET_SUPPORTED_CORE_VERSIONS_DATA: list[
             Version.parse("2.16"),
             Version.parse("2.17"),
             Version.parse("2.18"),
+            Version.parse("2.19"),
         ],
     ),
     (