What is the recommended Python project structure?

The 'src' layout is generally recommended because it prevents accidental imports from the project root and ensures your tests run against the installed version of your package.

Can I use this to create command-line tools?

Absolutely. The skill includes specific patterns for creating CLI entry points using both the Click framework and the standard argparse library.

Does this skill support modern build backends?

Yes, it provides configuration patterns and guidance for several backends including setuptools, hatchling, flit, and poetry.

How do I automate publishing to PyPI?

This skill provides ready-to-use GitHub Actions workflow templates that handle building the package and uploading it to PyPI whenever a new release is created.

Python Packaging & Distribution

Name: Python Packaging & Distribution
Author: lifangda

bylifangda

•

Developer Tools

Builds distributable Python packages using modern standards, optimized project structures, and automated PyPI publishing workflows.

About

This skill provides comprehensive guidance for creating professional Python libraries and command-line tools according to the latest industry standards. It automates the setup of modern project structures like the 'src' layout, configures pyproject.toml according to PEP 621, and manages various build backends including setuptools and hatch. Whether you are publishing to PyPI for the first time, managing complex dependencies, or setting up automated CI/CD release workflows with GitHub Actions, this skill ensures your Python projects are robust, maintainable, and easy to install.

Key Features

Automated publishing workflows for PyPI and TestPyPI via GitHub Actions
Standardized pyproject.toml configuration following PEP 517/518/621
16 GitHub stars
Implementation of 'src' layout and flat layout project structures
Support for dynamic versioning and package metadata management
CLI tool development patterns using Click and argparse entry points

Use Cases

Converting local Python scripts into professional, distributable PyPI libraries
Creating standalone command-line utilities with registered entry points
Migrating legacy setup.py projects to modern pyproject.toml standards

About

Key Features

Automated publishing workflows for PyPI and TestPyPI via GitHub Actions
Standardized pyproject.toml configuration following PEP 517/518/621
16 GitHub stars
Implementation of 'src' layout and flat layout project structures
Support for dynamic versioning and package metadata management
CLI tool development patterns using Click and argparse entry points

Use Cases

Converting local Python scripts into professional, distributable PyPI libraries
Creating standalone command-line utilities with registered entry points
Migrating legacy setup.py projects to modern pyproject.toml standards