OSTree.RepoFinder

g GObject.GInterface GObject.GInterface OSTree.RepoFinder OSTree.RepoFinder GObject.GInterface->OSTree.RepoFinder

Implementations:
 OSTree.RepoFinderAvahi, OSTree.RepoFinderConfig, OSTree.RepoFinderMount, OSTree.RepoFinderOverride

Methods

class resolve_all_async (finders, refs, parent_repo, cancellable, callback, *user_data)
class resolve_all_finish (result)
  resolve_async (refs, parent_repo, cancellable, callback, *user_data)
  resolve_finish (result)

Virtual Methods

  do_resolve_async (refs, parent_repo, cancellable, callback, *user_data)
  do_resolve_finish (result)

Properties

None

Signals

None

Fields

None

Class Details

class OSTree.RepoFinder
Bases:GObject.GInterface
Structure:OSTree.RepoFinderInterface
classmethod resolve_all_async(finders, refs, parent_repo, cancellable, callback, *user_data)
Parameters:

A version of OSTree.RepoFinder.resolve_async() which queries one or more finders in parallel and combines the results.

New in version 2018.6.

classmethod resolve_all_finish(result)
Parameters:result (Gio.AsyncResult) – Gio.AsyncResult from the callback
Raises:GLib.Error
Returns:array of zero or more results
Return type:[OSTree.RepoFinderResult]

Get the results from a OSTree.RepoFinder.resolve_all_async() operation.

New in version 2018.6.

resolve_async(refs, parent_repo, cancellable, callback, *user_data)
Parameters:

Find reachable remote URIs which claim to provide any of the given refs. The specific method for finding the remotes depends on the OSTree.RepoFinder implementation.

Any remote which is found and which claims to support any of the given refs will be returned in the results. It is possible that a remote claims to support a given ref, but turns out not to — it is not possible to verify this until OSTree.Repo.pull_from_remotes_async() is called.

The returned results will be sorted with the most useful first — this is typically the remote which claims to provide the most refs, at the lowest latency.

Each result contains a mapping of refs to the checksums of the commits which the result provides. If the result provides the latest commit for a ref across all of the results, the checksum will be set. Otherwise, if the result provides an outdated commit, or doesn’t provide a given ref at all, the checksum will not be set. Results which provide none of the requested refs may be listed with an empty refs map.

Pass the results to OSTree.Repo.pull_from_remotes_async() to pull the given refs from those remotes.

New in version 2018.6.

resolve_finish(result)
Parameters:result (Gio.AsyncResult) – Gio.AsyncResult from the callback
Raises:GLib.Error
Returns:array of zero or more results
Return type:[OSTree.RepoFinderResult]

Get the results from a OSTree.RepoFinder.resolve_async() operation.

New in version 2018.6.

do_resolve_async(refs, parent_repo, cancellable, callback, *user_data) virtual
Parameters:

Find reachable remote URIs which claim to provide any of the given refs. The specific method for finding the remotes depends on the OSTree.RepoFinder implementation.

Any remote which is found and which claims to support any of the given refs will be returned in the results. It is possible that a remote claims to support a given ref, but turns out not to — it is not possible to verify this until OSTree.Repo.pull_from_remotes_async() is called.

The returned results will be sorted with the most useful first — this is typically the remote which claims to provide the most refs, at the lowest latency.

Each result contains a mapping of refs to the checksums of the commits which the result provides. If the result provides the latest commit for a ref across all of the results, the checksum will be set. Otherwise, if the result provides an outdated commit, or doesn’t provide a given ref at all, the checksum will not be set. Results which provide none of the requested refs may be listed with an empty refs map.

Pass the results to OSTree.Repo.pull_from_remotes_async() to pull the given refs from those remotes.

New in version 2018.6.

do_resolve_finish(result) virtual
Parameters:result (Gio.AsyncResult) – Gio.AsyncResult from the callback
Returns:array of zero or more results
Return type:[OSTree.RepoFinderResult]

Get the results from a OSTree.RepoFinder.resolve_async() operation.

New in version 2018.6.