Modulemd.ModuleIndexMerger¶

Methods¶

class	`new` ()
	`associate_index` (index, priority)
	`resolve` ()
	`resolve_ext` (strict_default_streams)

None

class Modulemd.ModuleIndexMerger(**kwargs)¶

classmethod new()¶

New in version 2.0.

associate_index(index, priority)¶

Parameters:

index (Modulemd.ModuleIndex) – A Modulemd.ModuleIndex, usually constructed by reading the module metadata from a repository with Modulemd.ModuleIndex.update_from_file(), Modulemd.ModuleIndex.update_from_string(), or modulemd_module_index_update_from_stream(). This function take a reference on index, so the caller must not modify it while the Modulemd.ModuleIndexMerger is in use.
priority (int) – The priority of the repository that the entries in index came from. This is used to determine when index should override rather then merge. In most cases, this will be zero. See the Description section for the Modulemd.ModuleIndexMerger class for details on the merge logic. Acceptable values are in the range of 0-1000.

Enqueues a Modulemd.ModuleIndex representing the parsed metadata from a repository into this Modulemd.ModuleIndexMerger for merging and deduplication of other repositories.

Once all repositories have been added, call Modulemd.ModuleIndexMerger.resolve() to perform the merge.

New in version 2.0.

resolve()¶

Raises:: GLib.Error
Returns:: A newly-allocated Modulemd.ModuleIndex object containing the merged results. If this function encounters an unresolvable merge conflict, it will return None and set error appropriately.
Return type:: Modulemd.ModuleIndex

Merges all added Modulemd.ModuleIndex objects according to their priority. The logic of this merge is described in the Description of Modulemd.ModuleIndexMerger.

Once this function has been called, the internal state of the Modulemd.ModuleIndexMerger is undefined. The only valid action on it after that point is GObject.Object.unref().

This function is equivalent to calling Modulemd.ModuleIndexMerger.resolve_ext() with strict_default_streams=FALSE.

New in version 2.0.

resolve_ext(strict_default_streams)¶

Parameters:: strict_default_streams (bool) – If True, merging two Modulemd.Defaults with conflicting default streams will raise an error. If False, the module will have its default stream blocked.
Raises:: GLib.Error
Returns:: A newly-allocated Modulemd.ModuleIndex object containing the merged results. If this function encounters an unresolvable merge conflict, it will return None and set error appropriately.
Return type:: Modulemd.ModuleIndex

Merges all added Modulemd.ModuleIndex objects according to their priority. The logic of this merge is described in the Description of Modulemd.ModuleIndexMerger.

Once this function has been called, the internal state of the Modulemd.ModuleIndexMerger is undefined. The only valid action on it after that point is GObject.Object.unref().

New in version 2.6.