antsibull-nox 0.0.1__tar.gz → 0.2.0__tar.gz

{antsibull_nox-0.0.1 → antsibull_nox-0.2.0}/.github/workflows/nox.yml

@@ -2,7 +2,7 @@
 # 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
-# SPDX-FileCopyrightText: 2023 Maxwell G <maxwell@gtmx.me
+# SPDX-FileCopyrightText: 2023 Maxwell G <maxwell@gtmx.me>
 
 name: nox
 'on':
@@ -21,20 +21,25 @@ env:
 jobs:
   nox:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: antsibull-nox
     strategy:
       fail-fast: false
       matrix:
         include:
           - session: test
             python-versions: "3.9, 3.10, 3.11, 3.12, 3.13"
+            force-python: ""
+            codecov: true
+            packages: ""
+
+          - session: integration
+            python-versions: "3.13"
+            force-python: "3.13"
             codecov: true
             packages: ""
 
           - session: lint
             python-versions: "3.13"
+            force-python: "3.13"
             codecov: false
             packages: ""
     name: "Run nox ${{ matrix.session }} session"
@@ -58,21 +63,12 @@ jobs:
         uses: wntrblm/nox@2025.02.09
         with:
           python-versions: "${{ matrix.python-versions }}"
-      - name: Set up nox environments
-        run: |
-          nox -v -e "${{ matrix.session }}" ${{ matrix.codecov && 'coverage' || '' }} --install-only
-      - name: "Run nox -e ${{ matrix.session }}"
-        run: |
-          nox -v -e "${{ matrix.session }}" --reuse-existing-virtualenvs --no-install
-      - name: Report coverage
-        if: ${{ matrix.codecov }}
-        run: |
-          nox -v -e coverage --reuse-existing-virtualenvs --no-install
-      - name: Upload coverage
-        if: ${{ matrix.codecov }}
-        uses: codecov/codecov-action@v5
+      - name: Run nox
+        uses: ansible-community/github-action-run-nox@v1
         with:
+          sessions: ${{ matrix.session }}
+          force-pythons: ${{ matrix.force-python }}
           working-directory: antsibull-nox
-          name: "${{ matrix.session }}"
-        env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+          codecov: ${{ matrix.codecov }}
+          codecov-session: coverage
+          codecov-token: ${{ secrets.CODECOV_TOKEN }}

antsibull_nox-0.2.0/.github/workflows/reusable-nox-matrix.yml

@@ -0,0 +1,162 @@
+---
+# 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
+# SPDX-FileCopyrightText: 2025 Felix Fontein <felix@fontein.de>
+
+name: Run sanity, unit, and integration tests
+
+"on":
+  workflow_call:
+    inputs:
+      upload-codecov:
+        type: boolean
+        description: >-
+          Whether code coverage should be collected and uploaded to codecov.io.
+        required: false
+        default: false
+    secrets:
+      CODECOV_TOKEN:
+        required: false
+
+jobs:
+  create-matrixes:
+    name: "Create matrixes"
+    runs-on: ubuntu-latest
+    outputs:
+      sanity-matrix: ${{ fromJSON(steps.generate-matrix.outputs.run-nox).sanity }}
+      units-matrix: ${{ fromJSON(steps.generate-matrix.outputs.run-nox).units }}
+      integration-matrix: ${{ fromJSON(steps.generate-matrix.outputs.run-nox).integration }}
+    steps:
+      - name: Check out collection
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Run nox
+        uses: ansible-community/antsibull-nox@main
+        id: generate-matrix
+        with:
+          sessions: matrix-generator
+
+  sanity:
+    name: ${{ matrix.skip && 'Skipping ' || '' }}Sanity (Ⓐ${{ matrix.ansible-core }})
+    needs:
+      - create-matrixes
+    strategy:
+      matrix:
+        include: >-
+          ${{ fromJson(needs.create-matrixes.outputs.sanity-matrix || '[{"skip": true}]') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out collection
+        if: >-
+          !matrix.skip
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Run nox
+        if: >-
+          !matrix.skip
+        uses: ansible-community/antsibull-nox@main
+        with:
+          extra-python-versions: ${{ matrix.python }}
+          extra-args: ${{ inputs.upload-codecov && '--coverage' || '' }}
+          sessions: ${{ matrix.name }}
+      - name: Upload coverage for final step
+        if: >-
+          !matrix.skip && inputs.upload-codecov
+        uses: actions/upload-artifact@v4
+        with:
+          name: code-coverage-sanity-${{ matrix.name }}
+          path: tests/output/reports/coverage=sanity=*.xml
+
+  units:
+    name: ${{ matrix.skip && 'Skipping ' || '' }}Units (Ⓐ${{ matrix.ansible-core }})
+    needs:
+      - create-matrixes
+    strategy:
+      matrix:
+        include: >-
+          ${{ fromJson(needs.create-matrixes.outputs.units-matrix || '[{"skip": true}]') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out collection
+        if: >-
+          !matrix.skip
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Run nox
+        if: >-
+          !matrix.skip
+        uses: ansible-community/antsibull-nox@main
+        with:
+          extra-python-versions: ${{ matrix.python }}
+          extra-args: ${{ inputs.upload-codecov && '--coverage' || '' }}
+          sessions: ${{ matrix.name }}
+      - name: Upload coverage for final step
+        if: >-
+          !matrix.skip && inputs.upload-codecov
+        uses: actions/upload-artifact@v4
+        with:
+          name: code-coverage-units-${{ matrix.name }}
+          path: tests/output/reports/coverage=units=*.xml
+
+  integration:
+    name: ${{ matrix.skip && 'Skipping ' || '' }}I (Ⓐ${{ matrix.ansible-core }}+py${{ matrix.test-python }}+${{ matrix.test-container }})
+    needs:
+      - create-matrixes
+    strategy:
+      fail-fast: false
+      matrix:
+        include: >-
+          ${{ fromJson(needs.create-matrixes.outputs.integration-matrix || '[{"skip": true}]') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out collection
+        if: >-
+          !matrix.skip
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Run nox
+        if: >-
+          !matrix.skip
+        uses: ansible-community/antsibull-nox@main
+        with:
+          extra-python-versions: ${{ matrix.python }}
+          extra-args: ${{ inputs.upload-codecov && '--coverage' || '' }}
+          sessions: ${{ matrix.name }}
+      - name: Upload coverage for final step
+        if: >-
+          !matrix.skip && inputs.upload-codecov
+        uses: actions/upload-artifact@v4
+        with:
+          name: code-coverage-integration-${{ matrix.name }}
+          path: tests/output/reports/coverage=integration=*.xml
+
+  upload-coverage:
+    name: Upload coverage
+    if: inputs.upload-codecov
+    needs:
+      - sanity
+      - units
+      - integration
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out collection
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Download coverage from previous steps
+        uses: actions/download-artifact@v4
+        with:
+          pattern: code-coverage-*
+      - name: List all files
+        run: find . -name 'coverage=*.xml'
+        shell: bash
+      - name: Upload coverage
+        uses: codecov/codecov-action@v5
+        with:
+          files: coverage=*.xml
+          token: ${{ secrets.CODECOV_TOKEN }}

antsibull_nox-0.2.0/.github/workflows/test-gh-action.yml

@@ -0,0 +1,33 @@
+---
+# 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
+# SPDX-FileCopyrightText: 2023 Maxwell G <maxwell@gtmx.me>
+
+name: test-gh-action
+'on':
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  # Run once per week (Monday at 03:30 UTC)
+  schedule:
+    - cron: '30 3 * * 1'
+  workflow_dispatch:
+
+env:
+  FORCE_COLOR: "1"
+
+jobs:
+  test-gh-action:
+    runs-on: ubuntu-latest
+    name: "Run nox"
+    steps:
+      - name: Check out antsibull-nox
+        uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - name: Run nox action in subdirectory
+        uses: ./
+        with:
+          working-directory: tests/test-collection/

{antsibull_nox-0.0.1 → antsibull_nox-0.2.0}/.pylintrc.automated

@@ -66,7 +66,9 @@ confidence=
 # --disable=W".
 disable=
     locally-disabled,
+    too-few-public-methods,
     too-many-arguments,
+    too-many-lines,
     too-many-locals,
     too-many-positional-arguments,
 

antsibull_nox-0.2.0/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Antsibull Nox Helper Release Notes
+
+**Topics**
+
+- <a href="#v0-2-0">v0\.2\.0</a>
+    - <a href="#release-summary">Release Summary</a>
+    - <a href="#major-changes">Major Changes</a>
+    - <a href="#minor-changes">Minor Changes</a>
+    - <a href="#deprecated-features">Deprecated Features</a>
+- <a href="#v0-1-0">v0\.1\.0</a>
+    - <a href="#release-summary-1">Release Summary</a>
+    - <a href="#minor-changes-1">Minor Changes</a>
+    - <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a>
+    - <a href="#bugfixes">Bugfixes</a>
+- <a href="#v0-0-1">v0\.0\.1</a>
+    - <a href="#release-summary-2">Release Summary</a>
+
+<a id="v0-2-0"></a>
+## v0\.2\.0
+
+<a id="release-summary"></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>
+### 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"></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)\)\.
+* Add function <code>add\_matrix\_generator</code> which allows to generate matrixes for CI systems for ansible\-test runs \([https\://github\.com/ansible\-community/antsibull\-nox/pull/32](https\://github\.com/ansible\-community/antsibull\-nox/pull/32)\)\.
+* Add several new functions to add ansible\-test runs \([https\://github\.com/ansible\-community/antsibull\-nox/issues/5](https\://github\.com/ansible\-community/antsibull\-nox/issues/5)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/32](https\://github\.com/ansible\-community/antsibull\-nox/pull/32)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/41](https\://github\.com/ansible\-community/antsibull\-nox/pull/41)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/45](https\://github\.com/ansible\-community/antsibull\-nox/pull/45)\)\.
+* Add shared workflow for running ansible\-test from nox and generating the CI matrix from nox as well \([https\://github\.com/ansible\-community/antsibull\-nox/issues/35](https\://github\.com/ansible\-community/antsibull\-nox/issues/35)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/37](https\://github\.com/ansible\-community/antsibull\-nox/pull/37)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/38](https\://github\.com/ansible\-community/antsibull\-nox/pull/38)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/48](https\://github\.com/ansible\-community/antsibull\-nox/pull/48)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/53](https\://github\.com/ansible\-community/antsibull\-nox/pull/53)\)\.
+* Allow to add <code>yamllint</code> session to <code>lint</code> meta\-session that checks YAML files\, and YAML content embedded in plugins and sidecar docs \([https\://github\.com/ansible\-community/antsibull\-nox/pull/42](https\://github\.com/ansible\-community/antsibull\-nox/pull/42)\)\.
+* Allow to add ansible\-lint session \([https\://github\.com/ansible\-community/antsibull\-nox/issues/40](https\://github\.com/ansible\-community/antsibull\-nox/issues/40)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/49](https\://github\.com/ansible\-community/antsibull\-nox/pull/49)\)\.
+* Allow to disable using installed collections that are not checked out next to the current one by setting the environment variable <code>ANTSIBULL\_NOX\_IGNORE\_INSTALLED\_COLLECTIONS</code> to <code>true</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/51](https\://github\.com/ansible\-community/antsibull\-nox/pull/51)\)\.
+* Collapse Galaxy importer\'s output in GitHub Actions \([https\://github\.com/ansible\-community/antsibull\-nox/pull/46](https\://github\.com/ansible\-community/antsibull\-nox/pull/46)\)\.
+* In the GitHub Action\, no longer use installed collections\, but only ones that have been checked out next to the current one\. This avoids using collections that come with the Ansible community package installed in the default GHA image \([https\://github\.com/ansible\-community/antsibull\-nox/pull/51](https\://github\.com/ansible\-community/antsibull\-nox/pull/51)\)\.
+* The action allows to install additional Python versions with the new <code>extra\-python\-versions</code> option \([https\://github\.com/ansible\-community/antsibull\-nox/pull/32](https\://github\.com/ansible\-community/antsibull\-nox/pull/32)\)\.
+* The action allows to pass extra commands after <code>\-\-</code> with the new <code>extra\-args</code> option \([https\://github\.com/ansible\-community/antsibull\-nox/pull/32](https\://github\.com/ansible\-community/antsibull\-nox/pull/32)\)\.
+* antsibull\-nox now automatically installs missing collections\. It uses <code>\.nox/\.cache</code> to store the collection artifacts and the extracted collections \([https\://github\.com/ansible\-community/antsibull\-nox/pull/46](https\://github\.com/ansible\-community/antsibull\-nox/pull/46)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/52](https\://github\.com/ansible\-community/antsibull\-nox/pull/52)\, [https\://github\.com/ansible\-community/antsibull\-nox/issues/7](https\://github\.com/ansible\-community/antsibull\-nox/issues/7)\)\.
+* pydantic is now a required Python dependency of antsibull\-nox \([https\://github\.com/ansible\-community/antsibull\-nox/pull/50](https\://github\.com/ansible\-community/antsibull\-nox/pull/50)\)\.
+* tomli is now a required Python dependency of antsibull\-nox for Python versions 3\.9 and 3\.10 For Python 3\.11\+\, the standard library tomllib will be used \([https\://github\.com/ansible\-community/antsibull\-nox/pull/50](https\://github\.com/ansible\-community/antsibull\-nox/pull/50)\)\.
+
+<a id="deprecated-features"></a>
+### Deprecated Features
+
+* All functions in <code>antsibull\_nox\.\*\*</code> are deprecated except <code>antsibull\_nox\.load\_antsibull\_nox\_toml\(\)</code>\, <code>antsibull\_nox\.add\_ansible\_test\_session\(\)</code>\, and <code>antsibull\_nox\.sessions\.prepare\_collections\(\)</code>\. The other function will still work for the next minor release\, but will then be removed\. Use <code>antsibull\-nox\.toml</code> and <code>antsibull\_nox\.load\_antsibull\_nox\_toml\(\)</code> instead \([https\://github\.com/ansible\-community/antsibull\-nox/pull/50](https\://github\.com/ansible\-community/antsibull\-nox/pull/50)\)\.
+
+<a id="v0-1-0"></a>
+## v0\.1\.0
+
+<a id="release-summary-1"></a>
+### Release Summary
+
+Feature release\.
+
+<a id="minor-changes-1"></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)\)\.
+* A <code>docs\-check</code> session that runs <code>antsibull\-docs lint\-collection\-docs</code> can be added with <code>add\_docs\_check\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/issues/8](https\://github\.com/ansible\-community/antsibull\-nox/issues/8)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
+* A <code>extra\-checks</code> session that runs extra checks such as <code>no\-unwanted\-files</code> or <code>action\-groups</code> can be added with <code>add\_extra\_checks\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/issues/8](https\://github\.com/ansible\-community/antsibull\-nox/issues/8)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
+* A <code>license\-check</code> session that runs <code>reuse</code> and checks for bad licenses can be added with <code>add\_license\_check\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/issues/8](https\://github\.com/ansible\-community/antsibull\-nox/issues/8)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
+* Allow to decide which sessions should be marked as default and which not \([https\://github\.com/ansible\-community/antsibull\-nox/issues/18](https\://github\.com/ansible\-community/antsibull\-nox/issues/18)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/20](https\://github\.com/ansible\-community/antsibull\-nox/pull/20)\)\.
+* Allow to provide <code>extra\_code\_files</code> to <code>add\_lint\_sessions\(\)</code> \([https\://github\.com/ansible\-community/antsibull\-nox/pull/14](https\://github\.com/ansible\-community/antsibull\-nox/pull/14)\)\.
+* Check whether we\'re running in CI using the generic <code>\$CI</code> enviornment variable instead of <code>\$GITHUB\_ACTIONS</code>\. <code>\$CI</code> is set to <code>true</code> on Github Actions\, Gitlab CI\, and other CI systems \([https\://github\.com/ansible\-community/antsibull\-nox/pull/28](https\://github\.com/ansible\-community/antsibull\-nox/pull/28)\)\.
+* For running pylint and mypy\, copy the collection and dependent collections into a new tree\. This allows the collection repository to be checked out outside an approriate tree structure\, and it also allows the dependent collections to live in another tree structure\, as long as <code>ansible\-galaxy collection list</code> can find them \([https\://github\.com/ansible\-community/antsibull\-nox/pull/1](https\://github\.com/ansible\-community/antsibull\-nox/pull/1)\)\.
+* When a collection checkout is not part of an <code>ansible\_collections</code> tree\, look for collections in adjacent directories of the form <code>\<namespace\>\.\<name\></code> that match the containing collection\'s FQCN \([https\://github\.com/ansible\-community/antsibull\-nox/issues/6](https\://github\.com/ansible\-community/antsibull\-nox/issues/6)\, [https\://github\.com/ansible\-community/antsibull\-nox/pull/22](https\://github\.com/ansible\-community/antsibull\-nox/pull/22)\)\.
+* antsibull\-nox now depends on antsibull\-fileutils \>\= 1\.2\.0 \([https\://github\.com/ansible\-community/antsibull\-nox/pull/1](https\://github\.com/ansible\-community/antsibull\-nox/pull/1)\)\.
+
+<a id="breaking-changes--porting-guide"></a>
+### Breaking Changes / Porting Guide
+
+* 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"></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)\)\.
+
+<a id="v0-0-1"></a>
+## v0\.0\.1
+
+<a id="release-summary-2"></a>
+### Release Summary
+
+Initial alpha release\.

antsibull_nox-0.2.0/CHANGELOG.rst

@@ -0,0 +1,81 @@
+==================================
+Antsibull Nox Helper Release Notes
+==================================
+
+.. contents:: Topics
+
+v0.2.0
+======
+
+Release Summary
+---------------
+
+Major extension and overhaul with many breaking changes. The next minor release is expected to bring more stabilization.
+
+Major Changes
+-------------
+
+- There is now a new function ``antsibull_nox.load_antsibull_nox_toml()`` which loads ``antsibull-nox.toml`` and creates configuration and sessions from it. Calling other functionality from ``antsibull_nox`` in ``noxfile.py`` is only necessary for creating own specialized sessions, or ansible-test sessions that cannot be created with the ``antsibull_nox.add_all_ansible_test_*_test_sessions*()`` type functions (https://github.com/ansible-community/antsibull-nox/pull/50, https://github.com/ansible-community/antsibull-nox/issues/34).
+
+Minor Changes
+-------------
+
+- Add descriptions to generated sessions that are shown when running ``nox --list`` (https://github.com/ansible-community/antsibull-nox/pull/31).
+- Add function ``add_matrix_generator`` which allows to generate matrixes for CI systems for ansible-test runs (https://github.com/ansible-community/antsibull-nox/pull/32).
+- Add several new functions to add ansible-test runs (https://github.com/ansible-community/antsibull-nox/issues/5, https://github.com/ansible-community/antsibull-nox/pull/32, https://github.com/ansible-community/antsibull-nox/pull/41, https://github.com/ansible-community/antsibull-nox/pull/45).
+- Add shared workflow for running ansible-test from nox and generating the CI matrix from nox as well (https://github.com/ansible-community/antsibull-nox/issues/35, https://github.com/ansible-community/antsibull-nox/pull/37, https://github.com/ansible-community/antsibull-nox/pull/38, https://github.com/ansible-community/antsibull-nox/pull/48, https://github.com/ansible-community/antsibull-nox/pull/53).
+- Allow to add ``yamllint`` session to ``lint`` meta-session that checks YAML files, and YAML content embedded in plugins and sidecar docs (https://github.com/ansible-community/antsibull-nox/pull/42).
+- Allow to add ansible-lint session (https://github.com/ansible-community/antsibull-nox/issues/40, https://github.com/ansible-community/antsibull-nox/pull/49).
+- Allow to disable using installed collections that are not checked out next to the current one by setting the environment variable ``ANTSIBULL_NOX_IGNORE_INSTALLED_COLLECTIONS`` to ``true`` (https://github.com/ansible-community/antsibull-nox/pull/51).
+- Collapse Galaxy importer's output in GitHub Actions (https://github.com/ansible-community/antsibull-nox/pull/46).
+- In the GitHub Action, no longer use installed collections, but only ones that have been checked out next to the current one. This avoids using collections that come with the Ansible community package installed in the default GHA image (https://github.com/ansible-community/antsibull-nox/pull/51).
+- The action allows to install additional Python versions with the new ``extra-python-versions`` option (https://github.com/ansible-community/antsibull-nox/pull/32).
+- The action allows to pass extra commands after ``--`` with the new ``extra-args`` option (https://github.com/ansible-community/antsibull-nox/pull/32).
+- antsibull-nox now automatically installs missing collections. It uses ``.nox/.cache`` to store the collection artifacts and the extracted collections (https://github.com/ansible-community/antsibull-nox/pull/46, https://github.com/ansible-community/antsibull-nox/pull/52, https://github.com/ansible-community/antsibull-nox/issues/7).
+- pydantic is now a required Python dependency of antsibull-nox (https://github.com/ansible-community/antsibull-nox/pull/50).
+- tomli is now a required Python dependency of antsibull-nox for Python versions 3.9 and 3.10 For Python 3.11+, the standard library tomllib will be used (https://github.com/ansible-community/antsibull-nox/pull/50).
+
+Deprecated Features
+-------------------
+
+- All functions in ``antsibull_nox.**`` are deprecated except ``antsibull_nox.load_antsibull_nox_toml()``, ``antsibull_nox.add_ansible_test_session()``, and ``antsibull_nox.sessions.prepare_collections()``. The other function will still work for the next minor release, but will then be removed. Use ``antsibull-nox.toml`` and ``antsibull_nox.load_antsibull_nox_toml()`` instead (https://github.com/ansible-community/antsibull-nox/pull/50).
+
+v0.1.0
+======
+
+Release Summary
+---------------
+
+Feature release.
+
+Minor Changes
+-------------
+
+- A ``build-import-check`` session that builds and tries to import the collection with Galaxy Importer can be added with ``add_build_import_check()`` (https://github.com/ansible-community/antsibull-nox/issues/15, https://github.com/ansible-community/antsibull-nox/pull/17).
+- A ``docs-check`` session that runs ``antsibull-docs lint-collection-docs`` can be added with ``add_docs_check()`` (https://github.com/ansible-community/antsibull-nox/issues/8, https://github.com/ansible-community/antsibull-nox/pull/14).
+- A ``extra-checks`` session that runs extra checks such as ``no-unwanted-files`` or ``action-groups`` can be added with ``add_extra_checks()`` (https://github.com/ansible-community/antsibull-nox/issues/8, https://github.com/ansible-community/antsibull-nox/pull/14).
+- A ``license-check`` session that runs ``reuse`` and checks for bad licenses can be added with ``add_license_check()`` (https://github.com/ansible-community/antsibull-nox/issues/8, https://github.com/ansible-community/antsibull-nox/pull/14).
+- Allow to decide which sessions should be marked as default and which not (https://github.com/ansible-community/antsibull-nox/issues/18, https://github.com/ansible-community/antsibull-nox/pull/20).
+- Allow to provide ``extra_code_files`` to ``add_lint_sessions()`` (https://github.com/ansible-community/antsibull-nox/pull/14).
+- Check whether we're running in CI using the generic ``$CI`` enviornment variable instead of ``$GITHUB_ACTIONS``. ``$CI`` is set to ``true`` on Github Actions, Gitlab CI, and other CI systems (https://github.com/ansible-community/antsibull-nox/pull/28).
+- For running pylint and mypy, copy the collection and dependent collections into a new tree. This allows the collection repository to be checked out outside an approriate tree structure, and it also allows the dependent collections to live in another tree structure, as long as ``ansible-galaxy collection list`` can find them (https://github.com/ansible-community/antsibull-nox/pull/1).
+- When a collection checkout is not part of an ``ansible_collections`` tree, look for collections in adjacent directories of the form ``<namespace>.<name>`` that match the containing collection's FQCN (https://github.com/ansible-community/antsibull-nox/issues/6, https://github.com/ansible-community/antsibull-nox/pull/22).
+- antsibull-nox now depends on antsibull-fileutils >= 1.2.0 (https://github.com/ansible-community/antsibull-nox/pull/1).
+
+Breaking Changes / Porting Guide
+--------------------------------
+
+- The nox workflow now by default runs all sessions, unless restricted with the ``sessions`` parameter (https://github.com/ansible-community/antsibull-nox/pull/14).
+
+Bugfixes
+--------
+
+- Make sure that black in CI checks formatting instead of just reformatting (https://github.com/ansible-community/antsibull-nox/pull/14).
+
+v0.0.1
+======
+
+Release Summary
+---------------
+
+Initial alpha release.

{antsibull_nox-0.0.1 → antsibull_nox-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: antsibull-nox
-Version: 0.0.1
+Version: 0.2.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/
@@ -22,11 +22,13 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.9.0
-Requires-Dist: antsibull-fileutils<2.0.0,>=1.0.0
+Requires-Dist: antsibull-fileutils<2.0.0,>=1.2.0
 Requires-Dist: nox>=2025.2.9
 Requires-Dist: packaging
+Requires-Dist: pydantic~=2.0
 Requires-Dist: pyyaml
 Requires-Dist: semantic-version
+Requires-Dist: tomli; python_version < '3.11'
 Provides-Extra: codeqa
 Requires-Dist: antsibull-changelog; extra == 'codeqa'
 Requires-Dist: flake8>=3.8.0; extra == 'codeqa'
@@ -67,12 +69,14 @@ SPDX-License-Identifier: GPL-3.0-or-later
 -->
 
 # antsibull-nox -- Antsibull Nox Helper
+[![Documentation](https://img.shields.io/badge/docs-brightgreen.svg)](https://ansible.readthedocs.io/projects/antsibull-nox/)
 [![Discuss on Matrix at #antsibull:ansible.com](https://img.shields.io/matrix/antsibull:ansible.com.svg?server_fqdn=ansible-accounts.ems.host&label=Discuss%20on%20Matrix%20at%20%23antsibull:ansible.com&logo=matrix)](https://matrix.to/#/#antsibull:ansible.com)
 [![Nox badge](https://github.com/ansible-community/antsibull-nox/actions/workflows/nox.yml/badge.svg)](https://github.com/ansible-community/antsibull-nox/actions?query=workflow%3A%22nox%22+branch%3Amain)
 [![Codecov badge](https://img.shields.io/codecov/c/github/ansible-community/antsibull-nox)](https://codecov.io/gh/ansible-community/antsibull-nox)
 [![REUSE status](https://api.reuse.software/badge/github.com/ansible-community/antsibull-nox)](https://api.reuse.software/info/github.com/ansible-community/antsibull-nox)
 
 A [nox](https://nox.thea.codes/en/stable/) helper for Ansible collections.
+Please check out the [documentation](https://ansible.readthedocs.io/projects/antsibull-nox/) for more information.
 
 antsibull-nox is covered by the [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html).
 
@@ -86,6 +90,12 @@ It can be installed with pip:
 
     pip install antsibull-nox
 
+## Versioning and compatibility
+
+From version 1.0.0 on, antsibull-nox sticks to semantic versioning and aims at providing no backwards compatibility breaking changes [**to the documented API**](https://ansible.readthedocs.io/projects/antsibull-nox/reference/) during a major release cycle. We might make exceptions from this in case of security fixes for vulnerabilities that are severe enough.
+
+Interfaces and functions that are not [documented in the API reference](https://ansible.readthedocs.io/projects/antsibull-nox/reference/) are exempt from this and might break even in bugfix releases!
+
 ## Development
 
 Install and run `nox` to run all tests. That's it for simple contributions!
@@ -139,5 +149,5 @@ General Public License v3 or, at your option, later. See
 [LICENSES/GPL-3.0-or-later.txt](https://github.com/ansible-community/antsibull-nox/tree/main/LICENSE)
 for a copy of the license.
 
-The repository follows the [REUSE Specification](https://reuse.software/spec/) for declaring copyright and
-licensing information. The only exception are changelog fragments in ``changelog/fragments/``.
+The repository follows the [REUSE Specification](https://reuse.software/spec/)
+for declaring copyright and licensing information.

{antsibull_nox-0.0.1 → antsibull_nox-0.2.0}/README.md

@@ -5,12 +5,14 @@ SPDX-License-Identifier: GPL-3.0-or-later
 -->
 
 # antsibull-nox -- Antsibull Nox Helper
+[![Documentation](https://img.shields.io/badge/docs-brightgreen.svg)](https://ansible.readthedocs.io/projects/antsibull-nox/)
 [![Discuss on Matrix at #antsibull:ansible.com](https://img.shields.io/matrix/antsibull:ansible.com.svg?server_fqdn=ansible-accounts.ems.host&label=Discuss%20on%20Matrix%20at%20%23antsibull:ansible.com&logo=matrix)](https://matrix.to/#/#antsibull:ansible.com)
 [![Nox badge](https://github.com/ansible-community/antsibull-nox/actions/workflows/nox.yml/badge.svg)](https://github.com/ansible-community/antsibull-nox/actions?query=workflow%3A%22nox%22+branch%3Amain)
 [![Codecov badge](https://img.shields.io/codecov/c/github/ansible-community/antsibull-nox)](https://codecov.io/gh/ansible-community/antsibull-nox)
 [![REUSE status](https://api.reuse.software/badge/github.com/ansible-community/antsibull-nox)](https://api.reuse.software/info/github.com/ansible-community/antsibull-nox)
 
 A [nox](https://nox.thea.codes/en/stable/) helper for Ansible collections.
+Please check out the [documentation](https://ansible.readthedocs.io/projects/antsibull-nox/) for more information.
 
 antsibull-nox is covered by the [Ansible Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html).
 
@@ -24,6 +26,12 @@ It can be installed with pip:
 
     pip install antsibull-nox
 
+## Versioning and compatibility
+
+From version 1.0.0 on, antsibull-nox sticks to semantic versioning and aims at providing no backwards compatibility breaking changes [**to the documented API**](https://ansible.readthedocs.io/projects/antsibull-nox/reference/) during a major release cycle. We might make exceptions from this in case of security fixes for vulnerabilities that are severe enough.
+
+Interfaces and functions that are not [documented in the API reference](https://ansible.readthedocs.io/projects/antsibull-nox/reference/) are exempt from this and might break even in bugfix releases!
+
 ## Development
 
 Install and run `nox` to run all tests. That's it for simple contributions!
@@ -77,5 +85,5 @@ General Public License v3 or, at your option, later. See
 [LICENSES/GPL-3.0-or-later.txt](https://github.com/ansible-community/antsibull-nox/tree/main/LICENSE)
 for a copy of the license.
 
-The repository follows the [REUSE Specification](https://reuse.software/spec/) for declaring copyright and
-licensing information. The only exception are changelog fragments in ``changelog/fragments/``.
+The repository follows the [REUSE Specification](https://reuse.software/spec/)
+for declaring copyright and licensing information.

{antsibull_nox-0.0.1 → antsibull_nox-0.2.0}/REUSE.toml

@@ -1,3 +1,6 @@
+# SPDX-FileCopyrightText: Ansible Project
+# SPDX-License-Identifier: GPL-3.0-or-later
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
 version = 1
 
 [[annotations]]

{antsibull_nox-0.0.1 → antsibull_nox-0.2.0}/action.yml

@@ -14,17 +14,32 @@ inputs:
       Python-version to use. We recommend to stick to the default.
     required: false
     default: "3.13"
+  extra-python-versions:
+    description: |-
+      Newline-separated list of Python versions to install as well.
+      Should be used if other Python versions are needed.
+    required: false
+    default: ""
+  extra-args:
+    description: |-
+      Additional arguments to pass to the nox run after `--`.
+    required: false
+    default: ""
   sessions:
     description: |-
-      Nox sessions to run. We recommend to stick to the default.
+      Nox sessions to run. By default, all sessions are run.
     required: false
-    default: lint
+    default: ""
   working-directory:
     description: |-
       The directory where to run the nox sessions in.
       Should be the directory where the collection's `galaxy.yml` is in, and where the `noxfile.py` is in.
     required: false
     default: .
+outputs:
+  run-nox:
+    description: Output of the 'run nox' step.
+    value: ${{ toJSON(steps.run-nox.outputs) }}
 
 runs:
   using: composite
@@ -33,25 +48,33 @@ runs:
       uses: actions/setup-python@v5
       id: python
       with:
-        python-version: "${{ inputs.python-version }}"
+        python-version: |-
+          ${{ inputs.extra-python-versions }}
+          ${{ inputs.python-version }}
 
     - name: "Install nox and antsibull-nox"
       run: |
+        echo "::group::Install nox and antsibull-nox"
         ${{ steps.python.outputs.python-path }} -m pip install ${{ github.action_path }}
+        echo "::endgroup::"
       shell: bash
 
     - name: "Set up nox environments"
       run: |
-        nox --verbose --install-only --sessions ${{ inputs.sessions }}
+        echo "::group::Set up nox environments"
+        nox --verbose --install-only${{ inputs.sessions && ' --sessions ' || '' }}${{ inputs.sessions }}
+        echo "::endgroup::"
       env:
         FORCE_COLOR: "1"
       shell: bash
       working-directory: "${{ inputs.working-directory }}"
 
     - name: "Run nox"
+      id: run-nox
       run: |
-        nox --verbose --reuse-existing-virtualenvs --no-install --sessions ${{ inputs.sessions }}
+        nox --verbose --reuse-existing-virtualenvs --no-install${{ inputs.sessions && ' --sessions ' || '' }}${{ inputs.sessions }}${{ inputs.extra-args && ' -- ' || '' }}${{ inputs.extra-args }}
       env:
         FORCE_COLOR: "1"
+        ANTSIBULL_NOX_IGNORE_INSTALLED_COLLECTIONS: "true"
       shell: bash
       working-directory: "${{ inputs.working-directory }}"