# RIP: Fast, barebones **pip** implementation in Rust ![License][license-badge] [![Build Status][build-badge]][build] [![Project Chat][chat-badge]][chat-url] [![docs main][docs-main-badge]][docs-main] # Introduction `rip` is a library that allows the resolving and installing of Python [PyPI](https://pypi.org/) packages from Rust into a virtual environment. It's based on our experience with building [rattler] and aims to provide the same experience but for PyPI instead of Conda. ## What should I use this for? Like [rattler], `rip` should be fast and easy to use. This library is not a package manager itself but provides the low-level plumbing to be used in one. To see an example of this take a look at our package manager: [pixi](https://github.com/prefix-dev/pixi) 📦 `rip` is based on the quite excellent work of [posy](https://github.com/njsmith/posy) and we have tried to credit the authors where possible. # Showcase `rip` has a very incomplete pip-like binary that can be used to test package installs. Let's resolve and install the `flask` python package. Running `cargo run install flask /tmp/flask` we get something like this:  This showcases the downloading and caching of metadata from PyPI. As well as the package resolution using our incremental SAT solver: [Resolvo](https://github.com/mamba-org/resolvo), more on this below. Finally, after resolution it installs the package into a venv. We cache everything locally so that we can reuse the PyPI metadata. ## Features This is a list of current features of `rip`, the biggest are listed below: - [x] Async downloading and aggressive caching of PyPI metadata. - [x] Resolving of PyPI packages using [Resolvo](https://github.com/mamba-org/resolvo). - [x] Installation of wheel files. - [x] Support sdist files (must currently adhere to the `PEP 517` and `PEP 518` standards). - [x] Caching of locally built wheels. More intricacies of the PyPI ecosystem need to be implemented, see our [GitHub issues](https://github.com/prefix-dev/rip/issues) for more details. # Details ## Resolving We have integrated the stand-alone packaging SAT solver [Resolvo](https://github.com/mamba-org/resolvo), to resolve PyPI packages. This solver is incremental and adds packaging metadata during resolution of the SAT problem. This feature can be enabled with the `resolvo` feature flag. ## Installation We have very simple installation support for the resolved packages. This should be used for testing purposes exclusively e.g. `cargo run -- install flask /tmp/flask_env` to create a venv and install the flask and it's into it. After which you can run: 1. `/tmp/flask_env/bin/python` to start python in the venv. 2. `import flask #`, this should import the flask package from the venv. There is no detection of existing packages in the venv yet, although this should be relatively straightforward. # Contributing 😍 We would love to have you contribute! See the [CONTRIBUTING.md](./CONTRIBUTING.md) for more info. For questions, requests or a casual chat, we are very active on our [Discord server][chat-url]. [//]: # "[![crates.io][crates-badge]][crates]" [license-badge]: https://img.shields.io/badge/license-BSD--3--Clause-blue?style=flat-square [build-badge]: https://img.shields.io/github/actions/workflow/status/prefix-dev/rip/rust-compile.yml?style=flat-square&branch=main [build]: https://github.com/prefix-dev/rip/actions [chat-badge]: https://img.shields.io/discord/1082332781146800168.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2&style=flat-square [chat-url]: https://discord.gg/kKV8ZxyzY4 [docs-main-badge]: https://img.shields.io/badge/docs-main-yellow.svg?style=flat-square [docs-main]: https://prefix-dev.github.io/rip [crates]: https://crates.io/crates/rattler_installs_packages [crates-badge]: https://img.shields.io/crates/v/rattler_installs_packages.svg [rattler]: https://github.com/mamba-org/rattler