The Complete Guide to Python uv

# Replace pip commands directly
pip install requests    →    uv add requests
pip install -r req.txt  →    uv add -r req.txt
pip freeze             →    uv pip freeze

# Replace pip commands directly
pip install requests    →    uv add requests
pip install -r req.txt  →    uv add -r req.txt
pip freeze             →    uv pip freeze

# Install uv globally
pip install uv

# Or install for current user only
pip install --user uv

# Install uv globally
pip install uv

# Or install for current user only
pip install --user uv

uv --version
# Expected output: uv 0.4.0 (or latest version)

uv --version
# Expected output: uv 0.4.0 (or latest version)

# Install pipx first (if not already installed)
pip install pipx

# Install uv with pipx
pipx install uv

# Ensure pipx bin directory is in PATH
pipx ensurepath

# Install pipx first (if not already installed)
pip install pipx

# Install uv with pipx
pipx install uv

# Ensure pipx bin directory is in PATH
pipx ensurepath

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

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

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Install Homebrew (if needed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install uv
brew install uv

# Install Homebrew (if needed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install uv
brew install uv

# Install Scoop (if needed)
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# Install uv
scoop install uv

# Install Scoop (if needed)
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# Install uv
scoop install uv

# Arch Linux
pacman -S uv

# Fedora
dnf install uv

# Ubuntu/Debian (via snap)
snap install uv

# Arch Linux
pacman -S uv

# Fedora
dnf install uv

# Ubuntu/Debian (via snap)
snap install uv

# Prerequisites: Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone https://github.com/astral-sh/uv.git
cd uv
cargo build --release

# Install
cargo install --path .

# Prerequisites: Rust toolchain
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone https://github.com/astral-sh/uv.git
cd uv
cargo build --release

# Install
cargo install --path .

# Check version
uv --version

# Check help
uv --help

# Test basic functionality
uv pip list

# Check version
uv --version

# Check help
uv --help

# Test basic functionality
uv pip list

# uv completions
eval "$(uv generate-shell-completion bash)"

# uv aliases (optional)
alias pip="uv pip"
alias python="uv run python"

# uv completions
eval "$(uv generate-shell-completion bash)"

# uv aliases (optional)
alias pip="uv pip"
alias python="uv run python"

# uv completions
eval "$(uv generate-shell-completion zsh)"

# uv aliases (optional)
alias pip="uv pip"
alias python="uv run python"

# uv completions
eval "$(uv generate-shell-completion zsh)"

# uv aliases (optional)
alias pip="uv pip"
alias python="uv run python"

# Add to your PowerShell profile
Invoke-Expression (uv generate-shell-completion powershell)

# Add to your PowerShell profile
Invoke-Expression (uv generate-shell-completion powershell)

[tool.uv]
# Default Python version
python = "3.11"

# Cache directory
cache-dir = "~/.cache/uv"

# Default index URL
index-url = "https://pypi.org/simple"

# Concurrent downloads
concurrent-downloads = 10

# Timeout settings
timeout = 30

[tool.uv]
# Default Python version
python = "3.11"

# Cache directory
cache-dir = "~/.cache/uv"

# Default index URL
index-url = "https://pypi.org/simple"

# Concurrent downloads
concurrent-downloads = 10

# Timeout settings
timeout = 30

# Create a test directory
mkdir uv-test && cd uv-test

# Initialize a project
uv init test-project
cd test-project

# Add a package
uv add requests

# Run a simple test
uv run python -c "import requests; print('✅ uv is working correctly!')"

# Clean up
cd ../..
rm -rf uv-test

# Create a test directory
mkdir uv-test && cd uv-test

# Initialize a project
uv init test-project
cd test-project

# Add a package
uv add requests

# Run a simple test
uv run python -c "import requests; print('✅ uv is working correctly!')"

# Clean up
cd ../..
rm -rf uv-test

✅ uv is working correctly!

✅ uv is working correctly!

# Option 1: User installation
pip install --user uv

# Option 2: Use pipx
pipx install uv

# Option 3: Virtual environment
python -m venv uv-env
source uv-env/bin/activate  # Unix
# or: uv-env\Scripts\activate  # Windows
pip install uv

# Option 1: User installation
pip install --user uv

# Option 2: Use pipx
pipx install uv

# Option 3: Virtual environment
python -m venv uv-env
source uv-env/bin/activate  # Unix
# or: uv-env\Scripts\activate  # Windows
pip install uv

# Check if uv is in PATH
which uv  # Unix
where uv  # Windows

# Add to PATH if needed (Unix)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Add to PATH (Windows - PowerShell)
$env:PATH += ";$env:USERPROFILE\.local\bin"

# Check if uv is in PATH
which uv  # Unix
where uv  # Windows

# Add to PATH if needed (Unix)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Add to PATH (Windows - PowerShell)
$env:PATH += ";$env:USERPROFILE\.local\bin"

# Set proxy for pip
pip install --proxy http://user:pass@proxy.server:port uv

# Set proxy environment variables
export HTTP_PROXY=http://proxy.server:port
export HTTPS_PROXY=http://proxy.server:port

# Use different index
pip install -i https://pypi.org/simple/ uv

# Set proxy for pip
pip install --proxy http://user:pass@proxy.server:port uv

# Set proxy environment variables
export HTTP_PROXY=http://proxy.server:port
export HTTPS_PROXY=http://proxy.server:port

# Use different index
pip install -i https://pypi.org/simple/ uv

# Install newer Python version
# macOS
brew install python@3.11

# Windows
# Download from python.org

# Linux
sudo apt-get install python3.11

# Use specific Python version
python3.11 -m pip install uv

# Install newer Python version
# macOS
brew install python@3.11

# Windows
# Download from python.org

# Linux
sudo apt-get install python3.11

# Use specific Python version
python3.11 -m pip install uv

# pipx
pipx upgrade uv

# pip
pip install --upgrade uv

# Homebrew
brew upgrade uv

# Check latest version
uv --version

# pipx
pipx upgrade uv

# pip
pip install --upgrade uv

# Homebrew
brew upgrade uv

# Check latest version
uv --version

uv init my-first-project
cd my-first-project

uv init my-first-project
cd my-first-project

my-first-project/
├── pyproject.toml
├── README.md
├── src/
│   └── my_first_project/
│       └── __init__.py
└── .python-version

my-first-project/
├── pyproject.toml
├── README.md
├── src/
│   └── my_first_project/
│       └── __init__.py
└── .python-version

uv add requests

uv add requests

import requests

def get_python_version():
    """Fetch Python version from httpbin."""
    response = requests.get('https://httpbin.org/json')
    return response.json()

if __name__ == "__main__":
    data = get_python_version()
    print(f"Response: {data}")

import requests

def get_python_version():
    """Fetch Python version from httpbin."""
    response = requests.get('https://httpbin.org/json')
    return response.json()

if __name__ == "__main__":
    data = get_python_version()
    print(f"Response: {data}")

uv run python src/my_first_project/main.py

uv run python src/my_first_project/main.py

# Install a single package
uv add numpy

# Install multiple packages
uv add pandas matplotlib seaborn

# Install with version constraints
uv add "django>=4.0,<5.0"

# Install from specific index
uv add --index-url https://pypi.org/simple/ requests

# Install a single package
uv add numpy

# Install multiple packages
uv add pandas matplotlib seaborn

# Install with version constraints
uv add "django>=4.0,<5.0"

# Install from specific index
uv add --index-url https://pypi.org/simple/ requests

# Add development dependencies
uv add --dev pytest black flake8

# Add optional dependencies
uv add --optional docs sphinx

# Add with extras
uv add "fastapi[all]"

# Add development dependencies
uv add --dev pytest black flake8

# Add optional dependencies
uv add --optional docs sphinx

# Add with extras
uv add "fastapi[all]"

# Remove a package
uv remove numpy

# Remove multiple packages
uv remove pandas matplotlib

# Remove development dependencies
uv remove --dev pytest

# Remove a package
uv remove numpy

# Remove multiple packages
uv remove pandas matplotlib

# Remove development dependencies
uv remove --dev pytest

# List installed packages
uv pip list

# Show package information
uv pip show requests

# List outdated packages
uv pip list --outdated

# List installed packages
uv pip list

# Show package information
uv pip show requests

# List outdated packages
uv pip list --outdated

# Create a new virtual environment
uv venv

# Create with specific Python version
uv venv --python 3.11

# Create with custom name
uv venv my-env

# Create in specific directory
uv venv /path/to/my-env

# Create a new virtual environment
uv venv

# Create with specific Python version
uv venv --python 3.11

# Create with custom name
uv venv my-env

# Create in specific directory
uv venv /path/to/my-env

.venv\Scripts\activate

.venv\Scripts\activate

source .venv/bin/activate

source .venv/bin/activate

# Run command in virtual environment
uv run python script.py

# Run with specific environment
uv run --env my-env python script.py

# Install and run tool
uv tool run black script.py

# Run command in virtual environment
uv run python script.py

# Run with specific environment
uv run --env my-env python script.py

# Install and run tool
uv tool run black script.py

# Show current environment info
uv venv --show-path

# List all environments
uv venv --list

# Remove environment
uv venv --remove my-env

# Show current environment info
uv venv --show-path

# List all environments
uv venv --list

# Remove environment
uv venv --remove my-env

# Sync environment with lock file
uv sync

# Sync only production dependencies
uv sync --no-dev

# Sync specific groups
uv sync --group test

# Force sync (reinstall all)
uv sync --force

# Sync environment with lock file
uv sync

# Sync only production dependencies
uv sync --no-dev

# Sync specific groups
uv sync --group test

# Force sync (reinstall all)
uv sync --force

# List all available Python versions
uv python list

# List installed Python versions
uv python list --installed

# Find specific Python version
uv python find 3.11

# List all available Python versions
uv python list

# List installed Python versions
uv python list --installed

# Find specific Python version
uv python find 3.11

# Install latest Python 3.11
uv python install 3.11

# Install specific version
uv python install 3.11.5

# Install multiple versions
uv python install 3.10 3.11 3.12

# Install latest Python 3.11
uv python install 3.11

# Install specific version
uv python install 3.11.5

# Install multiple versions
uv python install 3.10 3.11 3.12

3.11.5

3.11.5

# Set Python version for current project
uv python pin 3.11

# Set specific patch version
uv python pin 3.11.5

# Use system Python
uv python pin system

# Set Python version for current project
uv python pin 3.11

# Set specific patch version
uv python pin 3.11.5

# Use system Python
uv python pin system

[project]
name = "my-awesome-project"
version = "0.1.0"
description = "A sample project using uv"
authors = [
    {name = "Your Name", email = "your.email@example.com"}
]
dependencies = [
    "requests>=2.28.0",
    "click>=8.0.0",
]
requires-python = ">=3.8"

[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "black>=22.0.0",
    "flake8>=5.0.0",
]
docs = [
    "sphinx>=5.0.0",
    "sphinx-rtd-theme>=1.0.0",
]

[tool.uv]
dev-dependencies = [
    "pytest-cov>=4.0.0",
]

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

[project]
name = "my-awesome-project"
version = "0.1.0"
description = "A sample project using uv"
authors = [
    {name = "Your Name", email = "your.email@example.com"}
]
dependencies = [
    "requests>=2.28.0",
    "click>=8.0.0",
]
requires-python = ">=3.8"

[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "black>=22.0.0",
    "flake8>=5.0.0",
]
docs = [
    "sphinx>=5.0.0",
    "sphinx-rtd-theme>=1.0.0",
]

[tool.uv]
dev-dependencies = [
    "pytest-cov>=4.0.0",
]

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

version = 1
requires-python = ">=3.8"

[[package]]
name = "certifi"
version = "2023.7.22"
source = { registry = "https://pypi.org/simple" }
sdist = { url = "https://files.pythonhosted.org/packages/98/98/c2ff18671db109c9f10ed27f5ef610ae05b73bd876664139cf95bd1429aa/certifi-2023.7.22.tar.gz", hash = "sha256:539cc1d13202e33ca466e88b2807e29f4c13049d6d87031a3c110744495cb082" }
wheels = [
    { url = "https://files.pythonhosted.org/packages/88/5f/e351af9a41f866ac3f1fac4ca0613908d9a41741cfcf2228f4e80058d3...certifi-2023.7.22-py3-none-any.whl", hash = "sha256:92d6037539857d8206b8f6ae472e8b77db8058fec5937a1ef3f54304089edbb9" },
]

dependencies = [
    { name = "requests" },
]

version = 1
requires-python = ">=3.8"

[[package]]
name = "certifi"
version = "2023.7.22"
source = { registry = "https://pypi.org/simple" }
sdist = { url = "https://files.pythonhosted.org/packages/98/98/c2ff18671db109c9f10ed27f5ef610ae05b73bd876664139cf95bd1429aa/certifi-2023.7.22.tar.gz", hash = "sha256:539cc1d13202e33ca466e88b2807e29f4c13049d6d87031a3c110744495cb082" }
wheels = [
    { url = "https://files.pythonhosted.org/packages/88/5f/e351af9a41f866ac3f1fac4ca0613908d9a41741cfcf2228f4e80058d3...certifi-2023.7.22-py3-none-any.whl", hash = "sha256:92d6037539857d8206b8f6ae472e8b77db8058fec5937a1ef3f54304089edbb9" },
]

dependencies = [
    { name = "requests" },
]

[tool.uv.workspace]
members = [
    "packages/*",
    "apps/web",
    "apps/api",
]

[tool.uv.workspace.dependencies]
shared-utils = { path = "packages/shared-utils" }

[tool.uv.workspace]
members = [
    "packages/*",
    "apps/web",
    "apps/api",
]

[tool.uv.workspace.dependencies]
shared-utils = { path = "packages/shared-utils" }

# Install a tool globally
uv tool install black

# Run a tool without installing
uv tool run ruff check .

# List installed tools
uv tool list

# Upgrade a tool
uv tool upgrade black

# Uninstall a tool
uv tool uninstall black

# Install a tool globally
uv tool install black

# Run a tool without installing
uv tool run ruff check .

# List installed tools
uv tool list

# Upgrade a tool
uv tool upgrade black

# Uninstall a tool
uv tool uninstall black

#!/usr/bin/env uv run
# /// script
# requires-python = ">=3.8"
# dependencies = [
#     "requests",
#     "click",
# ]
# ///

import requests
import click

@click.command()
@click.argument("url")
def fetch(url):
    """Fetch and display URL content."""
    response = requests.get(url)
    click.echo(response.text[:200])

if __name__ == "__main__":
    fetch()

#!/usr/bin/env uv run
# /// script
# requires-python = ">=3.8"
# dependencies = [
#     "requests",
#     "click",
# ]
# ///

import requests
import click

@click.command()
@click.argument("url")
def fetch(url):
    """Fetch and display URL content."""
    response = requests.get(url)
    click.echo(response.text[:200])

if __name__ == "__main__":
    fetch()

uv run script.py https://httpbin.org/json

uv run script.py https://httpbin.org/json

# Build wheel and sdist
uv build

# Build only wheel
uv build --wheel

# Build only sdist
uv build --sdist

# Build wheel and sdist
uv build

# Build only wheel
uv build --wheel

# Build only sdist
uv build --sdist

# Use highest version resolution
uv add --resolution highest package

# Use lowest version resolution  
uv add --resolution lowest package

# Preview resolution without installing
uv add --dry-run package

# Use highest version resolution
uv add --resolution highest package

# Use lowest version resolution  
uv add --resolution lowest package

# Preview resolution without installing
uv add --dry-run package

[tool.uv]
override-dependencies = [
    "numpy==1.24.0",  # Force specific version
]

[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

[tool.uv]
override-dependencies = [
    "numpy==1.24.0",  # Force specific version
]

[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

# Show cache information
uv cache info

# Clean cache
uv cache clean

# Clean specific package from cache
uv cache clean requests

# Show cache information
uv cache info

# Clean cache
uv cache clean

# Clean specific package from cache
uv cache clean requests

# Pre-populate cache for CI
uv cache sync

# Use cache in CI/CD
uv install --cache-dir /cache/uv

# Pre-populate cache for CI
uv cache sync

# Use cache in CI/CD
uv install --cache-dir /cache/uv

[tool.uv]
# Use fewer network requests
index-strategy = "unsafe-first-match"

# Compile from source less often
compile-bytecode = false

# Use specific indexes for faster resolution
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"

[tool.uv]
# Use fewer network requests
index-strategy = "unsafe-first-match"

# Compile from source less often
compile-bytecode = false

# Use specific indexes for faster resolution
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"

# Verbose output for debugging
uv add --verbose package

# Show resolution process
uv lock --upgrade --verbose

# Time operations
time uv add package

# Verbose output for debugging
uv add --verbose package

# Show resolution process
uv lock --upgrade --verbose

# Time operations
time uv add package

# Show cache hit rates
uv cache info --verbose

# Monitor cache size
du -sh ~/.cache/uv

# Show cache hit rates
uv cache info --verbose

# Monitor cache size
du -sh ~/.cache/uv

# Try lowest compatible versions
uv add --resolution lowest conflicting-package

# Override specific dependencies
# In pyproject.toml:
[tool.uv]
override-dependencies = ["problematic-package==1.0.0"]

# Try lowest compatible versions
uv add --resolution lowest conflicting-package

# Override specific dependencies
# In pyproject.toml:
[tool.uv]
override-dependencies = ["problematic-package==1.0.0"]

# Install required Python version
uv python install 3.11

# Use different version
uv add --python 3.10 package

# Install required Python version
uv python install 3.11

# Use different version
uv add --python 3.10 package

# Use different index
uv add --index-url https://pypi.org/simple/ package

# Configure proxy
export HTTPS_PROXY=http://proxy.company.com:8080
uv add package

# Use different index
uv add --index-url https://pypi.org/simple/ package

# Configure proxy
export HTTPS_PROXY=http://proxy.company.com:8080
uv add package

# Verbose output
uv --verbose add package

# Show resolution tree
uv tree

# Check environment
uv pip check

# Show configuration
uv config

# Validate lock file
uv lock --check

# Verbose output
uv --verbose add package

# Show resolution tree
uv tree

# Check environment
uv pip check

# Show configuration
uv config

# Validate lock file
uv lock --check

# Enable debug logging
UV_LOG_LEVEL=debug uv add package

# Log to file
uv add package 2> uv.log

# Enable debug logging
UV_LOG_LEVEL=debug uv add package

# Log to file
uv add package 2> uv.log

my-project/
├── pyproject.toml          # Project configuration
├── uv.lock                 # Dependency lock file
├── .python-version         # Python version pin
├── README.md               # Documentation
├── src/                    # Source code
│   └── my_project/
│       ├── __init__.py
│       └── main.py
├── tests/                  # Test files
│   ├── __init__.py
│   └── test_main.py
├── docs/                   # Documentation
└── scripts/                # Utility scripts

my-project/
├── pyproject.toml          # Project configuration
├── uv.lock                 # Dependency lock file
├── .python-version         # Python version pin
├── README.md               # Documentation
├── src/                    # Source code
│   └── my_project/
│       ├── __init__.py
│       └── main.py
├── tests/                  # Test files
│   ├── __init__.py
│   └── test_main.py
├── docs/                   # Documentation
└── scripts/                # Utility scripts

# pyproject.toml best practices
[project]
name = "my-project"
version = "0.1.0"
description = "Clear, concise description"
readme = "README.md"
license = {text = "MIT"}
authors = [
    {name = "Author Name", email = "author@example.com"}
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.8",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
]
requires-python = ">=3.8"
dependencies = [
    "requests>=2.28.0",
    "click>=8.0.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "pytest-cov>=4.0.0",
    "black>=22.0.0",
    "ruff>=0.1.0",
    "mypy>=1.0.0",
]
docs = [
    "sphinx>=5.0.0",
    "sphinx-rtd-theme>=1.0.0",
]

[project.scripts]
my-cli = "my_project.cli:main"

[tool.uv]
dev-dependencies = [
    "pre-commit>=3.0.0",
]

[tool.black]
line-length = 88
target-version = ['py38']

[tool.ruff]
line-length = 88
target-version = "py38"

[tool.mypy]
python_version = "3.8"
strict = true

# pyproject.toml best practices
[project]
name = "my-project"
version = "0.1.0"
description = "Clear, concise description"
readme = "README.md"
license = {text = "MIT"}
authors = [
    {name = "Author Name", email = "author@example.com"}
]
classifiers = [
    "Development Status :: 4 - Beta",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.8",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
]
requires-python = ">=3.8"
dependencies = [
    "requests>=2.28.0",
    "click>=8.0.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "pytest-cov>=4.0.0",
    "black>=22.0.0",
    "ruff>=0.1.0",
    "mypy>=1.0.0",
]
docs = [
    "sphinx>=5.0.0",
    "sphinx-rtd-theme>=1.0.0",
]

[project.scripts]
my-cli = "my_project.cli:main"

[tool.uv]
dev-dependencies = [
    "pre-commit>=3.0.0",
]

[tool.black]
line-length = 88
target-version = ['py38']

[tool.ruff]
line-length = 88
target-version = "py38"

[tool.mypy]
python_version = "3.8"
strict = true

# Core runtime dependencies
dependencies = [
    "fastapi>=0.100.0",
    "uvicorn>=0.23.0",
    "pydantic>=2.0.0",
]

# Development tools
[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "black>=22.0.0",
    "ruff>=0.1.0",
]

# Testing dependencies
test = [
    "pytest>=7.0.0",
    "pytest-asyncio>=0.21.0",
    "httpx>=0.24.0",
]

# Documentation
docs = [
    "mkdocs>=1.5.0",
    "mkdocs-material>=9.0.0",
]

# Core runtime dependencies
dependencies = [
    "fastapi>=0.100.0",
    "uvicorn>=0.23.0",
    "pydantic>=2.0.0",
]

# Development tools
[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "black>=22.0.0",
    "ruff>=0.1.0",
]

# Testing dependencies
test = [
    "pytest>=7.0.0",
    "pytest-asyncio>=0.21.0",
    "httpx>=0.24.0",
]

# Documentation
docs = [
    "mkdocs>=1.5.0",
    "mkdocs-material>=9.0.0",
]

# Update lock file regularly
uv lock --upgrade

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

# Check for outdated packages
uv pip list --outdated

# Update lock file regularly
uv lock --upgrade

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

# Check for outdated packages
uv pip list --outdated

repos:
  - repo: https://github.com/psf/black
    rev: 23.7.0
    hooks:
      - id: black
        language_version: python3.11

  - repo: https://github.com/charliermarsh/ruff-pre-commit
    rev: v0.0.287
    hooks:
      - id: ruff
        args: [--fix, --exit-non-zero-on-fix]

  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.5.1
    hooks:
      - id: mypy
        additional_dependencies: [types-requests]

repos:
  - repo: https://github.com/psf/black
    rev: 23.7.0
    hooks:
      - id: black
        language_version: python3.11

  - repo: https://github.com/charliermarsh/ruff-pre-commit
    rev: v0.0.287
    hooks:
      - id: ruff
        args: [--fix, --exit-non-zero-on-fix]

  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.5.1
    hooks:
      - id: mypy
        additional_dependencies: [types-requests]

name: CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.8", "3.9", "3.10", "3.11"]

    steps:
    - uses: actions/checkout@v4

    - name: Install uv
      uses: astral-sh/setup-uv@v1
      with:
        version: "latest"

    - name: Set up Python ${{ matrix.python-version }}
      run: uv python install ${{ matrix.python-version }}

    - name: Install dependencies
      run: uv sync --all-extras --dev

    - name: Run tests
      run: uv run pytest

    - name: Run linting
      run: |
        uv run black --check .
        uv run ruff check .
        uv run mypy .

name: CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.8", "3.9", "3.10", "3.11"]

    steps:
    - uses: actions/checkout@v4

    - name: Install uv
      uses: astral-sh/setup-uv@v1
      with:
        version: "latest"

    - name: Set up Python ${{ matrix.python-version }}
      run: uv python install ${{ matrix.python-version }}

    - name: Install dependencies
      run: uv sync --all-extras --dev

    - name: Run tests
      run: uv run pytest

    - name: Run linting
      run: |
        uv run black --check .
        uv run ruff check .
        uv run mypy .

# Audit dependencies for vulnerabilities
uv pip audit

# Use trusted sources
uv add --trusted-host pypi.org package

# Verify checksums
uv add --require-hashes package

# Audit dependencies for vulnerabilities
uv pip audit

# Use trusted sources
uv add --trusted-host pypi.org package

# Verify checksums
uv add --require-hashes package

pip install requests
pip install -r requirements.txt
pip freeze > requirements.txt

pip install requests
pip install -r requirements.txt
pip freeze > requirements.txt

uv add requests
uv add -r requirements.txt
uv pip freeze > requirements.txt

uv add requests
uv add -r requirements.txt
uv pip freeze > requirements.txt

[tool.poetry]
name = "my-project"
version = "0.1.0"
description = ""
authors = ["Author <author@example.com>"]

[tool.poetry.dependencies]
python = "^3.8"
requests = "^2.28.0"

[tool.poetry.group.dev.dependencies]
pytest = "^7.0.0"

[tool.poetry]
name = "my-project"
version = "0.1.0"
description = ""
authors = ["Author <author@example.com>"]

[tool.poetry.dependencies]
python = "^3.8"
requests = "^2.28.0"

[tool.poetry.group.dev.dependencies]
pytest = "^7.0.0"

[project]
name = "my-project"
version = "0.1.0"
description = ""
authors = [{name = "Author", email = "author@example.com"}]
requires-python = ">=3.8"
dependencies = [
    "requests>=2.28.0,<3.0.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=7.0.0,<8.0.0",
]

[project]
name = "my-project"
version = "0.1.0"
description = ""
authors = [{name = "Author", email = "author@example.com"}]
requires-python = ">=3.8"
dependencies = [
    "requests>=2.28.0,<3.0.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=7.0.0,<8.0.0",
]

# Convert poetry.lock to uv.lock
uv add $(poetry export --format=requirements.txt --output=-)

# Or use migration tool
uv init --from-poetry

# Convert poetry.lock to uv.lock
uv add $(poetry export --format=requirements.txt --output=-)

# Or use migration tool
uv init --from-poetry

[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]
requests = "*"
django = ">=4.0,<5.0"

[dev-packages]
pytest = "*"

[requires]
python_version = "3.11"

[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]
requests = "*"
django = ">=4.0,<5.0"

[dev-packages]
pytest = "*"

[requires]
python_version = "3.11"

[project]
requires-python = ">=3.11"
dependencies = [
    "requests",
    "django>=4.0,<5.0",
]

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

[project]
requires-python = ">=3.11"
dependencies = [
    "requests",
    "django>=4.0,<5.0",
]

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

[tool.uv]
# Multiple package indexes
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

[[tool.uv.index]]
name = "private"
url = "https://pypi.company.com/simple"
default = true

# Index priority
index-strategy = "first-index"

# Source distributions preferences
no-build = ["numpy", "scipy"]  # Don't build these from source
build = ["custom-package"]     # Always build from source

[tool.uv]
# Multiple package indexes
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

[[tool.uv.index]]
name = "private"
url = "https://pypi.company.com/simple"
default = true

# Index priority
index-strategy = "first-index"

# Source distributions preferences
no-build = ["numpy", "scipy"]  # Don't build these from source
build = ["custom-package"]     # Always build from source

# Configuration via environment variables
export UV_INDEX_URL=https://pypi.org/simple
export UV_EXTRA_INDEX_URL=https://download.pytorch.org/whl/cpu
export UV_NO_CACHE=1
export UV_CACHE_DIR=/custom/cache/path
export UV_PYTHON=3.11

# Configuration via environment variables
export UV_INDEX_URL=https://pypi.org/simple
export UV_EXTRA_INDEX_URL=https://download.pytorch.org/whl/cpu
export UV_NO_CACHE=1
export UV_CACHE_DIR=/custom/cache/path
export UV_PYTHON=3.11

[tool.uv]
# Adjust concurrent downloads
concurrent-downloads = 50

# Adjust concurrent builds
concurrent-builds = 4

# Network timeout settings
timeout = 30

[tool.uv]
# Adjust concurrent downloads
concurrent-downloads = 50

# Adjust concurrent builds
concurrent-builds = 4

# Network timeout settings
timeout = 30

# Pre-warm cache for better performance
uv cache warm

# Clean cache periodically
uv cache clean --older-than=30d

# Cache statistics
uv cache info --stats

# Pre-warm cache for better performance
uv cache warm

# Clean cache periodically
uv cache clean --older-than=30d

# Cache statistics
uv cache info --stats

#!/usr/bin/env uv run
# /// script
# requires-python = ">=3.8"
# dependencies = [
#     "httpx",
#     "rich",
#     "typer",
# ]
# ///

import asyncio
import httpx
from rich.console import Console
from rich.progress import Progress
import typer

console = Console()

async def fetch_urls(urls: list[str]) -> None:
    """Fetch multiple URLs concurrently."""
    async with httpx.AsyncClient() as client:
        with Progress() as progress:
            task = progress.add_task("Fetching...", total=len(urls))

            async def fetch_one(url: str) -> None:
                response = await client.get(url)
                console.print(f"[green]{url}[/green]: {response.status_code}")
                progress.advance(task)

            await asyncio.gather(*(fetch_one(url) for url in urls))

def main(urls: list[str]) -> None:
    """Main CLI entry point."""
    asyncio.run(fetch_urls(urls))

if __name__ == "__main__":
    typer.run(main)

#!/usr/bin/env uv run
# /// script
# requires-python = ">=3.8"
# dependencies = [
#     "httpx",
#     "rich",
#     "typer",
# ]
# ///

import asyncio
import httpx
from rich.console import Console
from rich.progress import Progress
import typer

console = Console()

async def fetch_urls(urls: list[str]) -> None:
    """Fetch multiple URLs concurrently."""
    async with httpx.AsyncClient() as client:
        with Progress() as progress:
            task = progress.add_task("Fetching...", total=len(urls))

            async def fetch_one(url: str) -> None:
                response = await client.get(url)
                console.print(f"[green]{url}[/green]: {response.status_code}")
                progress.advance(task)

            await asyncio.gather(*(fetch_one(url) for url in urls))

def main(urls: list[str]) -> None:
    """Main CLI entry point."""
    asyncio.run(fetch_urls(urls))

if __name__ == "__main__":
    typer.run(main)

# Root pyproject.toml
[tool.uv.workspace]
members = [
    "packages/*",
    "services/*",
]

# Shared dependencies across workspace
[tool.uv.workspace.dependencies]
pytest = ">=7.0.0"
mypy = ">=1.0.0"

# Package-specific overrides
[tool.uv.workspace.package-overrides]
"my-package" = { python = ">=3.10" }

# Root pyproject.toml
[tool.uv.workspace]
members = [
    "packages/*",
    "services/*",
]

# Shared dependencies across workspace
[tool.uv.workspace.dependencies]
pytest = ">=7.0.0"
mypy = ">=1.0.0"

# Package-specific overrides
[tool.uv.workspace.package-overrides]
"my-package" = { python = ">=3.10" }

# tool_template.py
#!/usr/bin/env python3
"""Custom uv tool template."""

import subprocess
import sys
from pathlib import Path

def run_uv_command(args: list[str]) -> int:
    """Run uv command with custom logic."""
    cmd = ["uv"] + args

    # Custom pre-processing
    if "--my-flag" in args:
        args.remove("--my-flag")
        print("Custom flag detected!")

    # Run uv command
    result = subprocess.run(cmd, capture_output=False)

    # Custom post-processing
    if result.returncode == 0:
        print("✅ Command succeeded!")

    return result.returncode

if __name__ == "__main__":
    sys.exit(run_uv_command(sys.argv[1:]))

# tool_template.py
#!/usr/bin/env python3
"""Custom uv tool template."""

import subprocess
import sys
from pathlib import Path

def run_uv_command(args: list[str]) -> int:
    """Run uv command with custom logic."""
    cmd = ["uv"] + args

    # Custom pre-processing
    if "--my-flag" in args:
        args.remove("--my-flag")
        print("Custom flag detected!")

    # Run uv command
    result = subprocess.run(cmd, capture_output=False)

    # Custom post-processing
    if result.returncode == 0:
        print("✅ Command succeeded!")

    return result.returncode

if __name__ == "__main__":
    sys.exit(run_uv_command(sys.argv[1:]))

#!/usr/bin/env uv run
# /// script
# dependencies = ["psutil", "rich"]
# ///

import time
import psutil
from rich.console import Console
from rich.table import Table
from rich.live import Live

def monitor_uv_process():
    """Monitor uv process performance."""
    console = Console()

    def make_table():
        table = Table()
        table.add_column("Metric")
        table.add_column("Value")

        for proc in psutil.process_iter(['pid', 'name', 'cpu_percent', 'memory_info']):
            if 'uv' in proc.info['name']:
                table.add_row("PID", str(proc.info['pid']))
                table.add_row("CPU %", f"{proc.info['cpu_percent']:.1f}%")
                table.add_row("Memory", f"{proc.info['memory_info'].rss / 1024 / 1024:.1f} MB")

        return table

    with Live(make_table(), refresh_per_second=1) as live:
        while True:
            time.sleep(1)
            live.update(make_table())

if __name__ == "__main__":
    monitor_uv_process()

#!/usr/bin/env uv run
# /// script
# dependencies = ["psutil", "rich"]
# ///

import time
import psutil
from rich.console import Console
from rich.table import Table
from rich.live import Live

def monitor_uv_process():
    """Monitor uv process performance."""
    console = Console()

    def make_table():
        table = Table()
        table.add_column("Metric")
        table.add_column("Value")

        for proc in psutil.process_iter(['pid', 'name', 'cpu_percent', 'memory_info']):
            if 'uv' in proc.info['name']:
                table.add_row("PID", str(proc.info['pid']))
                table.add_row("CPU %", f"{proc.info['cpu_percent']:.1f}%")
                table.add_row("Memory", f"{proc.info['memory_info'].rss / 1024 / 1024:.1f} MB")

        return table

    with Live(make_table(), refresh_per_second=1) as live:
        while True:
            time.sleep(1)
            live.update(make_table())

if __name__ == "__main__":
    monitor_uv_process()

# Dockerfile optimized for uv
FROM python:3.11-slim

# Install uv
COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv

# Copy dependency files
COPY pyproject.toml uv.lock ./

# Install dependencies
RUN uv sync --frozen --no-cache

# Copy application code
COPY . .

# Run application
CMD ["uv", "run", "python", "-m", "myapp"]

# Dockerfile optimized for uv
FROM python:3.11-slim

# Install uv
COPY --from=ghcr.io/astral-sh/uv:latest /uv /bin/uv

# Copy dependency files
COPY pyproject.toml uv.lock ./

# Install dependencies
RUN uv sync --frozen --no-cache

# Copy application code
COPY . .

# Run application
CMD ["uv", "run", "python", "-m", "myapp"]

{
    "python.defaultInterpreterPath": "./.venv/bin/python",
    "python.terminal.activateEnvironment": false,
    "python.formatting.provider": "black",
    "python.linting.enabled": true,
    "python.linting.ruffEnabled": true,
    "terminal.integrated.env.linux": {
        "UV_PROJECT_ENVIRONMENT": ".venv"
    }
}

{
    "python.defaultInterpreterPath": "./.venv/bin/python",
    "python.terminal.activateEnvironment": false,
    "python.formatting.provider": "black",
    "python.linting.enabled": true,
    "python.linting.ruffEnabled": true,
    "terminal.integrated.env.linux": {
        "UV_PROJECT_ENVIRONMENT": ".venv"
    }
}

# Debug dependency resolution
UV_LOG_LEVEL=trace uv add package 2> resolution.log

# Profile installation
UV_PROFILING=1 uv add package

# Memory debugging
UV_DEBUG_MEMORY=1 uv sync

# Debug dependency resolution
UV_LOG_LEVEL=trace uv add package 2> resolution.log

# Profile installation
UV_PROFILING=1 uv add package

# Memory debugging
UV_DEBUG_MEMORY=1 uv sync

#!/usr/bin/env uv run
# /// script
# dependencies = ["click", "tomlkit"]
# ///

import click
import tomlkit
from pathlib import Path

@click.command()
@click.option("--project", default=".", help="Project directory")
def debug_project(project: str):
    """Debug uv project configuration."""
    project_path = Path(project)
    pyproject_path = project_path / "pyproject.toml"
    lock_path = project_path / "uv.lock"

    if pyproject_path.exists():
        with open(pyproject_path) as f:
            config = tomlkit.parse(f.read())

        click.echo("📋 Project Configuration:")
        click.echo(f"  Name: {config.get('project', {}).get('name', 'Unknown')}")
        click.echo(f"  Python: {config.get('project', {}).get('requires-python', 'Not specified')}")

        deps = config.get('project', {}).get('dependencies', [])
        click.echo(f"  Dependencies: {len(deps)}")

        if lock_path.exists():
            click.echo("🔒 Lock file: Present")
        else:
            click.echo("❌ Lock file: Missing")
    else:
        click.echo("❌ No pyproject.toml found")

if __name__ == "__main__":
    debug_project()

#!/usr/bin/env uv run
# /// script
# dependencies = ["click", "tomlkit"]
# ///

import click
import tomlkit
from pathlib import Path

@click.command()
@click.option("--project", default=".", help="Project directory")
def debug_project(project: str):
    """Debug uv project configuration."""
    project_path = Path(project)
    pyproject_path = project_path / "pyproject.toml"
    lock_path = project_path / "uv.lock"

    if pyproject_path.exists():
        with open(pyproject_path) as f:
            config = tomlkit.parse(f.read())

        click.echo("📋 Project Configuration:")
        click.echo(f"  Name: {config.get('project', {}).get('name', 'Unknown')}")
        click.echo(f"  Python: {config.get('project', {}).get('requires-python', 'Not specified')}")

        deps = config.get('project', {}).get('dependencies', [])
        click.echo(f"  Dependencies: {len(deps)}")

        if lock_path.exists():
            click.echo("🔒 Lock file: Present")
        else:
            click.echo("❌ Lock file: Missing")
    else:
        click.echo("❌ No pyproject.toml found")

if __name__ == "__main__":
    debug_project()

# Initialize new project
uv init project-name

# Add dependencies
uv add package-name
uv add "package>=1.0,<2.0"
uv add --dev pytest
uv add --optional docs sphinx

# Remove dependencies
uv remove package-name
uv remove --dev pytest

# Sync environment with lock file
uv sync
uv sync --dev
uv sync --no-dev

# Initialize new project
uv init project-name

# Add dependencies
uv add package-name
uv add "package>=1.0,<2.0"
uv add --dev pytest
uv add --optional docs sphinx

# Remove dependencies
uv remove package-name
uv remove --dev pytest

# Sync environment with lock file
uv sync
uv sync --dev
uv sync --no-dev

# Create virtual environment
uv venv
uv venv --python 3.11
uv venv my-env

# Run commands in environment
uv run python script.py
uv run --env my-env python script.py

# Show environment info
uv venv --show-path

# Create virtual environment
uv venv
uv venv --python 3.11
uv venv my-env

# Run commands in environment
uv run python script.py
uv run --env my-env python script.py

# Show environment info
uv venv --show-path

# List Python versions
uv python list
uv python list --installed

# Install Python version
uv python install 3.11
uv python install 3.11.5

# Pin Python version
uv python pin 3.11

# List Python versions
uv python list
uv python list --installed

# Install Python version
uv python install 3.11
uv python install 3.11.5

# Pin Python version
uv python pin 3.11

# Install global tool
uv tool install black

# Run tool without installing
uv tool run black script.py
uv tool run --from black==23.7.0 black .

# List installed tools
uv tool list

# Upgrade tool
uv tool upgrade black

# Install global tool
uv tool install black

# Run tool without installing
uv tool run black script.py
uv tool run --from black==23.7.0 black .

# List installed tools
uv tool list

# Upgrade tool
uv tool upgrade black

# List installed packages
uv pip list
uv pip list --outdated

# Show package info
uv pip show package-name

# Check for security vulnerabilities
uv pip audit

# List installed packages
uv pip list
uv pip list --outdated

# Show package info
uv pip show package-name

# Check for security vulnerabilities
uv pip audit

[project]
name = "my-project"
version = "0.1.0"
description = "Project description"
readme = "README.md"
authors = [{name = "Author", email = "author@example.com"}]
requires-python = ">=3.8"
dependencies = [
    "requests>=2.28.0",
]

[project.optional-dependencies]
dev = ["pytest>=7.0.0", "black>=22.0.0"]
docs = ["sphinx>=5.0.0"]

[project.scripts]
my-cli = "my_project.cli:main"

[tool.uv]
dev-dependencies = ["pre-commit>=3.0.0"]

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

[project]
name = "my-project"
version = "0.1.0"
description = "Project description"
readme = "README.md"
authors = [{name = "Author", email = "author@example.com"}]
requires-python = ">=3.8"
dependencies = [
    "requests>=2.28.0",
]

[project.optional-dependencies]
dev = ["pytest>=7.0.0", "black>=22.0.0"]
docs = ["sphinx>=5.0.0"]

[project.scripts]
my-cli = "my_project.cli:main"

[tool.uv]
dev-dependencies = ["pre-commit>=3.0.0"]

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

# ~/.config/uv/uv.toml (Unix) or %APPDATA%\uv\uv.toml (Windows)
[tool.uv]
python = "3.11"
cache-dir = "~/.cache/uv"
index-url = "https://pypi.org/simple"
concurrent-downloads = 10
timeout = 30

# ~/.config/uv/uv.toml (Unix) or %APPDATA%\uv\uv.toml (Windows)
[tool.uv]
python = "3.11"
cache-dir = "~/.cache/uv"
index-url = "https://pypi.org/simple"
concurrent-downloads = 10
timeout = 30

# 1. Create project
uv init my-project
cd my-project

# 2. Add dependencies
uv add requests click

# 3. Add dev dependencies
uv add --dev pytest black ruff

# 4. Create main script
echo 'print("Hello, uv!")' > src/my_project/main.py

# 5. Run the script
uv run python src/my_project/main.py

# 1. Create project
uv init my-project
cd my-project

# 2. Add dependencies
uv add requests click

# 3. Add dev dependencies
uv add --dev pytest black ruff

# 4. Create main script
echo 'print("Hello, uv!")' > src/my_project/main.py

# 5. Run the script
uv run python src/my_project/main.py

# 1. Clone repository
git clone https://github.com/user/project.git
cd project

# 2. Sync dependencies
uv sync

# 3. Run tests
uv run pytest

# 4. Add new dependency
uv add new-package

# 5. Update lock file
uv lock

# 1. Clone repository
git clone https://github.com/user/project.git
cd project

# 2. Sync dependencies
uv sync

# 3. Run tests
uv run pytest

# 4. Add new dependency
uv add new-package

# 5. Update lock file
uv lock

# Pre-warm cache for CI
uv cache warm

# Clean old cache entries
uv cache clean --older-than=30d

# Show cache statistics
uv cache info --stats

# Use custom cache location
UV_CACHE_DIR=/custom/path uv add package

# Pre-warm cache for CI
uv cache warm

# Clean old cache entries
uv cache clean --older-than=30d

# Show cache statistics
uv cache info --stats

# Use custom cache location
UV_CACHE_DIR=/custom/path uv add package

# pyproject.toml
[tool.uv]
concurrent-downloads = 50  # Increase for faster downloads
concurrent-builds = 8      # Adjust based on CPU cores

# pyproject.toml
[tool.uv]
concurrent-downloads = 50  # Increase for faster downloads
concurrent-builds = 8      # Adjust based on CPU cores

# Use lowest compatible versions
uv add --resolution lowest package

# Preview changes without installing
uv add --dry-run package

# Upgrade specific package
uv lock --upgrade-package requests

# Use lowest compatible versions
uv add --resolution lowest package

# Preview changes without installing
uv add --dry-run package

# Upgrade specific package
uv lock --upgrade-package requests

[tool.uv]
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

[[tool.uv.index]]
name = "private"
url = "https://pypi.company.com/simple"
default = true

[tool.uv]
[[tool.uv.index]]
name = "pytorch"
url = "https://download.pytorch.org/whl/cpu"
explicit = true

[[tool.uv.index]]
name = "private"
url = "https://pypi.company.com/simple"
default = true

# Development shortcuts
export UV_PROJECT_ENVIRONMENT=".venv"
export UV_PYTHON="3.11"
export UV_INDEX_URL="https://pypi.org/simple"

# CI/CD optimizations
export UV_NO_CACHE=1           # Disable cache
export UV_CACHE_DIR="/cache"   # Custom cache location
export UV_COMPILE_BYTECODE=0   # Skip bytecode compilation

# Development shortcuts
export UV_PROJECT_ENVIRONMENT=".venv"
export UV_PYTHON="3.11"
export UV_INDEX_URL="https://pypi.org/simple"

# CI/CD optimizations
export UV_NO_CACHE=1           # Disable cache
export UV_CACHE_DIR="/cache"   # Custom cache location
export UV_COMPILE_BYTECODE=0   # Skip bytecode compilation

#!/usr/bin/env uv run
# /// script
# requires-python = ">=3.8"
# dependencies = [
#     "httpx",
#     "rich",
# ]
# ///

import asyncio
import httpx
from rich.console import Console

console = Console()

async def fetch_data(url: str) -> None:
    async with httpx.AsyncClient() as client:
        response = await client.get(url)
        console.print(f"[green]{url}[/green]: {response.status_code}")

if __name__ == "__main__":
    asyncio.run(fetch_data("https://httpbin.org/json"))

#!/usr/bin/env uv run
# /// script
# requires-python = ">=3.8"
# dependencies = [
#     "httpx",
#     "rich",
# ]
# ///

import asyncio
import httpx
from rich.console import Console

console = Console()

async def fetch_data(url: str) -> None:
    async with httpx.AsyncClient() as client:
        response = await client.get(url)
        console.print(f"[green]{url}[/green]: {response.status_code}")

if __name__ == "__main__":
    asyncio.run(fetch_data("https://httpbin.org/json"))