What is the recommended Python package structure?

This skill recommends the 'src' layout (src/package_name/) because it prevents accidental imports from the project root and ensures a cleaner, more professional testing environment.

Does this skill support modern PEP standards?

Yes, it focuses on modern standards including PEP 517/518 for build systems, PEP 621 for metadata in pyproject.toml, and PEP 660 for editable installs.

Can I use this to create command-line tools?

Absolutely. The skill provides specific patterns for registering scripts in pyproject.toml and implementing CLI logic using popular libraries like Click or the standard argparse.

Does it support automated releases?

Yes, it includes advanced patterns for using GitHub Actions to automate the building and publishing process whenever a new release or tag is created.

How do I publish my package to PyPI?

The skill guides you through using tools like 'build' and 'twine' to create distributions and securely upload them to the Python Package Index using API tokens.

Python Packaging

Name: Python Packaging
Author: HermeticOrmus

byHermeticOrmus

0•

Deployment & DevOps

Builds and distributes production-grade Python packages using modern standards like pyproject.toml and PyPI.

This skill provides comprehensive guidance for creating, structuring, and distributing Python packages according to modern PEP standards. It helps developers implement the recommended source layout, configure build backends like setuptools or hatchling, and define project metadata within pyproject.toml. Whether you are building a command-line tool with Click or publishing a complex library to PyPI, this skill ensures your project follows best practices for versioning, dependency management, and automated CI/CD publishing workflows.

Key Features

01Professional project structuring using recommended source layout patterns

02Command-line interface (CLI) integration using Click or argparse

03Modern pyproject.toml configuration and PEP 621 metadata implementation

040 GitHub stars

05Automated build and distribution workflows for PyPI and TestPyPI

06Advanced packaging patterns including dynamic versioning and namespace packages

Use Cases

01Setting up automated GitHub Actions for seamless package releases

02Creating a CLI tool with entry points for global system installation

03Converting a local script into a distributable Python library

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hermeticormus/floreserlife python-packaging

For use in Claude.ai and ChatGPT

Download Skill