GI.OSTree.Objects.MutableTree

Private instance structure.

Exported types

newtype MutableTree

Memory-managed wrapper type.

Constructors

MutableTree (ManagedPtr MutableTree)

Instances

GObject MutableTree

Defined in GI.OSTree.Objects.MutableTree

Methods

gobjectType :: IO GType

HasParentTypes MutableTree

Defined in GI.OSTree.Objects.MutableTree

type ParentTypes MutableTree

Defined in GI.OSTree.Objects.MutableTree

type ParentTypes MutableTree = Object ': ([] :: [Type])

class (GObject o, IsDescendantOf MutableTree o) => IsMutableTree o

Type class for types which can be safely cast to MutableTree, for instance with toMutableTree.

Instances

(GObject o, IsDescendantOf MutableTree o) => IsMutableTree o

Defined in GI.OSTree.Objects.MutableTree

toMutableTree :: (MonadIO m, IsMutableTree o) => o -> m MutableTree

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

noMutableTree :: Maybe MutableTree

A convenience alias for Nothing :: Maybe MutableTree.

Methods

checkError

mutableTreeCheckError

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a)

=> a

self: Tree

-> m ()

(Can throw GError)

In some cases, a tree may be in a "lazy" state that loads data in the background; if an error occurred during a non-throwing API call, it will have been cached. This function checks for a cached error. The tree remains in error state.

Since: 2018.7

ensureDir

mutableTreeEnsureDir

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a)

=> a

self: Tree

-> Text

name: Name of subdirectory of self to retrieve/creates

-> m MutableTree

(Can throw GError)

Returns the subdirectory of self with filename name, creating an empty one it if it doesn't exist.

ensureParentDirs

mutableTreeEnsureParentDirs

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a)

=> a

self: Tree

-> [Text]

splitPath: File path components

-> Text

metadataChecksum: SHA256 checksum for metadata

-> m MutableTree

(Can throw GError)

Create all parent trees necessary for the given splitPath to exist.

fillEmptyFromDirtree

mutableTreeFillEmptyFromDirtree

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a, IsRepo b)

=> a

-> b

-> Text

-> Text

-> m Bool

Returns: tRUE if merge was successful, fALSE if it was not possible.

This function enables optimisations when composing trees. The provided checksums are not loaded or checked when this function is called. Instead the contents will be loaded only when needed.

Merges self with the tree given by contentsChecksum and metadataChecksum, but only if it's possible without writing new objects to the repo. We can do this if either self is empty, the tree given by contentsChecksum is empty or if both trees already have the same contentsChecksum.

getContentsChecksum

mutableTreeGetContentsChecksum :: (HasCallStack, MonadIO m, IsMutableTree a) => a -> m Text

No description available in the introspection data.

getFiles

mutableTreeGetFiles

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a)

=> a

-> m (Map Text Text)

Returns: All children files (the value is a checksum)

No description available in the introspection data.

getMetadataChecksum

mutableTreeGetMetadataChecksum :: (HasCallStack, MonadIO m, IsMutableTree a) => a -> m Text

No description available in the introspection data.

lookup

mutableTreeLookup

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a, IsMutableTree b)

=> a

-> Text

-> Text

-> b

-> m ()

(Can throw GError)

No description available in the introspection data.

new

mutableTreeNew

Arguments

:: (HasCallStack, MonadIO m)

=> m MutableTree

Returns: A new tree

No description available in the introspection data.

newFromChecksum

mutableTreeNewFromChecksum

Arguments

:: (HasCallStack, MonadIO m, IsRepo a)

=> a

repo: The repo which contains the objects refered by the checksums.

-> Text

contentsChecksum: dirtree checksum

-> Text

metadataChecksum: dirmeta checksum

-> m MutableTree

Returns: A new tree

Creates a new OstreeMutableTree with the contents taken from the given repo and checksums. The data will be loaded from the repo lazily as needed.

remove

mutableTreeRemove

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a)

=> a

self: Tree

-> Text

name: Name of file or subdirectory to remove

-> Bool

allowNoent: If fALSE, an error will be thrown if name does not exist in the tree

-> m ()

(Can throw GError)

Remove the file or subdirectory named name from the mutable tree self.

replaceFile

mutableTreeReplaceFile

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a)

=> a

-> Text

-> Text

-> m ()

(Can throw GError)

No description available in the introspection data.

setContentsChecksum

mutableTreeSetContentsChecksum :: (HasCallStack, MonadIO m, IsMutableTree a) => a -> Text -> m ()

No description available in the introspection data.

setMetadataChecksum

mutableTreeSetMetadataChecksum :: (HasCallStack, MonadIO m, IsMutableTree a) => a -> Text -> m ()

No description available in the introspection data.

walk

mutableTreeWalk

Arguments

:: (HasCallStack, MonadIO m, IsMutableTree a)

=> a

self: Tree

-> [Text]

splitPath: Split pathname

-> Word32

start: Descend from this number of elements in splitPath

-> m MutableTree

(Can throw GError)

Traverse start number of elements starting from splitPath; the child will be returned in outSubdir.