ResolveLib at the highest level provides a Resolver class that includes dependency resolution logic. You give it some things, and a little information on how it should interact with them, and it will spit out a resolution result.
Intended Usage
import resolvelib
# Things I want to resolve.
requirements = [...]
# Implement logic so the resolver understands the requirement format.
class MyProvider:
...
provider = MyProvider()
reporter = resolvelib.BaseReporter()
# Create the (reusable) resolver.
resolver = resolvelib.Resolver(provider, reporter)
# Kick off the resolution process, and get the final result.
result = resolver.resolve(requirements)
The provider interface is specified in resolvelib.providers. You don’t need to inherit anything, however, only need to implement the right methods.
Terminology
The intention of this section is to unify the terms we use when talking about this code base, and packaging in general, to avoid confusion. Class and variable names in the code base should try to stick to terms defined here.
Things passed into Resolver.resolve() and provided by the provider are all considered opaque. They don’t need to adhere to this set of terminologies. Nothing can go wrong as long as the provider implementers can keep their heads straight.
Package
A thing that can be installed. A Package can have one or more versions available for installation.
Version
A string, usually in a number form, describing a snapshot of a Package. This number should increase when a Package posts a new snapshot, i.e a higher number means a more up-to-date snapshot.
Specifier
A collection of one or more Versions. This could be a wildcard, indicating that any Version is acceptable.
Candidate
A combination of a Package and a Version, i.e. a “concrete requirement”. Python people sometimes call this a “locked” or “pinned” dependency. Both of “requirement” and “dependency”, however, SHOULD NOT be used when describing a Candidate, to avoid confusion.
Some resolver architectures refer this as a “specification”, but it is not used here to avoid confusion with a Specifier.
Requirement
An intention to acquire a needed package, i.e. an “abstract requirement”. A “dependency”, if not clarified otherwise, also refers to this concept.
A Requirement should specify two things: a Package, and a Specifier.
Contributing
Please see developer documentation.
Release files for resolvelib 1.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| resolvelib-1.2.1.tar.gz | 24.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| resolvelib-1.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 43.3 kB
Release files / resolvelib-1.2.1.tar.gz
| Download URL | resolvelib-1.2.1.tar.gz |
|---|---|
| Size | 24.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d08a2022f6e16ce405d60b68c390f054efcfd0477d4b9bd019cc941c28fad1c
|
|
BLAKE2b-256 checksum How to use checksums |
1d144669927e06631070edb968c78fdb6ce8992e27c9ab2cde4b3993e22ac7af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2025.
Transparency logRelease files / resolvelib-1.2.1-py3-none-any.whl
| Download URL | resolvelib-1.2.1-py3-none-any.whl |
|---|---|
| Size | 18.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb06b66c8da04172d9e72a21d7d06186d8919e32ae5ab5cdf5b9d920be805ac2
|
|
BLAKE2b-256 checksum How to use checksums |
e223c941a0d0353681ca138489983c4309e0f5095dfd902e1357004f2357ddf2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 11, 2025.
Transparency log
