Python Project with UV Package Manager

This project uses the uv package manager for fast and reliable Python package management.

Project Structure

project/
├── src/                    # Source code
│   └── package_name/      # Main package directory
├── tests/                 # Test files
├── docs/                  # Documentation
├── pyproject.toml        # Project configuration
├── requirements.txt      # Production dependencies
├── requirements-dev.txt  # Development dependencies
└── README.md            # Project documentation

Prerequisites

• Python 3.8+
• UV package manager

Installation

1. Install UV:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Create a virtual environment:

uv venv

3. Install dependencies:

uv pip install -r requirements.txt

Development Setup

1. Install development dependencies:

uv pip install -r requirements-dev.txt

2. Install the package in development mode:

uv pip install -e .

Usage

# Run tests
pytest

# Run linting
ruff check .

# Run type checking
mypy .

Dependencies

• See requirements.txt for production dependencies
• See requirements-dev.txt for development dependencies

source .venv/bin/activate && uvicorn src.app.main:app --host 0.0.0.0 --port 8000 --log-level debug