python-packaging

## Table of Contents - [Quick Start](#quick-start) - [When to Use](#when-to-use) - [Core Decisions](#core-decisions) - [1. Layout Choice](#1-layout-choice) - [2. Project Structure](#2-project-structure) - [Detailed Topics](#detailed-topics) - [Best Practices](#best-practices) - [Exit Criteria](#exit-criteria) # Python Packaging Modern Python packaging with pyproject.toml, uv, and best practices for distribution. ## Quick Start ```bash # Create new project with uv uv init my-package cd my-package # Add dependencies uv add requests click # Build package uv build # Publish to PyPI uv publish ``` **Verification:** Run the command with `--help` flag to verify availability. ## When To Use - Creating distributable Python libraries - Building CLI tools - Publishing to PyPI - Setting up development environments - Managing project dependencies ## When NOT To Use - Testing packages - use python-testing instead - Optimizing package performance - use python-performance - Testing packages - use python-testing instead - Optimizing package performance - use python-performance ## Core Decisions ### 1. Layout Choice ```yaml # Source layout (recommended) src/my_package/ __init__.py module.py # Flat layout (simple) my_package/ __init__.py module.py ``` **Verification:** Run the command with `--help` flag to verify availability. **Source layout benefits:** - Clear separation of source and tests - Prevents accidental imports of uninstalled code - Better for pa...