Welcome to the python-package-folder documentation wiki!

{QUICK_LINKS}

Easily build and publish any target folder in a repository, including subfolders of a monorepo.
Together with sysappend, this library makes relative imports, flexible import management, and package publishing a breeze.

• Subfolder Build Support: Build subfolders as separate packages with automatic detection and configuration
• Smart Import Classification: Recursively parses all .py files to detect and classify imports
• Automatic Version Resolution: Resolve versions via conventional commits (Python-native, no Node.js required)
• Package Publishing: Publish to PyPI, TestPyPI, or Azure Artifacts

# Build and publish a subfolder
cd src/my_subfolder
python-package-folder --publish pypi

For more information, see the Usage Guide.