📦 Junior Python Track 36 • Capstone Package Publishing

36. Packaging & Distribution

Master modern Python packaging & library distribution: understand pyproject.toml (PEP 621), package directory layouts (src-layout), Semantic Versioning (SemVer), building Wheel (.whl) artifacts, local editable installs (pip install -e .), and publishing to PyPI with twine.

← 35. Concurrency & Async 📚 Overview Matrix 📦 Launch Packaging Studio

🎓 Junior Python Curriculum — Select Module

1️⃣ Fundamentals 2️⃣ Data Types 3️⃣ Operators 4️⃣ Conditionals 5️⃣ Loops 6️⃣ Collections 7️⃣ Comprehensions 8️⃣ Functions 9️⃣ *args & **kwargs 🔟 Scope & Namespaces 1️⃣1️⃣ OOP 1️⃣2️⃣ Exceptions 1️⃣3️⃣ File Handling 1️⃣4️⃣ Modules & Packages 1️⃣5️⃣ Virtual Environments 1️⃣6️⃣ Standard Library 1️⃣7️⃣ Iterators & Iterables 1️⃣8️⃣ Generators 1️⃣9️⃣ Decorators 2️⃣0️⃣ Context Managers 2️⃣1️⃣ Lambda Functions 2️⃣2️⃣ Functional Programming 2️⃣3️⃣ Type Hints 2️⃣4️⃣ Dataclasses 2️⃣5️⃣ Testing 2️⃣6️⃣ Debugging 2️⃣7️⃣ Logging 2️⃣8️⃣ JSON & Data 2️⃣9️⃣ Regular Expressions 3️⃣0️⃣ Databases 3️⃣1️⃣ APIs & HTTP 3️⃣2️⃣ Code Quality 3️⃣3️⃣ Software Architecture 3️⃣4️⃣ Performance & Big-O 3️⃣5️⃣ Concurrency & Async 3️⃣6️⃣ Packaging & Distribution

📄

pyproject.toml & PEP 621

The modern declarative configuration file replacing legacy `setup.py`. Defines build system requirements, project metadata, authors, dependencies, and entry-point CLI scripts.

`[build-system]`: Specifies build backend (`setuptools`, `hatchling`).
`[project]`: Standard metadata fields (version, dependencies).
`[project.scripts]`: Register CLI terminal commands.

🏷️

Semantic Versioning (SemVer)

Standardized 3-part versioning format (`MAJOR.MINOR.PATCH`) to clearly signal breaking changes, backwards-compatible additions, and patch bug fixes.

MAJOR (`1.0.0` → `2.0.0`): Incompatible API breaking changes.
MINOR (`1.0.0` → `1.1.0`): Backwards-compatible new features.
PATCH (`1.0.0` → `1.0.1`): Backwards-compatible bug fixes.

📦

Wheels & PyPI Upload

Build distribution packages into pre-compiled binary Wheel (`.whl`) files and source archives (`.tar.gz`) for publication to the Python Package Index (PyPI).

`python -m build`: Generate `.whl` and `.tar.gz` in `./dist/`.
`pip install -e .`: Install package in local editable mode.
`twine upload dist/*`: Securely publish release artifacts to PyPI.

📦 Packaging, Distribution & Dependency Studio

pyproject.toml, SemVer, Building & PyPI Publishing

PEP 621 | PEP 517 | Wheel

📄 pyproject.toml & PEP 621

Single source of truth for build backend (`setuptools`, `hatchling`, `flit`), project metadata, and dependencies.

🏷️ Semantic Versioning

Follow `MAJOR.MINOR.PATCH` rules to communicate breaking changes, new features, and backwards-compatible fixes.

🛠️ Building & PyPI Upload

Build binary Wheels (`.whl`) & source archives (`.tar.gz`) via `python -m build` and publish with `twine upload`.

⚡ Packaging Interactive Presets:

✅ Ready for Packaging Execution

🖥️ Terminal Output Execution Result:

=== EXECUTION RESULT ===

[build-system]
requires = ["setuptools>=61.0.0", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "teachcloud-sdk"
version = "1.4.2"
description = "TeachCloud Enterprise Python SDK"
readme = "README.md"
requires-python = ">=3.10"
license = { text = "MIT" }
authors = [
    { name = "TeachCloud Engineering", email = "dev@teachcloud.dev" }
]
dependencies = [
    "requests>=2.31.0",
    "pydantic>=2.5.0"
]

# ==============================================================================
# PEP 621 PYPROJECT.TOML CONFIGURATION GENERATOR
# ==============================================================================
def generate_pyproject_toml(name: str, version: str) -> str:
    return f"""[build-system]
requires = ["setuptools>=61.0.0", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "{name}"
version = "{version}"
requires-python = ">=3.10"
dependencies = ["requests>=2.31.0", "pydantic>=2.5.0"]
"""

# ==============================================================================
# SEMANTIC VERSION BUMPING (SemVer 2.0.0)
# ==============================================================================
class SemanticVersion:
    def bump_minor(self) -> str:
        return f"{self.major}.{self.minor + 1}.0"

    def bump_major(self) -> str:
        return f"{self.major + 1}.0.0"

# ==============================================================================
# TERMINAL COMMANDS FOR BUILDING & PUBLISHING
# ==============================================================================
# 1. Install build tools:
python -m pip install --upgrade build twine

# 2. Build Wheel (.whl) & Source Archive (.tar.gz):
python -m build

# 3. Local Editable Installation:
pip install -e .

# 4. Upload to PyPI Production Registry:
python -m twine upload dist/*

import unittest
from cloud_app.tutorials.python_packaging_basics import SemanticVersion, simulate_package_build

class TestPythonPackagingTutorial(unittest.TestCase):
    def test_simulate_package_build(self):
        build = simulate_package_build("my-lib", "1.2.0")
        self.assertIn("dist/my_lib-1.2.0-py3-none-any.whl", build["artifacts_generated"]["wheel_distribution"])

💎 Junior Track 36 Master Reference