fix: add support for python 3.14 (#533)

Author: ssbarnea

.github/workflows/tox.yml

@@ -40,7 +40,7 @@ jobs:
         py313-ansible218
         py314-devel
         py310-macos:tox -e py310
-        py314-macos:tox -e py314
+        py314-devel-macos:tox -e py314-devel
         smoke
       skip_explode: "1"
     secrets: inherit

pyproject.toml

@@ -21,6 +21,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Software Development :: Bug Tracking",
   "Topic :: Software Development :: Quality Assurance",
   "Topic :: Software Development :: Testing",
@@ -479,6 +480,7 @@ env_list = [
   "py312-ansible218",
   "py313-ansible218",
   "py313-devel",
+  "py314-devel",
 ]
 requires = [
   "setuptools>=65.3",
@@ -590,6 +592,11 @@ deps = ["ansible-core @ git+https://github.com/ansible/ansible.git@devel"]
 description = "ansible-core devel py{py_dot_ver}"
 runner = "uv-venv-runner"
 
+[tool.tox.env.py314-devel]
+deps = ["ansible-core @ git+https://github.com/ansible/ansible.git@devel"]
+description = "ansible-core devel py{py_dot_ver}"
+runner = "uv-venv-runner"
+
 [tool.tox.env.rpm]
 commands = [["sh", "-c", "packit build in-mock --root=fedora-40-$(arch)"]]
 deps = ["packitos"]

src/ansible_compat/prerun.py

@@ -1,11 +1,26 @@
-"""Utilities for configuring ansible runtime environment."""
+"""Utilities for configuring ansible runtime environment.
+
+No import of ansible-core must happen within this file!
+"""
 
 import hashlib
 import os
+import sys
 import tempfile
 import warnings
+from importlib.metadata import version
 from pathlib import Path
 
+from packaging.version import Version
+
+# This module is early loaded by tools like ansible-lint and we want to fail
+# fast even for `ansible-lint --version` if the setup is known as broken.
+if sys.version_info >= (3, 14):
+    core_version = Version(version("ansible-core"))
+    if core_version < Version("2.20.0dev0"):  # pragma: no cover
+        msg = f"Python 3.14 requires ansible-core version >= 2.20.0, and we found {core_version}."
+        raise RuntimeError(msg)
+
 
 def is_writable(path: Path) -> bool:
     """Check if path is writable, creating if necessary.
@@ -43,7 +58,7 @@ def get_cache_dir(project_dir: Path, *, isolated: bool = True) -> Path:
         if is_writable(path):
             cache_dir = path
         else:
-            msg = f"Found VIRTUAL_ENV={os.environ['VIRTUAL_ENV']} but we cannot use it for caching as it is not writable."
+            msg = f"Found VIRTUAL_ENV={os.environ['VIRTUAL_ENV']} but we cannot use it for caching as it is not writable."  # pylint: disable=W0621
             warnings.warn(
                 message=msg,
                 stacklevel=2,

test/test_runtime_scan_path.py

@@ -3,6 +3,7 @@
 import json
 import os
 import subprocess
+import sys
 import textwrap
 from pathlib import Path
 
@@ -20,6 +21,10 @@
 V2_COLLECTION_FULL_NAME = f"{V2_COLLECTION_NAMESPACE}.{V2_COLLECTION_NAME}"
 
 
+@pytest.mark.skipif(
+    sys.version_info >= (3, 14),
+    reason="Python 3.14 requires unreleased ansible-core which will fail this test.",
+)
 @pytest.mark.parametrize(
     ("scan", "raises_not_found"),
     (