uvhow 0.3.0

Detect how uv was installed and get upgrade instructions

uvhow

Detect how uv was installed and get upgrade instructions.

Usage

Run with uvx (recommended):

uvx uvhow

Or install and run:

uv add uvhow
uvhow

Example Output

🔍 uv installation detected

✅ Found uv: uv 0.8.0 (0b2357294 2025-07-17)
📍 Location: /Users/user/.local/bin/uv

🎯 Installation method: Standalone installer
💡 To upgrade: uv self update

Supported Installation Methods

• Standalone installer (~/.local/bin/uv) -> uv self update
• Cargo (~/.cargo/bin/uv) -> cargo install --git https://github.com/astral-sh/uv uv --force
• Homebrew (/opt/homebrew/bin/uv) -> brew upgrade uv
• pipx (~/.local/share/pipx/venvs/uv/bin/uv) -> pipx upgrade uv
• pip (virtual environment) -> pip install --upgrade uv
• pip (system) -> sudo pip install --upgrade uv
• pip (user) -> pip install --upgrade --user uv

Programmatic Usage

from uvhow import detect_uv_installation

installation = detect_uv_installation()
if installation:
    print(f"Method: {installation.method}")
    print(f"Upgrade: {installation.upgrade_command}")

Development

Releasing New Versions

Use the included version bump script to release new versions:

# Preview what will happen
python bump_version.py patch --dry-run

# Bump patch version (0.1.2 -> 0.1.3) and deploy
python bump_version.py patch

# Bump minor version (0.1.2 -> 0.2.0) and deploy  
python bump_version.py minor

# Bump major version (0.1.2 -> 1.0.0) and deploy
python bump_version.py major

The script will:

1. Update the version in pyproject.toml
2. Commit the version change
3. Create a git tag (e.g., v0.1.3)
4. Push the tag to trigger GitHub Actions deployment to PyPI

Requirements:

• Clean git working directory (no uncommitted changes)
• Push access to the repository