What problem does it solve?
Packaging and publishing Python projects involves many repetitive, error-prone steps—project layout, metadata, build backends, distribution formats, and CI publishing—making releases slow and fragile. This Skill consolidates best practices and concrete patterns so maintainers can produce reproducible builds, correct metadata, and reliable uploads to TestPyPI/PyPI or private indexes.
Core Features & Use Cases
- Project layout recommendations: source (src/) and flat layouts, multi-package monorepos, and namespace package patterns.
- Modern metadata and build: pyproject.toml examples following PEP 517/518/621, dynamic versioning, and build-backend configurations.
- Distribution and publishing: build wheels and sdist, twine checks, TestPyPI validation, and GitHub Actions for automated releases.
- Advanced scenarios: C extensions, package data inclusion, multi-architecture wheel builds, and editable installs for development workflows.
- Use Case: Turn a library repository into a production-ready package with CI automation that builds artifacts, runs tests, and publishes on release.
Quick Start
Generate a complete pyproject.toml, recommended src/ layout, and a GitHub Actions workflow that builds wheels and uploads to TestPyPI for my library named "my-package".