uv-migrator
| Crates.io | uv-migrator |
| lib.rs | uv-migrator |
| version | |
| source | src |
| created_at | 2024-10-09 19:54:16.306774 |
| updated_at | 2024-12-10 05:59:46.975594 |
| description | Tool for converting various python package soltutions to use the uv solution by astral |
| homepage | |
| repository | https://github.com/stvnksslr/uv-migrator |
| max_upload_size | |
| id | 1403007 |
| Cargo.toml error: | TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
Steven Kessler (stvnksslr)
documentation
README
UV Migrator
UV Migrator is a Rust-based tool designed to facilitate the migration of Python projects from various dependency management systems (like pip or poetry) to the UV package manager. This tool automates the process of creating a new UV-based project structure while preserving existing dependencies.
Disclaimer
This project is not associated with astral or the uv project in anyway, please use at your own risk and keep backups of your dependency declarations for reference
Features
- Supports migration from Poetry and PEP 621 project structures
- Creates a new virtual environment using UV
- Automatically transfers dependencies from the existing
pyproject.tomlorrequirements.txtto the new UV-based project - Attempts to migrate all [tool.*] configs to the new
pyproject.tomlfile - By default, if using dependency groups in poetry or
requirements-some_group_name.txtwith req files they will be translated into uv dependency groups otherwise they will use the main and --dev conventions - Handles both main and development dependencies
- Provides detailed logging for transparency and debugging
- Supports importing extra index URLs from global pip configuration
- Allows specifying additional index URLs during migration
- By default, doesn't pin the python version via a .python-versions file in case the user uses asdf/mise and .tool-versions files
Prerequisites
Before you begin, ensure you have the following installed:
- Rust (latest stable version)
- UV package manager
Installation
Install to .local/bin
curl https://uv-migrator.stvnksslr.com/install.sh | bash
Install via Cargo
cargo install uv-migrator
The compiled binary will be available in the target/release directory.
Supported Package Managers
- poetry
- pip (requirements.txt)
In Progress
- pdm
- hatch
- pipenv
- Open Issues for more!
Usage
Run the UV Migrator with the path to your existing project directory:
uv-migrator path/to/your/project
or
1. cd /to/project
2. uv-migrator .
Additional Options
-
--import-global-pip-conf: Import extra index URLs from~/.pip/pip.confuv-migrator path/to/your/project --import-global-pip-conf -
--import-index: Specify additional index URLs to import (can be used multiple times)uv-migrator path/to/your/project --import-index https://custom.pypi.org/simple/ -
--help: Display comprehensive help informationuv-migrator --help -
--self-update: Update UV Migrator to the latest versionuv-migrator --self-update