Codec.RPM.Version

Functions and types for working with version numbers, as understood by RPM.

Types

data DepOrdering

Like Ordering, but with support for less-than-or-equal and greater-than-or-equal.

Constructors

LT

LTE

EQ

GTE

GT

Instances

Eq DepOrdering

Methods

(==) :: DepOrdering -> DepOrdering -> Bool

(/=) :: DepOrdering -> DepOrdering -> Bool

Show DepOrdering

Methods

showsPrec :: Int -> DepOrdering -> ShowS

show :: DepOrdering -> String

showList :: [DepOrdering] -> ShowS

data DepRequirement

RPM supports the concept of dependencies between packages. Collectively, these dependencies are commonly referred to as PRCO - Provides, Requires, Conflicts, and Obsoletes. These dependencies can optionally include version information. These relationships can be examined with various RPM inspection tools or can be found in the spec files that define how a package is built. Examples include:

Requires: python-six
Requires: python3-blivet >= 1:1.0
Obsoletes: booty <= 0.107-1

This data type expresses a single dependency relationship. The example dependencies above would be represented like so:

DepRequirement "python-six" Nothing
DepRequirement "python3-blivet" (Just (GTE, EVR (Just 1) "1.0" ""))
DepRequirement "booty" (Just (LTE, EVR Nothing "0.107" "1"))

It is not in the scope of this type to know what kind of relationship a DepRequirement describes.

Constructors

DepRequirement Text (Maybe (DepOrdering, EVR))

Instances

Eq DepRequirement

Methods

(==) :: DepRequirement -> DepRequirement -> Bool

(/=) :: DepRequirement -> DepRequirement -> Bool

Show DepRequirement

Methods

showsPrec :: Int -> DepRequirement -> ShowS

show :: DepRequirement -> String

showList :: [DepRequirement] -> ShowS

data EVR

The versioning information portion of a package's name - epoch, version, release.

Constructors

EVR

Fields

• epoch :: Maybe Word32

  The epoch of a package. This is sort of a super version number, used when a package with an earlier version number must upgrade a package with a later version number. The package with a larger epoch will always in version comparisons. Most packages do not have an epoch.

• version :: Text

  The version number provided by the package's upstream, represented as Text.

• release :: Text

  The release number, represented as Text. The release value is added on by a distribution and allows them to make multiple releases of the same upstream version, fixing bugs and applying distribution-specific tweaks.

Instances

Eq EVR

Methods

(==) :: EVR -> EVR -> Bool

(/=) :: EVR -> EVR -> Bool

Ord EVR

Methods

compare :: EVR -> EVR -> Ordering

(<) :: EVR -> EVR -> Bool

(<=) :: EVR -> EVR -> Bool

(>) :: EVR -> EVR -> Bool

(>=) :: EVR -> EVR -> Bool

max :: EVR -> EVR -> EVR

min :: EVR -> EVR -> EVR

Show EVR

Methods

showsPrec :: Int -> EVR -> ShowS

show :: EVR -> String

showList :: [EVR] -> ShowS

Functions

parseEVR :: Text -> Either ParseError EVR

Convert a Text representation into an EVR or a ParseError if something goes wrong.

parseDepRequirement :: Text -> Either ParseError DepRequirement

Convert a Text representation into a DepRequirement or a ParseError if something goes wrong.

satisfies

Arguments

:: DepRequirement

The package in question, represented as a DepRequirement.

-> DepRequirement

The requirement.

-> Bool

Determine if a candidate package satisfies the dependency relationship required by some other package.

vercmp :: Text -> Text -> Ordering

Compare two version numbers and return an Ordering.