Python packaging has become much simpler with pyproject.toml as the modern project standard and uv as a fast, all-in-one frontend for dependency management, virtual environments, and execution.

This post shows a minimal, production-ready layout including:

• a clean package structure
• a runnable Python script
• a FastAPI server
• uv-based workflows (install, run, build)

---

📁 Recommended Project Layout

myproject/
├─ src/
│  └─ myproject/
│     ├─ __init__.py
│     ├─ core.py
│     ├─ script.py
│     └─ api.py
├─ tests/
│  └─ test_core.py
├─ pyproject.toml
└─ README.md

Two runnable components:

• script.py → a simple command-line script
• api.py → a minimal FastAPI server

---

⚙️ Minimal pyproject.toml

[project]
name = "myproject"
version = "0.1.0"
description = "A simple example Python package with scripts and a FastAPI server."
readme = "README.md"
requires-python = ">=3.9"
authors = [
  { name="Your Name", email="you@example.com" }
]

dependencies = [
  "fastapi",
  "uvicorn"
]

[project.optional-dependencies]
dev = ["pytest"]

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project.scripts]
myproject-script = "myproject.script:main"

[project.entry-points."uvicorn.run"]
myproject-api = "myproject.api:app"

---

📝 Example Python Script

src/myproject/script.py

def main():
    print("Hello from my project script!")

if __name__ == "__main__":
    main()

Run it with uv

uv run myproject-script

Or run directly:

uv run src/myproject/script.py

---

🚀 Minimal FastAPI Server

src/myproject/api.py

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def root():
    return {"message": "Hello from FastAPI!"}

Create Python Virutal Environment

uv venv --seed .venv

Run the API server with uv

“bash

```bash
uv run uvicorn myproject.api:app --reload

Or, because we defined an entry point:

uv run uvicorn myproject-api

---

🧪 Running Tests

uv run pytest

---

🧱 Installing Dependencies

uv pip install -e .[dev]

---

🏗️ Build & Publish

Build:

uv build

Publish:

uv publish

---

🎯 Summary

Using pyproject.toml + uv, you get:

• A clean package structure
• Fast script execution (uv run)
• A minimal FastAPI server with entry points
• Simple dependency + environment management
• One tool for build & publish