ansible-core 2.17.4rc1__py3-none-any.whl → 2.18.0b1__py3-none-any.whl

{ansible_core-2.17.4rc1.dist-info → ansible_core-2.18.0b1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (75.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{ansible_core-2.17.4rc1.dist-info → ansible_core-2.18.0b1.dist-info}/entry_points.txt

@@ -1,11 +1,11 @@
 [console_scripts]
 ansible = ansible.cli.adhoc:main
 ansible-config = ansible.cli.config:main
-ansible-connection = ansible.cli.scripts.ansible_connection_cli_stub:main
 ansible-console = ansible.cli.console:main
 ansible-doc = ansible.cli.doc:main
 ansible-galaxy = ansible.cli.galaxy:main
 ansible-inventory = ansible.cli.inventory:main
 ansible-playbook = ansible.cli.playbook:main
 ansible-pull = ansible.cli.pull:main
+ansible-test = ansible_test._util.target.cli.ansible_test_cli_stub:main
 ansible-vault = ansible.cli.vault:main

ansible_core-2.18.0b1.dist-info/simplified_bsd.txt

@@ -0,0 +1,8 @@
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

ansible_test/_data/completion/docker.txt

@@ -1,7 +1,7 @@
-base image=quay.io/ansible/base-test-container:6.2.0 python=3.12,3.7,3.8,3.9,3.10,3.11
-default image=quay.io/ansible/default-test-container:9.6.0 python=3.12,3.7,3.8,3.9,3.10,3.11 context=collection
-default image=quay.io/ansible/ansible-core-test-container:9.6.0 python=3.12,3.7,3.8,3.9,3.10,3.11 context=ansible-core
-alpine319 image=quay.io/ansible/alpine319-test-container:7.1.0 python=3.11 cgroup=none audit=none
-fedora39 image=quay.io/ansible/fedora39-test-container:7.1.0 python=3.12
-ubuntu2004 image=quay.io/ansible/ubuntu2004-test-container:7.1.0 python=3.8
-ubuntu2204 image=quay.io/ansible/ubuntu2204-test-container:7.1.0 python=3.10
+base image=quay.io/ansible/base-test-container:7.5.0 python=3.12,3.8,3.9,3.10,3.11,3.13
+default image=quay.io/ansible/default-test-container:10.5.0 python=3.12,3.8,3.9,3.10,3.11,3.13 context=collection
+default image=quay.io/ansible/ansible-core-test-container:10.5.0 python=3.12,3.8,3.9,3.10,3.11,3.13 context=ansible-core
+alpine320 image=quay.io/ansible/alpine320-test-container:8.1.0 python=3.12 cgroup=none audit=none
+fedora40 image=quay.io/ansible/fedora40-test-container:8.1.0 python=3.12
+ubuntu2204 image=quay.io/ansible/ubuntu2204-test-container:8.1.0 python=3.10
+ubuntu2404 image=quay.io/ansible/ubuntu2404-test-container:8.1.0 python=3.12

ansible_test/_data/completion/remote.txt

@@ -1,13 +1,14 @@
-alpine/3.19 python=3.11 become=doas_sudo provider=aws arch=x86_64
+alpine/3.20 python=3.12 become=doas_sudo provider=aws arch=x86_64
 alpine become=doas_sudo provider=aws arch=x86_64
-fedora/39 python=3.12 become=sudo provider=aws arch=x86_64
+fedora/40 python=3.12 become=sudo provider=aws arch=x86_64
 fedora become=sudo provider=aws arch=x86_64
 freebsd/13.3 python=3.9,3.11 python_dir=/usr/local/bin become=su_sudo provider=aws arch=x86_64
-freebsd/14.0 python=3.9,3.11 python_dir=/usr/local/bin become=su_sudo provider=aws arch=x86_64
+freebsd/14.1 python=3.9,3.11 python_dir=/usr/local/bin become=su_sudo provider=aws arch=x86_64
 freebsd python_dir=/usr/local/bin become=su_sudo provider=aws arch=x86_64
 macos/14.3 python=3.11 python_dir=/usr/local/bin become=sudo provider=parallels arch=x86_64
 macos python_dir=/usr/local/bin become=sudo provider=parallels arch=x86_64
-rhel/9.3 python=3.9,3.11 become=sudo provider=aws arch=x86_64
+rhel/9.4 python=3.9,3.12 become=sudo provider=aws arch=x86_64
 rhel become=sudo provider=aws arch=x86_64
 ubuntu/22.04 python=3.10 become=sudo provider=aws arch=x86_64
+ubuntu/24.04 python=3.12 become=sudo provider=aws arch=x86_64
 ubuntu become=sudo provider=aws arch=x86_64

ansible_test/_data/completion/windows.txt

@@ -1,4 +1,4 @@
-windows/2016 provider=aws arch=x86_64
-windows/2019 provider=aws arch=x86_64
-windows/2022 provider=aws arch=x86_64
-windows provider=aws arch=x86_64
+windows/2016 provider=aws arch=x86_64 connection=winrm+http
+windows/2019 provider=aws arch=x86_64 connection=winrm+https
+windows/2022 provider=aws arch=x86_64 connection=winrm+https
+windows provider=aws arch=x86_64 connection=winrm+https

ansible_test/_data/requirements/ansible-test.txt

@@ -1,3 +1,2 @@
 # The test-constraints sanity test verifies this file, but changes must be made manually to keep it in up-to-date.
-coverage == 7.3.2 ; python_version >= '3.8' and python_version <= '3.12'
-coverage == 6.5.0 ; python_version >= '3.7' and python_version <= '3.7'
+coverage == 7.6.1 ; python_version >= '3.8' and python_version <= '3.13'

ansible_test/_data/requirements/constraints.txt

@@ -1,8 +1,7 @@
 # do not add a cryptography or pyopenssl constraint to this file, they require special handling, see get_cryptography_requirements in python_requirements.py
 # do not add a coverage constraint to this file, it is handled internally by ansible-test
 pypsrp < 1.0.0  # in case the next major version is too big of a change
-pywinrm >= 0.3.0 ; python_version < '3.11' # message encryption support
-pywinrm >= 0.4.3 ; python_version >= '3.11' # support for Python 3.11
+pywinrm >= 0.5.0  # support for WSManFaultError and type annotation
 pytest >= 4.5.0  # pytest 4.5.0 added support for --strict-markers
 ntlm-auth >= 1.3.0 # message encryption support using cryptography
 requests-ntlm >= 1.1.0 # message encryption support

ansible_test/_data/requirements/sanity.ansible-doc.txt

@@ -1,5 +1,5 @@
 # edit "sanity.ansible-doc.in" and generate with: hacking/update-sanity-requirements.py --test ansible-doc
-Jinja2==3.1.3
+Jinja2==3.1.4
 MarkupSafe==2.1.5
-packaging==24.0
-PyYAML==6.0.1
+packaging==24.1
+PyYAML==6.0.2

ansible_test/_data/requirements/sanity.changelog.in

@@ -1,2 +1,2 @@
 rstcheck < 6  # newer versions have too many dependencies
-antsibull-changelog
+antsibull-changelog == 0.29.0  # newer versions have additional dependencies

ansible_test/_data/requirements/sanity.changelog.txt

@@ -1,9 +1,9 @@
 # edit "sanity.changelog.in" and generate with: hacking/update-sanity-requirements.py --test changelog
-antsibull-changelog==0.26.0
+antsibull-changelog==0.29.0
 docutils==0.18.1
-packaging==24.0
-PyYAML==6.0.1
+packaging==24.1
+PyYAML==6.0.2
 rstcheck==5.0.0
 semantic-version==2.10.0
 types-docutils==0.18.3
-typing_extensions==4.10.0
+typing_extensions==4.12.2

ansible_test/_data/requirements/sanity.import.plugin.txt

@@ -1,4 +1,4 @@
 # edit "sanity.import.plugin.in" and generate with: hacking/update-sanity-requirements.py --test import.plugin
-Jinja2==3.1.3
+Jinja2==3.1.4
 MarkupSafe==2.1.5
-PyYAML==6.0.1
+PyYAML==6.0.2

ansible_test/_data/requirements/sanity.import.txt

@@ -1,2 +1,2 @@
 # edit "sanity.import.in" and generate with: hacking/update-sanity-requirements.py --test import
-PyYAML==6.0.1
+PyYAML==6.0.2

ansible_test/_data/requirements/sanity.integration-aliases.txt

@@ -1,2 +1,2 @@
 # edit "sanity.integration-aliases.in" and generate with: hacking/update-sanity-requirements.py --test integration-aliases
-PyYAML==6.0.1
+PyYAML==6.0.2

ansible_test/_data/requirements/sanity.pep8.txt

@@ -1,2 +1,2 @@
 # edit "sanity.pep8.in" and generate with: hacking/update-sanity-requirements.py --test pep8
-pycodestyle==2.11.1
+pycodestyle==2.12.1

ansible_test/_data/requirements/sanity.pylint.txt

@@ -1,11 +1,9 @@
 # edit "sanity.pylint.in" and generate with: hacking/update-sanity-requirements.py --test pylint
-astroid==3.1.0
+astroid==3.2.4
 dill==0.3.8
 isort==5.13.2
 mccabe==0.7.0
-platformdirs==4.2.0
-pylint==3.1.0
-PyYAML==6.0.1
-tomli==2.0.1
-tomlkit==0.12.4
-typing_extensions==4.10.0
+platformdirs==4.3.2
+pylint==3.2.7
+PyYAML==6.0.2
+tomlkit==0.13.2

ansible_test/_data/requirements/sanity.runtime-metadata.txt

@@ -1,3 +1,3 @@
 # edit "sanity.runtime-metadata.in" and generate with: hacking/update-sanity-requirements.py --test runtime-metadata
-PyYAML==6.0.1
-voluptuous==0.14.2
+PyYAML==6.0.2
+voluptuous==0.15.2

ansible_test/_data/requirements/sanity.validate-modules.txt

@@ -1,6 +1,6 @@
 # edit "sanity.validate-modules.in" and generate with: hacking/update-sanity-requirements.py --test validate-modules
 antsibull-docs-parser==1.0.0
-Jinja2==3.1.3
+Jinja2==3.1.4
 MarkupSafe==2.1.5
-PyYAML==6.0.1
-voluptuous==0.14.2
+PyYAML==6.0.2
+voluptuous==0.15.2

ansible_test/_data/requirements/sanity.yamllint.in

@@ -1 +1,2 @@
+pyyaml
 yamllint

ansible_test/_data/requirements/sanity.yamllint.txt

@@ -1,4 +1,4 @@
 # edit "sanity.yamllint.in" and generate with: hacking/update-sanity-requirements.py --test yamllint
 pathspec==0.12.1
-PyYAML==6.0.1
+PyYAML==6.0.2
 yamllint==1.35.1

ansible_test/_internal/ansible_util.py

@@ -11,10 +11,6 @@ from .constants import (
     SOFT_RLIMIT_NOFILE,
 )
 
-from .io import (
-    write_text_file,
-)
-
 from .util import (
     common_environment,
     ApplicationError,
@@ -25,7 +21,6 @@ from .util import (
     ANSIBLE_SOURCE_ROOT,
     ANSIBLE_TEST_TOOLS_ROOT,
     MODE_FILE_EXECUTE,
-    get_ansible_version,
     raw_command,
     verified_chmod,
 )
@@ -115,14 +110,16 @@ def ansible_environment(args: CommonConfig, color: bool = True, ansible_config:
         # enabled even when not using code coverage to surface warnings when worker processes do not exit cleanly
         ANSIBLE_WORKER_SHUTDOWN_POLL_COUNT='100',
         ANSIBLE_WORKER_SHUTDOWN_POLL_DELAY='0.1',
+        # ansible-test specific environment variables require an 'ANSIBLE_TEST_' prefix to distinguish them from ansible-core env vars defined by config
+        ANSIBLE_TEST_ANSIBLE_LIB_ROOT=ANSIBLE_LIB_ROOT,  # used by the coverage injector
     )
 
     if isinstance(args, IntegrationConfig) and args.coverage:
-        # standard path injection is not effective for ansible-connection, instead the location must be configured
-        # ansible-connection only requires the injector for code coverage
+        # standard path injection is not effective for the persistent connection helper, instead the location must be configured
+        # it only requires the injector for code coverage
         # the correct python interpreter is already selected using the sys.executable used to invoke ansible
         ansible.update(
-            ANSIBLE_CONNECTION_PATH=os.path.join(get_injector_path(), 'ansible-connection'),
+            _ANSIBLE_CONNECTION_PATH=os.path.join(get_injector_path(), 'ansible_connection_cli_stub.py'),
         )
 
     if isinstance(args, PosixIntegrationConfig):
@@ -249,12 +246,15 @@ def get_cli_path(path: str) -> str:
     raise RuntimeError(path)
 
 
+# noinspection PyUnusedLocal
 @mutex
 def get_ansible_python_path(args: CommonConfig) -> str:
     """
     Return a directory usable for PYTHONPATH, containing only the ansible package.
     If a temporary directory is required, it will be cached for the lifetime of the process and cleaned up at exit.
     """
+    del args  # not currently used
+
     try:
         return get_ansible_python_path.python_path  # type: ignore[attr-defined]
     except AttributeError:
@@ -271,38 +271,11 @@ def get_ansible_python_path(args: CommonConfig) -> str:
 
         os.symlink(ANSIBLE_LIB_ROOT, os.path.join(python_path, 'ansible'))
 
-    if not args.explain:
-        generate_egg_info(python_path)
-
     get_ansible_python_path.python_path = python_path  # type: ignore[attr-defined]
 
     return python_path
 
 
-def generate_egg_info(path: str) -> None:
-    """Generate an egg-info in the specified base directory."""
-    # minimal PKG-INFO stub following the format defined in PEP 241
-    # required for older setuptools versions to avoid a traceback when importing pkg_resources from packages like cryptography
-    # newer setuptools versions are happy with an empty directory
-    # including a stub here means we don't need to locate the existing file or run any tools to generate it when running from source
-    pkg_info = '''
-Metadata-Version: 1.0
-Name: ansible
-Version: %s
-Platform: UNKNOWN
-Summary: Radically simple IT automation
-Author-email: info@ansible.com
-License: GPLv3+
-''' % get_ansible_version()
-
-    pkg_info_path = os.path.join(path, 'ansible_core.egg-info', 'PKG-INFO')
-
-    if os.path.exists(pkg_info_path):
-        return
-
-    write_text_file(pkg_info_path, pkg_info.lstrip(), create_directories=True)
-
-
 class CollectionDetail:
     """Collection detail."""
 

ansible_test/_internal/ci/azp.py

@@ -221,7 +221,7 @@ class AzurePipelinesChanges:
             self.diff = []
 
     def get_successful_merge_run_commits(self) -> set[str]:
-        """Return a set of recent successsful merge commits from Azure Pipelines."""
+        """Return a set of recent successful merge commits from Azure Pipelines."""
         parameters = dict(
             maxBuildsPerDefinition=100,  # max 5000
             queryOrder='queueTimeDescending',  # assumes under normal circumstances that later queued jobs are for later commits

ansible_test/_internal/classification/__init__.py

@@ -834,8 +834,6 @@ class PathMapper:
                 'MANIFEST.in',
                 'pyproject.toml',
                 'requirements.txt',
-                'setup.cfg',
-                'setup.py',
             ):
                 return packaging
 

ansible_test/_internal/cli/parsers/key_value_parsers.py

@@ -17,6 +17,7 @@ from ...completion import (
 
 from ...util import (
     REMOTE_ARCHITECTURES,
+    WINDOWS_CONNECTIONS,
 )
 
 from ...host_configs import (
@@ -177,6 +178,7 @@ class WindowsRemoteKeyValueParser(KeyValueParser):
         return dict(
             provider=ChoicesParser(REMOTE_PROVIDERS),
             arch=ChoicesParser(REMOTE_ARCHITECTURES),
+            connection=ChoicesParser(WINDOWS_CONNECTIONS),
         )
 
     def document(self, state: DocumentationState) -> t.Optional[str]:
@@ -186,6 +188,7 @@ class WindowsRemoteKeyValueParser(KeyValueParser):
         state.sections[f'target {section_name} (comma separated):'] = '\n'.join([
             f'  provider={ChoicesParser(REMOTE_PROVIDERS).document(state)}',
             f'  arch={ChoicesParser(REMOTE_ARCHITECTURES).document(state)}',
+            f'  connection={ChoicesParser(WINDOWS_CONNECTIONS).document(state)}',
         ])
 
         return f'{{{section_name}}}'

ansible_test/_internal/commands/integration/cloud/hcloud.py

@@ -78,7 +78,7 @@ class HcloudCloudProvider(CloudProvider):
         self._write_config(config)
 
     def _create_ansible_core_ci(self) -> AnsibleCoreCI:
-        """Return a Heztner instance of AnsibleCoreCI."""
+        """Return a Hetzner instance of AnsibleCoreCI."""
         return AnsibleCoreCI(self.args, CloudResource(platform='hetzner'))
 
 

ansible_test/_internal/commands/integration/cloud/httptester.py

@@ -31,7 +31,7 @@ class HttptesterProvider(CloudProvider):
     def __init__(self, args: IntegrationConfig) -> None:
         super().__init__(args)
 
-        self.image = os.environ.get('ANSIBLE_HTTP_TEST_CONTAINER', 'quay.io/ansible/http-test-container:2.1.0')
+        self.image = os.environ.get('ANSIBLE_HTTP_TEST_CONTAINER', 'quay.io/ansible/http-test-container:3.2.0')
 
         self.uses_docker = True
 

ansible_test/_internal/commands/integration/cloud/nios.py

@@ -28,7 +28,7 @@ class NiosProvider(CloudProvider):
     #
     # It's source source itself resides at:
     # https://github.com/ansible/nios-test-container
-    DOCKER_IMAGE = 'quay.io/ansible/nios-test-container:3.0.0'
+    DOCKER_IMAGE = 'quay.io/ansible/nios-test-container:5.0.0'
 
     def __init__(self, args: IntegrationConfig) -> None:
         super().__init__(args)

ansible_test/_internal/commands/sanity/__init__.py

@@ -209,9 +209,7 @@ def command_sanity(args: SanityConfig) -> None:
                 result.reason = f'Skipping sanity test "{test.name}" on Python {version} because it is unsupported.' \
                                 f' Supported Python versions: {", ".join(test.supported_python_versions)}'
             else:
-                if isinstance(test, SanityCodeSmellTest):
-                    settings = test.load_processor(args)
-                elif isinstance(test, SanityMultipleVersion):
+                if isinstance(test, SanityMultipleVersion):
                     settings = test.load_processor(args, version)
                 elif isinstance(test, SanitySingleVersion):
                     settings = test.load_processor(args)
@@ -327,7 +325,7 @@ def collect_code_smell_tests() -> tuple[SanityTest, ...]:
         skip_tests = read_lines_without_comments(os.path.join(ansible_code_smell_root, 'skip.txt'), remove_blank_lines=True, optional=True)
         paths.extend(path for path in glob.glob(os.path.join(ansible_code_smell_root, '*.py')) if os.path.basename(path) not in skip_tests)
 
-    tests = tuple(SanityCodeSmellTest(p) for p in paths)
+    tests = tuple(SanityScript.create(p) for p in paths)
 
     return tests
 
@@ -829,21 +827,34 @@ class SanitySingleVersion(SanityTest, metaclass=abc.ABCMeta):
         return SanityIgnoreProcessor(args, self, None)
 
 
-class SanityCodeSmellTest(SanitySingleVersion):
-    """Sanity test script."""
+class SanityScript(SanityTest, metaclass=abc.ABCMeta):
+    """Base class for sanity test scripts."""
 
-    def __init__(self, path) -> None:
+    @classmethod
+    def create(cls, path: str) -> SanityScript:
+        """Create and return a SanityScript instance from the given path."""
         name = os.path.splitext(os.path.basename(path))[0]
         config_path = os.path.splitext(path)[0] + '.json'
 
+        if os.path.exists(config_path):
+            config = read_json_file(config_path)
+        else:
+            config = None
+
+        instance: SanityScript
+
+        if config.get('multi_version'):
+            instance = SanityScriptMultipleVersion(name=name, path=path, config=config)
+        else:
+            instance = SanityScriptSingleVersion(name=name, path=path, config=config)
+
+        return instance
+
+    def __init__(self, name: str, path: str, config: dict[str, t.Any] | None) -> None:
         super().__init__(name=name)
 
         self.path = path
-        self.config_path = config_path if os.path.exists(config_path) else None
-        self.config = None
-
-        if self.config_path:
-            self.config = read_json_file(self.config_path)
+        self.config = config
 
         if self.config:
             self.enabled = not self.config.get('disabled')
@@ -854,6 +865,8 @@ class SanityCodeSmellTest(SanitySingleVersion):
             self.files: list[str] = self.config.get('files')
             self.text: t.Optional[bool] = self.config.get('text')
             self.ignore_self: bool = self.config.get('ignore_self')
+            self.controller_only: bool = self.config.get('controller_only')
+            self.min_max_python_only: bool = self.config.get('min_max_python_only')
             self.minimum_python_version: t.Optional[str] = self.config.get('minimum_python_version')
             self.maximum_python_version: t.Optional[str] = self.config.get('maximum_python_version')
 
@@ -869,6 +882,8 @@ class SanityCodeSmellTest(SanitySingleVersion):
             self.files = []
             self.text = None
             self.ignore_self = False
+            self.controller_only = False
+            self.min_max_python_only = False
             self.minimum_python_version = None
             self.maximum_python_version = None
 
@@ -925,12 +940,18 @@ class SanityCodeSmellTest(SanitySingleVersion):
         """A tuple of supported Python versions or None if the test does not depend on specific Python versions."""
         versions = super().supported_python_versions
 
+        if self.controller_only:
+            versions = tuple(version for version in versions if version in CONTROLLER_PYTHON_VERSIONS)
+
         if self.minimum_python_version:
             versions = tuple(version for version in versions if str_to_version(version) >= str_to_version(self.minimum_python_version))
 
         if self.maximum_python_version:
             versions = tuple(version for version in versions if str_to_version(version) <= str_to_version(self.maximum_python_version))
 
+        if self.min_max_python_only:
+            versions = versions[0], versions[-1]
+
         return versions
 
     def filter_targets(self, targets: list[TestTarget]) -> list[TestTarget]:
@@ -960,17 +981,29 @@ class SanityCodeSmellTest(SanitySingleVersion):
 
         return targets
 
-    def test(self, args: SanityConfig, targets: SanityTargets, python: PythonConfig) -> TestResult:
+    def test_script(self, args: SanityConfig, targets: SanityTargets, virtualenv_python: PythonConfig, python: PythonConfig) -> TestResult:
         """Run the sanity test and return the result."""
-        cmd = [python.path, self.path]
+        cmd = [virtualenv_python.path, self.path]
 
         env = ansible_environment(args, color=False)
-        env.update(PYTHONUTF8='1')  # force all code-smell sanity tests to run with Python UTF-8 Mode enabled
+
+        env.update(
+            PYTHONUTF8='1',  # force all code-smell sanity tests to run with Python UTF-8 Mode enabled
+            ANSIBLE_TEST_TARGET_PYTHON_VERSION=python.version,
+            ANSIBLE_TEST_CONTROLLER_PYTHON_VERSIONS=','.join(CONTROLLER_PYTHON_VERSIONS),
+            ANSIBLE_TEST_REMOTE_ONLY_PYTHON_VERSIONS=','.join(REMOTE_ONLY_PYTHON_VERSIONS),
+        )
+
+        if self.min_max_python_only:
+            min_python, max_python = self.supported_python_versions
+
+            env.update(ANSIBLE_TEST_MIN_PYTHON=min_python)
+            env.update(ANSIBLE_TEST_MAX_PYTHON=max_python)
 
         pattern = None
         data = None
 
-        settings = self.load_processor(args)
+        settings = self.conditionally_load_processor(args, python.version)
 
         paths = [target.path for target in targets.include]
 
@@ -991,7 +1024,7 @@ class SanityCodeSmellTest(SanitySingleVersion):
                 display.info(data, verbosity=4)
 
         try:
-            stdout, stderr = intercept_python(args, python, cmd, data=data, env=env, capture=True)
+            stdout, stderr = intercept_python(args, virtualenv_python, cmd, data=data, env=env, capture=True)
             status = 0
         except SubprocessError as ex:
             stdout = ex.stdout
@@ -1031,9 +1064,9 @@ class SanityCodeSmellTest(SanitySingleVersion):
 
         return SanitySuccess(self.name)
 
-    def load_processor(self, args: SanityConfig) -> SanityIgnoreProcessor:
+    @abc.abstractmethod
+    def conditionally_load_processor(self, args: SanityConfig, python_version: str) -> SanityIgnoreProcessor:
         """Load the ignore processor for this sanity test."""
-        return SanityIgnoreProcessor(args, self, None)
 
 
 class SanityVersionNeutral(SanityTest, metaclass=abc.ABCMeta):
@@ -1094,6 +1127,50 @@ class SanityMultipleVersion(SanityTest, metaclass=abc.ABCMeta):
         return targets
 
 
+class SanityScriptSingleVersion(SanityScript, SanitySingleVersion):
+    """External sanity test script which should run on a single python version."""
+
+    def test(self, args: SanityConfig, targets: SanityTargets, python: PythonConfig) -> TestResult:
+        """Run the sanity test and return the result."""
+        return super().test_script(args, targets, python, python)
+
+    def conditionally_load_processor(self, args: SanityConfig, python_version: str) -> SanityIgnoreProcessor:
+        """Load the ignore processor for this sanity test."""
+        return SanityIgnoreProcessor(args, self, None)
+
+
+class SanityScriptMultipleVersion(SanityScript, SanityMultipleVersion):
+    """External sanity test script which should run on multiple python versions."""
+
+    def test(self, args: SanityConfig, targets: SanityTargets, python: PythonConfig) -> TestResult:
+        """Run the sanity test and return the result."""
+        multi_version = self.config['multi_version']
+
+        if multi_version == 'controller':
+            virtualenv_python_config = args.controller_python
+        elif multi_version == 'target':
+            virtualenv_python_config = python
+        else:
+            raise NotImplementedError(f'{multi_version=}')
+
+        virtualenv_python = create_sanity_virtualenv(args, virtualenv_python_config, self.name)
+
+        if not virtualenv_python:
+            result = SanitySkipped(self.name, python.version)
+            result.reason = f'Skipping sanity test "{self.name}" due to missing virtual environment support on Python {virtualenv_python_config.version}.'
+
+            return result
+
+        if args.prime_venvs:
+            return SanitySkipped(self.name, python.version)
+
+        return super().test_script(args, targets, virtualenv_python, python)
+
+    def conditionally_load_processor(self, args: SanityConfig, python_version: str) -> SanityIgnoreProcessor:
+        """Load the ignore processor for this sanity test."""
+        return SanityIgnoreProcessor(args, self, python_version)
+
+
 @cache
 def sanity_get_tests() -> tuple[SanityTest, ...]:
     """Return a tuple of the available sanity tests."""