11 releases (breaking)

0.10.0 Nov 26, 2024
0.9.0 Apr 23, 2024
0.8.1 Feb 15, 2024
0.1.0 Dec 8, 2023

#1810 in Development tools

Download history 52/week @ 2024-08-17 74/week @ 2024-08-24 187/week @ 2024-08-31 48/week @ 2024-09-07 47/week @ 2024-09-14 126/week @ 2024-09-21 122/week @ 2024-09-28 319/week @ 2024-10-05 118/week @ 2024-10-12 124/week @ 2024-10-19 185/week @ 2024-10-26 193/week @ 2024-11-02 334/week @ 2024-11-09 244/week @ 2024-11-16 305/week @ 2024-11-23 233/week @ 2024-11-30

1,139 downloads per month
Used in 2 crates

BSD-3-Clause

1.5MB
12K SLoC

Rust 10K SLoC // 0.1% comments Python 2.5K SLoC // 0.4% comments

Contains (DOS exe, 185KB) src/win/windows-launcher/t64-arm.exe, (DOS exe, 170KB) src/win/windows-launcher/w64-arm.exe, (DOS exe, 98KB) src/win/windows-launcher/t32.exe, (DOS exe, 110KB) src/win/windows-launcher/t64.exe, (DOS exe, 92KB) src/win/windows-launcher/w32.exe, (DOS exe, 105KB) src/win/windows-launcher/w64.exe

banner

RIP: Fast, barebones pip implementation in Rust

License Build Status Project Chat docs main

Introduction

rip is a library that allows the resolving and installing of Python PyPI 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 📦

rip is based on the quite excellent work of 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:

rip-install

This showcases the downloading and caching of metadata from PyPI. As well as the package resolution using our incremental SAT solver: 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:

  • Async downloading and aggressive caching of PyPI metadata.
  • Resolving of PyPI packages using Resolvo.
  • Installation of wheel files.
  • Support sdist files (must currently adhere to the PEP 517 and PEP 518 standards).
  • Caching of locally built wheels.

More intricacies of the PyPI ecosystem need to be implemented, see our GitHub issues for more details.

Details

Resolving

We have integrated the stand-alone packaging SAT solver 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 for more info.

For questions, requests or a casual chat, we are very active on our Discord server.

Dependencies

~29–63MB
~1M SLoC