ai-marketplace-monitor/MIGRATION_TO_UV.md

Migration from Poetry to uv

This project has been migrated from Poetry to uv for faster dependency management and better performance.

For Contributors

If you were previously contributing to this project using Poetry, here's how to migrate:

1. Remove Poetry artifacts

# Remove the old virtual environment (if using poetry's default location)
rm -rf .venv
# Remove poetry.lock (now replaced by uv.lock)
rm poetry.lock

2. Install uv

pip install uv

3. Set up the development environment

# Install all dependencies including development extras
uv sync --all-extras

# Install pre-commit hooks
uv run inv install-hooks

4. Common command translations

Poetry Command	uv Equivalent
poetry install	uv sync
poetry add package	uv add package
poetry add --group dev package	uv add --dev package
poetry run command	uv run command
poetry shell	source .venv/bin/activate (Linux/Mac) or .venv\Scripts\activate (Windows)
poetry build	uv build
poetry publish	uv publish

5. Running tasks

All invoke tasks now use uv instead of poetry:

# Run tests
uv run inv tests

# Format code
uv run inv format

# Run linting
uv run inv lint

# Type checking
uv run inv mypy

For End Users

If you were installing the package from source using Poetry, now use:

git clone https://github.com/BoPeng/ai-marketplace-monitor
cd ai-marketplace-monitor
uv sync

The published package on PyPI remains the same:

pip install ai-marketplace-monitor

Benefits of uv

• Faster: uv is significantly faster than Poetry for dependency resolution and installation
• Better caching: More efficient caching mechanism
• Simpler: Fewer configuration files and simpler setup
• Standard: Uses standard Python packaging (pyproject.toml) without Poetry-specific extensions