pypa/hatch
Hatch
Hatch is a unified tool for managing Python environments, building packages, scaffolding projects, and installing Python versions. It provides a single command-line interface for automating common development workflows, including running scripts, tests, and static analysis with automatic dependency resolution and configuration.
The tool manages project settings, dependencies, and build instructions through a declarative TOML configuration file, ensuring reproducibility across environments. It creates and manages isolated virtual environments across all major shells, installs and manages multiple Python versions for project-specific requirements, and generates new project skeletons from customizable templates that enforce standard directory layouts and best practices.
Hatch builds Python packages with deterministic, repeatable outputs using a plugin ecosystem for customization, and can upload built packages to PyPI or other package indices with minimal configuration. It also runs test suites with automatic code coverage reporting, performs static analysis using Ruff with sensible defaults, and increments version numbers according to semantic versioning rules without manual file edits.
Features
- Python Workflow Automators - Automates Python development workflows including script execution, testing, and static analysis with automatic dependency resolution.
- Build Plugin Architectures - Ships a plugin-based build system that allows custom build steps and output formats via extensible backends.
- Project Scaffolding - Generates new Python projects from templates that incorporate established best practices.
- Python Project Scaffolders - Generates new Python projects from customizable templates that enforce standard directory layouts and best practices.
- Project Scaffolding Templates - Generates new Python projects from customizable templates that enforce standard directory layouts and best practices.
- Dependency-Aware Script Runners - Runs scripts in isolated environments with automatic dependency resolution and Python version management.
- Python Environment Managers - Creates, activates, and switches between isolated Python virtual environments across all major shells.
- Python Script Dependency Resolvers - Executes Python scripts while automatically resolving and installing their specific dependencies and Python version requirements.
- Virtual Environment Managers - Creates and manages isolated Python virtual environments across all major shells using a unified command interface.
- Python Distribution Packaging - Builds reproducible Python packages and uploads them to PyPI or other package indices.
- TOML-Based Configurations - Provides a declarative TOML configuration file that defines project settings, dependencies, and build instructions.
- Python Tooling - Provides a unified tool for managing Python projects, including building, testing, and publishing packages.
- Python Version Managers - Installs and manages multiple Python interpreter versions for use in project environments.
- Reproducible Builds - Builds Python packages with deterministic, repeatable outputs using a plugin ecosystem for customization.
- Package Publishing - Uploads built packages to PyPI or other package indices with minimal configuration steps.
- Semantic Versioning - Automatically increments version numbers according to semantic versioning rules without manual file edits.
- Automated Version Incrementing - Increments the version number of a project according to semantic versioning rules without editing files manually.
- PyPI Uploaders - Packages projects into distributable archives and uploads them to the Python Package Index.
- Static Code Analyzers - Analyzes code statically with Ruff using current, sensible default configurations.
- Static Code Analysis - Integrates Ruff for static code analysis with sensible defaults directly into the development workflow.
- Test Suite Execution - Runs project tests following established best practices for Python testing workflows.
- Test Coverage Metrics - Runs the test suite and automatically reports code coverage metrics in a single command.
