feat: add Python 3.14 support and make it the default

- Add Python 3.14 to CI test matrix and classifiers
- Update mypy python_version and ruff target-version to 3.14
- Update release workflow and ReadTheDocs to Python 3.14
- Remove stale Python 3.7 pydot step from CI
- Add UP037 and UP042 to ruff ignore (require future annotations / 3.11+)
- Remove stale UP038 ignore (rule removed from ruff)
- Add match parameter to pytest.warns (PT030)
- Upgrade ruff 0.8.1 -> 0.15.0, mypy 1.4.1 -> 1.14.1, watchfiles 0.24.0 -> 1.1.1

Author: fgmacedo

.github/workflows/python-package.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
     - uses: actions/checkout@v4
@@ -33,15 +33,11 @@ jobs:
         cache-suffix: "python${{ matrix.python-version }}"
     - name: Install the project
       run: uv sync --all-extras --dev
-    - name: Install old pydot for 3.7 only
-      if: matrix.python-version == 3.7
-      run: |
-        uv pip install pydot==2.0.0
       #----------------------------------------------
       #              run ruff
       #----------------------------------------------
     - name: Linter with ruff
-      if: matrix.python-version == 3.13
+      if: matrix.python-version == 3.14
       run: |
         uv run ruff check .
         uv run ruff format --check .
@@ -57,7 +53,7 @@ jobs:
       #----------------------------------------------
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v4
-      if: matrix.python-version == 3.13
+      if: matrix.python-version == 3.14
       with:
         token: ${{ secrets.CODECOV_TOKEN }} # not required for public repos
         directory: .

.github/workflows/release.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
-          python-version: '3.13'
+          python-version: '3.14'
 
       - name: Setup Graphviz
         uses: ts-graphviz/setup-graphviz@v2

.readthedocs.yaml

@@ -8,7 +8,7 @@ version: 2
 build:
   os: "ubuntu-22.04"
   tools:
-    python: "3.12"
+    python: "3.14"
   apt_packages:
     - graphviz
   jobs:

AGENTS.md

@@ -72,7 +72,7 @@ uv run mypy statemachine/ tests/
 
 ## Code style
 
-- **Formatter/Linter:** ruff (line length 99, target Python 3.13)
+- **Formatter/Linter:** ruff (line length 99, target Python 3.14)
 - **Rules:** pycodestyle, pyflakes, isort, pyupgrade, flake8-comprehensions, flake8-bugbear, flake8-pytest-style
 - **Imports:** single-line, sorted by isort
 - **Docstrings:** Google convention

pyproject.toml

@@ -17,6 +17,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: 3.7",
     "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
@@ -113,7 +114,7 @@ directory = "tmp/htmlcov"
 show_contexts = true
 
 [tool.mypy]
-python_version = "3.13"
+python_version = "3.14"
 warn_return_any = true
 warn_unused_configs = true
 disable_error_code = "annotation-unchecked"
@@ -127,7 +128,7 @@ ignore_missing_imports = true
 src = ["statemachine"]
 
 line-length = 99
-target-version = "py313"
+target-version = "py314"
 
 # Exclude a variety of commonly ignored directories.
 exclude = [
@@ -166,7 +167,8 @@ select = [
 ignore = [
     "UP006", # `use-pep585-annotation` Requires Python3.9+
     "UP035", # `use-pep585-annotation` Requires Python3.9+
-    "UP038", # `use-pep585-annotation` Requires Python3.9+
+    "UP037", # `remove-quotes-from-type-annotation` Not safe without `from __future__ import annotations`
+    "UP042", # `use-str-enum` Requires Python3.11+
 ]
 
 # Allow unused variables when underscore-prefixed.

tests/test_registry.py

@@ -28,7 +28,7 @@ class CampaignMachine(StateMachine):
     assert "CampaignMachine" in registry._REGISTRY
     assert registry.get_machine_cls("tests.test_registry.CampaignMachine") == CampaignMachine
 
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="fully qualified names"):
         assert registry.get_machine_cls("CampaignMachine") == CampaignMachine