ollama-git-commit 0.1.0__tar.gz

ollama_git_commit-0.1.0/.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# GitHub Sponsors configuration
+
+github: himanshu231204
+custom: ["https://www.buymeacoffee.com/himanshu231204"]

ollama_git_commit-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,40 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: '[BUG] '
+labels: bug
+assignees: himanshu231204
+
+---
+
+## Bug Description
+A clear and concise description of the bug.
+
+## Steps to Reproduce
+1. Go to '...'
+2. Run command '...'
+3. See error
+
+## Expected Behavior
+What you expected to happen.
+
+## Actual Behavior
+What actually happened.
+
+## Screenshots
+If applicable, add screenshots to help explain your problem.
+
+## Environment
+- OS: [e.g., Ubuntu 22.04, macOS 13, Windows 11]
+- Python Version: [e.g., 3.10.5]
+- AI Commit Version: [e.g., 0.1.0]
+- Ollama Version: [e.g., 0.1.14]
+- Model Used: [e.g., llama2]
+
+## Additional Context
+Add any other context about the problem here.
+
+## Error Logs
+```
+Paste any error messages or logs here
+```

ollama_git_commit-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,31 @@
+---
+name: Feature Request
+about: Suggest a new feature for AI Commit
+title: '[FEATURE] '
+labels: enhancement
+assignees: himanshu231204
+
+---
+
+## Feature Description
+A clear and concise description of the feature you'd like to see.
+
+## Problem Statement
+What problem does this feature solve? Why do you need it?
+
+## Proposed Solution
+How do you envision this feature working?
+
+## Alternative Solutions
+Have you considered any alternative approaches?
+
+## Use Cases
+Provide specific examples of how this feature would be used.
+
+## Additional Context
+Add any other context, mockups, or examples about the feature request here.
+
+## Would you like to implement this?
+- [ ] Yes, I'd like to work on this feature
+- [ ] No, but I can help test it
+- [ ] I'm just suggesting the idea

ollama_git_commit-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,51 @@
+# Pull Request
+
+## Description
+<!-- Provide a brief description of the changes in this PR -->
+
+## Type of Change
+<!-- Mark the relevant option with an 'x' -->
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring
+- [ ] Performance improvement
+- [ ] Other (please describe):
+
+## Related Issues
+<!-- Link to related issues using #issue_number -->
+Closes #
+
+## Changes Made
+<!-- List the specific changes made in this PR -->
+- 
+- 
+- 
+
+## Testing
+<!-- Describe the tests you ran to verify your changes -->
+- [ ] Tested on local machine
+- [ ] All existing tests pass
+- [ ] Added new tests (if applicable)
+- [ ] Tested with different Ollama models
+- [ ] Tested on multiple operating systems
+
+## Screenshots/Output
+<!-- If applicable, add screenshots or command output to demonstrate the changes -->
+
+## Checklist
+- [ ] My code follows the project's code style (PEP 8)
+- [ ] I have commented my code where necessary
+- [ ] I have updated the documentation (README, etc.)
+- [ ] My changes generate no new warnings
+- [ ] I have tested my changes thoroughly
+- [ ] All tests pass locally
+- [ ] I have added myself to contributors (if applicable)
+
+## Additional Notes
+<!-- Any additional information that reviewers should know -->
+
+---
+
+Thank you for contributing to AI Commit! 🎉

ollama_git_commit-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,66 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+    
+    - name: Lint with flake8
+      run: |
+        pip install flake8
+        # Stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # Exit-zero treats all errors as warnings
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    
+    - name: Test import
+      run: |
+        python -c "from ai_commit import OllamaClient, GitService, CommitGenerator"
+    
+    - name: Check script execution
+      run: |
+        python ai_commit.py --help || true
+
+  lint:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install black isort flake8
+    
+    - name: Check formatting with black
+      run: black --check . || true
+    
+    - name: Check import sorting with isort
+      run: isort --check-only . || true

ollama_git_commit-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:  # Manual trigger option
+
+jobs:
+  pypi-publish:
+    name: Upload release to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi 
+      url: https://pypi.org/p/ai-commit-cli
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+      
+      - name: Build package
+        run: python -m build
+      
+      - name: Check package
+        run: twine check dist/*
+      
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

ollama_git_commit-0.1.0/.gitignore

@@ -0,0 +1,44 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/

ollama_git_commit-0.1.0/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to AI Commit will be documented in this file.
+
+## [0.1.0] - 2024-03-05
+
+### Added
+- Initial release
+- AI-powered commit message generation using local Ollama
+- Support for multiple commit styles (Conventional, Semantic, Detailed)
+- Interactive CLI with colored output
+- Multiple Ollama model support
+- Cross-platform support (Linux, macOS, Windows)
+- Privacy-first local AI processing
+- Offline capability
+
+### Features
+- Command-line interface
+- Beautiful terminal UI
+- Error handling and validation
+- Git repository validation
+- Interactive user prompts
+
+---
+
+## How to Update Version
+
+1. Update version in `setup.py` and `pyproject.toml`
+2. Add changes to this CHANGELOG
+3. Commit: `git commit -m "chore: bump version to X.Y.Z"`
+4. Tag: `git tag -a vX.Y.Z -m "Release vX.Y.Z"`
+5. Push: `git push origin main --tags`
+6. Build and publish to PyPI

ollama_git_commit-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,198 @@
+# Contributing to AI Commit
+
+Thank you for your interest in contributing to AI Commit! 🎉
+
+## Ways to Contribute
+
+- 🐛 Report bugs
+- 💡 Suggest new features
+- 📝 Improve documentation
+- 🔧 Submit code changes
+- ⭐ Star the repository
+- 🌐 Translate documentation
+
+## Getting Started
+
+1. **Fork the repository**
+   ```bash
+   # Click "Fork" on GitHub, then:
+   git clone https://github.com/YOUR_USERNAME/ai-commit.git
+   cd ai-commit
+   ```
+
+2. **Create a branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+3. **Make your changes**
+   - Write clean, readable code
+   - Follow Python PEP 8 style guidelines
+   - Add comments where necessary
+
+4. **Test your changes**
+   ```bash
+   # Make sure the tool works
+   python ai_commit.py
+   ```
+
+5. **Commit your changes** (use ai-commit if you want! 😄)
+   ```bash
+   git add .
+   git commit -m "feat: add your feature description"
+   ```
+
+6. **Push to your fork**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+7. **Create a Pull Request**
+   - Go to the original repository
+   - Click "New Pull Request"
+   - Select your fork and branch
+   - Describe your changes
+
+## Development Setup
+
+```bash
+# Clone your fork
+git clone https://github.com/YOUR_USERNAME/ai-commit.git
+cd ai-commit
+
+# Install in development mode
+pip install -e .
+
+# Install development dependencies
+pip install requests pytest flake8 black
+```
+
+## Code Style
+
+- Follow PEP 8 guidelines
+- Use meaningful variable names
+- Add docstrings to functions and classes
+- Keep functions focused and small
+- Comment complex logic
+
+Example:
+```python
+def generate_commit_message(diff: str) -> str:
+    """
+    Generate a commit message from git diff.
+    
+    Args:
+        diff: The git diff string
+        
+    Returns:
+        Generated commit message
+    """
+    # Your code here
+```
+
+## Commit Message Guidelines
+
+Use conventional commit format:
+
+- `feat:` - New feature
+- `fix:` - Bug fix
+- `docs:` - Documentation changes
+- `style:` - Code style changes (formatting, etc.)
+- `refactor:` - Code refactoring
+- `test:` - Adding tests
+- `chore:` - Maintenance tasks
+
+Examples:
+```
+feat: add support for custom Ollama models
+fix: resolve connection timeout issue
+docs: update installation instructions
+```
+
+## Reporting Bugs
+
+When reporting bugs, include:
+
+1. **Description** - Clear description of the issue
+2. **Steps to Reproduce** - How to reproduce the bug
+3. **Expected Behavior** - What should happen
+4. **Actual Behavior** - What actually happens
+5. **Environment**:
+   - OS (Windows/Mac/Linux)
+   - Python version
+   - Ollama version
+   - AI Commit version
+
+Example:
+```markdown
+**Description**
+AI Commit fails to connect to Ollama server
+
+**Steps to Reproduce**
+1. Start Ollama with `ollama serve`
+2. Run `ai-commit`
+3. Error appears
+
+**Expected Behavior**
+Should connect to Ollama
+
+**Actual Behavior**
+Connection timeout error
+
+**Environment**
+- OS: Ubuntu 22.04
+- Python: 3.10
+- Ollama: 0.1.14
+```
+
+## Suggesting Features
+
+When suggesting features:
+
+1. **Clear Title** - Descriptive title
+2. **Use Case** - Why is this needed?
+3. **Proposed Solution** - How should it work?
+4. **Alternatives** - Other solutions considered?
+
+## Pull Request Process
+
+1. **Update documentation** - Update README if needed
+2. **Test thoroughly** - Make sure everything works
+3. **One feature per PR** - Keep PRs focused
+4. **Describe changes** - Explain what and why
+5. **Be responsive** - Respond to review comments
+
+## Code Review
+
+All submissions require review. We'll:
+
+- Check code quality
+- Test functionality
+- Ensure documentation is updated
+- Verify no breaking changes
+
+## Community Guidelines
+
+- Be respectful and inclusive
+- Help others learn
+- Give constructive feedback
+- Follow the Code of Conduct
+
+## Questions?
+
+- Open an [Issue](https://github.com/himanshu231204/ai-commit/issues)
+- Start a [Discussion](https://github.com/himanshu231204/ai-commit/discussions)
+- Email: himanshu231204@gmail.com
+
+## Recognition
+
+Contributors will be:
+- Added to README
+- Mentioned in release notes
+- Given credit in commit messages
+
+Thank you for contributing! 🙏
+
+---
+
+**Made with ❤️ by [Himanshu Kumar](https://github.com/himanshu231204)**

ollama_git_commit-0.1.0/DOCUMENTATION.md

@@ -0,0 +1,204 @@
+# AI Commit - Project Documentation
+
+## Overview
+
+AI Commit is a command-line tool that generates intelligent git commit messages using local Ollama AI models. It analyzes your staged changes and creates meaningful commit messages following best practices.
+
+## Author Information
+
+**Himanshu Kumar**
+- GitHub: [@himanshu231204](https://github.com/himanshu231204)
+- LinkedIn: [himanshu231204](https://www.linkedin.com/in/himanshu231204)
+- Twitter/X: [@himanshu231204](https://twitter.com/himanshu231204)
+- Email: himanshu231204@gmail.com
+
+## Support the Project
+
+- ⭐ Star the repository
+- ☕ [Buy me a coffee](https://www.buymeacoffee.com/himanshu231204)
+- 💝 [Sponsor on GitHub](https://github.com/sponsors/himanshu231204)
+
+## Quick Links
+
+- **Repository**: https://github.com/himanshu231204/ai-commit
+- **Issues**: https://github.com/himanshu231204/ai-commit/issues
+- **Discussions**: https://github.com/himanshu231204/ai-commit/discussions
+- **Wiki**: https://github.com/himanshu231204/ai-commit/wiki
+
+## Installation
+
+### Quick Install
+```bash
+git clone https://github.com/himanshu231204/ai-commit.git
+cd ai-commit
+bash install.sh
+```
+
+### Manual Install
+```bash
+git clone https://github.com/himanshu231204/ai-commit.git
+cd ai-commit
+pip install -e .
+```
+
+## Usage
+
+```bash
+# Stage your changes
+git add .
+
+# Generate commit message
+ai-commit
+```
+
+## Features
+
+- 🤖 AI-powered commit message generation
+- 🔒 100% local and private
+- 💰 Free (uses local Ollama)
+- ⚡ Fast generation
+- 🎨 Multiple commit styles
+- 🌐 Works offline
+
+## Technical Stack
+
+- **Language**: Python 3.8+
+- **Dependencies**: requests
+- **AI Backend**: Ollama
+- **License**: MIT
+
+## Project Structure
+
+```
+ai-commit/
+├── ai_commit.py              # Main application
+├── setup.py                  # Package configuration
+├── requirements.txt          # Dependencies
+├── install.sh                # Installation script
+├── README.md                 # User documentation
+├── CONTRIBUTING.md           # Contribution guidelines
+├── LICENSE                   # MIT License
+├── .gitignore                # Git ignore rules
+└── .github/
+    └── workflows/
+        └── ci.yml            # GitHub Actions CI
+```
+
+## How It Works
+
+1. **Analyze**: Reads git diff of staged changes
+2. **Generate**: Sends diff to local Ollama model
+3. **Present**: Shows generated commit message
+4. **Interactive**: User can accept, regenerate, edit, or cancel
+5. **Commit**: Creates git commit with chosen message
+
+## Supported Models
+
+- llama2 (recommended)
+- codellama (code-optimized)
+- mistral (fast)
+- phi (lightweight)
+- llama3 (most powerful)
+- Any Ollama model
+
+## Commit Message Styles
+
+### Conventional Commits
+```
+feat(auth): add user login functionality
+fix(api): resolve timeout issue
+docs(readme): update installation steps
+```
+
+### Semantic
+```
+Add user login functionality
+Fix timeout issue in API
+Update installation steps in README
+```
+
+### Detailed
+```
+Add user authentication system
+
+- Implement JWT-based authentication
+- Add login and logout endpoints
+- Create user session management
+```
+
+## Development
+
+### Setup Development Environment
+```bash
+git clone https://github.com/himanshu231204/ai-commit.git
+cd ai-commit
+pip install -e .
+```
+
+### Running Tests
+```bash
+# Coming soon
+pytest tests/
+```
+
+### Code Style
+- Follow PEP 8
+- Use type hints
+- Add docstrings
+- Write clean, readable code
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+### Quick Contribution Guide
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Test thoroughly
+5. Submit a pull request
+
+## Roadmap
+
+- [x] Basic commit message generation
+- [x] Multiple commit styles
+- [x] Interactive CLI
+- [ ] Configuration file support
+- [ ] Custom prompt templates
+- [ ] Git hooks integration
+- [ ] VSCode extension
+- [ ] Multiple language support
+- [ ] Batch commit support
+- [ ] Commit history analysis
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- **Ollama** - For local LLM runtime
+- **Git** - Version control system
+- **Python** - Programming language
+- **Community** - Contributors and users
+
+## Support
+
+- **Bug Reports**: [GitHub Issues](https://github.com/himanshu231204/ai-commit/issues)
+- **Feature Requests**: [GitHub Discussions](https://github.com/himanshu231204/ai-commit/discussions)
+- **Email**: himanshu231204@gmail.com
+
+## Statistics
+
+![GitHub stars](https://img.shields.io/github/stars/himanshu231204/ai-commit?style=social)
+![GitHub forks](https://img.shields.io/github/forks/himanshu231204/ai-commit?style=social)
+![GitHub issues](https://img.shields.io/github/issues/himanshu231204/ai-commit)
+![GitHub pull requests](https://img.shields.io/github/issues-pr/himanshu231204/ai-commit)
+![Python version](https://img.shields.io/badge/python-3.8+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+
+---
+
+**Made with ❤️ by [Himanshu Kumar](https://github.com/himanshu231204)**
+
+If you find this project useful, please consider giving it a ⭐ on GitHub!