python-release-master 0.4.2

An automated Python package release management tool with AI-powered changelog generation

Python Release Master

An automated Python package release management tool with AI-powered changelog generation.

Features

• 🤖 AI-powered changelog generation
• 🔄 Automated version bumping (semantic versioning)
• 📦 PyPI publishing
• 🏷️ Git tag and release creation
• 🎯 Smart version bump suggestions

Installation

# Install from PyPI
pip install python-release-master

# Verify installation
release-master --version

Quick Start

1. Create a .release-master.yaml configuration file in your project root:

version:
  files:
    - pyproject.toml  # Files containing version strings
  pattern: '\d+\.\d+\.\d+'

changelog:
  ai:
    enabled: true
    model: gpt-4-1106-preview
  sections:
    - Features
    - Bug Fixes
    - Documentation
    - Internal Changes

git:
  push: true
  tag_prefix: v
  release:
    enabled: true

pypi:
  publish: true

2. Set required environment variables:

export OPENAI_API_KEY=your-openai-api-key
export PYPI_TOKEN=your-pypi-token

3. Run the release command from your project directory:

release-master release-package

How It Works

1. Analyzes git history to determine version bump type (major, minor, patch)
2. Updates version in specified files
3. Generates changelog using OpenAI
4. Builds Python package
5. Publishes to PyPI
6. Creates Git tag and release

Configuration

Key configuration options in .release-master.yaml:

• version.files: List of files containing version strings
• changelog.ai.enabled: Enable/disable AI-powered changelog
• git.push: Whether to push changes to remote
• pypi.publish: Whether to publish to PyPI

CLI Commands

# Create a new release
release-master release-package

# Show help
release-master --help

# Show version
release-master --version

Requirements

• Python 3.8+
• OpenAI API key
• PyPI token
• Git repository

Development

If you want to contribute or develop the package:

1. Clone the repository:

git clone https://github.com/kareemaly/python-release-master.git
cd python-release-master

2. Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install in development mode with dev dependencies:

pip install -e ".[dev]"

4. Run the development version:

# Use python -m when running from source
python -m python_release_master release-package

License

MIT License