pymelos 0.1.5

Python monorepo manager

Pymelos

Pymelos is a monorepo management tool for Python, inspired by Melos.

It is designed to manage multiple Python packages efficiently using modern tooling such as uv and Ruff, while providing fully automated semantic release workflows.

Key Features

• Fast Dependency Management: Built on top of uv for lightning-fast dependency resolution and installation.
• Workspace Management: Leverages uv workspaces to handle local package linking and dependencies automatically.
• Script Execution: Run scripts across multiple packages with filtering and parallel execution.
• Versioning & Publishing: Automated versioning, changelog generation, and publishing inspired by semantic-release and Conventional Commits.
• Change Detection: Smartly detect changed packages and their dependents to optimize CI/CD pipelines.

Why Pymelos?

1. Zero-Config Linking: Leverages uv workspaces for instant, automatic package linking.
2. Unified Scripts: Define tasks once in pymelos.yaml and run them everywhere.
3. Semantic Releases: Fully automated version bumping, changelogs, and publishing.

Documentation

Full documentation is available in the docs/ directory.

• Getting Started
• Configuration
• CLI Commands

Installation

# Using uv (recommended)
uv tool install pymelos

# Using pip
pip install pymelos

Quick Start

# Initialize a new workspace
pymelos init --name my-workspace

# Install dependencies and link local packages
pymelos bootstrap

# List all packages in the workspace
pymelos list

# Run a script across all packages
pymelos run test

# Run on specific packages
pymelos run test --scope my-package

# Run on changed packages since main
pymelos run test --since main

# Execute any command
pymelos exec "pytest -v"

# Show changed packages
pymelos changed main

# Clean build artifacts
pymelos clean

# Semantic release (dry run)
pymelos release --dry-run

Projects using Pymelos

• Flash Framework
• Using Pymelos? Submit a PR to add your project here!

Contributing

See CONTRIBUTING.md for details on how to contribute to Pymelos.

License

MIT