version bumps, docs updates ahead of release

Author: ariebovenberg

.flake8

@@ -0,0 +1,8 @@
+[flake8]
+exclude = .git,__pycache__,docs/source/conf.py,old,build,dist,.tox
+extend-ignore =
+  # let black handle line length
+  E501
+  # not black compatible (whitespace before `:`)
+  E203
+

.github/dependabot.yml

@@ -1,5 +1,9 @@
 version: 2
 updates:
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule:
+    interval: "weekly"
 - package-ecosystem: pip
   directory: "/"
   schedule:

.github/workflows/build.yml

@@ -2,6 +2,8 @@ name: Build
 
 on:
   push:
+    tags:
+      - "*"
     branches:
       - main
   pull_request:
@@ -21,14 +23,15 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install 'poetry>=1.8,<1.9'
+        pip install 'poetry>=2.2.1,<2.3'
         poetry check --lock
 
   build:
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
     - uses: actions/checkout@v1
@@ -39,12 +42,72 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install 'tox<5' tox-gh-actions 'poetry>=1.8,<1.9'
+        pip install 'tox<5' tox-gh-actions 'poetry>=2.2,<2.3'
     - name: Test with tox
       run: tox
 
     - name: Upload coverage to Codecov
-      if: matrix.python-version == 3.11
+      if: matrix.python-version == 3.13
       uses: codecov/codecov-action@v2.1.0
       with:
         file: ./coverage.xml
+
+  # https://github.com/marketplace/actions/alls-green#why
+  all-green:
+    name: Are all checks green?
+    if: always()
+    needs:
+      - poetry-lockfile-up-to-date
+      - build
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Decide whether the needed jobs succeeded or failed
+      uses: re-actors/alls-green@release/v1
+      with:
+        jobs: ${{ toJSON(needs) }}
+
+  check-tag:
+    name: Check tag correctness
+    runs-on: ubuntu-latest
+    if: "startsWith(github.ref, 'refs/tags/v')"
+    steps:
+      - uses: actions/checkout@v4
+      - run: |
+          version=$(grep -E '^version\s*=' pyproject.toml | sed -E 's/^version\s*=\s*"([^"]+)".*/\1/')
+
+          tag="${GITHUB_REF_NAME}"
+
+          echo "Detected version in pyproject.toml: $version"
+          echo "Detected tag name: $tag"
+
+          # Compare them
+          if [ "v$version" != "$tag" ]; then
+            echo "❌ Tag ($tag) does not match version in pyproject.toml ($version)"
+            exit 1
+          fi
+
+          echo "✅ Tag matches version. Proceeding with release..."
+
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    if: "startsWith(github.ref, 'refs/tags/v')"
+    needs: [all-green, check-tag]
+    environment: PyPI
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v1
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: '3.13'
+      - name: Install dependencies
+        run: |
+          pip install 'poetry>=2.2,<2.3'
+      - name: Build distribution
+        run: |
+          poetry build
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

AGENTS.md

@@ -60,7 +60,7 @@ CLI args + config file
 
 ### Prerequisites
 
-- Python 3.9+ (3.9–3.13 supported)
+- Python 3.10+ (3.10–3.14 supported)
 - [Poetry](https://python-poetry.org/) for dependency management
 - [tox](https://tox.wiki/) for test automation
 
@@ -96,8 +96,8 @@ pip install -r docs/requirements.txt
 ### CI
 
 GitHub Actions (`.github/workflows/build.yml`):
-- Tests on Python 3.9–3.13
-- Coverage uploaded to Codecov on Python 3.11
+- Tests on Python 3.10–3.14
+- Coverage uploaded to Codecov on Python 3.13
 - Poetry lockfile consistency check
 
 ## Testing

CHANGELOG.rst

@@ -1,7 +1,7 @@
 Changelog
 =========
 
-0.20.0 (2025-06-12)
+0.20.0 (2026-05-29)
 -------------------
 
 - Improve speed and accuracy of detecting of "slotless" classes,

README.rst

@@ -31,8 +31,8 @@ It's easy to get wrong, and what's worse: there is nothing warning you that you
 ``slotscheck`` helps you validate your slots are working properly.
 You can even use it to enforce the use of slots across (parts of) your codebase.
 
-See my `blog post <https://dev.arie.bovenberg.net/blog/finding-broken-slots-in-popular-python-libraries/>`_
-for the origin story behind ``slotscheck``.
+See `my talk at EuroPython <https://www.youtube.com/watch?v=87DoVbgtuRA>`_
+for the details of how slots work and what can go wrong with them.
 
 Quickstart
 ----------

docs/advanced.rst

@@ -28,7 +28,7 @@ Use the following configuration:
 
    repos:
    - repo: https://github.com/ariebovenberg/slotscheck
-     rev: v0.19.1
+     rev: v0.20.0
      hooks:
      - id: slotscheck
        # If your Python files are not importable from the project root,

docs/configuration.rst

@@ -51,31 +51,3 @@ Alternatively, you can manually specify the config file to be used with the
 
 Note that CLI options have precedence over a config file.
 Thus, you can always override what's configured there.
-
-Unused slots detection (Experimental)
---------------------------------------
-
-.. note::
-
-   Requires **Python 3.13+**. Disabled by default.
-
-To enable detection of unused slots:
-
-.. code-block:: toml
-
-   [tool.slotscheck]
-   detect-unused-slots = true
-
-To suppress false positives, use a regex pattern matching
-``module.path:ClassName.slot_name``:
-
-.. code-block:: toml
-
-   [tool.slotscheck]
-   detect-unused-slots = true
-   exclude-slots = '''
-   (
-     mymodule:MyClass\.externally_set_slot
-     |.*\.cache
-   )
-   '''

docs/errors.rst

@@ -137,8 +137,10 @@ implementors.
 The special slots ``__weakref__`` and ``__dict__`` are also excluded,
 as they serve Python-internal purposes rather than user assignment.
 
-**Known limitation:** This check uses Python 3.13's ``__static_attributes__``
-to determine which attributes are assigned within the class body.
-Attributes that are only set externally (e.g. ``obj.slot = value``
-from outside the class) will be reported as unused. Use
-``--exclude-slots`` with a regex pattern to suppress such false positives.
+.. admonition:: Limitations
+
+   This check uses Python 3.13's ``__static_attributes__``
+   to determine which attributes are assigned within the class body.
+   Attributes that are only set externally (e.g. ``obj.slot = value``
+   from outside the class) will be reported as unused. Use
+   ``--exclude-slots`` with a regex pattern to suppress such false positives.