pezin 0.1.0__tar.gz

pezin-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: pezin
+Version: 0.1.0
+Summary: Automated version bumping and changelog management using conventional commits
+Author-email: Tatus9 <rafael@rro.one>
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: packaging>=25.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: typer>=0.16.0
+Requires-Dist: tomli>=2.0.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pre-commit>=3.0.0
+
+# 🚀 Pezin
+
+[![CI](https://github.com/tatus9/pezin/workflows/CI/badge.svg)](https://github.com/tatus9/pezin/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/pezin.svg)](https://badge.fury.io/py/pezin)
+[![Python versions](https://img.shields.io/pypi/pyversions/pezin.svg)](https://pypi.org/project/pezin/)
+[![License](https://img.shields.io/github/license/tatus9/pezin.svg)](https://github.com/tatus9/pezin/blob/main/LICENSE)
+[![Downloads](https://img.shields.io/pypi/dm/pezin.svg)](https://pypi.org/project/pezin/)
+
+A tool that care about versions, you could you manually or it could be used as a pre-commit hook to automate version bumping and changelog management using conventional commits.
+
+<img src="static/img/icon.png" alt="Pump it UP" style="width:50%; height:auto;">
+
+## Features
+
+- 🔄 **Automatic version bumping** based on conventional commits
+- 🌍 **Universal language support** - Python, Node.js, C/C++, Rust, PHP, Go, Java, .NET, and any custom patterns
+- 📁 **Multi-file version management** - Update multiple version files simultaneously
+- 🎨 **Advanced pattern system** - Component-level version control with rich template formatting
+- 📝 **Automated changelog generation** with comparison links
+- 🎣 **Git pre-commit hook integration** with reliable amend detection
+- ⚡ **CLI tool** for manual version management
+- 🏷️ **Pre-release version support** (alpha, beta, rc)
+- 🔧 **Flexible version formats** - Support any prefix/suffix pattern (v1.2.3, 1.2.3v, release-1.2.3)
+
+## Quick Start
+
+### Installation
+
+Install from PyPI:
+
+```bash
+pip install pezin
+```
+
+Or install the latest development version:
+
+```bash
+pip install git+https://github.com/tatus9/pezin.git
+```
+
+### Setup Git Hook
+
+Add to your `.pre-commit-config.yaml`:
+
+```yaml
+repos:
+  - repo: https://github.com/tatus9/pezin
+    rev: v1.1.0  # Use the latest version
+    hooks:
+      - id: pezin
+```
+
+Install the hooks:
+
+```bash
+pip install pre-commit pezin
+pre-commit install --hook-type commit-msg
+```
+
+### Start Using
+
+Just commit with conventional commit format:
+
+```bash
+git commit -m "feat: add user authentication"    # 1.0.0 → 1.1.0
+git commit -m "fix: resolve login bug"           # 1.1.0 → 1.1.1
+git commit -m "feat!: redesign API"              # 1.1.1 → 2.0.0
+```
+
+Your version files will be automatically updated!
+
+## Conventional Commits
+
+| Type | Version Bump | Example |
+|------|--------------|---------|
+| `feat:` | Minor (1.0.0 → 1.1.0) | `feat: add user dashboard` |
+| `fix:` | Patch (1.0.0 → 1.0.1) | `fix: resolve login issue` |
+| `feat!:` | Major (1.0.0 → 2.0.0) | `feat!: redesign API` |
+| `docs:`, `chore:`, etc. | No bump | `docs: update readme` |
+
+**Special tokens:**
+- `[skip-bump]` - Skip version bump
+- `[force-major]` - Force major bump
+- `[pre-release=beta]` - Add pre-release label
+
+## CLI Usage
+
+```bash
+# Check versions
+pezin -v                       # Shows current project + pezin versions
+pezin version                  # Same as above
+
+# Manual version bumping
+pezin minor                    # Bump minor version
+pezin patch --dry-run          # Preview changes
+pezin major --pre-release rc   # Pre-release version
+
+# Custom configuration
+pezin patch --config package.json
+pezin minor --skip-changelog
+
+# Multi-language project example
+# Updates pyproject.toml, package.json, version.h simultaneously
+git commit -m "feat: add multi-platform support"
+```
+
+## Python API
+
+```python
+from pezin import Version, ConventionalCommit, ChangelogManager
+
+# Parse and bump version
+version = Version.parse("1.2.3")
+new_version = version.bump("minor")
+print(str(new_version))  # "1.3.0"
+
+# Parse commit message
+commit = ConventionalCommit.parse(
+    "feat(api)!: add new endpoint\n\nBREAKING CHANGE: new auth"
+)
+print(commit.breaking)  # True
+
+# Update changelog
+config = ChangelogConfig(repo_url="https://github.com/tatus9/pezin.git")
+manager = ChangelogManager(config)
+manager.update_changelog(
+    Path("CHANGELOG.md"),
+    str(new_version),
+    [commit]
+)
+```
+
+## Conventional Commits Guide
+
+Pezin follows the [Conventional Commits](https://www.conventionalcommits.org/) specification:
+
+### Basic Format
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Version Bump Rules
+- `feat`: Minor version bump (1.0.0 → 1.1.0) - New features
+- `fix`: Patch version bump (1.0.0 → 1.0.1) - Bug fixes
+- `!` or `BREAKING CHANGE`: Major version bump (1.0.0 → 2.0.0) - Breaking changes
+
+### Other Commit Types (no version bump)
+- `docs`: Documentation changes
+- `style`: Code style/formatting changes
+- `refactor`: Code refactoring without functional changes
+- `perf`: Performance improvements
+- `test`: Adding or updating tests
+- `chore`: Maintenance tasks, dependency updates
+- `ci`: CI/CD configuration changes
+- `build`: Build system changes
+
+### Special Footer Tokens
+Control version bumping behavior with footer tokens:
+
+```bash
+# Skip version bump entirely
+git commit -m "feat: new feature
+
+[skip-bump]"
+
+# Force specific bump type
+git commit -m "docs: update readme
+
+[force-patch]"
+
+# Add pre-release label
+git commit -m "feat: beta feature
+
+[pre-release=beta]"
+```
+
+Available tokens:
+- `[skip-bump]`: Skip version bump
+- `[force-major]`: Force major bump (1.0.0 → 2.0.0)
+- `[force-minor]`: Force minor bump (1.0.0 → 1.1.0)
+- `[force-patch]`: Force patch bump (1.0.0 → 1.0.1)
+- `[pre-release=label]`: Add pre-release label (alpha, beta, rc)
+
+## Documentation
+
+- 📖 **[Quick Start Guide](docs/quick-start.md)** - Get started in minutes
+- 📖 **[Installation Guide](docs/installation.md)** - Detailed setup instructions
+- 🌍 **[Multi-Language Support](docs/multi-language-support.md)** - Python, Node.js, C++, Rust, and more
+- 🎨 **[Advanced Patterns](docs/advanced-patterns.md)** - Custom version formats and templates
+- 📋 **[Conventional Commits](docs/conventional-commits.md)** - Complete commit format guide
+- ⚙️ **[Configuration](docs/configuration.md)** - Customize Pezin behavior
+- 💻 **[CLI Usage](docs/cli-usage.md)** - Manual version management
+- 🐍 **[Python API](docs/python-api.md)** - Programmatic usage
+- 🔧 **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions
+
+### Examples
+
+- 🌍 **[Multi-Language Examples](examples/multi-language-setup.md)** - Complete project setups
+
+## Contributing
+
+We welcome contributions!
+
+## License
+
+MIT License - feel free to use this project for any purpose.

pezin-0.1.0/README.md

@@ -0,0 +1,210 @@
+# 🚀 Pezin
+
+[![CI](https://github.com/tatus9/pezin/workflows/CI/badge.svg)](https://github.com/tatus9/pezin/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/pezin.svg)](https://badge.fury.io/py/pezin)
+[![Python versions](https://img.shields.io/pypi/pyversions/pezin.svg)](https://pypi.org/project/pezin/)
+[![License](https://img.shields.io/github/license/tatus9/pezin.svg)](https://github.com/tatus9/pezin/blob/main/LICENSE)
+[![Downloads](https://img.shields.io/pypi/dm/pezin.svg)](https://pypi.org/project/pezin/)
+
+A tool that care about versions, you could you manually or it could be used as a pre-commit hook to automate version bumping and changelog management using conventional commits.
+
+<img src="static/img/icon.png" alt="Pump it UP" style="width:50%; height:auto;">
+
+## Features
+
+- 🔄 **Automatic version bumping** based on conventional commits
+- 🌍 **Universal language support** - Python, Node.js, C/C++, Rust, PHP, Go, Java, .NET, and any custom patterns
+- 📁 **Multi-file version management** - Update multiple version files simultaneously
+- 🎨 **Advanced pattern system** - Component-level version control with rich template formatting
+- 📝 **Automated changelog generation** with comparison links
+- 🎣 **Git pre-commit hook integration** with reliable amend detection
+- ⚡ **CLI tool** for manual version management
+- 🏷️ **Pre-release version support** (alpha, beta, rc)
+- 🔧 **Flexible version formats** - Support any prefix/suffix pattern (v1.2.3, 1.2.3v, release-1.2.3)
+
+## Quick Start
+
+### Installation
+
+Install from PyPI:
+
+```bash
+pip install pezin
+```
+
+Or install the latest development version:
+
+```bash
+pip install git+https://github.com/tatus9/pezin.git
+```
+
+### Setup Git Hook
+
+Add to your `.pre-commit-config.yaml`:
+
+```yaml
+repos:
+  - repo: https://github.com/tatus9/pezin
+    rev: v1.1.0  # Use the latest version
+    hooks:
+      - id: pezin
+```
+
+Install the hooks:
+
+```bash
+pip install pre-commit pezin
+pre-commit install --hook-type commit-msg
+```
+
+### Start Using
+
+Just commit with conventional commit format:
+
+```bash
+git commit -m "feat: add user authentication"    # 1.0.0 → 1.1.0
+git commit -m "fix: resolve login bug"           # 1.1.0 → 1.1.1
+git commit -m "feat!: redesign API"              # 1.1.1 → 2.0.0
+```
+
+Your version files will be automatically updated!
+
+## Conventional Commits
+
+| Type | Version Bump | Example |
+|------|--------------|---------|
+| `feat:` | Minor (1.0.0 → 1.1.0) | `feat: add user dashboard` |
+| `fix:` | Patch (1.0.0 → 1.0.1) | `fix: resolve login issue` |
+| `feat!:` | Major (1.0.0 → 2.0.0) | `feat!: redesign API` |
+| `docs:`, `chore:`, etc. | No bump | `docs: update readme` |
+
+**Special tokens:**
+- `[skip-bump]` - Skip version bump
+- `[force-major]` - Force major bump
+- `[pre-release=beta]` - Add pre-release label
+
+## CLI Usage
+
+```bash
+# Check versions
+pezin -v                       # Shows current project + pezin versions
+pezin version                  # Same as above
+
+# Manual version bumping
+pezin minor                    # Bump minor version
+pezin patch --dry-run          # Preview changes
+pezin major --pre-release rc   # Pre-release version
+
+# Custom configuration
+pezin patch --config package.json
+pezin minor --skip-changelog
+
+# Multi-language project example
+# Updates pyproject.toml, package.json, version.h simultaneously
+git commit -m "feat: add multi-platform support"
+```
+
+## Python API
+
+```python
+from pezin import Version, ConventionalCommit, ChangelogManager
+
+# Parse and bump version
+version = Version.parse("1.2.3")
+new_version = version.bump("minor")
+print(str(new_version))  # "1.3.0"
+
+# Parse commit message
+commit = ConventionalCommit.parse(
+    "feat(api)!: add new endpoint\n\nBREAKING CHANGE: new auth"
+)
+print(commit.breaking)  # True
+
+# Update changelog
+config = ChangelogConfig(repo_url="https://github.com/tatus9/pezin.git")
+manager = ChangelogManager(config)
+manager.update_changelog(
+    Path("CHANGELOG.md"),
+    str(new_version),
+    [commit]
+)
+```
+
+## Conventional Commits Guide
+
+Pezin follows the [Conventional Commits](https://www.conventionalcommits.org/) specification:
+
+### Basic Format
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Version Bump Rules
+- `feat`: Minor version bump (1.0.0 → 1.1.0) - New features
+- `fix`: Patch version bump (1.0.0 → 1.0.1) - Bug fixes
+- `!` or `BREAKING CHANGE`: Major version bump (1.0.0 → 2.0.0) - Breaking changes
+
+### Other Commit Types (no version bump)
+- `docs`: Documentation changes
+- `style`: Code style/formatting changes
+- `refactor`: Code refactoring without functional changes
+- `perf`: Performance improvements
+- `test`: Adding or updating tests
+- `chore`: Maintenance tasks, dependency updates
+- `ci`: CI/CD configuration changes
+- `build`: Build system changes
+
+### Special Footer Tokens
+Control version bumping behavior with footer tokens:
+
+```bash
+# Skip version bump entirely
+git commit -m "feat: new feature
+
+[skip-bump]"
+
+# Force specific bump type
+git commit -m "docs: update readme
+
+[force-patch]"
+
+# Add pre-release label
+git commit -m "feat: beta feature
+
+[pre-release=beta]"
+```
+
+Available tokens:
+- `[skip-bump]`: Skip version bump
+- `[force-major]`: Force major bump (1.0.0 → 2.0.0)
+- `[force-minor]`: Force minor bump (1.0.0 → 1.1.0)
+- `[force-patch]`: Force patch bump (1.0.0 → 1.0.1)
+- `[pre-release=label]`: Add pre-release label (alpha, beta, rc)
+
+## Documentation
+
+- 📖 **[Quick Start Guide](docs/quick-start.md)** - Get started in minutes
+- 📖 **[Installation Guide](docs/installation.md)** - Detailed setup instructions
+- 🌍 **[Multi-Language Support](docs/multi-language-support.md)** - Python, Node.js, C++, Rust, and more
+- 🎨 **[Advanced Patterns](docs/advanced-patterns.md)** - Custom version formats and templates
+- 📋 **[Conventional Commits](docs/conventional-commits.md)** - Complete commit format guide
+- ⚙️ **[Configuration](docs/configuration.md)** - Customize Pezin behavior
+- 💻 **[CLI Usage](docs/cli-usage.md)** - Manual version management
+- 🐍 **[Python API](docs/python-api.md)** - Programmatic usage
+- 🔧 **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions
+
+### Examples
+
+- 🌍 **[Multi-Language Examples](examples/multi-language-setup.md)** - Complete project setups
+
+## Contributing
+
+We welcome contributions!
+
+## License
+
+MIT License - feel free to use this project for any purpose.

pezin-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = [
+    "setuptools>=61.0",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pezin"
+version = "0.1.0"
+description = "Automated version bumping and changelog management using conventional commits"
+authors = [
+    { name = "Tatus9", email = "rafael@rro.one" },
+]
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "packaging>=25.0",
+    "rich>=14.0.0",
+    "typer>=0.16.0",
+    "tomli>=2.0.0",
+    "tomli-w>=1.0.0",
+    "loguru>=0.7.3",
+    "pre-commit>=3.0.0",
+]
+
+[project.scripts]
+pezin = "pezin.cli.main:run"
+
+[dependency-groups]
+dev = [
+    "pdbpp>=0.11.6",
+    "pytest>=8.4.0",
+    "pytest-cov>=6.0.0",
+    "ruff>=0.8.0",
+]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools.packages.find]
+where = [
+    "src",
+]
+include = [
+    "pezin",
+    "pezin.*",
+]
+namespaces = true
+
+[tool.pytest.ini_options]
+testpaths = [
+    "tests",
+]
+python_files = "test_*.py"
+addopts = "-v"

pezin-0.1.0/setup.cfg

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

pezin-0.1.0/src/pezin/__init__.py

@@ -0,0 +1,27 @@
+"""Automated version bumping and changelog management.
+
+Example:
+    ```bash
+    # Install pre-commit hook
+    pre-commit install --hook-type commit-msg
+
+    # Run manually
+    pezin bump minor
+    ```
+"""
+
+from .core.changelog import ChangelogConfig, ChangelogManager
+from .core.commit import BumpType, CommitType, ConventionalCommit
+from .core.version import Version, VersionBumpType
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "Version",
+    "VersionBumpType",
+    "ConventionalCommit",
+    "CommitType",
+    "BumpType",
+    "ChangelogConfig",
+    "ChangelogManager",
+]

pezin-0.1.0/src/pezin/cli/__init__.py

@@ -0,0 +1,13 @@
+"""CLI package for pezin."""
+
+from .commands import bump_version, get_commits_since_last_tag, update_changelog
+from .main import app
+from .utils import find_project_root
+
+__all__ = [
+    "app",
+    "bump_version",
+    "update_changelog",
+    "get_commits_since_last_tag",
+    "find_project_root",
+]