pycodegate 0.1.1__tar.gz → 0.1.3__tar.gz

{pycodegate-0.1.1 → pycodegate-0.1.3}/AGENTS.md

@@ -2,17 +2,17 @@
 
 ## Overview
 
-py-gate is a Python code quality gate that produces a 0–100 health score. It detects your framework, runs parallel lint and dead-code analysis across 40+ rules, and reports findings by severity so you always know what to fix first.
+PyCodeGate is the quality gate for AI-generated Python code. It produces a 0–100 health score by detecting your framework, running parallel lint and dead-code analysis across 40+ rules, and reporting findings by severity — so you can trust what your AI agent just wrote.
 
 ## Quick Start
 
 ```bash
-uvx py-gate . --json
+uvx pycodegate . --json
 ```
 
 ## For AI Agents
 
-Run `py-gate . --json` after modifying Python files. Fix findings with severity `"error"` first (security, correctness). Re-run to verify the score improved. Target: **80+**.
+Run `pycodegate . --json` after modifying Python files. Fix findings with severity `"error"` first (security, correctness). Re-run to verify the score improved. Target: **80+**.
 
 The JSON output includes the score, label, per-diagnostic severity and file location, and detected project context (framework, Python version, package manager).
 
@@ -38,7 +38,7 @@ The JSON output includes the score, label, per-diagnostic severity and file loca
 ```bash
 uv run pytest -q                              # run all tests
 uv run ruff check . && uv run ruff format --check .  # lint + format check
-uv run py-gate . --verbose                   # dogfood on ourselves
+uv run pycodegate . --verbose                   # dogfood on ourselves
 ```
 
 ## Adding Rules
@@ -56,7 +56,7 @@ src/pycodegate/
   api.py          — Programmatic API (diagnose function)
   scan.py         — Orchestrator: parallel lint + dead code
   score.py        — Score calculation from diagnostics
-  config.py       — Config loading (py-gate.toml / pyproject.toml)
+  config.py       — Config loading (pycodegate.toml / pyproject.toml)
   discover.py     — Project detection (framework, package manager, etc.)
   output.py       — Rich terminal output
   types.py        — All data types (Diagnostic, Score, etc.)

{pycodegate-0.1.1 → pycodegate-0.1.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: pycodegate
-Version: 0.1.1
-Summary: One command. One score. Your Python quality gate.
+Version: 0.1.3
+Summary: Trust, but verify. The quality gate for AI-generated Python code.
 Project-URL: Homepage, https://github.com/themohitkhare/pycodegate
 Project-URL: Repository, https://github.com/themohitkhare/pycodegate
 Project-URL: Issues, https://github.com/themohitkhare/pycodegate/issues
@@ -32,22 +32,26 @@ Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: ruff>=0.4; extra == 'dev'
 Description-Content-Type: text/markdown
 
-<h1 align="center">Py Gate</h1>
+<h1 align="center">PyCodeGate</h1>
 <p align="center">
-  <strong>One command. One score. Your Python quality gate.</strong>
+  <strong>Trust, but verify. The quality gate for AI-generated Python code.</strong>
 </p>
 <p align="center">
   <a href="https://github.com/themohitkhare/pycodegate/actions/workflows/ci.yml"><img src="https://github.com/themohitkhare/pycodegate/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://pypi.org/project/py-gate/"><img src="https://img.shields.io/pypi/v/py-gate" alt="PyPI"></a>
-  <a href="https://pypi.org/project/py-gate/"><img src="https://img.shields.io/pypi/pyversions/py-gate" alt="Python"></a>
+  <a href="https://pypi.org/project/pycodegate/"><img src="https://img.shields.io/pypi/v/pycodegate" alt="PyPI"></a>
+  <a href="https://pypi.org/project/pycodegate/"><img src="https://img.shields.io/pypi/pyversions/pycodegate" alt="Python"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
 </p>
 
 ---
 
+## Why PyCodeGate?
+
+AI coding agents ship code fast — but fast doesn't mean safe. Every `eval()` an LLM drops in, every mutable default it forgets, every circular import it creates is a landmine waiting to go off. PyCodeGate is the trust layer between AI-generated code and your production codebase: one command, one score, zero ambiguity.
+
 ## How it works
 
-Py Gate starts by detecting your project's context: framework (Django, FastAPI, Flask), Python version, package manager (uv, poetry, pip), and test framework. That context drives which rules are active — Django projects get SQL injection checks, FastAPI projects get async-correctness checks, and so on.
+PyCodeGate detects your project's context: framework (Django, FastAPI, Flask), Python version, package manager (uv, poetry, pip), and test framework. That context drives which rules are active — Django projects get SQL injection checks, FastAPI projects get async-correctness checks, and so on.
 
 It then runs two analysis passes **in parallel**: a lint pass that evaluates 40+ rules across 8 categories (Security, Correctness, Complexity, Architecture, Performance, Structure, Imports, Dead Code), and a dead-code pass powered by [Vulture](https://github.com/jendrikseipp/vulture) that finds unused functions, classes, imports, and variables.
 
@@ -58,39 +62,39 @@ Findings are filtered through your configuration and scored using a **weighted c
 Run instantly with `uvx` — no install needed:
 
 ```bash
-uvx py-gate .
+uvx pycodegate .
 ```
 
 Install globally with pipx or uv:
 
 ```bash
-pipx install py-gate
+pipx install pycodegate
 # or
-uv tool install py-gate
+uv tool install pycodegate
 # or
-pip install py-gate
+pip install pycodegate
 ```
 
 ## Quick Start
 
 ```bash
 # Basic scan — score + summary
-py-gate .
+pycodegate .
 
 # Show file paths and line numbers for every finding
-py-gate . --verbose
+pycodegate . --verbose
 
 # Machine-readable output for AI agents and CI
-py-gate . --json
+pycodegate . --json
 
 # Auto-fix ruff-fixable issues, then scan
-py-gate . --fix
+pycodegate . --fix
 
 # Output only the numeric score (useful in scripts)
-py-gate . --score
+pycodegate . --score
 
 # Scan only files changed vs a base branch
-py-gate . --diff main
+pycodegate . --diff main
 ```
 
 ## JSON Output
@@ -98,7 +102,7 @@ py-gate . --diff main
 Pass `--json` to get structured output that AI agents and CI pipelines can parse:
 
 ```bash
-py-gate . --json
+pycodegate . --json
 ```
 
 ```json
@@ -139,7 +143,7 @@ py-gate . --json
 
 ## Agent Integration
 
-Py Gate is designed to be used by AI coding agents. Add it to your agent's context so it runs after every Python change.
+PyCodeGate is designed to be used by AI coding agents. Add it to your agent's context so it runs after every Python change.
 
 ### Claude Code
 
@@ -147,18 +151,18 @@ Add the skill to your project:
 
 ```bash
 mkdir -p .claude/skills
-curl -fsSL https://raw.githubusercontent.com/themohitkhare/pycodegate/main/skills/py-gate/SKILL.md \
-  -o .claude/skills/py-gate.md
+curl -fsSL https://raw.githubusercontent.com/themohitkhare/pycodegate/main/skills/pycodegate/SKILL.md \
+  -o .claude/skills/pycodegate.md
 ```
 
 Or copy `AGENTS.md` to your project root — Claude Code picks it up automatically.
 
 ### Cursor
 
-Add to `.cursor/rules/py-gate.mdc`:
+Add to `.cursor/rules/pycodegate.mdc`:
 
 ```markdown
-After modifying Python files, run `uvx py-gate . --json` and fix all findings
+After modifying Python files, run `uvx pycodegate . --json` and fix all findings
 with severity "error" before marking the task complete. Target score: 80+.
 ```
 
@@ -167,7 +171,7 @@ with severity "error" before marking the task complete. Target score: 80+.
 Add to `.windsurfrules`:
 
 ```
-After modifying Python files, run: uvx py-gate . --json
+After modifying Python files, run: uvx pycodegate . --json
 Fix all "error" severity findings. Re-run to verify the score improved.
 ```
 
@@ -176,7 +180,7 @@ Fix all "error" severity findings. Re-run to verify the score improved.
 Add to your system prompt:
 
 ```
-After modifying Python files, run `uvx py-gate . --json` to check code quality.
+After modifying Python files, run `uvx pycodegate . --json` to check code quality.
 Fix errors first. Target score: 80+.
 ```
 
@@ -194,7 +198,7 @@ name: Quality Gate
 on: [push, pull_request]
 
 jobs:
-  py-gate:
+  pycodegate:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -205,10 +209,10 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Run Py Gate
+      - name: Run PyCodeGate
         run: |
-          pip install py-gate
-          py-gate . --verbose --diff main --fail-on error
+          pip install pycodegate
+          pycodegate . --verbose --diff main --fail-on error
 ```
 
 ## CLI Reference
@@ -244,7 +248,7 @@ Framework-specific rules (Django, FastAPI, Flask) are mapped into the Security o
 
 ## Scoring
 
-Py Gate uses a **weighted category-budget system**:
+PyCodeGate uses a **weighted category-budget system**:
 
 1. Each category has a weight (see table above). Weights are normalized to sum to 100 points of total deduction budget.
 2. Within a category, findings are sorted by cost (errors cost more than warnings). The top 3 findings apply at full cost; every additional finding applies **diminishing returns** (10% of its cost).
@@ -260,7 +264,7 @@ Py Gate uses a **weighted category-budget system**:
 
 ## Configuration
 
-Create `py-gate.toml` in your project root:
+Create `pycodegate.toml` in your project root:
 
 ```toml
 [options]
@@ -284,27 +288,27 @@ max-deduction.Dead Code = 0  # disable dead-code penalty entirely
 Or use `pyproject.toml`:
 
 ```toml
-[tool.py-gate]
+[tool.pycodegate]
 lint = true
 dead_code = true
 fail_on = "error"
 
-[tool.py-gate.ignore]
+[tool.pycodegate.ignore]
 rules = ["no-import-in-function"]
 files = ["tests/fixtures/**"]
 
-[tool.py-gate.per-file-ignores]
+[tool.pycodegate.per-file-ignores]
 "src/legacy/*.py" = ["high-complexity"]
 
-[tool.py-gate.scoring]
+[tool.pycodegate.scoring]
 "max-deduction" = { Security = 20, "Dead Code" = 0 }
 ```
 
-If both files exist, `py-gate.toml` takes precedence. CLI flags always override config values.
+If both files exist, `pycodegate.toml` takes precedence. CLI flags always override config values.
 
 ## Profiles
 
-Py Gate auto-detects a project profile and adjusts rule weights accordingly. You can also set a profile explicitly in config (`profile = "library"`).
+PyCodeGate auto-detects a project profile and adjusts rule weights accordingly. You can also set a profile explicitly in config (`profile = "library"`).
 
 | Profile | Auto-detected when | Adjustments |
 |---------|--------------------|-------------|
@@ -315,10 +319,10 @@ Py Gate auto-detects a project profile and adjusts rule weights accordingly. You
 
 ## Pre-commit Hook
 
-Use `--pre-commit` to run Py Gate as a pre-commit hook. It automatically scans only the staged files:
+Use `--pre-commit` to run PyCodeGate as a pre-commit hook. It automatically scans only the staged files:
 
 ```bash
-py-gate . --pre-commit --fail-on error
+pycodegate . --pre-commit --fail-on error
 ```
 
 Add to `.pre-commit-config.yaml`:
@@ -327,9 +331,9 @@ Add to `.pre-commit-config.yaml`:
 repos:
   - repo: local
     hooks:
-      - id: py-gate
-        name: Py Gate quality check
-        entry: py-gate . --pre-commit --fail-on error
+      - id: pycodegate
+        name: PyCodeGate quality check
+        entry: pycodegate . --pre-commit --fail-on error
         language: system
         types: [python]
         pass_filenames: false
@@ -342,7 +346,7 @@ git clone https://github.com/themohitkhare/pycodegate
 cd pycodegate
 uv sync --all-extras
 uv run pytest -q
-uv run py-gate . --verbose  # dogfood it
+uv run pycodegate . --verbose  # dogfood it
 ```
 
 To add a new rule:

{pycodegate-0.1.1 → pycodegate-0.1.3}/README.md

@@ -1,19 +1,23 @@
-<h1 align="center">Py Gate</h1>
+<h1 align="center">PyCodeGate</h1>
 <p align="center">
-  <strong>One command. One score. Your Python quality gate.</strong>
+  <strong>Trust, but verify. The quality gate for AI-generated Python code.</strong>
 </p>
 <p align="center">
   <a href="https://github.com/themohitkhare/pycodegate/actions/workflows/ci.yml"><img src="https://github.com/themohitkhare/pycodegate/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
-  <a href="https://pypi.org/project/py-gate/"><img src="https://img.shields.io/pypi/v/py-gate" alt="PyPI"></a>
-  <a href="https://pypi.org/project/py-gate/"><img src="https://img.shields.io/pypi/pyversions/py-gate" alt="Python"></a>
+  <a href="https://pypi.org/project/pycodegate/"><img src="https://img.shields.io/pypi/v/pycodegate" alt="PyPI"></a>
+  <a href="https://pypi.org/project/pycodegate/"><img src="https://img.shields.io/pypi/pyversions/pycodegate" alt="Python"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
 </p>
 
 ---
 
+## Why PyCodeGate?
+
+AI coding agents ship code fast — but fast doesn't mean safe. Every `eval()` an LLM drops in, every mutable default it forgets, every circular import it creates is a landmine waiting to go off. PyCodeGate is the trust layer between AI-generated code and your production codebase: one command, one score, zero ambiguity.
+
 ## How it works
 
-Py Gate starts by detecting your project's context: framework (Django, FastAPI, Flask), Python version, package manager (uv, poetry, pip), and test framework. That context drives which rules are active — Django projects get SQL injection checks, FastAPI projects get async-correctness checks, and so on.
+PyCodeGate detects your project's context: framework (Django, FastAPI, Flask), Python version, package manager (uv, poetry, pip), and test framework. That context drives which rules are active — Django projects get SQL injection checks, FastAPI projects get async-correctness checks, and so on.
 
 It then runs two analysis passes **in parallel**: a lint pass that evaluates 40+ rules across 8 categories (Security, Correctness, Complexity, Architecture, Performance, Structure, Imports, Dead Code), and a dead-code pass powered by [Vulture](https://github.com/jendrikseipp/vulture) that finds unused functions, classes, imports, and variables.
 
@@ -24,39 +28,39 @@ Findings are filtered through your configuration and scored using a **weighted c
 Run instantly with `uvx` — no install needed:
 
 ```bash
-uvx py-gate .
+uvx pycodegate .
 ```
 
 Install globally with pipx or uv:
 
 ```bash
-pipx install py-gate
+pipx install pycodegate
 # or
-uv tool install py-gate
+uv tool install pycodegate
 # or
-pip install py-gate
+pip install pycodegate
 ```
 
 ## Quick Start
 
 ```bash
 # Basic scan — score + summary
-py-gate .
+pycodegate .
 
 # Show file paths and line numbers for every finding
-py-gate . --verbose
+pycodegate . --verbose
 
 # Machine-readable output for AI agents and CI
-py-gate . --json
+pycodegate . --json
 
 # Auto-fix ruff-fixable issues, then scan
-py-gate . --fix
+pycodegate . --fix
 
 # Output only the numeric score (useful in scripts)
-py-gate . --score
+pycodegate . --score
 
 # Scan only files changed vs a base branch
-py-gate . --diff main
+pycodegate . --diff main
 ```
 
 ## JSON Output
@@ -64,7 +68,7 @@ py-gate . --diff main
 Pass `--json` to get structured output that AI agents and CI pipelines can parse:
 
 ```bash
-py-gate . --json
+pycodegate . --json
 ```
 
 ```json
@@ -105,7 +109,7 @@ py-gate . --json
 
 ## Agent Integration
 
-Py Gate is designed to be used by AI coding agents. Add it to your agent's context so it runs after every Python change.
+PyCodeGate is designed to be used by AI coding agents. Add it to your agent's context so it runs after every Python change.
 
 ### Claude Code
 
@@ -113,18 +117,18 @@ Add the skill to your project:
 
 ```bash
 mkdir -p .claude/skills
-curl -fsSL https://raw.githubusercontent.com/themohitkhare/pycodegate/main/skills/py-gate/SKILL.md \
-  -o .claude/skills/py-gate.md
+curl -fsSL https://raw.githubusercontent.com/themohitkhare/pycodegate/main/skills/pycodegate/SKILL.md \
+  -o .claude/skills/pycodegate.md
 ```
 
 Or copy `AGENTS.md` to your project root — Claude Code picks it up automatically.
 
 ### Cursor
 
-Add to `.cursor/rules/py-gate.mdc`:
+Add to `.cursor/rules/pycodegate.mdc`:
 
 ```markdown
-After modifying Python files, run `uvx py-gate . --json` and fix all findings
+After modifying Python files, run `uvx pycodegate . --json` and fix all findings
 with severity "error" before marking the task complete. Target score: 80+.
 ```
 
@@ -133,7 +137,7 @@ with severity "error" before marking the task complete. Target score: 80+.
 Add to `.windsurfrules`:
 
 ```
-After modifying Python files, run: uvx py-gate . --json
+After modifying Python files, run: uvx pycodegate . --json
 Fix all "error" severity findings. Re-run to verify the score improved.
 ```
 
@@ -142,7 +146,7 @@ Fix all "error" severity findings. Re-run to verify the score improved.
 Add to your system prompt:
 
 ```
-After modifying Python files, run `uvx py-gate . --json` to check code quality.
+After modifying Python files, run `uvx pycodegate . --json` to check code quality.
 Fix errors first. Target score: 80+.
 ```
 
@@ -160,7 +164,7 @@ name: Quality Gate
 on: [push, pull_request]
 
 jobs:
-  py-gate:
+  pycodegate:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -171,10 +175,10 @@ jobs:
         with:
           python-version: "3.12"
 
-      - name: Run Py Gate
+      - name: Run PyCodeGate
         run: |
-          pip install py-gate
-          py-gate . --verbose --diff main --fail-on error
+          pip install pycodegate
+          pycodegate . --verbose --diff main --fail-on error
 ```
 
 ## CLI Reference
@@ -210,7 +214,7 @@ Framework-specific rules (Django, FastAPI, Flask) are mapped into the Security o
 
 ## Scoring
 
-Py Gate uses a **weighted category-budget system**:
+PyCodeGate uses a **weighted category-budget system**:
 
 1. Each category has a weight (see table above). Weights are normalized to sum to 100 points of total deduction budget.
 2. Within a category, findings are sorted by cost (errors cost more than warnings). The top 3 findings apply at full cost; every additional finding applies **diminishing returns** (10% of its cost).
@@ -226,7 +230,7 @@ Py Gate uses a **weighted category-budget system**:
 
 ## Configuration
 
-Create `py-gate.toml` in your project root:
+Create `pycodegate.toml` in your project root:
 
 ```toml
 [options]
@@ -250,27 +254,27 @@ max-deduction.Dead Code = 0  # disable dead-code penalty entirely
 Or use `pyproject.toml`:
 
 ```toml
-[tool.py-gate]
+[tool.pycodegate]
 lint = true
 dead_code = true
 fail_on = "error"
 
-[tool.py-gate.ignore]
+[tool.pycodegate.ignore]
 rules = ["no-import-in-function"]
 files = ["tests/fixtures/**"]
 
-[tool.py-gate.per-file-ignores]
+[tool.pycodegate.per-file-ignores]
 "src/legacy/*.py" = ["high-complexity"]
 
-[tool.py-gate.scoring]
+[tool.pycodegate.scoring]
 "max-deduction" = { Security = 20, "Dead Code" = 0 }
 ```
 
-If both files exist, `py-gate.toml` takes precedence. CLI flags always override config values.
+If both files exist, `pycodegate.toml` takes precedence. CLI flags always override config values.
 
 ## Profiles
 
-Py Gate auto-detects a project profile and adjusts rule weights accordingly. You can also set a profile explicitly in config (`profile = "library"`).
+PyCodeGate auto-detects a project profile and adjusts rule weights accordingly. You can also set a profile explicitly in config (`profile = "library"`).
 
 | Profile | Auto-detected when | Adjustments |
 |---------|--------------------|-------------|
@@ -281,10 +285,10 @@ Py Gate auto-detects a project profile and adjusts rule weights accordingly. You
 
 ## Pre-commit Hook
 
-Use `--pre-commit` to run Py Gate as a pre-commit hook. It automatically scans only the staged files:
+Use `--pre-commit` to run PyCodeGate as a pre-commit hook. It automatically scans only the staged files:
 
 ```bash
-py-gate . --pre-commit --fail-on error
+pycodegate . --pre-commit --fail-on error
 ```
 
 Add to `.pre-commit-config.yaml`:
@@ -293,9 +297,9 @@ Add to `.pre-commit-config.yaml`:
 repos:
   - repo: local
     hooks:
-      - id: py-gate
-        name: Py Gate quality check
-        entry: py-gate . --pre-commit --fail-on error
+      - id: pycodegate
+        name: PyCodeGate quality check
+        entry: pycodegate . --pre-commit --fail-on error
         language: system
         types: [python]
         pass_filenames: false
@@ -308,7 +312,7 @@ git clone https://github.com/themohitkhare/pycodegate
 cd pycodegate
 uv sync --all-extras
 uv run pytest -q
-uv run py-gate . --verbose  # dogfood it
+uv run pycodegate . --verbose  # dogfood it
 ```
 
 To add a new rule:

{pycodegate-0.1.1 → pycodegate-0.1.3}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "pycodegate"
-version = "0.1.1"
-description = "One command. One score. Your Python quality gate."
+version = "0.1.3"
+description = "Trust, but verify. The quality gate for AI-generated Python code."
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
@@ -42,7 +42,7 @@ dev = [
 
 [project.scripts]
 pycodegate = "pycodegate.cli:main"
-py-gate = "pycodegate.cli:main"
+
 
 [build-system]
 requires = ["hatchling"]
@@ -70,6 +70,10 @@ ignore = ["SIM102"]  # nested ifs in AST walking are clearer than combined condi
 "src/pycodegate/rules/base.py" = ["TC001"]  # runtime import in abstract method
 "src/pycodegate/utils/*.py" = ["E501"]
 
-[tool.py-gate]
-[tool.py-gate.ignore]
-files = ["tests/fixtures/**"]
+[tool.pycodegate]
+[tool.pycodegate.ignore]
+files = ["tests/fixtures/**", "tests/**"]
+
+[tool.pycodegate.per-file-suppress]
+# Click CLI entry-points must declare all options as individual parameters
+"src/pycodegate/cli.py" = ["too-many-arguments"]

{pycodegate-0.1.1/skills/py-gate → pycodegate-0.1.3/skills/pycodegate}/SKILL.md

@@ -1,17 +1,17 @@
 ---
-name: py-gate
+name: pycodegate
 description: Run after making Python changes to catch issues early. Use when reviewing code, finishing a feature, or fixing bugs.
 version: 1.0.0
 ---
 
-# Py Gate
+# PyCodeGate
 
 Scans your Python codebase for security, performance, correctness, architecture, and structure issues. Outputs a 0-100 score with actionable diagnostics. Auto-detects Django, FastAPI, and Flask to activate framework-specific rules.
 
 ## Usage
 
 ```bash
-uvx py-gate . --verbose --diff
+uvx pycodegate . --verbose --diff
 ```
 
 ## Workflow

{pycodegate-0.1.1 → pycodegate-0.1.3}/src/pycodegate/__init__.py

@@ -1,3 +1,3 @@
 """Python Doctor - Diagnose your Python project's health."""
 
-__version__ = "0.1.1"
+__version__ = "0.1.3"