precommit-swear 0.1.0__py3-none-any.whl

precommit_swear/cli.py

@@ -0,0 +1,104 @@
+import argparse
+import stat
+import sys
+from pathlib import Path
+
+def make_hook_content(ignore: list[str] | None = None) -> str:
+    parts = ["#!/usr/bin/env sh", "# precommit-swear", "precommit-swear hook"]
+    if ignore:
+        for word in ignore:
+            parts[-1] += f" --ignore {word}"
+    return "\n".join(parts) + "\n"
+
+SENTINEL = "# precommit-swear"
+
+
+def install(repo: Path, force: bool, ignore: list[str] | None = None) -> None:
+    git_dir = repo / ".git"
+    if not git_dir.is_dir():
+        print(f"Error: {repo} is not a git repository.", file=sys.stderr)
+        sys.exit(1)
+
+    hooks_dir = git_dir / "hooks"
+    hooks_dir.mkdir(exist_ok=True)
+    hook_file = hooks_dir / "pre-commit"
+
+    if hook_file.exists() and not force:
+        print(
+            f"Error: {hook_file} already exists. Use --force to overwrite.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    hook_file.write_text(make_hook_content(ignore), encoding="utf-8")
+    hook_file.chmod(hook_file.stat().st_mode | stat.S_IEXEC)
+    print(f"Installed pre-commit hook into {repo}")
+
+
+def uninstall(repo: Path) -> None:
+    hook_file = repo / ".git" / "hooks" / "pre-commit"
+
+    if not hook_file.exists():
+        print("No pre-commit hook found.", file=sys.stderr)
+        sys.exit(1)
+
+    content = hook_file.read_text(encoding="utf-8")
+    if SENTINEL not in content:
+        print(
+            "Error: existing pre-commit hook was not installed by precommit-swear.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    hook_file.unlink()
+    print(f"Uninstalled pre-commit hook from {repo}")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="precommit-swear")
+    sub = parser.add_subparsers(dest="command")
+
+    install_parser = sub.add_parser(
+        "install", help="Install the pre-commit hook into a repo"
+    )
+    install_parser.add_argument(
+        "--repo", default=".", help="Path to the git repo (default: current directory)"
+    )
+    install_parser.add_argument(
+        "--force", action="store_true", help="Overwrite existing pre-commit hook"
+    )
+    install_parser.add_argument(
+        "--ignore",
+        action="append",
+        default=[],
+        help="Word to ignore (can be specified multiple times)",
+    )
+
+    uninstall_parser = sub.add_parser(
+        "uninstall", help="Remove the pre-commit hook from a repo"
+    )
+    uninstall_parser.add_argument(
+        "--repo", default=".", help="Path to the git repo (default: current directory)"
+    )
+
+    hook_parser = sub.add_parser("hook", help="Run the hook (called by git)")
+    hook_parser.add_argument(
+        "--ignore",
+        action="append",
+        default=[],
+        help="Word to ignore (can be specified multiple times)",
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "install":
+        install(Path(args.repo).resolve(), args.force, args.ignore or None)
+    elif args.command == "uninstall":
+        uninstall(Path(args.repo).resolve())
+    elif args.command == "hook":
+        from precommit_swear.hook import main as hook_main
+
+        hook_main(ignore=set(args.ignore) if args.ignore else None)
+    else:
+        parser.print_help()
+        sys.exit(1)

precommit_swear/hook.py

@@ -0,0 +1,39 @@
+import subprocess
+import sys
+
+from precommit_swear.scanner import scan_diff
+
+
+def main(ignore: set[str] | None = None) -> None:
+    result = subprocess.run(
+        ["git", "diff", "--cached", "--diff-filter=ACMR"],
+        capture_output=True,
+        text=True,
+    )
+
+    if result.returncode != 0:
+        print("precommit-swear: failed to get staged diff", file=sys.stderr)
+        sys.exit(1)
+
+    if not result.stdout.strip():
+        sys.exit(0)
+
+    matches = scan_diff(result.stdout, ignore=ignore)
+    if not matches:
+        sys.exit(0)
+
+    print("=" * 40, file=sys.stderr)
+    print(" precommit-swear: bad words detected!", file=sys.stderr)
+    print("=" * 40, file=sys.stderr)
+    print(file=sys.stderr)
+
+    for filename, line_no, word, line_text in matches:
+        print(f"  {filename}:{line_no}  '{word}'  ->  {line_text.strip()}", file=sys.stderr)
+
+    print(file=sys.stderr)
+    print("Remove them and try again, or use 'git commit --no-verify' to skip.", file=sys.stderr)
+    sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

precommit_swear/scanner.py

@@ -0,0 +1,44 @@
+import re
+from importlib.resources import files
+
+
+def load_bad_words() -> set[str]:
+    text = files("precommit_swear").joinpath("bad-words.txt").read_text(encoding="utf-8")
+    return {word.lower() for line in text.splitlines() if (word := line.strip())}
+
+
+def scan_diff(
+    diff_text: str, ignore: set[str] | None = None
+) -> list[tuple[str, int, str, str]]:
+    """Scan a unified diff for bad words.
+
+    Returns a list of (filename, line_number, matched_word, line_text) tuples.
+    """
+    bad_words = load_bad_words()
+    if ignore:
+        bad_words -= {w.lower() for w in ignore}
+    matches = []
+    current_file = ""
+    current_line = 0
+
+    for line in diff_text.splitlines():
+        if line.startswith("+++ b/"):
+            current_file = line[6:]
+            continue
+
+        hunk = re.match(r"^@@ -\d+(?:,\d+)? \+(\d+)", line)
+        if hunk:
+            current_line = int(hunk.group(1))
+            continue
+
+        if line.startswith("+") and not line.startswith("+++"):
+            content = line[1:]
+            tokens = re.split(r"[^a-zA-Z]+", content)
+            for token in tokens:
+                if token and token.lower() in bad_words:
+                    matches.append((current_file, current_line, token, content))
+            current_line += 1
+        elif not line.startswith("-"):
+            current_line += 1
+
+    return matches

precommit_swear-0.1.0.dist-info/METADATA

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: precommit-swear
+Version: 0.1.0
+Summary: Git pre-commit hook that blocks commits containing bad words
+Requires-Python: >=3.9

precommit_swear-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+precommit_swear/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+precommit_swear/bad-words.txt,sha256=dkJScK8Opw4itvAUW6Zw1kvfQwTawBcyTCs9FOqblf4,11169
+precommit_swear/cli.py,sha256=s7Q8GDZzjKyWSPJovDoV-tvPYA9O_YmMya495UOpwDk,3198
+precommit_swear/hook.py,sha256=Rs8AuMbyefvMcUV6W--dYunpf5ThYS9DdI3s3Z7x5oM,1050
+precommit_swear/scanner.py,sha256=-rght6zLdWCfJfmt00Fv-QLUSnaPEixq9Mr5CqJiA9w,1370
+precommit_swear-0.1.0.dist-info/METADATA,sha256=vT9mF-vMSC0T4XhLLXCGCy0B2b4OH2NjsR_pIia5ZyU,152
+precommit_swear-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+precommit_swear-0.1.0.dist-info/entry_points.txt,sha256=LJK61Frie0JMtxBR8A3EuDslis0myZnCjMbunKBxEhY,61
+precommit_swear-0.1.0.dist-info/RECORD,,

precommit_swear-0.1.0.dist-info/WHEEL

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

precommit_swear-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+precommit-swear = precommit_swear.cli:main