4 releases (breaking)

0.4.0 Feb 8, 2024
0.3.0 Jan 30, 2024
0.2.0 Nov 3, 2023
0.1.0 Sep 25, 2023

#92 in Algorithms

Download history 94/week @ 2023-12-23 251/week @ 2023-12-30 301/week @ 2024-01-06 442/week @ 2024-01-13 180/week @ 2024-01-20 435/week @ 2024-01-27 438/week @ 2024-02-03 456/week @ 2024-02-10 583/week @ 2024-02-17 662/week @ 2024-02-24 659/week @ 2024-03-02 504/week @ 2024-03-09 1004/week @ 2024-03-16 1552/week @ 2024-03-23 2554/week @ 2024-03-30 1277/week @ 2024-04-06

6,425 downloads per month
Used in 5 crates (3 directly)

BSD-3-Clause

225KB
4K SLoC

banner

Resolvo: Fast package resolver written in Rust

License crates.io Build Status Project Chat Docs

Resolvo implements a fast package resolution algorithm based on CDCL SAT solving. If resolvo is unable to find a solution it outputs a human-readable error message:

The following packages are incompatible
├─ bluesky-widgets >=0, <100 can be installed with any of the following options:
  └─ bluesky-widgets 42 would require
│     └─ suitcase-utils >=0, <54, which can be installed with any of the following options:
        └─ suitcase-utils 53
└─ suitcase-utils >=54, <100 cannot be installed because there are no viable options:
   ─ suitcase-utils 54, which conflicts with the versions reported above.

Resolve provides a generic interface which allows integrating the solver with a variety of package managers. For instance resolvo is used in rattler and pixi to solve packages from the conda ecosystem.

Originally resolvo started out as a port/fork of libsolv but it has since then diverged substantially. However, the same CDCL algorithm based on MiniSats An Extensible SAT-solver is still used underneath. Major differences compared to libsolv are:

  • Resolvo does not come with built-in support for several packaging ecosystems but instead provides a generic interface to allow it to be used in different scenarios.
  • Resolvo has support for incremental/lazy solving. This allows users to quickly find solutions in ecosystems where retrieving package metadata is expensive.
  • Resolvo is considerably faster than libsolv in large complex cases.
  • Resolvo can easily be used in multithreaded environments.
  • Resolvo provides human-readable error messages out-of-the-box.
  • Resolvo optionally provides an async interface to allow concurrent metadata fetching.
  • However, Libsolv is more extensive and supports more complex queries.

Contributing 😍

We would love to have you contribute! See the CONTRIBUTION.md for more info. For questions, requests or a casual chat, we are very active on our discord server. You can join our discord server via this link.

Dependencies

~4–17MB
~211K SLoC