Python Packaging

Overview

Python Packaging handles the entire lifecycle of creating and distributing Python packages. From initial project structure to PyPI release, this skill ensures your package follows modern Python packaging standards.

Key Features

• Project Structure: Creates a well-organized package layout with src/ structure, proper __init__.py files, and separation of source, tests, and documentation.
• pyproject.toml Configuration: Generates complete pyproject.toml with build system, project metadata, optional dependencies, entry points, and tool configurations (pytest, ruff, mypy).
• Version Management: Supports dynamic versioning with setuptools-scm or manual versioning with bump scripts. Follows semantic versioning conventions.
• Publishing Pipeline: Creates GitHub Actions workflows for test, build, and publish cycles. Supports TestPyPI for staging and PyPI for production releases with trusted publishing (OIDC).

Build Backend Support

Configures your choice of build backend: setuptools for traditional projects, hatchling for modern conventions, flit for simple pure-Python packages, or maturin for Rust extensions.

Distribution Formats

Generates both wheel and sdist distributions. Handles platform-specific wheels for packages with C extensions. Supports PEP 561 type stubs for typed packages.