chore: initial commit

Author: CoderDeltaLAN

README.md

@@ -0,0 +1 @@
+# commit-guardian

pyproject.toml

@@ -0,0 +1,33 @@
+[tool.poetry]
+name = "commit-guardian"
+version = "0.1.0"
+description = "CLI to enforce commit hygiene, SPDX headers & LICENSE presence (Always-Green CI, MIT)."
+authors = ["CoderDeltaLAN <[email protected]>"]
+license = "MIT"
+readme = "README.md"
+packages = [{include = "commit_guardian", from = "src"}]
+
+[tool.poetry.dependencies]
+python = "^3.11"
+click = "^8.1"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0"
+mypy = "^1.7"
+ruff = "^0.6"
+black = "^24.10"
+
+[tool.poetry.scripts]
+commit-guardian = "commit_guardian.cli:main"
+
+[tool.ruff]
+line-length = 100
+
+[tool.black]
+line-length = 100
+
+[tool.mypy]
+python_version = "3.11"
+warn_unused_ignores = true
+warn_redundant_casts = true
+disallow_untyped_defs = true

src/commit_guardian/__init__.py

@@ -0,0 +1,5 @@
+__all__ = ["ping", "__version__"]
+__version__ = "0.1.0"
+
+def ping() -> str:
+    return "pong"

src/commit_guardian/cli.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+import sys
+import click
+from . import __version__, ping
+
+@click.command()
+@click.option("--version", is_flag=True, help="Show version and exit.")
+def main(version: bool) -> None:
+    if version:
+        click.echo(__version__)
+        raise SystemExit(0)
+    click.echo(ping())
+    raise SystemExit(0)
+
+if __name__ == "__main__":
+    main()

tests/test_sanity.py

@@ -0,0 +1,4 @@
+import commit_guardian as cg
+
+def test_ping() -> None:
+    assert cg.ping() == "pong"