habit-hooks-php 1.0.0__py3-none-any.whl

habit_hooks_php/__init__.py

@@ -0,0 +1 @@
+"""The php Habit Hooks plugin: package data discovered via the habit_hooks.plugins entry point."""

habit_hooks_php/config.toml

@@ -0,0 +1,5 @@
+# PHP plugin defaults.
+language = "php"
+files = ["**/*.php"]
+sensors = ["phpmd"]
+transformers = []

habit_hooks_php/guides/unused-variable.md

@@ -0,0 +1,4 @@
+{% include "includes/line_level_issues.md" %}
+An unused local variable is dead weight: the reader has to prove to themselves it does not matter. It usually signals one of three things — a computation whose result is never consumed (delete the computation, not just the assignment), a leftover from a refactor that moved logic elsewhere, or a value you meant to use and forgot to wire in (the real bug).
+
+Decide which it is before deleting. If the right-hand side has side effects you still need, keep the call but drop the binding. If it was meant to be returned or passed on, finish that thread rather than silencing the warning. Suppressing it with a throwaway name hides the question instead of answering it.

habit_hooks_php/sensors/phpmd.toml

@@ -0,0 +1 @@
+command = "python ${dir}/phpmd_sensor.py ${files}"

habit_hooks_php/sensors/phpmd_sensor.py

@@ -0,0 +1,91 @@
+"""Run PHPMD and print canonical smell findings.
+
+PHPMD exits 2 when it finds violations and 1 on a real error, so a bare pipe
+cannot tell a clean run from a crash. This wrapper runs PHPMD against the scoped
+files, treats only 0/2 as success, and shapes each rule into the canonical
+finding, mapping PHPMD rule names to smell keys.
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+from pathlib import Path
+
+RULE_SMELLS = {
+    "ExcessiveParameterList": "too-many-parameters",
+    "CyclomaticComplexity": "high-complexity",
+    "ExcessiveMethodLength": "oversized-function",
+    "UnusedLocalVariable": "unused-variable",
+}
+
+RULESETS = "codesize,unusedcode"
+SUCCESS_EXIT_CODES = (0, 2)
+
+
+def run_phpmd(files: list[str]) -> subprocess.CompletedProcess[str]:
+    phar = str(Path(__file__).with_name("phpmd.phar"))
+    command = [
+        "php",
+        "-d",
+        "error_reporting=0",
+        "-d",
+        "display_errors=0",
+        phar,
+        ",".join(files),
+        "json",
+        RULESETS,
+    ]
+    return subprocess.run(command, capture_output=True, text=True)
+
+
+def violations(report: dict) -> list[dict]:
+    return [
+        {"file": file["file"], "violation": violation}
+        for file in report.get("files", [])
+        for violation in file["violations"]
+    ]
+
+
+def issue(entry: dict) -> dict:
+    violation = entry["violation"]
+    return {
+        "key": entry["file"],
+        "details": {
+            "file": entry["file"],
+            "line": violation["beginLine"],
+            "message": violation["description"],
+            "source": "phpmd:" + violation["rule"],
+        },
+    }
+
+
+def findings(entries: list[dict]) -> list[dict]:
+    by_smell: dict[str, list[dict]] = {}
+    for entry in entries:
+        smell = RULE_SMELLS.get(entry["violation"]["rule"])
+        if smell is not None:
+            by_smell.setdefault(smell, []).append(issue(entry))
+    return [
+        {"smell": smell, "details": {}, "issues": issues}
+        for smell, issues in by_smell.items()
+    ]
+
+
+def main() -> int:
+    files = sys.argv[1:]
+    if not files:
+        print("[]")
+        return 0
+    result = run_phpmd(files)
+    if result.returncode not in SUCCESS_EXIT_CODES:
+        sys.stderr.write(result.stderr or result.stdout)
+        return 2
+    report = json.loads(result.stdout)
+    print(json.dumps(findings(violations(report))))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

habit_hooks_php-1.0.0.dist-info/METADATA

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: habit-hooks-php
+Version: 1.0.0
+Summary: The PHP Habit Hooks plugin
+Requires-Python: >=3.11

habit_hooks_php-1.0.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+habit_hooks_php/__init__.py,sha256=Ri-WRtCwo7MgXzR3hDP9UZQb_IOeWABCSTz7OjQizn0,99
+habit_hooks_php/config.toml,sha256=AhNY0IkvREB_OQPckLnRzlSpVWVoQ9bWm1ntZv6Tn-w,99
+habit_hooks_php/guides/unused-variable.md,sha256=FzsT05P9gsslRtZSFHoc9vnyxVQpiSlrW4nU95m2IWg,714
+habit_hooks_php/sensors/phpmd.phar,sha256=aijvVd4MdTsHDR0VgLsIoNFGAW-J8O3c72CsT8EINUQ,3168622
+habit_hooks_php/sensors/phpmd.toml,sha256=pn4Aq_4OSvT7my03Js3TtrEed61HxrSlLtvII_sC-Pg,51
+habit_hooks_php/sensors/phpmd_sensor.py,sha256=0OGgMSJSNbCqbbpDR9z1Wc2V68D7i-i19dPqKQFgWSU,2449
+habit_hooks_php-1.0.0.dist-info/METADATA,sha256=ftUpJ0Vmrd02oezvdJa1lCa9pcaRkAwqHApMu1IgnJc,119
+habit_hooks_php-1.0.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+habit_hooks_php-1.0.0.dist-info/entry_points.txt,sha256=7Uepfg4PE7W_V74t0xOsKo9VrUUXMOqxPCBl14Baf4M,44
+habit_hooks_php-1.0.0.dist-info/RECORD,,

habit_hooks_php-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

habit_hooks_php-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[habit_hooks.plugins]
+php = habit_hooks_php