gi-ostree-1.0.18: OSTree bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.OSTree.Interfaces.RepoFinder

Description

No description available in the introspection data.

Synopsis

Exported types

newtype RepoFinder Source #

Memory-managed wrapper type.

Constructors

RepoFinder (ManagedPtr RepoFinder) 

Instances

Instances details
Eq RepoFinder Source # 
Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

GObject RepoFinder Source # 
Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

ManagedPtrNewtype RepoFinder Source # 
Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

Methods

toManagedPtr :: RepoFinder -> ManagedPtr RepoFinder

TypedObject RepoFinder Source # 
Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

Methods

glibType :: IO GType

HasParentTypes RepoFinder Source # 
Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

IsGValue (Maybe RepoFinder) Source #

Convert RepoFinder to and from GValue. See toGValue and fromGValue.

Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe RepoFinder -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe RepoFinder)

type ParentTypes RepoFinder Source # 
Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

type ParentTypes RepoFinder = '[Object]

class (GObject o, IsDescendantOf RepoFinder o) => IsRepoFinder o Source #

Type class for types which can be safely cast to RepoFinder, for instance with toRepoFinder.

Instances

Instances details
(GObject o, IsDescendantOf RepoFinder o) => IsRepoFinder o Source # 
Instance details

Defined in GI.OSTree.Interfaces.RepoFinder

toRepoFinder :: (MonadIO m, IsRepoFinder o) => o -> m RepoFinder Source #

Cast to RepoFinder, for types for which this is known to be safe. For general casts, use castTo.

Methods

resolveAllAsync

repoFinderResolveAllAsync Source #

Arguments

:: (HasCallStack, MonadIO m, IsRepo a, IsCancellable b) 
=> [RepoFinder]

finders: non-empty array of OstreeRepoFinders

-> [CollectionRef]

refs: non-empty array of collection–ref pairs to find remotes for

-> a

parentRepo: the local repository which the refs are being resolved for, which provides configuration information and GPG keys

-> Maybe b

cancellable: a Cancellable, or Nothing

-> Maybe AsyncReadyCallback

callback: asynchronous completion callback

-> m () 

A version of repoFinderResolveAsync which queries one or more finders in parallel and combines the results.

Since: 2018.6

resolveAllFinish

repoFinderResolveAllFinish Source #

Arguments

:: (HasCallStack, MonadIO m, IsAsyncResult a) 
=> a

result: AsyncResult from the callback

-> m [RepoFinderResult]

Returns: array of zero or more results (Can throw GError)

Get the results from a repoFinderResolveAllAsync operation.

Since: 2018.6

resolveAsync

repoFinderResolveAsync Source #

Arguments

:: (HasCallStack, MonadIO m, IsRepoFinder a, IsRepo b, IsCancellable c) 
=> a

self: an RepoFinder

-> [CollectionRef]

refs: non-empty array of collection–ref pairs to find remotes for

-> b

parentRepo: the local repository which the refs are being resolved for, which provides configuration information and GPG keys

-> Maybe c

cancellable: a Cancellable, or Nothing

-> Maybe AsyncReadyCallback

callback: asynchronous completion callback

-> m () 

Find reachable remote URIs which claim to provide any of the given refs. The specific method for finding the remotes depends on the 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 repoPullFromRemotesAsync 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 repoPullFromRemotesAsync to pull the given refs from those remotes.

Since: 2018.6

resolveFinish

repoFinderResolveFinish Source #

Arguments

:: (HasCallStack, MonadIO m, IsRepoFinder a, IsAsyncResult b) 
=> a

self: an RepoFinder

-> b

result: AsyncResult from the callback

-> m [RepoFinderResult]

Returns: array of zero or more results (Can throw GError)

Get the results from a repoFinderResolveAsync operation.

Since: 2018.6