Struct libflatpak::Installation

impl Installation

pub const NONE: Option<&'static Installation> = None

pub fn for_path( path: &impl IsA<File>, user: bool, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Installation, Error>

Creates a new Installation for the installation at the given path.

§`path`

a gio::File

§`user`

whether this is a user-specific location

§`cancellable`

§Returns

pub fn new_system( cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Installation, Error>

Creates a new Installation for the default system-wide installation.

§`cancellable`

§Returns

pub fn new_system_with_id( id: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Installation, Error>

Creates a new Installation for the system-wide installation id.

§`id`

the ID of the system-wide installation

§`cancellable`

§Returns

pub fn new_user( cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Installation, Error>

Creates a new Installation for the per-user installation.

§`cancellable`

§Returns

Trait Implementations§

impl Clone for Installation

fn clone(&self) -> Self

Returns a copy of the value. Read more

1.0.0 · source§

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

Performs copy-assignment from source. Read more

impl Debug for Installation

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

Formats the value using the given formatter. Read more

impl HasParamSpec for Installation

type ParamSpec = ParamSpecObject

type SetValue = Installation

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

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

Feeds this value into the given Hasher. Read more

1.3.0 · source§

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

Feeds a slice of this type into the given Hasher. Read more

impl Ord for Installation

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

This method returns an Ordering between self and other. Read more

1.21.0 · source§

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

Compares and returns the maximum of two values. Read more

1.21.0 · source§

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

Compares and returns the minimum of two values. Read more

1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

Restrict a value to a certain interval. Read more

impl ParentClassIs for Installation

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

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

This method tests for self and other values to be equal, and is used by ==.

1.0.0 · source§

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

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

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

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

This method returns an ordering between self and other values if one exists. Read more

1.0.0 · source§

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

This method tests less than (for self and other) and is used by the < operator. Read more

1.0.0 · source§

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

1.0.0 · source§

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

This method tests greater than (for self and other) and is used by the > operator. Read more

1.0.0 · source§

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl StaticType for Installation

fn static_type() -> Type

Returns the type identifier of Self.

Auto Trait Implementations§

impl RefUnwindSafe for Installation

impl UnwindSafe for Installation

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> Cast for T
where T: ObjectType,

fn upcast<T>(self) -> T
where T: ObjectType, Self: IsA<T>,

Upcasts an object to a superclass or interface T. Read more

fn upcast_ref<T>(&self) -> &T
where T: ObjectType, Self: IsA<T>,

Upcasts an object to a reference of its superclass or interface T. Read more

fn downcast<T>(self) -> Result<T, Self>
where T: ObjectType, Self: MayDowncastTo<T>,

Tries to downcast to a subclass or interface implementor T. Read more

fn downcast_ref<T>(&self) -> Option<&T>
where T: ObjectType, Self: MayDowncastTo<T>,

Tries to downcast to a reference of its subclass or interface implementor T. Read more

fn dynamic_cast<T>(self) -> Result<T, Self>
where T: ObjectType,

Tries to cast to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while upcast will do many checks at compile-time already. downcast will perform the same checks at runtime as dynamic_cast, but will also ensure some amount of compile-time safety. Read more

fn dynamic_cast_ref<T>(&self) -> Option<&T>
where T: ObjectType,

Tries to cast to reference to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

unsafe fn unsafe_cast<T>(self) -> T
where T: ObjectType,

Casts to T unconditionally. Read more

unsafe fn unsafe_cast_ref<T>(&self) -> &T
where T: ObjectType,

Casts to &T unconditionally. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_num_as_vec(ptr: *const GList, num: usize) -> Vec<T>

unsafe fn from_glib_container_num_as_vec(_: *const GList, _: usize) -> Vec<T>

unsafe fn from_glib_full_num_as_vec(_: *const GList, _: usize) -> Vec<T>

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GPtrArray> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_num_as_vec(ptr: *const GPtrArray, num: usize) -> Vec<T>

unsafe fn from_glib_container_num_as_vec( _: *const GPtrArray, _: usize ) -> Vec<T>

unsafe fn from_glib_full_num_as_vec(_: *const GPtrArray, _: usize) -> Vec<T>

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GSList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_num_as_vec(ptr: *const GSList, num: usize) -> Vec<T>

unsafe fn from_glib_container_num_as_vec(_: *const GSList, _: usize) -> Vec<T>

unsafe fn from_glib_full_num_as_vec(_: *const GSList, _: usize) -> Vec<T>

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *mut GList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_num_as_vec(ptr: *mut GList, num: usize) -> Vec<T>

unsafe fn from_glib_container_num_as_vec(ptr: *mut GList, num: usize) -> Vec<T>

unsafe fn from_glib_full_num_as_vec(ptr: *mut GList, num: usize) -> Vec<T>

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *mut GPtrArray> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_num_as_vec(ptr: *mut GPtrArray, num: usize) -> Vec<T>

unsafe fn from_glib_container_num_as_vec( ptr: *mut GPtrArray, num: usize ) -> Vec<T>

unsafe fn from_glib_full_num_as_vec(ptr: *mut GPtrArray, num: usize) -> Vec<T>

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *mut GSList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_num_as_vec(ptr: *mut GSList, num: usize) -> Vec<T>

unsafe fn from_glib_container_num_as_vec(ptr: *mut GSList, num: usize) -> Vec<T>

unsafe fn from_glib_full_num_as_vec(ptr: *mut GSList, num: usize) -> Vec<T>

impl<T> FromGlibPtrArrayContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_as_vec(ptr: *const GList) -> Vec<T>

unsafe fn from_glib_container_as_vec(_: *const GList) -> Vec<T>

unsafe fn from_glib_full_as_vec(_: *const GList) -> Vec<T>

impl<T> FromGlibPtrArrayContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GPtrArray> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_as_vec(ptr: *const GPtrArray) -> Vec<T>

unsafe fn from_glib_container_as_vec(_: *const GPtrArray) -> Vec<T>

unsafe fn from_glib_full_as_vec(_: *const GPtrArray) -> Vec<T>

impl<T> FromGlibPtrArrayContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GSList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_as_vec(ptr: *const GSList) -> Vec<T>

unsafe fn from_glib_container_as_vec(_: *const GSList) -> Vec<T>

unsafe fn from_glib_full_as_vec(_: *const GSList) -> Vec<T>

impl<T> FromGlibPtrArrayContainerAsVec<<T as GlibPtrDefault>::GlibType, *mut GList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_as_vec(ptr: *mut GList) -> Vec<T>

unsafe fn from_glib_container_as_vec(ptr: *mut GList) -> Vec<T>

unsafe fn from_glib_full_as_vec(ptr: *mut GList) -> Vec<T>

impl<T> FromGlibPtrArrayContainerAsVec<<T as GlibPtrDefault>::GlibType, *mut GPtrArray> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_as_vec(ptr: *mut GPtrArray) -> Vec<T>

unsafe fn from_glib_container_as_vec(ptr: *mut GPtrArray) -> Vec<T>

unsafe fn from_glib_full_as_vec(ptr: *mut GPtrArray) -> Vec<T>

impl<T> FromGlibPtrArrayContainerAsVec<<T as GlibPtrDefault>::GlibType, *mut GSList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

unsafe fn from_glib_none_as_vec(ptr: *mut GSList) -> Vec<T>

unsafe fn from_glib_container_as_vec(ptr: *mut GSList) -> Vec<T>

unsafe fn from_glib_full_as_vec(ptr: *mut GSList) -> Vec<T>

impl<O> InstallationExt for O
where O: IsA<Installation>,

fn add_remote( &self, remote: &impl IsA<Remote>, if_needed: bool, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Adds a new remote object to the set of remotes. This is similar to modify_remote() for non-existing remote names. However, if the named remote already exists then instead of modifying it it fails with Error::AlreadyInstalled, or if if_needed is true it silently succeeds without doing anything. Read more

fn cleanup_local_refs_sync( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Remove all OSTree refs from the local flatpak repository which are not in a deployed state. The next time the underlying OSTree repo is pruned, objects which were attached to that ref will be removed. This is useful if you pulled a flatpak refs using InstallationExtManual::install_full() and specified InstallFlags::NO_DEPLOY but then decided not to deploy the refs later on and want to remove the local refs to prevent them from taking up disk space. Note that this will not remove the objects referred to by ref_ from the underlying OSTree repo, you should use prune_local_repo() to do that. Read more

fn create_monitor( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<FileMonitor, Error>

Gets monitor object for the installation. The returned file monitor will emit the changed signal whenever an application or runtime was installed, uninstalled or updated. Read more

fn drop_caches( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Drops all internal (in-memory) caches. For instance, this may be needed to pick up new or changed remotes configured outside this installation instance. Read more

fn fetch_remote_metadata_sync( &self, remote_name: &str, ref_: &impl IsA<Ref>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Bytes, Error>

Obtains the metadata file from a commit. Read more

fn fetch_remote_ref_sync( &self, remote_name: &str, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<RemoteRef, Error>

Gets the current remote branch of a ref in the remote. Read more

fn fetch_remote_ref_sync_full( &self, remote_name: &str, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, flags: QueryFlags, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<RemoteRef, Error>

Gets the current remote branch of a ref in the remote. Read more

fn fetch_remote_size_sync( &self, remote_name: &str, ref_: &impl IsA<Ref>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(u64, u64), Error>

Gets information about the maximum amount of data that needs to be transferred to pull the ref from a remote repository, and about the amount of local disk space that is required to check out this commit. Read more

fn config( &self, key: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<GString, Error>

Get a global configuration option for the installation, see set_config_sync() for supported keys. Read more

fn current_installed_app( &self, name: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<InstalledRef, Error>

Get the last build of reference name that was installed with InstallationExtManual::install(), or None if the reference has never been installed locally. Read more

fn default_languages(&self) -> Result<Vec<GString>, Error>

Get the default languages used by the installation to decide which subpaths to install of locale extensions. This list may also be used by frontends like GNOME Software to decide which language-specific apps to display. An empty array means that all languages should be installed. Read more

fn default_locales(&self) -> Result<Vec<GString>, Error>

Like default_languages() but includes territory information (e.g. en_US rather than en) which may be included in the extra-languages configuration. Read more

fn display_name(&self) -> Option<GString>

Returns the display name of the installation for self. Read more

fn id(&self) -> Option<GString>

Returns the ID of the installation for self. Read more

fn installed_ref( &self, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<InstalledRef, Error>

fn is_user(&self) -> bool

Returns whether the installation is for a user-specific location. Read more

fn min_free_space_bytes(&self) -> Result<u64, Error>

Returns the min-free-space config value from the OSTree repository of this installation. Read more

fn is_no_interaction(&self) -> bool

Returns the value set with set_no_interaction(). Read more

fn path(&self) -> Option<File>

Returns the installation location for self. Read more

fn priority(&self) -> i32

Returns the numeric priority of the installation for self. Read more

fn remote_by_name( &self, name: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Remote, Error>

Looks up a remote by name. Read more

fn storage_type(&self) -> StorageType

Returns the type of storage of the installation for self. Read more

fn install_ref_file( &self, ref_file_data: &Bytes, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<RemoteRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_install_flatpakref() instead. It has a lot more interesting features. Read more

fn launch( &self, name: &str, arch: Option<&str>, branch: Option<&str>, commit: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Launch an installed application. Read more

fn list_installed_refs( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<InstalledRef>, Error>

Lists the installed references. Read more

fn list_installed_refs_by_kind( &self, kind: RefKind, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<InstalledRef>, Error>

Lists the installed references of a specific kind. Read more

fn list_installed_refs_for_update( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<InstalledRef>, Error>

Lists the installed apps and runtimes that have an update available, either from the configured remote or locally available but not deployed (see TransactionExt::set_no_deploy()). Read more

fn list_installed_related_refs_sync( &self, remote_name: &str, ref_: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<RelatedRef>, Error>

Lists all the locally installed refs that are related to ref_. These are things that are interesting to install, update, or uninstall together with ref_. For instance, locale data or debug information. Read more

fn list_pinned_refs( &self, arch: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<InstalledRef>, Error>

Lists the installed references that are pinned, meaning they will not be returned by list_unused_refs() and won’t be removed unless explicitly specified for removal. Read more

fn list_remote_refs_sync( &self, remote_or_uri: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<RemoteRef>, Error>

Lists all the applications and runtimes in a remote. Read more

fn list_remote_refs_sync_full( &self, remote_or_uri: &str, flags: QueryFlags, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<RemoteRef>, Error>

Lists all the applications and runtimes in a remote. Read more

fn list_remote_related_refs_for_installed_sync( &self, remote_name: &str, ref_: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<RelatedRef>, Error>

Lists all the available refs on remote_name that are related to ref_, and which are appropriate for the installed version of ref_. For example if the installed version of org.videolan.VLC has a related ref of org.videolan.VLC.Plugin.bdj//3-19.08 and the remote version of VLC has a related ref of org.videolan.VLC.Plugin.bdj//3-20.08, this function will only return the 3-19.08 branch. Read more

fn list_remote_related_refs_sync( &self, remote_name: &str, ref_: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<RelatedRef>, Error>

Lists all the available refs on remote_name that are related to ref_, and the subpaths to use. These are things that are interesting to install, update, or uninstall together with ref_. For instance, locale data or debug information. Read more

fn list_remotes( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<Remote>, Error>

Lists the static remotes, in priority (highest first) order. For same priority, an earlier added remote comes before a later added one. Read more

fn list_unused_refs( &self, arch: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Vec<InstalledRef>, Error>

Lists the installed references that are not ‘used’. Read more

fn load_app_overrides( &self, app_id: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<GString, Error>

Loads the metadata overrides file for an application. Read more

fn modify_remote( &self, remote: &impl IsA<Remote>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Saves changes in the remote object. Read more

fn prune_local_repo( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Remove all orphaned OSTree objects from the underlying OSTree repo in self. Read more

fn remove_local_ref_sync( &self, remote_name: &str, ref_: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Remove the OSTree ref given by remote_name:ref_ from the local flatpak repository. The next time the underlying OSTree repo is pruned, objects which were attached to that ref will be removed. This is useful if you pulled a flatpak ref using InstallationExtManual::install_full() and specified InstallFlags::NO_DEPLOY but then decided not to deploy the ref later on and want to remove the local ref to prevent it from taking up disk space. Note that this will not remove the objects referred to by ref_ from the underlying OSTree repo, you should use prune_local_repo() to do that. Read more

fn remove_remote( &self, name: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Removes the remote with the given name from the installation. Read more

fn run_triggers( &self, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Run the trigger commands to update the files exported by the apps in self. Should be used after one or more app install, upgrade or uninstall operations with the InstallFlags::NO_TRIGGERS, UpdateFlags::NO_TRIGGERS or UninstallFlags::NO_TRIGGERS flags set. Read more

fn set_config_sync( &self, key: &str, value: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Set a global configuration option for the installation, currently the only supported keys are languages, which is a semicolon-separated list of language codes like "sv;en;pl", or "" to mean all languages, and extra-languages, which is a semicolon-separated list of locale identifiers like "en;en_DK;zh_HK.big5hkscs;uz_UZ.utf8cyrillic". Read more

fn set_no_interaction(&self, no_interaction: bool)

This method can be used to prevent interactive authorization dialogs to appear for operations on self. This is useful for background operations that are not directly triggered by a user action. Read more

fn update_remote_sync( &self, name: &str, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Updates the local configuration of a remote repository by fetching the related information from the summary file in the remote OSTree repository and committing the changes to the local installation. Read more

impl<O> InstallationExtManual for O
where O: IsA<Installation>,

fn update_appstream_sync( &self, remote_name: &str, arch: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Updates the local copy of appstream for remote_name for the specified arch. If you need progress feedback, use update_appstream_full_sync(). Read more

fn update_appstream_full_sync( &self, remote_name: &str, arch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

Updates the local copy of appstream for remote_name for the specified arch. Read more

fn update_full( &self, flags: UpdateFlags, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, subpaths: &[&str], progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_update() instead. It has a lot more interesting features. Read more

fn uninstall( &self, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_uninstall() instead. It has a lot more interesting features. Read more

fn uninstall_full( &self, flags: UninstallFlags, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<(), Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_uninstall() instead. It has a lot more interesting features. Read more

fn update( &self, flags: UpdateFlags, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_update() instead. It has a lot more interesting features. Read more

fn install( &self, remote_name: &str, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_install() instead. It has a lot more interesting features. Read more

fn install_bundle( &self, file: &impl IsA<File>, progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_install_bundle() instead. It has a lot more interesting features. Read more

fn install_full( &self, flags: InstallFlags, remote_name: &str, kind: RefKind, name: &str, arch: Option<&str>, branch: Option<&str>, subpaths: &[&str], progress: Option<&mut dyn FnMut(&str, u32, bool)>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<InstalledRef, Error>

👎Deprecated: Since 1.7

This is an old deprecated function, you should use Transaction and TransactionExt::add_install() instead. It has a lot more interesting features. Read more

fn launch_full( &self, flags: LaunchFlags, name: &str, arch: Option<&str>, branch: Option<&str>, commit: Option<&str>, cancellable: Option<&impl IsA<Cancellable>> ) -> Result<Instance, Error>

Launch an installed application. Read more

impl<T, U> Into for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoClosureReturnValue for T
where T: Into<Value>,

fn into_closure_return_value(self) -> Option<Value>

impl IsSubclassableExt for U
where U: IsClass + ParentClassIs,

fn parent_class_init<T>(class: &mut Class)
where T: ObjectSubclass, ::Parent: IsSubclassable<T>,

fn parent_instance_init<T>(instance: &mut InitializingObject<T>)
where T: ObjectSubclass, ::Parent: IsSubclassable<T>,

impl<T> ObjectExt for T
where T: ObjectType,

fn is(&self) -> bool
where U: StaticType,

Returns true if the object is an instance of (can be cast to) T.

fn type_(&self) -> Type

Returns the type of the object.

fn object_class(&self) -> &Class<Object>

Returns the ObjectClass of the object. Read more

fn class(&self) -> &Class<T>
where T: IsClass,

Returns the class of the object.

fn class_of(&self) -> Option<&Class>
where U: IsClass,

Returns the class of the object in the given type T. Read more

fn interface(&self) -> Option<InterfaceRef<'_, U>>
where U: IsInterface,

Returns the interface T of the object. Read more

fn set_property(&self, property_name: &str, value: impl Into<Value>)

Sets the property property_name of the object to value value. Read more

fn set_property_from_value(&self, property_name: &str, value: &Value)

Sets the property property_name of the object to value value. Read more

fn set_properties(&self, property_values: &[(&str, &dyn ToValue)])

Sets multiple properties of the object at once. Read more

fn set_properties_from_value(&self, property_values: &[(&str, Value)])

Sets multiple properties of the object at once. Read more

fn property<V>(&self, property_name: &str) -> V
where V: for<'b> FromValue<'b> + 'static,

Gets the property property_name of the object and cast it to the type V. Read more

fn property_value(&self, property_name: &str) -> Value

Gets the property property_name of the object. Read more

fn has_property(&self, property_name: &str, type_: Option<Type>) -> bool

Check if the object has a property property_name of the given type_. Read more

fn property_type(&self, property_name: &str) -> Option<Type>

Get the type of the property property_name of this object. Read more

fn find_property(&self, property_name: &str) -> Option<ParamSpec>

Get the ParamSpec of the property property_name of this object.

fn list_properties(&self) -> PtrSlice<ParamSpec>

Return all ParamSpec of the properties of this object.

fn freeze_notify(&self) -> PropertyNotificationFreezeGuard

Freeze all property notifications until the return guard object is dropped. Read more

unsafe fn set_qdata<QD>(&self, key: Quark, value: QD)
where QD: 'static,

Set arbitrary data on this object with the given key. Read more

unsafe fn qdata<QD>(&self, key: Quark) -> Option<NonNull<QD>>
where QD: 'static,

Return previously set arbitrary data of this object with the given key. Read more

unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD>
where QD: 'static,

Retrieve previously set arbitrary data of this object with the given key. Read more

unsafe fn set_data<QD>(&self, key: &str, value: QD)
where QD: 'static,

Set arbitrary data on this object with the given key. Read more

unsafe fn data<QD>(&self, key: &str) -> Option<NonNull<QD>>
where QD: 'static,

Return previously set arbitrary data of this object with the given key. Read more

unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD>
where QD: 'static,

Retrieve previously set arbitrary data of this object with the given key. Read more

fn block_signal(&self, handler_id: &SignalHandlerId)

Block a given signal handler. Read more

fn unblock_signal(&self, handler_id: &SignalHandlerId)

Unblock a given signal handler.

fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)

Stop emission of the currently emitted signal.

fn stop_signal_emission_by_name(&self, signal_name: &str)

Stop emission of the currently emitted signal by the (possibly detailed) signal name.

fn connect<F>( &self, signal_name: &str, after: bool, callback: F ) -> SignalHandlerId
where F: Fn(&[Value]) -> Option<Value> + Send + Sync + 'static,

Connect to the signal signal_name on this object. Read more

fn connect_id<F>( &self, signal_id: SignalId, details: Option<Quark>, after: bool, callback: F ) -> SignalHandlerId
where F: Fn(&[Value]) -> Option<Value> + Send + Sync + 'static,

Connect to the signal signal_id on this object. Read more

fn connect_local<F>( &self, signal_name: &str, after: bool, callback: F ) -> SignalHandlerId
where F: Fn(&[Value]) -> Option<Value> + 'static,

Connect to the signal signal_name on this object. Read more

fn connect_local_id<F>( &self, signal_id: SignalId, details: Option<Quark>, after: bool, callback: F ) -> SignalHandlerId
where F: Fn(&[Value]) -> Option<Value> + 'static,

Connect to the signal signal_id on this object. Read more

unsafe fn connect_unsafe<F>( &self, signal_name: &str, after: bool, callback: F ) -> SignalHandlerId
where F: Fn(&[Value]) -> Option<Value>,

Connect to the signal signal_name on this object. Read more

unsafe fn connect_unsafe_id<F>( &self, signal_id: SignalId, details: Option<Quark>, after: bool, callback: F ) -> SignalHandlerId
where F: Fn(&[Value]) -> Option<Value>,

Connect to the signal signal_id on this object. Read more

fn connect_closure( &self, signal_name: &str, after: bool, closure: RustClosure ) -> SignalHandlerId

Connect a closure to the signal signal_name on this object. Read more

fn connect_closure_id( &self, signal_id: SignalId, details: Option<Quark>, after: bool, closure: RustClosure ) -> SignalHandlerId

Connect a closure to the signal signal_id on this object. Read more

fn watch_closure(&self, closure: &impl AsRef<Closure>)

Limits the lifetime of closure to the lifetime of the object. When the object’s reference count drops to zero, the closure will be invalidated. An invalidated closure will ignore any calls to invoke_with_values, or invoke when using Rust closures.

fn emit<R>(&self, signal_id: SignalId, args: &[&dyn ToValue]) -> R
where R: TryFromClosureReturnValue,

Emit signal by signal id. Read more

fn emit_with_values(&self, signal_id: SignalId, args: &[Value]) -> Option<Value>

Same as Self::emit but takes Value for the arguments.

fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue]) -> R
where R: TryFromClosureReturnValue,

Emit signal by its name. Read more

fn emit_by_name_with_values( &self, signal_name: &str, args: &[Value] ) -> Option<Value>

Emit signal by its name. Read more

fn emit_by_name_with_details<R>( &self, signal_name: &str, details: Quark, args: &[&dyn ToValue] ) -> R
where R: TryFromClosureReturnValue,

Emit signal by its name with details. Read more

fn emit_by_name_with_details_and_values( &self, signal_name: &str, details: Quark, args: &[Value] ) -> Option<Value>

Emit signal by its name with details. Read more

fn emit_with_details<R>( &self, signal_id: SignalId, details: Quark, args: &[&dyn ToValue] ) -> R
where R: TryFromClosureReturnValue,

Emit signal by signal id with details. Read more

fn emit_with_details_and_values( &self, signal_id: SignalId, details: Quark, args: &[Value] ) -> Option<Value>

Emit signal by signal id with details. Read more

fn disconnect(&self, handler_id: SignalHandlerId)

Disconnect a previously connected signal handler.

fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId
where F: Fn(&T, &ParamSpec) + Send + Sync + 'static,

Connect to the notify signal of the object. Read more

fn connect_notify_local<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId
where F: Fn(&T, &ParamSpec) + 'static,

Connect to the notify signal of the object. Read more

unsafe fn connect_notify_unsafe<F>( &self, name: Option<&str>, f: F ) -> SignalHandlerId
where F: Fn(&T, &ParamSpec),

Connect to the notify signal of the object. Read more

fn notify(&self, property_name: &str)

Notify that the given property has changed its value. Read more

fn notify_by_pspec(&self, pspec: &ParamSpec)

Notify that the given property has changed its value. Read more

fn downgrade(&self) -> WeakRef<T>

Downgrade this object to a weak reference.

fn add_weak_ref_notify<F>(&self, f: F) -> WeakRefNotify<T>
where F: FnOnce() + Send + 'static,

Add a callback to be notified when the Object is disposed.

fn add_weak_ref_notify_local<F>(&self, f: F) -> WeakRefNotify<T>
where F: FnOnce() + 'static,

Add a callback to be notified when the Object is disposed. Read more

fn bind_property<'f, 't, O, 'a>( &'a self, source_property: &'a str, target: &'a O, target_property: &'a str ) -> BindingBuilder<'a, 'f, 't>
where O: ObjectType,

Bind property source_property on this object to the target_property on the target object. Read more

fn ref_count(&self) -> u32

Returns the strong reference count of this object.

unsafe fn run_dispose(&self)

Runs the dispose mechanism of the object. Read more

impl<T> Property for T
where T: HasParamSpec,

type Value = T

impl<T> PropertyGet for T
where T: HasParamSpec,

type Value = T

fn get<R, F>(&self, f: F) -> R
where F: Fn(&<T as PropertyGet>::Value) -> R,

impl<T> StaticTypeExt for T
where T: StaticType,

fn ensure_type()

Ensures that the type has been registered with the type system.

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> TransparentType for T
where T: TransparentPtrType,

type GlibType = <T as GlibPtrDefault>::GlibType

impl<T, U> TryFrom for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

impl<T> TryFromClosureReturnValue for T
where T: for<'a> FromValue<'a> + StaticType + 'static,

fn try_from_closure_return_value(v: Option<Value>) -> Result<T, BoolError>

impl<T, U> TryInto for T
where U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

impl<'a, T, C, E> FromValueOptional<'a> for T
where T: FromValue<'a, Checker = C>, C: ValueTypeChecker<Error = ValueTypeMismatchOrNoneError<E>>, E: Error + Send + 'static,