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

habit_hooks_python/__init__.py

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

habit_hooks_python/config.toml

@@ -0,0 +1,5 @@
+# Python plugin defaults.
+language = "python"
+files = ["**/*.py"]
+sensors = ["ruff", "deptry"]
+transformers = []

habit_hooks_python/guides/high-complexity.md

@@ -0,0 +1,12 @@
+High cyclomatic complexity means one function is making too many decisions at once. The smell is not the number, it is that the function has quietly taken on more than one job. The count is the symptom, tangled responsibilities are the cause.
+
+{% include "includes/line_level_issues.md" %}
+Work through it in order:
+
+1. **Name what each branch is for.** Give every branch a one-sentence description of the responsibility it handles. If two branches describe the same thing, they belong together. If a branch has no clean name, that path probably wants its own function.
+2. **Lift the guards out first.** Turn early-exit conditions into guard clauses (`if not user: return None`) so the happy path stays flat and left-aligned. Most of the count is preconditions wrapped around the real work.
+3. **Change the shape, do not just move it.** When every branch is the same kind of decision, reshape it: a long `if/elif` on a value is often a dict dispatch or polymorphism, a nested loop often a comprehension or a generator. When polymorphism is not the right fit and the branches are genuinely separate jobs, extract one named method per branch, each named for the responsibility it handles. The goal is fewer decisions in one place, not the same tangle split into `_part1` / `_part2` behind worse names.
+
+Reducing the number without reducing the tangle is not a fix. Do not merge conditions with `and`/`or` just to drop a branch, and do not rewrite `if` statements as ternaries to slip under the check. ruff's mccabe does not count ternary expressions, so that trick lowers the score while a human still has to hold every condition in their head.
+
+The test is not whether the number dropped. It is whether someone reading the function for the first time can hold it in their head at once. If not, it is still doing too much.

habit_hooks_python/guides/swallowed-exception.md

@@ -0,0 +1,12 @@
+A broad `except` (`except:`, `except Exception`, `except BaseException`) that discards the error silently is hiding a failure you have not understood, not handling one you planned for. Before you write it, name the specific error you expect and why. That one sentence is usually the fix.
+
+{% include "includes/line_level_issues.md" %}
+Work through it in order:
+
+1. **Catch only what you can name.** `ValueError`, `KeyError`, `TimeoutError`, whatever the call really raises. If you cannot name it, you are guessing, and every other error should stay free to surface where someone can see it.
+2. **Make the decision visible.** Recover from it, add context and re-raise (`raise ... from err`), or, at a boundary that has to stay alive, log the full traceback (`logging.exception(...)`) and continue. Logging and returning a default is a real option, not automatically a swallow.
+3. **The test is not whether you re-raised.** Ask one question: if this fires at 3am, will anyone know it happened, and will they know why? What turns a catch into a swallow is doing it blindly: a wide catch, no named error, nothing logged, the failure gone without a trace. If the answer is no, it is still a swallow, however you dressed it up.
+
+Narrowing the type or adding `# noqa` only to quiet ruff is not a fix if the error is still discarded.
+
+If you are unsure whether this catch is a real decision or a reflex, check with a human before you keep it.

habit_hooks_python/ruff.toml

@@ -0,0 +1,6 @@
+[lint.mccabe]
+max-complexity = 10
+
+[lint.pylint]
+max-args = 3
+max-statements = 12

habit_hooks_python/sensors/deptry.toml

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

habit_hooks_python/sensors/deptry_sensor.py

@@ -0,0 +1,70 @@
+"""Run deptry and print ``unused-dependency`` findings.
+
+deptry's stdout is unreliable when piped, so this wrapper runs it against a temp
+JSON report, reads that report, and shapes each ``DEP002`` (a declared but unused
+dependency) into the canonical finding.
+"""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+
+def run_deptry(report: Path) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        ["deptry", ".", "--json-output", str(report)],
+        capture_output=True,
+        text=True,
+    )
+
+
+def deptry_crashed(result: subprocess.CompletedProcess[str], report: Path) -> bool:
+    return result.returncode not in (0, 1) or not report.is_file()
+
+
+def unused_dependencies(report: Path) -> list[dict]:
+    entries = json.loads(report.read_text())
+    return [entry for entry in entries if entry["error"]["code"] == "DEP002"]
+
+
+def issue(entry: dict) -> dict:
+    return {
+        "key": entry["module"],
+        "details": {
+            "module": entry["module"],
+            "file": entry["location"]["file"],
+            "message": entry["error"]["message"],
+            "source": "deptry:DEP002",
+        },
+    }
+
+
+def findings(entries: list[dict]) -> list[dict]:
+    if not entries:
+        return []
+    return [
+        {
+            "smell": "unused-dependency",
+            "details": {},
+            "issues": [issue(entry) for entry in entries],
+        }
+    ]
+
+
+def main() -> int:
+    with tempfile.TemporaryDirectory() as tmp:
+        report = Path(tmp) / "deptry-report.json"
+        result = run_deptry(report)
+        if deptry_crashed(result, report):
+            sys.stderr.write(result.stderr)
+            return 2
+        print(json.dumps(findings(unused_dependencies(report))))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

habit_hooks_python/sensors/ruff.toml

@@ -0,0 +1,28 @@
+command = """
+set -o pipefail
+ruff check --output-format=json --select=C901,PLR0913,PLR0915,F841,F401,BLE001 ${files} | jq '
+  map(. + {smell: ({
+    "C901": "high-complexity",
+    "PLR0913": "too-many-parameters",
+    "PLR0915": "oversized-function",
+    "F841": "unused-variable",
+    "F401": "unused-import",
+    "BLE001": "swallowed-exception",
+    "invalid-syntax": "parse-error"
+  }[.code])})
+  | group_by(.smell)
+  | map({
+      smell: .[0].smell,
+      details: {},
+      issues: map({
+        key: .filename,
+        details: {
+          file: .filename,
+          line: .location.row,
+          column: .location.column,
+          message: .message,
+          source: ("ruff:" + .code)
+        }
+      })
+    })'
+"""

habit_hooks_python-1.0.0.dist-info/METADATA

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

habit_hooks_python-1.0.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+habit_hooks_python/__init__.py,sha256=LGBheP8EM8zRefLDnr_G-R-LLhPj_QxpJ04MSv3hLC8,102
+habit_hooks_python/config.toml,sha256=2ie74-nTqAadJGwi_F4kbAzbByhN_Ziu61toh00mkqw,113
+habit_hooks_python/ruff.toml,sha256=a4ALE0w4pF1pwJVwykQghExpZdlTMAQXB_MkNthvY84,82
+habit_hooks_python/guides/high-complexity.md,sha256=AOgAPBsGRnu8Vk01QHDbpyiAjb3knF9sYzow7DCxmPk,1821
+habit_hooks_python/guides/swallowed-exception.md,sha256=z_Vrfl2i-1k_8MjYSjvaaBrssphWMSL7l9tRyEujtuE,1435
+habit_hooks_python/sensors/deptry.toml,sha256=E94wN-47PGTCehtEQ8eAxA--GQUcjWEA2lQNFXgtjgs,43
+habit_hooks_python/sensors/deptry_sensor.py,sha256=H3UhcMhGbiOWXxbr7-NSDj1A7epXmDIVsZA7DwJqLMs,1856
+habit_hooks_python/sensors/ruff.toml,sha256=yNnsrgrC-3_yiRfZLWrZeX2CmU_ctA-6nJoVlITZnEA,727
+habit_hooks_python-1.0.0.dist-info/METADATA,sha256=AtrzMFDGwJtIGCmydjmS4e62ToAc6brWD2M0GNpy8WM,125
+habit_hooks_python-1.0.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+habit_hooks_python-1.0.0.dist-info/entry_points.txt,sha256=FA8Cm73udgU_q3rApY-aLWkYdiGs6X6uvVdxEAYQalc,50
+habit_hooks_python-1.0.0.dist-info/RECORD,,

habit_hooks_python-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_python-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[habit_hooks.plugins]
+python = habit_hooks_python