gitwit 0.1.0__py3-none-any.whl

gitwit-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,12 @@
+gitwit/__init__.py,sha256=HOgI5ZNgW_gtDehE1pd0oSf2K3r0YGuDz4USiV6U7jo,121
+gitwit/ai.py,sha256=OEYgVMoKlchFL0OD5vFfVJBTB1gnClmhfjKHROjWhng,9945
+gitwit/cli.py,sha256=M1ptTCQpbDbZF1nsNUPBktJFsrqi6yytvrBNYMERVVI,16469
+gitwit/config.py,sha256=remDuYt_Y-LW6m3wYzu82mfmx9rh_QONHwI5ZjvxZXU,3756
+gitwit/git.py,sha256=_4eHmOrxpDtcIoKw9ltySOFDGLS35RBvjc9kQifcDqw,7779
+gitwit/license.py,sha256=SKzq8bkIllXv-N8nl3rrpOJQY_zi9LUk7uXxNRn3vO0,3395
+gitwit/prompts.py,sha256=b2seG4gg_NAwgelEBeIJffil-QqNnBFPUM_k-oxK8f4,4943
+gitwit-0.1.0.dist-info/METADATA,sha256=FcNmYjjb80uvE6F3jGiVnWctGd-6x92UzsLLouR-UkM,5296
+gitwit-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+gitwit-0.1.0.dist-info/entry_points.txt,sha256=S-SLzShZN_MQ_eOSZ3PkKZn9BsD1a99hQhV_74DwY7E,43
+gitwit-0.1.0.dist-info/licenses/LICENSE,sha256=4OzyL-5X29jLq67l7tKYR0AZenzr5GM95O0mad8-704,1076
+gitwit-0.1.0.dist-info/RECORD,,

gitwit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

gitwit-0.1.0.dist-info/entry_points.txt

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

gitwit-0.1.0.dist-info/licenses/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.