commitguard-ai 0.1.0__tar.gz

commitguard_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PierrunoYT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

commitguard_ai-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: commitguard-ai
+Version: 0.1.0
+Summary: AI-powered tool to analyze Git commits for bugs and issues
+Author: CommitGuard
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/PierrunoYT/commitguard
+Project-URL: Repository, https://github.com/PierrunoYT/commitguard
+Project-URL: Issues, https://github.com/PierrunoYT/commitguard/issues
+Keywords: git,commit,ai,code-review,openai,cli,commitguard,commitguard-ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# CommitGuard
+
+AI-powered CLI that analyzes Git commits for bugs, security issues, and code quality problems.
+
+**[GitHub](https://github.com/PierrunoYT/commitguard)**
+
+## Requirements
+
+- Python 3.9+
+- OpenAI API key
+
+## Installation
+
+From PyPI:
+
+```bash
+pip install commitguard-ai
+```
+
+From source (development):
+
+```bash
+pip install -e .
+```
+
+Or install dependencies only:
+
+```bash
+pip install -r requirements.txt
+```
+
+## Configuration
+
+Set your OpenAI API key:
+
+```bash
+# Linux / macOS
+export OPENAI_API_KEY=sk-...
+
+# Windows (PowerShell)
+$env:OPENAI_API_KEY = "sk-..."
+```
+
+Or pass it via `--api-key` when running commands.
+
+## Usage
+
+**Analyze the last commit (HEAD):**
+```bash
+commitguard analyze
+```
+
+**Analyze a specific commit:**
+```bash
+commitguard analyze abc123
+```
+
+**Analyze last 5 commits:**
+```bash
+commitguard analyze -n 5
+```
+
+**Analyze staged changes (before committing):**
+```bash
+commitguard check
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-r, --repo PATH` | Path to Git repository (default: current dir) |
+| `--api-key KEY` | OpenAI API key (or use `OPENAI_API_KEY` env) |
+| `--model MODEL` | Model to use (default: `gpt-4o-mini`) |
+
+## Development
+
+Run from source without installing:
+
+```bash
+python -m commitguard.cli analyze
+```
+
+## License
+
+[MIT](LICENSE)
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history.

commitguard_ai-0.1.0/README.md

@@ -0,0 +1,90 @@
+# CommitGuard
+
+AI-powered CLI that analyzes Git commits for bugs, security issues, and code quality problems.
+
+**[GitHub](https://github.com/PierrunoYT/commitguard)**
+
+## Requirements
+
+- Python 3.9+
+- OpenAI API key
+
+## Installation
+
+From PyPI:
+
+```bash
+pip install commitguard-ai
+```
+
+From source (development):
+
+```bash
+pip install -e .
+```
+
+Or install dependencies only:
+
+```bash
+pip install -r requirements.txt
+```
+
+## Configuration
+
+Set your OpenAI API key:
+
+```bash
+# Linux / macOS
+export OPENAI_API_KEY=sk-...
+
+# Windows (PowerShell)
+$env:OPENAI_API_KEY = "sk-..."
+```
+
+Or pass it via `--api-key` when running commands.
+
+## Usage
+
+**Analyze the last commit (HEAD):**
+```bash
+commitguard analyze
+```
+
+**Analyze a specific commit:**
+```bash
+commitguard analyze abc123
+```
+
+**Analyze last 5 commits:**
+```bash
+commitguard analyze -n 5
+```
+
+**Analyze staged changes (before committing):**
+```bash
+commitguard check
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-r, --repo PATH` | Path to Git repository (default: current dir) |
+| `--api-key KEY` | OpenAI API key (or use `OPENAI_API_KEY` env) |
+| `--model MODEL` | Model to use (default: `gpt-4o-mini`) |
+
+## Development
+
+Run from source without installing:
+
+```bash
+python -m commitguard.cli analyze
+```
+
+## License
+
+[MIT](LICENSE)
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history.

commitguard_ai-0.1.0/commitguard/__init__.py

@@ -0,0 +1,3 @@
+"""CommitGuard - AI-powered Git commit analysis for bugs and issues."""
+
+__version__ = "0.1.0"

commitguard_ai-0.1.0/commitguard/analyzer.py

@@ -0,0 +1,77 @@
+"""Commit analysis using AI."""
+
+from git import Repo
+from openai import OpenAI
+
+
+SYSTEM_PROMPT = """You are a code review assistant. Analyze Git commits for:
+1. Potential bugs and logic errors
+2. Security vulnerabilities
+3. Code quality issues
+4. Missing error handling or validation
+5. Performance concerns
+
+Respond in markdown. Be concise. If nothing concerning is found, say "No issues detected."
+"""
+
+
+def _get_diff(repo: Repo, commit) -> str:
+    """Get diff for a commit."""
+    if commit.parents:
+        diff = repo.git.diff(commit.parents[0], commit)
+    else:
+        diff = repo.git.show(commit, format="", no_patch=False)
+    return diff[:12000]  # Limit context size
+
+
+def _call_ai(diff: str, message: str, files: list[str], api_key: str, model: str) -> str:
+    """Call OpenAI API for analysis."""
+    client = OpenAI(api_key=api_key)
+    user_content = f"""Analyze this commit:
+
+**Message:** {message}
+**Files:** {', '.join(files) if files else 'N/A'}
+
+**Diff:**
+```
+{diff or '(no diff)'}
+```
+"""
+    response = client.chat.completions.create(
+        model=model,
+        messages=[
+            {"role": "system", "content": SYSTEM_PROMPT},
+            {"role": "user", "content": user_content},
+        ],
+    )
+    return response.choices[0].message.content or "No response."
+
+
+def analyze_commit(
+    repo_path: str,
+    ref: str = "HEAD",
+    *,
+    api_key: str,
+    model: str = "gpt-4o-mini",
+) -> str:
+    """Analyze a specific commit."""
+    repo = Repo(repo_path)
+    commit = repo.commit(ref)
+    diff = _get_diff(repo, commit)
+    files = [d.a_path for d in commit.diff(commit.parents[0] if commit.parents else None, create_patch=False)]
+    return _call_ai(diff, commit.message, files, api_key, model)
+
+
+def analyze_staged(
+    repo_path: str,
+    *,
+    api_key: str,
+    model: str = "gpt-4o-mini",
+) -> str:
+    """Analyze staged changes."""
+    repo = Repo(repo_path)
+    diff = repo.git.diff("--cached")
+    if not diff.strip():
+        return "No staged changes to analyze."
+    files = repo.git.diff("--cached", "--name-only").splitlines()
+    return _call_ai(diff, "(staged changes)", files, api_key, model)

commitguard_ai-0.1.0/commitguard/cli.py

@@ -0,0 +1,122 @@
+"""CLI for CommitGuard."""
+
+import os
+from pathlib import Path
+
+import click
+
+from .analyzer import analyze_commit, analyze_staged
+from . import __version__
+
+
+def get_repo_path(path: str | None) -> Path:
+    """Resolve repository path. Defaults to current directory."""
+    repo_path = Path(path or ".").resolve()
+    if not (repo_path / ".git").exists():
+        raise click.ClickException(f"Not a Git repository: {repo_path}")
+    return repo_path
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="CommitGuard")
+def main() -> None:
+    """AI-powered tool to analyze Git commits for bugs and issues."""
+    pass
+
+
+@main.command()
+@click.argument("commit", default="HEAD", required=False)
+@click.option(
+    "-r",
+    "--repo",
+    "repo_path",
+    type=click.Path(exists=True, file_okay=False, path_type=Path),
+    default=".",
+    help="Path to Git repository.",
+)
+@click.option(
+    "-n",
+    "--count",
+    type=int,
+    default=1,
+    help="Number of commits to analyze (when using HEAD~n).",
+)
+@click.option(
+    "--api-key",
+    envvar="OPENAI_API_KEY",
+    help="OpenAI API key (or set OPENAI_API_KEY).",
+)
+@click.option(
+    "--model",
+    default="gpt-4o-mini",
+    help="OpenAI model to use.",
+)
+def analyze(
+    commit: str,
+    repo_path: Path,
+    count: int,
+    api_key: str | None,
+    model: str,
+) -> None:
+    """Analyze one or more commits for bugs and issues."""
+    repo = get_repo_path(str(repo_path))
+    key = api_key or os.environ.get("OPENAI_API_KEY")
+    if not key:
+        raise click.ClickException(
+            "OpenAI API key required. Set OPENAI_API_KEY or use --api-key."
+        )
+
+    refs = [commit] if count == 1 else [f"HEAD~{i}" for i in range(count)]
+    for ref in refs:
+        try:
+            result = analyze_commit(str(repo), ref, api_key=key, model=model)
+            click.echo()
+            click.secho(f"Commit: {ref}", fg="cyan", bold=True)
+            click.echo(result)
+            click.echo()
+        except Exception as e:
+            click.echo(click.style(f"Error analyzing {ref}: {e}", fg="red"))
+
+
+@main.command()
+@click.option(
+    "-r",
+    "--repo",
+    "repo_path",
+    type=click.Path(exists=True, file_okay=False, path_type=Path),
+    default=".",
+    help="Path to Git repository.",
+)
+@click.option(
+    "--api-key",
+    envvar="OPENAI_API_KEY",
+    help="OpenAI API key (or set OPENAI_API_KEY).",
+)
+@click.option(
+    "--model",
+    default="gpt-4o-mini",
+    help="OpenAI model to use.",
+)
+def check(
+    repo_path: Path,
+    api_key: str | None,
+    model: str,
+) -> None:
+    """Analyze staged changes (before commit)."""
+    repo = get_repo_path(str(repo_path))
+    key = api_key or os.environ.get("OPENAI_API_KEY")
+    if not key:
+        raise click.ClickException(
+            "OpenAI API key required. Set OPENAI_API_KEY or use --api-key."
+        )
+
+    click.echo("Analyzing staged changes...")
+    try:
+        result = analyze_staged(str(repo), api_key=key, model=model)
+        click.echo(result)
+    except Exception as e:
+        raise click.ClickException(str(e))
+
+
+if __name__ == "__main__":
+    main()

commitguard_ai-0.1.0/commitguard_ai.egg-info/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: commitguard-ai
+Version: 0.1.0
+Summary: AI-powered tool to analyze Git commits for bugs and issues
+Author: CommitGuard
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/PierrunoYT/commitguard
+Project-URL: Repository, https://github.com/PierrunoYT/commitguard
+Project-URL: Issues, https://github.com/PierrunoYT/commitguard/issues
+Keywords: git,commit,ai,code-review,openai,cli,commitguard,commitguard-ai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# CommitGuard
+
+AI-powered CLI that analyzes Git commits for bugs, security issues, and code quality problems.
+
+**[GitHub](https://github.com/PierrunoYT/commitguard)**
+
+## Requirements
+
+- Python 3.9+
+- OpenAI API key
+
+## Installation
+
+From PyPI:
+
+```bash
+pip install commitguard-ai
+```
+
+From source (development):
+
+```bash
+pip install -e .
+```
+
+Or install dependencies only:
+
+```bash
+pip install -r requirements.txt
+```
+
+## Configuration
+
+Set your OpenAI API key:
+
+```bash
+# Linux / macOS
+export OPENAI_API_KEY=sk-...
+
+# Windows (PowerShell)
+$env:OPENAI_API_KEY = "sk-..."
+```
+
+Or pass it via `--api-key` when running commands.
+
+## Usage
+
+**Analyze the last commit (HEAD):**
+```bash
+commitguard analyze
+```
+
+**Analyze a specific commit:**
+```bash
+commitguard analyze abc123
+```
+
+**Analyze last 5 commits:**
+```bash
+commitguard analyze -n 5
+```
+
+**Analyze staged changes (before committing):**
+```bash
+commitguard check
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-r, --repo PATH` | Path to Git repository (default: current dir) |
+| `--api-key KEY` | OpenAI API key (or use `OPENAI_API_KEY` env) |
+| `--model MODEL` | Model to use (default: `gpt-4o-mini`) |
+
+## Development
+
+Run from source without installing:
+
+```bash
+python -m commitguard.cli analyze
+```
+
+## License
+
+[MIT](LICENSE)
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for version history.

commitguard_ai-0.1.0/commitguard_ai.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+commitguard/__init__.py
+commitguard/analyzer.py
+commitguard/cli.py
+commitguard_ai.egg-info/PKG-INFO
+commitguard_ai.egg-info/SOURCES.txt
+commitguard_ai.egg-info/dependency_links.txt
+commitguard_ai.egg-info/entry_points.txt
+commitguard_ai.egg-info/requires.txt
+commitguard_ai.egg-info/top_level.txt

commitguard_ai-0.1.0/commitguard_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

commitguard_ai-0.1.0/commitguard_ai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+commitguard = commitguard.cli:main

commitguard_ai-0.1.0/commitguard_ai.egg-info/requires.txt

@@ -0,0 +1,8 @@
+click>=8.1.0
+gitpython>=3.1.0
+openai>=1.0.0
+python-dotenv>=1.0.0
+
+[dev]
+pytest>=7.0
+ruff>=0.1.0

commitguard_ai-0.1.0/commitguard_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+commitguard

commitguard_ai-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "commitguard-ai"
+version = "0.1.0"
+description = "AI-powered tool to analyze Git commits for bugs and issues"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    {name = "CommitGuard"}
+]
+keywords = ["git", "commit", "ai", "code-review", "openai", "cli", "commitguard", "commitguard-ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "click>=8.1.0",
+    "gitpython>=3.1.0",
+    "openai>=1.0.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/PierrunoYT/commitguard"
+Repository = "https://github.com/PierrunoYT/commitguard"
+Issues = "https://github.com/PierrunoYT/commitguard/issues"
+
+[project.scripts]
+commitguard = "commitguard.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["commitguard*"]

commitguard_ai-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+