gitwit 0.1.0__tar.gz

gitwit-0.1.0/.gitignore

@@ -0,0 +1,75 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+
+# Project specific
+.gitwit/

gitwit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GitWit Contributors
+
+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.

gitwit-0.1.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: gitwit
+Version: 0.1.0
+Summary: AI-powered git commit messages, PR descriptions, and changelogs using free APIs
+Project-URL: Homepage, https://github.com/MazadiaS/gitwit
+Project-URL: Repository, https://github.com/MazadiaS/gitwit
+Project-URL: Issues, https://github.com/MazadiaS/gitwit/issues
+Author: GitWit Contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,commit,gemini,git,groq,llm,ollama
+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: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# GitWit
+
+[![PyPI version](https://badge.fury.io/py/gitwit.svg)](https://badge.fury.io/py/gitwit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+
+**Stop wasting time writing commit messages.** GitWit generates meaningful, conventional commit messages using AI — completely free.
+
+```
+$ gitwit commit
+
+Analyzing 3 file(s): +147 -12
+Generating commit message using groq (llama-3.3-70b-versatile)...
+
+Generated commit message:
+
+  feat(auth): add OAuth2 login with Google provider
+
+Options: [y]es, [e]dit, [r]egenerate, [n]o/cancel
+Accept this message? [y]: y
+
+Committed successfully!
+  [main 8f3a2b1] feat(auth): add OAuth2 login with Google provider
+```
+
+## Why GitWit?
+
+| Feature | GitWit | aicommits | GitHub Copilot |
+|---------|--------|-----------|----------------|
+| **Price** | Free forever | Free (limited) | $10/month |
+| **API Key** | Free (Groq/Gemini) | Requires OpenAI ($) | Subscription |
+| **Local Option** | Yes (Ollama) | No | No |
+| **PR Descriptions** | Yes | No | Yes |
+| **Conventional Commits** | Yes | Yes | Sometimes |
+| **Edit/Regenerate** | Yes | Limited | No |
+
+## Quick Start (3 commands)
+
+```bash
+# 1. Install
+pip install gitwit
+
+# 2. Configure (one-time, 30 seconds)
+gitwit config init
+
+# 3. Use it
+git add .
+gitwit commit
+```
+
+That's it. Your first AI-powered commit in under a minute.
+
+## Features
+
+- **Commit Messages** — Generate conventional commits from staged changes
+- **PR Descriptions** — Generate title + description from branch diffs
+- **Multiple Providers** — Groq, Google Gemini, or local Ollama
+- **Interactive** — Accept, edit, regenerate, or cancel
+- **Fast** — Sub-second generation with Groq
+
+## Installation
+
+```bash
+pip install gitwit
+```
+
+Requires Python 3.10+
+
+## Configuration
+
+### Interactive Setup (Recommended)
+
+```bash
+gitwit config init
+```
+
+This walks you through choosing a provider and setting your API key.
+
+### Manual Setup
+
+```bash
+# Set provider (groq, gemini, or ollama)
+gitwit config set provider groq
+
+# Set API key (not needed for Ollama)
+gitwit config set api-key YOUR_API_KEY
+
+# View config
+gitwit config show
+```
+
+## Usage
+
+### Generate Commit Message
+
+```bash
+# From staged changes
+git add src/
+gitwit commit
+
+# Stage all + commit
+gitwit commit --all
+
+# Auto-accept (no confirmation)
+gitwit commit --yes
+
+# Dry run (preview only)
+gitwit commit --dry-run
+```
+
+### Generate PR Description
+
+```bash
+# Compare current branch to main
+gitwit pr
+
+# Specify base branch
+gitwit pr --base develop
+
+# Dry run
+gitwit pr --dry-run
+```
+
+## Why Free?
+
+GitWit uses AI providers with generous free tiers:
+
+| Provider | Free Tier | Speed | Best For |
+|----------|-----------|-------|----------|
+| **Groq** | 30 req/min | Fastest | Daily use |
+| **Gemini** | 1,500 req/day | Fast | High volume |
+| **Ollama** | Unlimited | Varies | Privacy, offline |
+
+**Groq** is recommended — it's the fastest inference provider and the free tier is more than enough for individual developers.
+
+### Get Your Free API Key
+
+- **Groq**: [console.groq.com](https://console.groq.com) (instant, no credit card)
+- **Gemini**: [aistudio.google.com](https://aistudio.google.com) (instant, no credit card)
+- **Ollama**: [ollama.ai](https://ollama.ai) (runs locally, no API key needed)
+
+## How It Works
+
+1. GitWit reads your staged changes (`git diff --cached`)
+2. Sends the diff to your chosen AI provider
+3. AI generates a conventional commit message
+4. You review, edit, regenerate, or accept
+5. GitWit runs `git commit` with your approved message
+
+Your code never leaves your machine when using Ollama.
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+```bash
+# Development setup
+git clone https://github.com/MazadiaS/gitwit.git
+cd gitwit
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT — use it however you want.
+
+---
+
+**Like GitWit?** Give it a ⭐ on [GitHub](https://github.com/MazadiaS/gitwit)!

gitwit-0.1.0/README.md

@@ -0,0 +1,170 @@
+# GitWit
+
+[![PyPI version](https://badge.fury.io/py/gitwit.svg)](https://badge.fury.io/py/gitwit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+
+**Stop wasting time writing commit messages.** GitWit generates meaningful, conventional commit messages using AI — completely free.
+
+```
+$ gitwit commit
+
+Analyzing 3 file(s): +147 -12
+Generating commit message using groq (llama-3.3-70b-versatile)...
+
+Generated commit message:
+
+  feat(auth): add OAuth2 login with Google provider
+
+Options: [y]es, [e]dit, [r]egenerate, [n]o/cancel
+Accept this message? [y]: y
+
+Committed successfully!
+  [main 8f3a2b1] feat(auth): add OAuth2 login with Google provider
+```
+
+## Why GitWit?
+
+| Feature | GitWit | aicommits | GitHub Copilot |
+|---------|--------|-----------|----------------|
+| **Price** | Free forever | Free (limited) | $10/month |
+| **API Key** | Free (Groq/Gemini) | Requires OpenAI ($) | Subscription |
+| **Local Option** | Yes (Ollama) | No | No |
+| **PR Descriptions** | Yes | No | Yes |
+| **Conventional Commits** | Yes | Yes | Sometimes |
+| **Edit/Regenerate** | Yes | Limited | No |
+
+## Quick Start (3 commands)
+
+```bash
+# 1. Install
+pip install gitwit
+
+# 2. Configure (one-time, 30 seconds)
+gitwit config init
+
+# 3. Use it
+git add .
+gitwit commit
+```
+
+That's it. Your first AI-powered commit in under a minute.
+
+## Features
+
+- **Commit Messages** — Generate conventional commits from staged changes
+- **PR Descriptions** — Generate title + description from branch diffs
+- **Multiple Providers** — Groq, Google Gemini, or local Ollama
+- **Interactive** — Accept, edit, regenerate, or cancel
+- **Fast** — Sub-second generation with Groq
+
+## Installation
+
+```bash
+pip install gitwit
+```
+
+Requires Python 3.10+
+
+## Configuration
+
+### Interactive Setup (Recommended)
+
+```bash
+gitwit config init
+```
+
+This walks you through choosing a provider and setting your API key.
+
+### Manual Setup
+
+```bash
+# Set provider (groq, gemini, or ollama)
+gitwit config set provider groq
+
+# Set API key (not needed for Ollama)
+gitwit config set api-key YOUR_API_KEY
+
+# View config
+gitwit config show
+```
+
+## Usage
+
+### Generate Commit Message
+
+```bash
+# From staged changes
+git add src/
+gitwit commit
+
+# Stage all + commit
+gitwit commit --all
+
+# Auto-accept (no confirmation)
+gitwit commit --yes
+
+# Dry run (preview only)
+gitwit commit --dry-run
+```
+
+### Generate PR Description
+
+```bash
+# Compare current branch to main
+gitwit pr
+
+# Specify base branch
+gitwit pr --base develop
+
+# Dry run
+gitwit pr --dry-run
+```
+
+## Why Free?
+
+GitWit uses AI providers with generous free tiers:
+
+| Provider | Free Tier | Speed | Best For |
+|----------|-----------|-------|----------|
+| **Groq** | 30 req/min | Fastest | Daily use |
+| **Gemini** | 1,500 req/day | Fast | High volume |
+| **Ollama** | Unlimited | Varies | Privacy, offline |
+
+**Groq** is recommended — it's the fastest inference provider and the free tier is more than enough for individual developers.
+
+### Get Your Free API Key
+
+- **Groq**: [console.groq.com](https://console.groq.com) (instant, no credit card)
+- **Gemini**: [aistudio.google.com](https://aistudio.google.com) (instant, no credit card)
+- **Ollama**: [ollama.ai](https://ollama.ai) (runs locally, no API key needed)
+
+## How It Works
+
+1. GitWit reads your staged changes (`git diff --cached`)
+2. Sends the diff to your chosen AI provider
+3. AI generates a conventional commit message
+4. You review, edit, regenerate, or accept
+5. GitWit runs `git commit` with your approved message
+
+Your code never leaves your machine when using Ollama.
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR.
+
+```bash
+# Development setup
+git clone https://github.com/MazadiaS/gitwit.git
+cd gitwit
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT — use it however you want.
+
+---
+
+**Like GitWit?** Give it a ⭐ on [GitHub](https://github.com/MazadiaS/gitwit)!

gitwit-0.1.0/demo.txt

@@ -0,0 +1,15 @@
+$ gitwit commit
+
+Analyzing 3 file(s): +147 -12
+Generating commit message using groq (llama-3.3-70b-versatile)...
+
+Generated commit message:
+
+  feat(auth): add OAuth2 login with Google provider
+
+Options: [y]es, [e]dit, [r]egenerate, [n]o/cancel
+Accept this message? [y]: y
+
+Committed successfully!
+  [main 8f3a2b1] feat(auth): add OAuth2 login with Google provider
+   3 files changed, 147 insertions(+), 12 deletions(-)

gitwit-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "gitwit"
+version = "0.1.0"
+description = "AI-powered git commit messages, PR descriptions, and changelogs using free APIs"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "GitWit Contributors" }
+]
+keywords = ["git", "ai", "commit", "llm", "groq", "gemini", "ollama", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "click>=8.0.0",
+    "httpx>=0.25.0",
+    "tomli>=2.0.0;python_version<'3.11'",
+    "tomli-w>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[project.scripts]
+gitwit = "gitwit.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/MazadiaS/gitwit"
+Repository = "https://github.com/MazadiaS/gitwit"
+Issues = "https://github.com/MazadiaS/gitwit/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gitwit"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

gitwit-0.1.0/src/gitwit/__init__.py

@@ -0,0 +1,4 @@
+"""GitWit - AI-powered git commit messages using free APIs."""
+
+__version__ = "0.1.0"
+__author__ = "GitWit Contributors"