Add --rename-dep option to rename dependencies in wheels

[ianhi]

Summary

Add the ability to rename dependencies when renaming a wheel, enabling installation of packages with conflicting dependency trees.

New Features

• --rename-dep CLI option: Rename dependencies in the wheel's METADATA and Python imports

  spare-tire rename pkg-1.0.0.whl pkg_v1 --rename-dep mydep=mydep_v1

• --python-version option for download: Specify target Python version when downloading wheels (useful with uvx)

  uvx spare-tire download zarr --python-version 3.12 -o ./wheels/

• Module attribute rewriting: Import rewriting now handles pkg.attr patterns (e.g., zarr.open() → zarr_v2.open())

• rename_wheel_from_bytes support: The bytes-based API now supports rename_deps for proxy server use

Use Case: Conflicting Dependencies

When two versions of a package require incompatible versions of the same dependency:

# Scenario: mypkg v1 needs zarr<3, mypkg v2 needs zarr>=3

# 1. Download and rename zarr v2
spare-tire download zarr --version ">=2,<3" --rename zarr_v2 -o ./wheels/

# 2. Rename mypkg v1, updating its dependency
spare-tire rename mypkg-1.0.0.whl mypkg_v1 --rename-dep zarr=zarr_v2 -o ./wheels/

# 3. Install both versions
pip install zarr  # v3
pip install ./wheels/zarr_v2-*.whl
pip install ./wheels/mypkg_v1-*.whl

Now both work in the same Python session:

import zarr           # v3.x
import zarr_v2        # v2.x
import mypkg          # uses zarr v3
import mypkg_v1       # uses zarr_v2

Testing

• 28 pytest tests pass (4 new tests for dependency renaming)
• Conflicting deps fixture (tests/fixtures/conflicting-deps/): Synthetic test with mypkg/mydep
• Zarr compatibility fixture (tests/fixtures/zarr-compat/): Real-world test downloading zarr v2 from PyPI, renaming to zarr_v2, and verifying both zarr v2 and v3 can read the same Zarr format 2 data

Run the zarr test:

uv run python tests/fixtures/zarr-compat/test_zarr_compat.py

Files Changed

• src/spare_tire/rename.py - Add rename_deps parameter to both rename functions, enhance import rewriting
• src/spare_tire/download.py - Add python_version parameter
• src/spare_tire/cli.py - Add --rename-dep and --python-version options
• tests/test_integration.py - Add TestDependencyRenaming class with 4 tests
• README.md - Document new features with examples
• AGENTS.md - Update function signatures
• tests/fixtures/conflicting-deps/ - Synthetic dependency conflict test
• tests/fixtures/zarr-compat/ - Real zarr v2/v3 compatibility test