Dep-Logic Python Library

0.5.2 · active · verified Thu Apr 09

Dep-Logic is a Python library that provides a robust API for working with package version specifiers and dependencies, supporting logical operations (AND, OR) on them. It is currently at version 0.5.2 and sees active development with several releases per year.

Warnings

breaking The primary import path for `Specifier` and `SpecifierSet` changed from `dep_logic.specifier` to `dep_logic` directly.
Fix: Update your imports from `from dep_logic.specifier import ...` to `from dep_logic import ...`
breaking The `Dependency` API was significantly reworked. The `DependencySpecifier` class was removed, and `Dependency` now takes a `name` and `specifier` directly upon initialization.
Fix: Refactor code using `DependencySpecifier` or old `Dependency` constructors to use the new `Dependency(name, specifier)` signature.
breaking The `specifier` attribute of `Dependency` objects became non-optional.
Fix: Ensure that when creating `Dependency` objects, you always provide a `specifier` argument.
gotcha Be aware of the difference between `&` (intersection/AND) and `|` (union/OR) for specifiers. Intersection requires a version to satisfy ALL combined conditions, while union requires it to satisfy ANY.
Fix: Carefully consider the logical operation needed for your dependency constraints. Test with edge cases to ensure the combined specifier behaves as expected.

Install

pip install dep-logic Install stable version

Imports

Specifier
```
from dep_logic import Specifier
```
Moved directly to the top-level 'dep_logic' package in v0.3.0.
SpecifierSet
```
from dep_logic import SpecifierSet
```
Moved directly to the top-level 'dep_logic' package in v0.3.0.
Dependency
```
from dep_logic import Dependency
```

Quickstart

This quickstart demonstrates how to create `Specifier` and `SpecifierSet` objects, perform logical AND/OR operations on them, check version containment, and define a `Dependency` object.

from dep_logic import Specifier, SpecifierSet, Dependency

# Define specifiers
spec1 = Specifier(">=1.0.0,<2.0.0")
spec2 = Specifier("~=1.5.0") # equivalent to >=1.5.0,==1.*,==1.5.*, <1.6.0 for a minor release

# Perform logical operations
combined_spec_and = spec1 & spec2 # Intersection
combined_spec_or = spec1 | spec2  # Union

print(f"Specifier 1: {spec1}")
print(f"Specifier 2: {spec2}")
print(f"Intersection (AND): {combined_spec_and}")
print(f"Union (OR): {combined_spec_or}")

# Check if a version satisfies a specifier
assert combined_spec_and.contains("1.5.2")
assert not combined_spec_and.contains("1.0.0")

# Define a dependency
my_dependency = Dependency("my_package", Specifier(">=1.0.0,<2.0.0"))
print(f"Dependency: {my_dependency}")

view raw JSON →