Struct libflatpak::TransactionOperation

pub struct TransactionOperation { /* private fields */ }

GLib type: GObject with reference counted clone semantics.

Implementations

impl TransactionOperation

pub fn bundle_path(&self) -> Option<File>

Gets the path to the bundle.

Returns

the bundle gio::File or None

pub fn commit(&self) -> Option<GString>

Gets the commit ID for the operation.

This information is available when the transaction is resolved, i.e. when ready is emitted.

Returns

the commit ID

pub fn download_size(&self) -> u64

Gets the maximum download size for the operation.

Note that this does not include the size of dependencies, and the actual download may be smaller, if some of the data is already available locally.

For uninstall operations, this returns 0.

This information is available when the transaction is resolved, i.e. when ready is emitted.

Returns

the download size, in bytes

pub fn installed_size(&self) -> u64

Gets the installed size for the operation.

Note that even for a new install, the extra space required on disk may be smaller than this number, if some of the data is already available locally.

For uninstall operations, this returns 0.

This information is available when the transaction is resolved, i.e. when ready is emitted.

Returns

the installed size, in bytes

pub fn is_skipped(&self) -> bool

Gets whether this operation will be skipped when the transaction is run. Operations are skipped in some transaction situations, for example when an app has reached end of life and needs a rebase, or when it would have been updated but no update is available. By default, skipped operations are not returned by TransactionExt::operations() — but they can be accessed by traversing the operation graph using related_to_ops().

Returns

true if the operation has been marked as to skip, false otherwise

pub fn metadata(&self) -> Option<KeyFile>

Gets the metadata that will be applicable when the operation is done.

This can be compared to the current metadata returned by old_metadata() to find new required permissions and similar changes.

This information is available when the transaction is resolved, i.e. when ready is emitted.

Returns

the metadata glib::KeyFile

pub fn old_metadata(&self) -> Option<KeyFile>

Gets the metadata current metadata for the ref that self works on. Also see metadata().

This information is available when the transaction is resolved, i.e. when ready is emitted.

Returns

the old metadata glib::KeyFile

pub fn operation_type(&self) -> TransactionOperationType

Gets the type of the operation.

Returns

the type of operation, as TransactionOperationType

pub fn get_ref(&self) -> Option<GString>

pub fn related_to_ops(&self) -> Vec<TransactionOperation>

Gets the operation(s) which caused this operation to be added to the transaction. In the case of a runtime, it’s the app(s) whose runtime it is, and/or a runtime extension in the special case of an extra-data extension that doesn’t define the “NoRuntime” key. In the case of a related ref such as an extension, it’s the main app or runtime. In the case of a main app or something added to the transaction by e.g. TransactionExt::add_install() and which is not otherwise needed, None or an empty array will be returned.

Note that an op will be returned even if it’s marked as to be skipped when the transaction is run. Check that using is_skipped().

Elements in the returned array are only safe to access while the parent Transaction is alive.

Returns

the FlatpakTransactionOperations this one is related to (may be None or an empty array, which are equivalent)

pub fn remote(&self) -> Option<GString>

Gets the remote that the operation applies to.

Returns

the remote

pub fn requires_authentication(&self) -> bool

Gets whether the given operation will require authentication to acquire needed tokens. See also the documentation for ready-pre-auth.

Returns

whether self requires authentication

pub fn subpaths(&self) -> Vec<GString>

Gets the set of subpaths that will be pulled from this ref.

Some refs are only partially installed, such as translations. These are subset by the toplevel directory (typically by translation name). The subset to install can be specified at install time, but is otherwise decided based on configurations and things like the current locale and how the app was previously installed.

If there is no subsetting active, this will always return None (even though some other APIs also take an empty string to mean no subsetting).

This information is available when the transaction is resolved, i.e. when ready is emitted.

Returns

the set of subpaths that will be pulled, or None if no subsetting.

Trait Implementations

impl Clone for TransactionOperation

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TransactionOperation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for TransactionOperation

type ParamSpec = ParamSpecObject

type SetValue = TransactionOperation

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, TransactionOperation>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for TransactionOperation

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for TransactionOperation

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl ParentClassIs for TransactionOperation

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for TransactionOperation

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for TransactionOperation

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for TransactionOperation

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for TransactionOperation