proj-flow 0.19.0__py3-none-any.whl → 0.20.1__py3-none-any.whl

proj_flow/__init__.py

@@ -6,4 +6,4 @@ The **proj_flow** contains only ``__version__`` to be updated, nothing more.
 This is in an attempt to make this module easy to load initially.
 """
 
-__version__ = "0.19.0"
+__version__ = "0.20.1"

proj_flow/api/makefile.py

@@ -73,7 +73,7 @@ class Rule(ABC):
     @abstractmethod
     def command(self, statement: Statement) -> List[str]: ...
 
-    def run(self, statement: Statement, rt: Runtime):
+    def run(self, statement: Statement, rt: Runtime) -> int:
         return 1
 
     @classmethod

proj_flow/ext/tools/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) 2026 Marcin Zdun
+# This file is licensed under MIT license (see LICENSE for details)
+
+from proj_flow.api import arg
+from proj_flow.ext.tools.pragma_once import pragma_once
+from proj_flow.ext.tools.run_linter import run_linter
+
+__all__ = ["tools", "pragma_once", "run_linter"]
+
+
+@arg.command("tools")
+def tools():
+    """Run various C++ tools and helpers"""

proj_flow/ext/tools/pragma_once.py

@@ -0,0 +1,40 @@
+# Copyright (c) 2026 Marcin Zdun
+# This file is licensed under MIT license (see LICENSE for details)
+
+from pathlib import Path
+
+from proj_flow.api import arg
+
+
+def _pragma_present(path: Path):
+    with path.open(encoding="UTF-8") as text:
+        for line in text:
+            line = line.rstrip()
+            if line == "#pragma once":
+                return True
+    return False
+
+
+@arg.command("tools", "pragma-once")
+def pragma_once():
+    """Check presence and absence of ``#pragma once``, as expected"""
+
+    code_exts = [".c", ".c++", ".cc", ".cpp", ".cxx"]
+    header_exts = [".h", ".h++", ".hh", ".hpp", ".hxx"]
+
+    paths: dict[bool, list[Path]] = {True: [], False: []}
+
+    for root, dirs, files in Path(".").walk():
+        dirs[:] = [dir_name for dir_name in dirs if dir_name not in [".git", "build"]]
+        for filename in files:
+            path = root / filename
+            ext = path.suffix
+            if ext in code_exts:
+                paths[False].append(path)
+            elif ext in header_exts:
+                paths[True].append(path)
+
+    for expected in paths:
+        for path in paths[expected]:
+            if _pragma_present(path) != expected:
+                print(path.as_posix())

proj_flow/ext/tools/run_linter.py

@@ -0,0 +1,228 @@
+# Copyright (c) 2026 Marcin Zdun
+# This code is licensed under MIT license (see LICENSE for details)
+
+import shlex
+import subprocess
+import urllib.parse
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Annotated, Any, cast
+
+import requests_cache
+from yaml import load, safe_load
+
+from proj_flow.api.arg import Argument, command
+from proj_flow.api.env import Runtime
+
+try:
+    from yaml import CLoader as Loader
+except ImportError:
+    from yaml import Loader
+
+IMAGE = "github/super-linter"
+PREFIX = f"{IMAGE}/"
+
+
+@dataclass
+class Image:
+    repo: str
+    name: str
+    version: str
+
+    @property
+    def full_name(self):
+        return f"{self.repo}/{self.name}"
+
+    @property
+    def label(self):
+        return f"{self.repo}/{self.name}:{self.version}"
+
+    def super_linter_args(self, env: dict[str, str], log_level: str):
+        _env = env.copy()
+        _env["RUN_LOCAL"] = "true"
+        _env["LOG_LEVEL"] = log_level
+        _env["USE_FIND_ALGORITHM"] = "true"
+        _env["VALIDATE_ALL_CODEBASE"] = "true"
+
+        args = [
+            arg
+            for pair in (["-e", f"{key}={_env[key]}"] for key in _env)
+            for arg in pair
+        ]
+        return [
+            "docker",
+            "run",
+            "--rm",
+            *args,
+            "-v" f"{Path().absolute().as_posix()}:/tmp/lint",
+            self.label,
+        ]
+
+
+@dataclass
+class Step:
+    name: str
+    image: Image
+    env: dict[str, str]
+
+
+@dataclass
+class Job:
+    name: str
+    steps: list[Step]
+
+
+@command("tools", "run-linter")
+def run_linter(
+    log_level: Annotated[
+        str,
+        Argument(
+            help="Select one of log levels (defaults to INFO)",
+            choices=["ERROR", "WARN", "NOTICE", "INFO", "DEBUG"],
+            default="INFO",
+            opt=True,
+        ),
+    ],
+    rt: Runtime,
+):
+    """Run dockerized super-linter with all the settings from local GitHub workflows"""
+
+    WORKFLOWS = Path(".github/workflows")
+    if not WORKFLOWS.is_dir():
+        if not rt.silent:
+            print("This project has no GitHub workflows")
+            return 0
+
+    db_path = Path("build")
+    db_path.mkdir(parents=True, exist_ok=True)
+    db_path = db_path / "cache_db"
+
+    session = requests_cache.CachedSession(db_path)
+    JOBS: list[Job] = []
+    for root, dirs, files in WORKFLOWS.walk():
+        for filename in files:
+            path = root / filename
+            if path.suffix not in [".yml", ".yaml"]:
+                continue
+
+            with path.open(encoding="UTF-8") as f:
+                data = load(f, Loader=Loader)
+                try:
+                    yml_name = cast(str, data["name"])
+                except KeyError:
+                    yml_name = path.stem
+                JOBS.extend(_get_linter_actions(data, yml_name, session, rt.verbose))
+
+    for job in JOBS:
+        job_name, steps = job.name, job.steps
+        print(f"job:  \033[1;49;95m{job_name}\033[m")
+        for step in steps:
+            print(
+                f"step: \033[1;49;96m{step.name}\033[m \033[2;49;32m({step.image.full_name}:\033[0;49;32m{step.image.version}\033[2;49;32m)\033[m"
+            )
+            args = step.image.super_linter_args(step.env, log_level=log_level)
+            print("\033[0;49;30m{}\033[m".format(shlex.join(args)))
+            subprocess.run(args, shell=False)
+            print()
+
+
+def _download_docker_image_id(
+    action: str,
+    version: str | None,
+    session: requests_cache.CachedSession,
+    verbose: bool,
+):
+    if action != IMAGE and not action.startswith(PREFIX):
+        return None
+
+    repo = "https://raw.githubusercontent.com/github/super-linter"
+    refs = f"refs/tags/{version}" if version else "refs/heads/main"
+    filename = "action.yml"
+    if action.startswith(PREFIX):
+        filename = f"{action[len(PREFIX):]}/{filename}"
+
+    url = f"{repo}/{refs}/{filename}"
+    if verbose:
+        print("-- run-linter: Downloading", url)
+    response = session.get(url)
+    response.raise_for_status()
+    data = cast(dict[str, dict[str, str]], safe_load(response.text))
+    runs = data.get("runs", {})
+    if runs.get("using") != "docker":
+        return None
+
+    image = runs.get("image")
+    if not image:
+        return None
+
+    url = urllib.parse.urlparse(image)
+    name, version = url.path[1:].split(":", 1)
+    return Image(url.netloc, name, version)
+
+
+def _get_linter_action(
+    step: dict, session: requests_cache.CachedSession, verbose: bool
+):
+    try:
+        id_parts = cast(str, step["uses"]).split("@", 1)
+    except KeyError:
+        return
+
+    action = id_parts[0]
+    action_version = id_parts[1] if len(id_parts) > 1 else None
+    image = _download_docker_image_id(action, action_version, session, verbose)
+    if not image:
+        return
+
+    try:
+        name = cast(str, step["name"])
+    except KeyError:
+        name = cast(str, step["uses"])
+
+    if verbose:
+        print(f'-- run-linter: Found {image.label} used by "{name}"')
+
+    try:
+        env = cast(dict[str, Any], step["env"])
+    except KeyError:
+        env = {}
+
+    _env: dict[str, str] = {}
+    for key in env:
+        value = env[key]
+        if isinstance(value, bool):
+            _env[key] = "true" if value else "false"
+            continue
+        if isinstance(value, str) and "${{" in value:
+            continue
+        _env[key] = value
+
+    return Step(name=name, image=image, env=_env)
+
+
+def _get_linter_actions(
+    data: dict, yml_name: str, session: requests_cache.CachedSession, verbose: bool
+):
+    result: list[Job] = []
+    for job_id, job in cast(dict[str, dict], data["jobs"]).items():
+        steps: list[Step] = []
+        for step_def in cast(list[dict], job["steps"]):
+            step = _get_linter_action(step_def, session, verbose)
+            if step is None:
+                continue
+            steps.append(step)
+
+        if not steps:
+            continue
+
+        try:
+            name = cast(str, job["name"])
+        except KeyError:
+            name = job_id
+
+        if name != yml_name:
+            name = f"{yml_name} » {name}"
+
+        result.append(Job(name=name, steps=steps))
+
+    return result

{proj_flow-0.19.0.dist-info → proj_flow-0.20.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proj-flow
-Version: 0.19.0
+Version: 0.20.1
 Summary: C++ project maintenance, automated
 Project-URL: Changelog, https://github.com/mzdun/proj-flow/blob/main/CHANGELOG.rst
 Project-URL: Documentation, https://proj-flow.readthedocs.io/en/latest/
@@ -22,6 +22,7 @@ Requires-Dist: chevron2021
 Requires-Dist: prompt-toolkit
 Requires-Dist: pywebidl2
 Requires-Dist: pyyaml
+Requires-Dist: requests-cache
 Requires-Dist: toml
 Description-Content-Type: text/markdown
 

{proj_flow-0.19.0.dist-info → proj_flow-0.20.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-proj_flow/__init__.py,sha256=mcoLRnfbs2cN5EIdEz5liGKLp_d_SkFreWMn94VFFiU,277
+proj_flow/__init__.py,sha256=ghRf_ta3bOGtcUvsUvM3PlPP3np2ais8jHQHW2Y76bg,277
 proj_flow/__main__.py,sha256=HUar_qQ9Ndmchmryegtzu__5wukwCLrFN_SGRl5Ol_M,233
 proj_flow/dependency.py,sha256=CpcnR6El8AO9hlLc9lQtYQADYlkx3GMHlkLYbEAtdMI,4639
 proj_flow/api/__init__.py,sha256=gV2f6kll_5JXtvkGASvnx7CbOWr34PHOdck-4ce-qEk,378
@@ -7,7 +7,7 @@ proj_flow/api/completers.py,sha256=NapNVu6QAQ_iF6dqcAzOV5kDHKD9MAMVX209Bklq-Mw,2
 proj_flow/api/ctx.py,sha256=IJu0q0Chivo6b2M4MKkAlV09oi7Cn9VxtDFeAeL_tnc,6646
 proj_flow/api/env.py,sha256=rbNtMB6bBRhUb6bolNduWVWZ7a5CIsnv8EEZsamT9Ek,12678
 proj_flow/api/init.py,sha256=p4ZDGfq6fw4bXbJu2iq0vEmVxbS7nALIhZfe-XnEs44,565
-proj_flow/api/makefile.py,sha256=AxtGOvmypBtSvoyMEDJq1bGoaVD5yW9YYRZSdunUEeg,3856
+proj_flow/api/makefile.py,sha256=q0fBSsWTWfR5YwunwiRjWJKtiLeHdSKUgUTEgo5I7dE,3863
 proj_flow/api/release.py,sha256=IM4axJ6dfyilCmpwL_Z8q43XGKsfHaPoMAdqSziwT7s,2810
 proj_flow/api/step.py,sha256=C6LfjAN5edYjlpkhd6k9eMO9SLfLtyS2ZG1Rg_dLcjg,4926
 proj_flow/base/__cmake_version__.py,sha256=imja0GnhpBvS8Crz-64eOUKhc4i6FeRrjBGRB68x_p0,239
@@ -46,6 +46,9 @@ proj_flow/ext/python/version.py,sha256=pnyuKATyZwBh1p0gf9KmqbRSZx8hJ5285CiFK_tHE
 proj_flow/ext/sign/__init__.py,sha256=b9AN1_BalPtVy7YLBjvGhLamTujHEKcZP7npgDDDuSI,4296
 proj_flow/ext/sign/api.py,sha256=l5SO5RHiHTwxg0aexkGOfApRdojWDcIBY_cfbKSKsC0,2286
 proj_flow/ext/sign/win32.py,sha256=yMAmO-DdIWZdOi_NxycRym8XM9WIsrWKtFANdIwthJ4,4968
+proj_flow/ext/tools/__init__.py,sha256=m9iJeCkdmrqLjBWNx9hp4o1H2kgzIXpgypHiSf3SzKE,373
+proj_flow/ext/tools/pragma_once.py,sha256=BiNvX5X5pX_bGPZwBaKISlL6KkxJJGWFeZGSO-UDAgo,1218
+proj_flow/ext/tools/run_linter.py,sha256=_EdmTfITc_hwI5hgMc_mKFkbw4unnDGkWaFohs0RDr4,6145
 proj_flow/ext/webidl/__init__.py,sha256=StPcfYM0l6Q3QNoXj5DfDpes6WwvhgfNnARQlhEoZco,316
 proj_flow/ext/webidl/registry.py,sha256=x-UeflSrbUBMCH0nTSjpHisSnxZkQUNWfyXoSlDcavA,585
 proj_flow/ext/webidl/base/__init__.py,sha256=VJs_ODnF7-8DE0MbYKX-Bs-JDNqHgGdMkk2w142bcYQ,101
@@ -157,8 +160,8 @@ proj_flow/template/licenses/MIT.mustache,sha256=NncPoQaNsuy-WmRmboik3fyhJJ8m5pc2
 proj_flow/template/licenses/Unlicense.mustache,sha256=awOCsWJ58m_2kBQwBUGWejVqZm6wuRtCL2hi9rfa0X4,1211
 proj_flow/template/licenses/WTFPL.mustache,sha256=lvF4V_PrKKfZPa2TC8CZo8tlqaKvs3Bpv9G6XsWWQ4k,483
 proj_flow/template/licenses/Zlib.mustache,sha256=uIj-mhSjes2HJ3rRapyy2ALflKRz4xQgS4mVM9827C0,868
-proj_flow-0.19.0.dist-info/METADATA,sha256=0SYn6uyzQ0xfGeduquoEvAK7eLVJ-OlUt1ITiNnwQHc,3005
-proj_flow-0.19.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-proj_flow-0.19.0.dist-info/entry_points.txt,sha256=d_OmGKZzpY7FCWz0sZ4wnBAPZC75oMEzTgJZWtpDELo,49
-proj_flow-0.19.0.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
-proj_flow-0.19.0.dist-info/RECORD,,
+proj_flow-0.20.1.dist-info/METADATA,sha256=1Ln8vCw1vobgp1FsGIiocIy2jVtkkp4y6bLYRJhCJkc,3035
+proj_flow-0.20.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+proj_flow-0.20.1.dist-info/entry_points.txt,sha256=d_OmGKZzpY7FCWz0sZ4wnBAPZC75oMEzTgJZWtpDELo,49
+proj_flow-0.20.1.dist-info/licenses/LICENSE,sha256=vpOQJ5QlrTedF3coEWvA4wJzVJH304f66ZitR7Od4iU,1068
+proj_flow-0.20.1.dist-info/RECORD,,