dnf.comps
An object of this class can merge comps information from arbitrary repositories. It typically is instantiated from dnf.Base
and covers all the available repositories.
The *_by_pattern
methods all take a pattern and an optional case_sensitive parameter. The pattern is matched against names and IDs of objects in the domain (groups, categories, environments), the globbing characters in pattern retain their usual expanding meaning. If case_sensitive is True
, matching is done in a case-sensitive manner.
categories
List of all contained dnf.comps.Category
objects.
environments
List of all contained dnf.comps.Environment
objects ordered by display_order tag defined in comps.xml file.
groups
List of all contained dnf.comps.Group
objects ordered by display_order tag defined in comps.xml file.
category_by_pattern(pattern, case_sensitive=False)
Returns a dnf.comps.Category
object matching pattern, or None
.
categories_by_pattern(pattern, case_sensitive=False)
Return an iterable of dnf.comps.Category
objects matching pattern.
categories_iter
Return iterator over all contained dnf.comps.Category
objects.
environment_by_pattern(pattern, case_sensitive=False)
Return a dnf.comps.Environment
object matching pattern, or None
.
environments_by_pattern(pattern, case_sensitive=False)
Return an iterable of dnf.comps.Environment
objects matching pattern ordered by display_order tag defined in comps.xml file.
environments_iter
Return iterator over all contained dnf.comps.Environment
objects in order they appear in comps.xml file.
group_by_pattern(pattern, case_sensitive=False)
Return a dnf.comps.Group
object matching pattern, or None
.
groups_by_pattern(pattern, case_sensitive=False)
Return an iterable of dnf.comps.Group
objects matching pattern ordered by display_order tag defined in comps.xml file.
groups_iter
Return iterator over all contained dnf.comps.Group
objects in order they appear in comps.xml file.
Represents comps package data.
Note
Should not be confused with dnf.package.Package
which represents a package contained in a ~.Sack
. There is no guarantee whether the comps package has a corresponding real sack package, i.e. there can be no package of given name in the sack, one such package, or more than one. For this reason two separate types are introduced.
name
Name of the package.
option_type
The type of inclusion of this particular package in its group. Must be one of the inclusion types <dnf.comps.CONDITIONAL>
.
id
Unique identifier of the category.
name
Name of the category.
ui_name
The name of the category translated to the language given by the current locale.
ui_description
The description of the category translated to the language given by the current locale.
Has the same set of attributes as dnf.comps.Category
.
Has the same set of attributes as dnf.comps.Category
.
packages_iter()
Return iterator over all packages <.Package>
belonging in this group.
Following types of inclusions of objects in their parent objects are defined:
CONDITIONAL
DEFAULT
MANDATORY
OPTIONAL