dependency-manager

# Dependency Manager

Manage Python project dependencies with UV, pip-tools, or requirements.txt.

## Quick Start

Choose UV for new projects (fast, modern), pip-tools for existing pip workflows, or requirements.txt for simple projects.

## Instructions

### Choosing a Tool

**UV** - Fast, modern Python package manager (recommended):
- Extremely fast dependency resolution (10-100x faster than pip)
- Automatic virtual environment management
- Drop-in replacement for pip and pip-tools
- Lock file support with uv.lock
- Best for: All projects, especially new ones

**pip-tools** - Lightweight, pip-compatible workflow:
- Generates lock files from requirements.in
- Works with existing pip workflows
- Minimal changes to project structure
- Best for: Existing projects, CI/CD with pip, gradual adoption

**requirements.txt** - Simple, universal:
- Direct pip install
- No additional tools
- No lock file (unless manually maintained)
- Best for: Simple scripts, minimal dependencies, quick prototypes

### UV Setup (Recommended)

**Install UV:**
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
# Or with pip
pip install uv
```

**Initialize new project:**
```bash
uv init my-project
cd my-project
```

**Add dependencies:**
```bash
# Runtime dependency
uv add requests

# Development dependency
uv add --dev pytest

# With version constraint
uv add "requests>=2.28.0,<3.0.0"
```

**Install dependencies:**
```bash
uv sync
```

**Update dependencies:**
```bash
# Update all
uv lock --upgrade

# Update specific package
uv lock --upgrade-package requests
```

**Remove dependencies:**
```bash
uv remove requests
```

**Show dependency tree:**
```bash
uv tree
```

**Export to requirements.txt:**
```bash
uv pip compile pyproject.toml -o requirements.txt
```

**Run commands in virtual environment:**
```bash
uv run python script.py
uv run pytest
```

### pip-tools Setup

**Install pip-tools:**
```bash
pip install pip-tools
```

**Create requirements.in:**
```
# requirements.in
requests>=2.2