gitdude 1.0.0__py3-none-any.whl

gitdude-1.0.0.dist-info/METADATA

@@ -0,0 +1,305 @@
+Metadata-Version: 2.4
+Name: gitdude
+Version: 1.0.0
+Summary: AI-powered Git workflow assistant — commit, review, recover, and more with a single command
+Project-URL: Homepage, https://github.com/utkarshgupta188/gitdude
+Project-URL: Repository, https://github.com/utkarshgupta188/gitdude
+Project-URL: Documentation, https://github.com/utkarshgupta188/gitdude#readme
+Project-URL: Bug Tracker, https://github.com/utkarshgupta188/gitdude/issues
+Author: GitDude Contributors
+License: MIT
+Keywords: ai,cli,developer-tools,gemini,git,groq,ollama,openai
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: google-generativeai>=0.7.0
+Requires-Dist: groq>=0.9.0
+Requires-Dist: ollama>=0.2.0
+Requires-Dist: openai>=1.30.0
+Requires-Dist: pyperclip>=1.8.2
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer[all]>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# GitDude 🧠
+
+[![PyPI version](https://img.shields.io/pypi/v/gitwise.svg)](https://pypi.org/project/gitwise/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://img.shields.io/pypi/dm/gitwise)](https://pypi.org/project/gitwise/)
+
+**GitDude is an AI-powered Git workflow assistant that turns plain English into git actions — commit, review, recover, and understand your repo from the terminal.**
+
+---
+
+## ✨ Features
+
+- 🤖 **Multi-provider AI** — Gemini (default, free), Groq (fastest), Ollama (100% local), OpenAI
+- 💬 **Natural language commands** — `gitwise do "stash, switch to main, pull"`
+- 🔍 **AI code review** — bugs, security issues, quality flags before you push
+- 🚑 **Emergency recovery** — `gitwise whoops` diagnoses and fixes git disasters
+- 📋 **PR generation** — full GitHub PR description, auto-copied to clipboard
+- 🎨 **Beautiful Rich UI** — tables, panels, spinners, color-coded output
+- 🔐 **Secure config** — keys stored in `~/.gitdude/config.json`, never in `.env`
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# 1. Install
+pip install gitdude
+
+# 2. Configure (takes 60 seconds)
+gitwise config
+
+# 3. Generate an AI commit message and push
+gitwise push
+
+# 4. Review your code before merging
+gitwise review
+
+# 5. Something went wrong? Ask for help
+gitwise whoops
+```
+
+---
+
+## 📦 Installation
+
+```bash
+pip install gitdude
+```
+
+**Python 3.10+ required.**
+
+---
+
+## 🔑 Provider Setup
+
+### Google Gemini (Default — Free)
+
+1. Get an API key from [Google AI Studio](https://aistudio.google.com/app/apikey)
+2. Run `gitwise config` → choose `gemini` → paste key
+
+### Groq (Fastest Free Tier)
+
+1. Get a key at [console.groq.com/keys](https://console.groq.com/keys)
+2. Run `gitwise config` → choose `groq` → paste key
+
+### Ollama (100% Local/Offline)
+
+1. Install Ollama: [ollama.ai](https://ollama.ai)
+2. Pull a model: `ollama pull llama3`
+3. Run `gitwise config` → choose `ollama` (no key needed)
+
+### OpenAI
+
+1. Get a key at [platform.openai.com](https://platform.openai.com/api-keys)
+2. Run `gitwise config` → choose `openai` → paste key
+
+---
+
+## 📖 Command Reference
+
+### `gitwise push`
+
+AI-generates a commit message for your changes, lets you confirm/edit, then commits and pushes.
+
+```bash
+gitwise push                      # Stage all → AI commit → push
+gitwise push --no-confirm         # Skip confirmation
+gitwise push --dry-run            # Preview only, don't execute
+gitwise push --style freeform     # Use freeform (not conventional) commit style
+```
+
+**Commit types (conventional):** `feat`, `fix`, `chore`, `docs`, `refactor`, `style`, `test`, `perf`, `ci`
+
+---
+
+### `gitwise sync`
+
+Fetch + rebase. If there are merge conflicts, AI explains what's conflicting and gives exact resolution steps.
+
+```bash
+gitwise sync
+gitwise sync --dry-run
+```
+
+---
+
+### `gitwise back`
+
+Shows last 30 commits in a table. Pick one to go back to, choose a mode.
+
+```bash
+gitwise back
+gitwise back --dry-run
+```
+
+**Modes:** `soft` (keep changes staged), `hard` (discard changes), `checkout` (detached HEAD), `branch` (new branch from that commit)
+
+---
+
+### `gitwise undo "<description>"`
+
+Describe what went wrong — AI reads your log and reflog to determine the safest recovery.
+
+```bash
+gitwise undo "I accidentally committed my .env file"
+gitwise undo "I deleted the wrong branch"
+gitwise undo "I made a mess of the last 3 commits" --dry-run
+```
+
+---
+
+### `gitwise do "<natural language>"`
+
+Convert plain English into a sequence of git commands, preview, then execute.
+
+```bash
+gitwise do "stash my changes, switch to main, pull latest"
+gitwise do "create a new branch called feature/auth and push it"
+gitwise do "squash my last 3 commits" --dry-run
+```
+
+If any command fails, AI reads the error and suggests a fix.
+
+---
+
+### `gitwise review`
+
+Diffs your current branch vs main/master, then AI reviews for bugs, security issues, and quality.
+
+```bash
+gitwise review
+gitwise review --base develop     # Compare against a different branch
+gitwise review --dry-run          # Show diff without AI review
+```
+
+**Review sections:** Summary · ⚠️ Potential Bugs · 🔒 Security Issues · 📏 Code Quality · 🔍 Things to Check · ✅ Overall Assessment
+
+---
+
+### `gitwise pr`
+
+Generates a complete PR title + description + bullet list + testing notes. Auto-copies to clipboard.
+
+```bash
+gitwise pr
+gitwise pr --base develop         # Compare against develop
+gitwise pr --no-copy              # Don't copy to clipboard
+```
+
+---
+
+### `gitwise explain`
+
+Reads your last 5 reflog entries and explains in plain English what happened.
+
+```bash
+gitwise explain
+```
+
+---
+
+### `gitwise whoops`
+
+Emergency recovery. Feeds git status + log + reflog to AI. Diagnoses what went wrong and gives step-by-step recovery.
+
+```bash
+gitwise whoops
+gitwise whoops --dry-run          # Diagnose only, don't execute
+```
+
+---
+
+### `gitwise config`
+
+Interactive configuration wizard.
+
+```bash
+gitwise config                    # Run setup
+gitwise config --show             # Print current config (keys masked)
+gitwise config --reset            # Wipe config and redo setup
+```
+
+**Stored settings:**
+- AI provider (`gemini` / `groq` / `ollama` / `openai`)
+- API key per provider
+- Model name per provider
+- Default branch (`main` or `master`)
+- Commit style (`conventional` or `freeform`)
+
+---
+
+## 🏗️ Architecture
+
+```
+gitwise/
+├── main.py        # Typer app — all command definitions
+├── ai.py          # Unified AI provider wrapper (ask_ai)
+├── git_ops.py     # GitPython operations (diff, log, push, reset…)
+├── config.py      # Config at ~/.gitdude/config.json
+└── utils.py       # Rich panels, tables, prompts, helpers
+```
+
+**AI Providers (`ai.py`):**
+
+| Provider | SDK | Default Model | Speed | Cost |
+|---|---|---|---|---|
+| `gemini` | `google-generativeai` | `gemini-2.0-flash` | Fast | Free tier |
+| `groq` | `groq` | `llama-3.3-70b-versatile` | Fastest | Free tier |
+| `ollama` | `ollama` | `llama3` | Local | Free (local) |
+| `openai` | `openai` | `gpt-4o-mini` | Fast | Pay per use |
+
+All providers go through a single interface: `ask_ai(prompt) -> str` with spinner feedback and unified error handling.
+
+---
+
+## 🛡️ Safety Features
+
+- ✅ **All destructive operations** (hard reset, force push, etc.) require explicit confirmation
+- ✅ **`--dry-run` flag** available on all mutating commands
+- ✅ **Color-coded risk levels** — green (safe), yellow (caution), red (destructive)
+- ✅ **No tracebacks** — all exceptions caught and shown as friendly Rich error panels
+- ✅ **API keys** stored privately in `~/.gitdude/config.json`, never in project files
+
+---
+
+## 🤝 Contributing
+
+1. Fork the repo
+2. Create a feature branch: `git checkout -b feat/amazing-feature`
+3. Make your changes
+4. Run linting: `ruff check .`
+5. Open a PR — or just use `gitwise pr` to generate your PR description! 😄
+
+**Dev setup:**
+```bash
+git clone https://github.com/gitwise/gitwise
+cd gitwise
+pip install -e ".[dev]"
+```
+
+---
+
+## 📄 License
+
+MIT © GitWise Contributors

gitdude-1.0.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+gitwise/__init__.py,sha256=mXFDA4plrZAZBHC1UQTMQRovGMNs4fHgCVNP-nwoSGM,132
+gitwise/ai.py,sha256=fIcRAzlFxy4IIT6oiBOuRNie7B0STD5iPil00tJ_bKM,4757
+gitwise/config.py,sha256=MfPlqAJ2pAwF4fNHl7imFYY-wXDj4Bxec-z_4MZKo1Q,2902
+gitwise/git_ops.py,sha256=BIvF7l-OU8MwxKP7DqYA2DzTsDpQypQ5SLujwKR6sW0,6759
+gitwise/main.py,sha256=xylYXLW_xP6Ui-YIM1_7d2TzwJFvizVGuhaPeRJw52s,31504
+gitwise/utils.py,sha256=VV4RJ9Uqbf-XWbtwSIk_DGLO_0NMhQ80X9pFLB-Blgc,5154
+gitdude-1.0.0.dist-info/METADATA,sha256=jL8pf71h4IZMIaXEQbTcYrygZAaPtBhPpBKf7D0I0Os,8874
+gitdude-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+gitdude-1.0.0.dist-info/entry_points.txt,sha256=AWdMzCVsC0k4pMbdRnbB5aYpNsrkoiwi3rLuYis36JM,46
+gitdude-1.0.0.dist-info/RECORD,,

gitdude-1.0.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

gitdude-1.0.0.dist-info/entry_points.txt

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

gitwise/__init__.py

@@ -0,0 +1,5 @@
+"""GitDude — AI-powered Git workflow assistant."""
+
+__version__ = "1.0.0"
+__author__ = "GitDude Contributors"
+__license__ = "MIT"

gitwise/ai.py

@@ -0,0 +1,148 @@
+"""
+ai.py — Unified AI provider wrapper.
+
+Single public function: ask_ai(prompt: str) -> str
+Supports: gemini, groq, ollama, openai
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Optional
+
+from rich.console import Console
+from rich.live import Live
+from rich.spinner import Spinner
+
+from gitwise.config import (
+    get_config,
+    get_current_provider,
+    get_model_for_provider,
+    get_provider_api_key,
+    is_configured,
+)
+
+console = Console()
+
+
+def _spinner_context(message: str = "🤖 Thinking..."):
+    """Return a Rich Live context showing a spinner."""
+    return Live(Spinner("dots", text=f"[bold magenta]{message}[/bold magenta]"), console=console, transient=True)
+
+
+# ---------------------------------------------------------------------------
+# Provider implementations
+# ---------------------------------------------------------------------------
+
+def _ask_gemini(prompt: str, model: str, api_key: str) -> str:
+    try:
+        import google.generativeai as genai  # type: ignore
+    except ImportError:
+        raise RuntimeError(
+            "google-generativeai is not installed. Run: pip install google-generativeai"
+        )
+    genai.configure(api_key=api_key)
+    client = genai.GenerativeModel(model)
+    response = client.generate_content(prompt)
+    return response.text.strip()
+
+
+def _ask_groq(prompt: str, model: str, api_key: str) -> str:
+    try:
+        from groq import Groq  # type: ignore
+    except ImportError:
+        raise RuntimeError("groq is not installed. Run: pip install groq")
+    client = Groq(api_key=api_key)
+    chat_completion = client.chat.completions.create(
+        messages=[{"role": "user", "content": prompt}],
+        model=model,
+    )
+    return chat_completion.choices[0].message.content.strip()
+
+
+def _ask_ollama(prompt: str, model: str, **_kwargs) -> str:
+    try:
+        import ollama  # type: ignore
+    except ImportError:
+        raise RuntimeError("ollama is not installed. Run: pip install ollama")
+    response = ollama.chat(
+        model=model,
+        messages=[{"role": "user", "content": prompt}],
+    )
+    return response["message"]["content"].strip()
+
+
+def _ask_openai(prompt: str, model: str, api_key: str) -> str:
+    try:
+        from openai import OpenAI  # type: ignore
+    except ImportError:
+        raise RuntimeError("openai is not installed. Run: pip install openai")
+    client = OpenAI(api_key=api_key)
+    completion = client.chat.completions.create(
+        model=model,
+        messages=[{"role": "user", "content": prompt}],
+    )
+    return completion.choices[0].message.content.strip()
+
+
+# ---------------------------------------------------------------------------
+# Public interface
+# ---------------------------------------------------------------------------
+
+def ask_ai(prompt: str, spinner_msg: str = "🤖 Thinking...") -> str:
+    """
+    Send a prompt to the configured AI provider and return the response.
+    Shows a Rich spinner while waiting.
+    Raises SystemExit on unrecoverable errors.
+    """
+    from gitwise.utils import error_panel  # late import to avoid circular
+
+    if not is_configured():
+        error_panel(
+            "GitWise is not configured yet.\nRun [bold cyan]gitwise config[/bold cyan] to get started.",
+            title="❌ Not Configured",
+        )
+        sys.exit(1)
+
+    cfg = get_config()
+    provider = get_current_provider()
+    model = get_model_for_provider(provider)
+    api_key = get_provider_api_key(provider)
+
+    if provider != "ollama" and not api_key:
+        error_panel(
+            f"No API key found for provider [bold]{provider}[/bold].\n"
+            f"Run [bold cyan]gitwise config[/bold cyan] to set your key.",
+            title="❌ Missing API Key",
+        )
+        sys.exit(1)
+
+    provider_fn = {
+        "gemini": _ask_gemini,
+        "groq": _ask_groq,
+        "ollama": _ask_ollama,
+        "openai": _ask_openai,
+    }.get(provider)
+
+    if provider_fn is None:
+        error_panel(
+            f"Unknown provider: [bold]{provider}[/bold]\n"
+            f"Run [bold cyan]gitwise config[/bold cyan] to choose a valid provider.",
+            title="❌ Invalid Provider",
+        )
+        sys.exit(1)
+
+    try:
+        with _spinner_context(spinner_msg):
+            result = provider_fn(prompt=prompt, model=model, api_key=api_key)
+        return result
+    except RuntimeError as exc:
+        error_panel(str(exc), title="❌ AI Provider Error")
+        sys.exit(1)
+    except Exception as exc:  # noqa: BLE001
+        error_panel(
+            f"An error occurred while calling [bold]{provider}[/bold]:\n{exc}\n\n"
+            "Check your API key, network connection, and model name.",
+            title="❌ AI Call Failed",
+        )
+        sys.exit(1)

gitwise/config.py

@@ -0,0 +1,106 @@
+"""
+config.py — GitWise configuration management.
+Stores config in ~/.gitwise/config.json.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+from typing import Any
+
+CONFIG_DIR = Path.home() / ".gitwise"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+PROVIDERS = ["gemini", "groq", "ollama", "openai"]
+
+DEFAULTS: dict[str, Any] = {
+    "provider": "gemini",
+    "model": {
+        "gemini": "gemini-2.0-flash",
+        "groq": "llama-3.3-70b-versatile",
+        "ollama": "llama3",
+        "openai": "gpt-4o-mini",
+    },
+    "api_key": {
+        "gemini": "",
+        "groq": "",
+        "ollama": "",
+        "openai": "",
+    },
+    "default_branch": "main",
+    "commit_style": "conventional",
+}
+
+
+def load_config() -> dict[str, Any]:
+    """Load config from disk, returning defaults if missing."""
+    if not CONFIG_FILE.exists():
+        return {}
+    try:
+        with open(CONFIG_FILE, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except (json.JSONDecodeError, OSError):
+        return {}
+
+
+def save_config(cfg: dict[str, Any]) -> None:
+    """Persist config to disk."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
+        json.dump(cfg, f, indent=2)
+
+
+def get_config() -> dict[str, Any]:
+    """Return merged config with defaults."""
+    cfg = load_config()
+    # Deep merge with defaults
+    merged = {
+        "provider": cfg.get("provider", DEFAULTS["provider"]),
+        "model": {**DEFAULTS["model"], **cfg.get("model", {})},
+        "api_key": {**DEFAULTS["api_key"], **cfg.get("api_key", {})},
+        "default_branch": cfg.get("default_branch", DEFAULTS["default_branch"]),
+        "commit_style": cfg.get("commit_style", DEFAULTS["commit_style"]),
+    }
+    return merged
+
+
+def is_configured() -> bool:
+    """Return True if a config file exists with at least a provider set."""
+    return CONFIG_FILE.exists()
+
+
+def get_provider_api_key(provider: str) -> str:
+    """Get API key for the given provider from config."""
+    cfg = get_config()
+    # Also allow environment variable overrides
+    env_map = {
+        "gemini": "GEMINI_API_KEY",
+        "groq": "GROQ_API_KEY",
+        "openai": "OPENAI_API_KEY",
+        "ollama": "",
+    }
+    env_key = env_map.get(provider, "")
+    if env_key:
+        env_val = os.environ.get(env_key, "")
+        if env_val:
+            return env_val
+    return cfg.get("api_key", {}).get(provider, "")
+
+
+def get_current_provider() -> str:
+    return get_config().get("provider", "gemini")
+
+
+def get_model_for_provider(provider: str) -> str:
+    return get_config().get("model", {}).get(provider, DEFAULTS["model"].get(provider, ""))
+
+
+def mask_key(key: str) -> str:
+    """Mask an API key for display."""
+    if not key:
+        return "<not set>"
+    if len(key) <= 8:
+        return "****"
+    return key[:4] + "****" + key[-4:]