python-app-conventions

A Python CLI application using a src layout places package code under a src/ directory, separates executable scripts via console entry points, and manages dependencies using pyproject.toml to ensure clean imports during development and packaging.

Managing configuration in a plain Python app is best handled using pydantic-settings, which loads environment variables into typed Settings objects, validating data and providing structured access to application configurations across different environments.

Production Python application logging is set up by configuring the standard logging module with structured formats, proper log levels, and consistent handlers, ensuring traceable output for CLI tools and background services without requiring external web frameworks.

Yes, this Python convention skill supports building CLI tools with argparse, click, or typer, and registers them as console scripts in pyproject.toml, allowing flexible command-line interface creation depending on your preferred library.

Using a src layout for Python packaging prevents accidental imports of the local package during testing, forces installation before running commands, and ensures that the packaged distribution behaves identically to the development environment.

Yes, you can package a Python project using only pyproject.toml by defining build-system requirements, project metadata, dependencies, and console script entry points, eliminating the need for legacy setup.py or setup.cfg files.