Add ament_lint_auto_py and ament_lint_common_py

ament_clang_format/ament_clang_format/main.py

@@ -19,13 +19,35 @@
 import subprocess
 import sys
 import time
+from typing import Literal
 from xml.etree import ElementTree
 from xml.sax.saxutils import escape
 from xml.sax.saxutils import quoteattr
 
 import yaml
 
 
+class ClangFormatRunner:
+
+    NAME = 'ament_clang_format'
+    FILE_TYPES = (
+        '*.c',
+        '*.cc',
+        '*.cpp',
+        '*.cxx',
+        '*.h',
+        '*.hh',
+        '*.hpp',
+        '*.hxx',
+    )
+
+    def __init__(self, args: list[str]) -> None:
+        self.args = args
+
+    def __call__(self) -> Literal[0, 1]:
+        return main(self.args)
+
+
 def main(argv=sys.argv[1:]):
     config_file = os.path.join(
         os.path.dirname(__file__), 'configuration', '.clang-format')

ament_clang_format/setup.py

@@ -44,5 +44,8 @@
         'console_scripts': [
             'ament_clang_format = ament_clang_format.main:main',
         ],
+        'ament_lint': [
+            'ament_clang_format = ament_clang_format.main:ClangFormatRunner',
+        ],
     },
 )

ament_clang_tidy/ament_clang_tidy/main.py

@@ -24,13 +24,35 @@
 import subprocess
 import sys
 import time
+from typing import Literal
 
 from xml.sax.saxutils import escape
 from xml.sax.saxutils import quoteattr
 
 import yaml
 
 
+class ClangTidyRunner:
+
+    NAME = 'ament_clang_tidy'
+    FILE_TYPES = (
+        '*.c',
+        '*.cc',
+        '*.cpp',
+        '*.cxx',
+        '*.h',
+        '*.hh',
+        '*.hpp',
+        '*.hxx',
+    )
+
+    def __init__(self, args: list[str]) -> None:
+        self.args = args
+
+    def __call__(self) -> Literal[0, 1]:
+        return main(self.args)
+
+
 def main(argv=sys.argv[1:]):
     extensions = ['c', 'cc', 'cpp', 'cxx', 'h', 'hh', 'hpp', 'hxx']
 

ament_clang_tidy/setup.py

@@ -44,5 +44,8 @@
         'console_scripts': [
             'ament_clang_tidy = ament_clang_tidy.main:main',
         ],
+        'ament_lint': [
+            'ament_clang_tidy = ament_clang_tidy.main:ClangTidyRunner',
+        ],
     },
 )

ament_copyright/ament_copyright/main.py

@@ -18,6 +18,7 @@
 import re
 import sys
 import time
+from typing import Literal
 from xml.sax.saxutils import escape
 from xml.sax.saxutils import quoteattr
 
@@ -36,6 +37,20 @@
 from ament_copyright.parser import search_copyright_information
 
 
+class CopyrightRunner:
+
+    NAME = 'ament_copyright'
+    FILE_TYPES = (
+        '*',
+    )
+
+    def __init__(self, args: list[str]) -> None:
+        self.args = args
+
+    def __call__(self) -> Literal[0, 1]:
+        return main(self.args)
+
+
 def main(argv=sys.argv[1:]):
     extensions = [
         'c', 'cc', 'cpp', 'cxx', 'h', 'hh', 'hpp', 'hxx',

ament_copyright/setup.py

@@ -58,5 +58,8 @@
         'pytest11': [
             'ament_copyright = ament_copyright.pytest_marker',
         ],
+        'ament_lint': [
+            'ament_copyright = ament_copyright.main:CopyrightRunner',
+        ],
     },
 )

ament_cppcheck/ament_cppcheck/main.py

@@ -22,6 +22,7 @@
 import subprocess
 import sys
 import time
+from typing import Literal
 from xml.etree import ElementTree
 from xml.sax.saxutils import escape
 from xml.sax.saxutils import quoteattr
@@ -51,6 +52,27 @@ def get_cppcheck_version(cppcheck_bin):
     return tokens[1]
 
 
+class CPPCheckRunner:
+
+    NAME = 'ament_cppcheck'
+    FILE_TYPES = (
+        '*.c',
+        '*.cc',
+        '*.cpp',
+        '*.cxx',
+        '*.h',
+        '*.hh',
+        '*.hpp',
+        '*.hxx',
+    )
+
+    def __init__(self, args: list[str]) -> None:
+        self.args = args
+
+    def __call__(self) -> Literal[0, 1]:
+        return main(self.args)
+
+
 def main(argv=sys.argv[1:]):
     extensions = ['c', 'cc', 'cpp', 'cxx', 'h', 'hh', 'hpp', 'hxx']
 

ament_cppcheck/setup.py

@@ -40,5 +40,8 @@
         'console_scripts': [
             'ament_cppcheck = ament_cppcheck.main:main',
         ],
+        'ament_lint': [
+            'ament_cppcheck = ament_cppcheck.main:CPPCheckRunner',
+        ],
     },
 )

ament_cpplint/ament_cpplint/main.py

@@ -21,6 +21,7 @@
 import re
 import sys
 import time
+from typing import Literal
 from xml.sax.saxutils import escape
 from xml.sax.saxutils import quoteattr
 
@@ -69,6 +70,27 @@ def custom_get_header_guard_cpp_variable(filename):
 cpplint.GetHeaderGuardCPPVariable = custom_get_header_guard_cpp_variable
 
 
+class CPPLintRunner:
+
+    NAME = 'ament_cpplint'
+    FILE_TYPES = (
+        '*.c',
+        '*.cc',
+        '*.cpp',
+        '*.cxx',
+        '*.h',
+        '*.hh',
+        '*.hpp',
+        '*.hxx',
+    )
+
+    def __init__(self, args: list[str]) -> None:
+        self.args = args
+
+    def __call__(self) -> Literal[0, 1]:
+        return main(self.args)
+
+
 def main(argv=sys.argv[1:]):
     extensions = ['c', 'cc', 'cpp', 'cxx']
     headers = ['h', 'hh', 'hpp', 'hxx']

ament_cpplint/setup.py

@@ -40,5 +40,8 @@
         'console_scripts': [
             'ament_cpplint = ament_cpplint.main:main',
         ],
+        'ament_lint': [
+            'ament_cpplint = ament_cpplint.main:CPPLintRunner',
+        ],
     },
 )

ament_flake8/ament_flake8/main.py

@@ -18,6 +18,7 @@
 import os
 import sys
 import time
+from typing import Literal
 from xml.sax.saxutils import escape
 from xml.sax.saxutils import quoteattr
 
@@ -27,6 +28,18 @@
 from flake8.main import options as flake8_options
 
 
+class Flake8Runner:
+
+    NAME = 'ament_flake8'
+    FILE_TYPES = ('*.py', )
+
+    def __init__(self, args: list[str]) -> None:
+        self.args = args
+
+    def __call__(self) -> Literal[0, 1]:
+        return main(self.args)
+
+
 def main(argv=sys.argv[1:]):
     rc, _ = main_with_errors(argv=argv)
     return rc

ament_flake8/setup.py

@@ -45,5 +45,8 @@
         'pytest11': [
             'ament_flake8 = ament_flake8.pytest_marker',
         ],
+        'ament_lint': [
+            'ament_flake8 = ament_flake8.main:Flake8Runner',
+        ],
     },
 )

ament_lint_auto_py/CHANGELOG.rst

@@ -0,0 +1,3 @@
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Changelog for package ament_lint_auto_py
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ament_lint_auto_py/ament_lint_auto_py/pytest_plugin.py

@@ -0,0 +1,120 @@
+# Copyright 2026 Open Source Robotics Foundation, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from importlib.metadata import entry_points
+from importlib.metadata import EntryPoint
+from pathlib import Path
+from typing import Literal
+
+from ament_lint_auto_py.xml_helpers import find_package_xml
+from ament_lint_auto_py.xml_helpers import get_depends_recursive
+from ament_lint_auto_py.xml_helpers import package_has_ament_lint_auto_py
+from pytest import Config
+from pytest import Item
+from pytest import Parser
+from pytest import Session
+
+
+def pytest_configure(config: Config) -> None:
+    config.addinivalue_line(
+        'markers', 'ament_lint_auto_py: marks tests as running all linter checks'
+    )
+
+
+class AmentLintItem(Item):
+    def __init__(
+        self,
+        *,
+        entry_point: EntryPoint,
+        file_excludes: list[str],
+        **kwargs,
+    ) -> None:
+        super().__init__(**kwargs)
+        self.entry_point = entry_point
+        self.file_excludes = file_excludes
+
+    def runtest(self) -> None:
+        runner = self.entry_point.load()
+
+        args: list[str] = []
+        if self.file_excludes:
+            args.append('--exclude')
+            args.extend(self.file_excludes)
+
+        rc = runner(args)()
+        if rc != 0:
+            raise AssertionError(
+                f'Linter[{runner.NAME}] failed with exit code {rc}'
+            )
+
+    def reportinfo(self) -> tuple[Path, Literal[0], str]:
+        return self.path, 0, f'ament_lint: {self.name}'
+
+
+def pytest_collection_modifyitems(session: Session, config: Config, items: list[Item]) -> None:
+    excluded = set(config.getini('ament_lint_auto_exclude'))
+    file_excludes = config.getini('ament_lint_auto_file_exclude')
+
+    pkg_xml = find_package_xml(config.rootpath)
+    if pkg_xml is None:
+        return  # Not in a ROS package
+
+    if not package_has_ament_lint_auto_py(pkg_xml):
+        return  # Package does not opt-in
+
+    effective_depends = get_depends_recursive(pkg_xml)
+    linters = entry_points(group='ament_lint')
+
+    for ep in linters:
+        runner = ep.load()
+
+        if runner.NAME not in effective_depends:
+            continue  # skipping linter if not declared in depends of a package.xmk
+
+        if runner.NAME in excluded:
+            continue  # skipping linter if declared in ament_lint_auto_exclude
+
+        # skip linters if no matching files exist
+        found_file = False
+        for pattern in runner.FILE_TYPES:
+            if any(Path('.').rglob(pattern)):
+                found_file = True
+                break
+        if not found_file:
+            continue
+
+        items.append(
+            AmentLintItem.from_parent(
+                parent=session,
+                name=runner.NAME,
+                entry_point=ep,
+                file_excludes=file_excludes,
+                path=config.rootpath,
+            )
+        )
+
+
+def pytest_addoption(parser: Parser):
+    parser.addini(
+        'ament_lint_auto_exclude',
+        'Linters to exclude from ament_lint_auto_py',
+        type='linelist',
+        default=[],
+    )
+    parser.addini(
+        'ament_lint_auto_file_exclude',
+        'File globs to exclude from ament linters',
+        type='linelist',
+        default=[],
+    )