Modularity Interface
- class dnf.module.module_base.ModuleBase
Basic class for handling modules.
- dnf.module.module_base.__init__(base)
Initialize
dnf.module.module_base.ModuleBase
object. base is an instance of thednf.Base
class.
- dnf.module.module_base.enable(module_specs)
Mark module streams matching the module_specs list and also all required modular dependencies for enabling. For specs that do not specify the stream, the default stream is used. In case that the module has only one stream available, this stream is used regardles of whether it is the default or not. Note that only one stream of any given module can be enabled on a system. The method raises
dnf.exceptions.MarkingErrors
in case of errors.Example:
#!/usr/bin/python3 import dnf base = dnf.Base() base.read_all_repos() base.fill_sack() module_base = dnf.module.module_base.ModuleBase(base) module_base.enable(['nodejs:11']) base.do_transaction()
- dnf.module.module_base.disable(module_specs)
Mark modules matching the module_specs list for disabling. Only the name part of the module specification is relevant. Stream, version, context, arch and profile parts are ignored (if given). All streams of the module will be disabled and all installed profiles will be removed. Packages previously installed from these modules will remain installed on the system. The method raises
dnf.exceptions.MarkingErrors
in case of errors.Example:
#!/usr/bin/python3 import dnf base = dnf.Base() base.read_all_repos() base.fill_sack() module_base = dnf.module.module_base.ModuleBase(base) module_base.disable(['nodejs']) base.do_transaction()
- dnf.module.module_base.reset(module_specs)
Mark module for resetting so that it will no longer be enabled or disabled. All installed profiles of streams that have been reset will be removed. The method raises
dnf.exceptions.MarkingErrors
in case of errors.
- dnf.module.module_base.install(module_specs, strict=True)
Mark module profiles matching module_specs for installation and enable all required streams. If the stream or profile part of specification is not specified, the defaults are chosen. All packages of installed profiles are also marked for installation. If strict is set to
False
, the installation skips modules with dependency solving problems. The method raisesdnf.exceptions.MarkingErrors
in case of errors.Example:
#!/usr/bin/python3 import dnf base = dnf.Base() base.read_all_repos() base.fill_sack() module_base = dnf.module.module_base.ModuleBase(base) module_base.install(['nodejs:11/minimal']) base.resolve() base.download_packages(base.transaction.install_set) base.do_transaction()
- dnf.module.module_base.remove(module_specs)
Mark module profiles matching module_spec for removal. All packages installed from removed profiles (unless they are required by other profiles or user-installed packages) are also marked for removal.
- dnf.module.module_base.upgrade(module_specs)
Mark packages of module streams (or profiles) matching module_spec for upgrade.
- dnf.module.module_base.get_modules(module_spec)
Get information about modules matching module_spec. Returns tuple (module_packages, nsvcap), where nsvcap is a hawkey.NSVCAP object parsed from module_spec and module_packages is a tuple of
libdnf.module.ModulePackage
objects matching this nsvcap.Example:
#!/usr/bin/python3 import dnf base = dnf.Base() base.read_all_repos() base.fill_sack() module_base = dnf.module.module_base.ModuleBase(base) module_packages, nsvcap = module_base.get_modules('nodejs:11/minimal') print("Parsed NSVCAP:") print("name:", nsvcap.name) print("stream:", nsvcap.stream) print("version:", nsvcap.version) print("context:", nsvcap.context) print("arch:", nsvcap.arch) print("profile:", nsvcap.profile) print("Matching modules:") for mpkg in module_packages: print(mpkg.getFullIdentifier())
- class libdnf.module.ModulePackage
This class represents a record identified by NSVCA from the repository modular metadata. See also https://github.com/fedora-modularity/libmodulemd/blob/main/spec.v2.yaml.
- dnf.module.module_base.getName()
Return the name of the module.
- dnf.module.module_base.getStream()
Return the stream of the module.
- dnf.module.module_base.getVersion()
Return the version of the module as a string.
- dnf.module.module_base.getVersionNum()
Return the version of the module as a number.
- dnf.module.module_base.getContext()
Return the context of the module.
- dnf.module.module_base.getArch()
Return the architecture of the module.
- dnf.module.module_base.getNameStream()
Return string in the form of ‘name:stream’ for the module.
- dnf.module.module_base.getNameStreamVersion()
Return string in the form of ‘name:stream:version’ for the module.
- dnf.module.module_base.getFullIdentifier()
Return string in the form of ‘name:stream:version:context:architecture’ for the module.
- dnf.module.module_base.getProfiles(name=None)
Return tuple of
libdnf.module.ModuleProfile
instancies representing each of the individual profiles of the module. If the name is given, only profiles matching the name pattern are returned.
- dnf.module.module_base.getSummary()
Return the summary of the module.
- dnf.module.module_base.getDescription()
Return the description of the module.
- dnf.module.module_base.getRepoID()
Return the identifier of source repository of the module.
- dnf.module.module_base.getArtifacts()
Return tuple of the artifacts of the module.
- dnf.module.module_base.getModuleDependencies()
Return tuple of
libdnf.module.ModuleDependencies
objects representing modular dependencies of the module.
- dnf.module.module_base.getYaml()
Return repomd yaml representing the module.
- class libdnf.module.ModuleProfile
- getName()
Return the name of the profile.
- getDescription()
Return the description of the profile.
- getContent()
Return tuple of package names to be installed with this profile.
- class libdnf.module.ModuleDependencies
- getRequires()
Return tuple of MapStringVectorString objects. These objects behave like standard python dictionaries and represent individual dependencies of the given module. Keys are names of required modules, values are tuples of required streams specifications.
- class libdnf.module.ModulePackageContainer
This class is under development and should be considered unstable at the moment.