./.../beman-submodule update --remote

Author: ClausKlein

infra/.beman_submodule

@@ -1,3 +1,3 @@
 [beman_submodule]
 remote=https://github.com/bemanproject/infra.git
-commit_hash=78de7eb4ff54bd12c9abb790107edc86bcda07d8
+commit_hash=8e80cc3049fcc450805349da381edddd7a920dff

infra/tools/beman-tidy/beman_tidy/lib/checks/beman_standard/readme.py

@@ -72,10 +72,42 @@ def fix(self):
         pass
 
 
-# TODO README.PURPOSE
+@register_beman_standard_check("README.IMPLEMENTS")
+class ReadmeImplementsCheck(ReadmeBaseCheck):
+    def __init__(self, repo_info, beman_standard_check_config):
+        super().__init__(repo_info, beman_standard_check_config)
+
+    def check(self):
+        lines = self.read_lines_strip()
 
+        # Match the pattern to start with "Implements:" and then have a paper reference and a wg21.link URL.
+        # Examples of valid lines:
+        # **Implements**: [Standard Library Concepts (P0898R3)](https://wg21.link/P0898R3).
+        # **Implements**: [Give *std::optional* Range Support (P3168R2)](https://wg21.link/P3168R2) and [`std::optional<T&>` (P2988R5)](https://wg21.link/P2988R5)
+        # **Implements**: [.... (PxyzwRr)](https://wg21.link/PxyzwRr), [.... (PabcdRr)](https://wg21.link/PabcdRr), and [.... (PijklRr)](https://wg21.link/PijklRr),
+        regex = r"^\*\*Implements\*\*:\s+.*\bP\d{4}R\d+\b.*wg21\.link/\S+"
+
+        # Count how many lines match the regex
+        implement_lines = 0
+        for line in lines:
+            if re.match(regex, line):
+                implement_lines += 1
+
+        # If there is exactly one "Implements:" line, it is valid
+        if implement_lines == 1:
+            return True
+
+        # Invalid/missing/duplicate "Implements:" line
+        self.log(
+            f"Invalid/missing/duplicate 'Implements:' line in '{self.path}'. See https://github.com/bemanproject/beman/blob/main/docs/BEMAN_STANDARD.md#readmeimplements for more information."
+        )
+        return False
 
-# TODO README.IMPLEMENTS
+    def fix(self):
+        self.log(
+            "Please write a Implements line in README.md file. See https://github.com/bemanproject/beman/blob/main/docs/BEMAN_STANDARD.md#readmeimplements for the desired format."
+        )
+        return False
 
 
 @register_beman_standard_check("README.LIBRARY_STATUS")

infra/tools/beman-tidy/tests/lib/checks/beman_standard/readme/test_readme.py

@@ -13,6 +13,7 @@
 from beman_tidy.lib.checks.beman_standard.readme import (
     ReadmeTitleCheck,
     ReadmeBadgesCheck,
+    ReadmeImplementsCheck,
     ReadmeLibraryStatusCheck,
 )
 
@@ -130,6 +131,55 @@ def test__README_BADGES__fix_inplace(repo_info, beman_standard_check_config):
     pass
 
 
+def test__README_IMPLEMENTS__valid(repo_info, beman_standard_check_config):
+    """
+    Test that a valid README.md "Implements" passes the check
+    """
+    valid_readme_paths = [
+        Path(f"{valid_prefix}/README-v1.md"),
+        Path(f"{valid_prefix}/README-v2.md"),
+        Path(f"{valid_prefix}/README-v3.md"),
+        Path(f"{valid_prefix}/README-v4.md"),
+    ]
+
+    run_check_for_each_path(
+        True,
+        valid_readme_paths,
+        ReadmeImplementsCheck,
+        repo_info,
+        beman_standard_check_config,
+    )
+
+
+def test__README_IMPLEMENTS__invalid(repo_info, beman_standard_check_config):
+    """
+    Test that an invalid README.md "Implements" fails the check
+    """
+    invalid_readme_paths = [
+        Path(f"{invalid_prefix}/invalid.md"),
+        Path(f"{invalid_prefix}/invalid-implements-v1.md"),
+        Path(f"{invalid_prefix}/invalid-implements-v2.md"),
+        Path(f"{invalid_prefix}/invalid-implements-v3.md"),
+        Path(f"{invalid_prefix}/invalid-implements-v4.md"),
+    ]
+
+    run_check_for_each_path(
+        False,
+        invalid_readme_paths,
+        ReadmeImplementsCheck,
+        repo_info,
+        beman_standard_check_config,
+    )
+
+
+@pytest.mark.skip(reason="NOT implemented")
+def test__README_IMPLEMENTS__fix_inplace(repo_info, beman_standard_check_config):
+    """
+    Test that the fix method corrects an invalid README.md "Implements"
+    """
+    pass
+
+
 def test__README_LIBRARY_STATUS__valid(repo_info, beman_standard_check_config):
     """
     Test that a valid README.md library status passes the check.