Update black

Change the versioning scheme to pin to the year. According to the
documentation that is the stability cadence of the style.

Author: mdellweg

.github/workflows/lint.yml

@@ -30,7 +30,7 @@ jobs:
       - name: "Lint plugin_template"
         working-directory: "plugin_template"
         run: |
-          pip3 install black==24.3.0 flake8
+          pip3 install black~=26.3 flake8
           black --version
           black --check --diff plugin-template utils.py
           flake8 plugin-template utils.py

plugin-template

@@ -2,9 +2,10 @@
 # /// script
 # requires-python = ">=3.11"
 # dependencies = [
-#     "black==24.3.0",
+#     "black~=26.3",
 #     "jamldump>=1.2.0,<1.3.0",
 #     "jinja2>=3.1.6,<3.2.0",
+#     "packaging>=26.0,<27",
 #     "pyyaml>=6.0.3,<6.1.0",
 #     "requests~=2.32.3",
 #     "requests-cache>=1.3.0,<1.4.0",
@@ -378,7 +379,7 @@ def write_template_section(
         "current_version": utils.current_version(plugin_root_dir),
         "pulpdocs_branch": PULPDOCS_BRANCH,
         "is_pulpdocs_member": config["plugin_name"] in utils.get_pulpdocs_members(PULPDOCS_BRANCH),
-        "black_version": utils.black_version(),
+        "black_requirement": utils.black_requirement(),
         "config": config,
         **config,
     }

requirements.txt

@@ -1,7 +1,8 @@
-# This needs to match the version in templates/github/lint_requirement.txt.j2
-black==24.3.0
+# This (black) is copied into templates/github/lint_requirement.txt.j2
+black~=26.3  # Pin style to the year. https://black.readthedocs.io/en/stable/faq.html#how-stable-is-black-s-style
 jamldump>=1.2.0,<1.3.0
 jinja2
+packaging>=26.0,<27
 pyyaml
 requests~=2.32.3
 requests_cache

templates/github/lint_requirements.txt.j2

@@ -1,7 +1,7 @@
 {% include 'header.j2' %}
 
 {% if black -%}
-black=={{ black_version }}
+{{ black_requirement }}
 {% endif -%}
 bump-my-version
 check-manifest

utils.py

@@ -1,4 +1,7 @@
+import contextlib
+
 from datetime import timedelta
+from packaging.requirements import Requirement, InvalidRequirement
 from pathlib import Path
 import re
 import stat
@@ -94,12 +97,13 @@ def current_version(plugin_root_path):
     return current_version
 
 
-def black_version():
-    PATTERN = re.compile(r"^black==(?P<version>.*)$")
+def black_requirement():
     requirements_file = Path(__file__).parent / "requirements.txt"
     for line in requirements_file.read_text().splitlines():
-        if match := PATTERN.fullmatch(line):
-            return match.group("version")
+        with contextlib.suppress(InvalidRequirement):
+            requirement = Requirement(line.split("#")[0])
+            if requirement.name.lower() == "black":
+                return line
 
     raise ValueError("'black' not found in 'requirements.txt'")