PackageKitGlib.Client¶

Subclasses:: PackageKitGlib.Task

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`create_helper_argv_envp` (argv, envp_out)
class	`new` ()
	`accept_eula` (eula_id, cancellable, progress_callback, *progress_user_data)
	`accept_eula_async` (eula_id, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`adopt` (transaction_id, cancellable, progress_callback, *progress_user_data)
	`adopt_async` (transaction_id, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`depends_on` (filters, package_ids, recursive, cancellable, progress_callback, *progress_user_data)
	`depends_on_async` (filters, package_ids, recursive, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`download_packages` (package_ids, directory, cancellable, progress_callback, *progress_user_data)
	`download_packages_async` (package_ids, directory, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`generic_finish` (res)
	`get_background` ()
	`get_cache_age` ()
	`get_categories` (cancellable, progress_callback, *progress_user_data)
	`get_categories_async` (cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_details` (package_ids, cancellable, progress_callback, *progress_user_data)
	`get_details_async` (package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_details_local` (files, cancellable, progress_callback, *progress_user_data)
	`get_details_local_async` (files, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_details_with_deps_size` ()
	`get_distro_upgrades` (cancellable, progress_callback, *progress_user_data)
	`get_distro_upgrades_async` (cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_files` (package_ids, cancellable, progress_callback, *progress_user_data)
	`get_files_async` (package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_files_local` (files, cancellable, progress_callback, *progress_user_data)
	`get_files_local_async` (files, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_idle` ()
	`get_interactive` ()
	`get_locale` ()
	`get_old_transactions` (number, cancellable, progress_callback, *progress_user_data)
	`get_old_transactions_async` (number, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_packages` (filters, cancellable, progress_callback, *progress_user_data)
	`get_packages_async` (filters, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_progress` (transaction_id, cancellable)
	`get_progress_async` (transaction_id, cancellable, callback_ready, *user_data)
	`get_progress_finish` (res)
	`get_repo_list` (filters, cancellable, progress_callback, *progress_user_data)
	`get_repo_list_async` (filters, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_update_detail` (package_ids, cancellable, progress_callback, *progress_user_data)
	`get_update_detail_async` (package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`get_updates` (filters, cancellable, progress_callback, *progress_user_data)
	`get_updates_async` (filters, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`install_files` (transaction_flags, files, cancellable, progress_callback, *progress_user_data)
	`install_files_async` (transaction_flags, files, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`install_packages` (transaction_flags, package_ids, cancellable, progress_callback, *progress_user_data)
	`install_packages_async` (transaction_flags, package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`install_signature` (type, key_id, package_id, cancellable, progress_callback, *progress_user_data)
	`install_signature_async` (type, key_id, package_id, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`refresh_cache` (force, cancellable, progress_callback, *progress_user_data)
	`refresh_cache_async` (force, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`remove_packages` (transaction_flags, package_ids, allow_deps, autoremove, cancellable, progress_callback, *progress_user_data)
	`remove_packages_async` (transaction_flags, package_ids, allow_deps, autoremove, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`repair_system` (transaction_flags, cancellable, progress_callback, *progress_user_data)
	`repair_system_async` (transaction_flags, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`repo_enable` (repo_id, enabled, cancellable, progress_callback, *progress_user_data)
	`repo_enable_async` (repo_id, enabled, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`repo_remove` (transaction_flags, repo_id, autoremove, cancellable, progress_callback, *progress_user_data)
	`repo_remove_async` (transaction_flags, repo_id, autoremove, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`repo_set_data` (repo_id, parameter, value, cancellable, progress_callback, *progress_user_data)
	`repo_set_data_async` (repo_id, parameter, value, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`required_by` (filters, package_ids, recursive, cancellable, progress_callback, *progress_user_data)
	`required_by_async` (filters, package_ids, recursive, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`resolve` (filters, packages, cancellable, progress_callback, *progress_user_data)
	`resolve_async` (filters, packages, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`search_details` (filters, values, cancellable, progress_callback, *progress_user_data)
	`search_details_async` (filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`search_files` (filters, values, cancellable, progress_callback, *progress_user_data)
	`search_files_async` (filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`search_groups` (filters, values, cancellable, progress_callback, *progress_user_data)
	`search_groups_async` (filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`search_names` (filters, values, cancellable, progress_callback, *progress_user_data)
	`search_names_async` (filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`set_background` (background)
	`set_cache_age` (cache_age)
	`set_details_with_deps_size` (details_with_deps_size)
	`set_interactive` (interactive)
	`set_locale` (locale)
	`update_packages` (transaction_flags, package_ids, cancellable, progress_callback, *progress_user_data)
	`update_packages_async` (transaction_flags, package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`upgrade_system` (transaction_flags, distro_id, upgrade_kind, cancellable, progress_callback, *progress_user_data)
	`upgrade_system_async` (transaction_flags, distro_id, upgrade_kind, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)
	`what_provides` (filters, values, cancellable, progress_callback, *progress_user_data)
	`what_provides_async` (filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)

Virtual Methods¶

Inherited:: GObject.Object (7)

do_changed ()

Properties¶

Name	Type	Flags	Short Description
`background`	`bool`	r/w
`cache-age`	`int`	r/w
`details-with-deps-size`	`bool`	r/w
`idle`	`bool`	r	if there are no transactions in progress on this client
`interactive`	`bool`	r/w
`locale`	`str`	r/w

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`GObject.Object`	r
priv	`PackageKitGlib.ClientPrivate`	r

Class Details¶

class PackageKitGlib.Client(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: PackageKitGlib.ClientClass

classmethod create_helper_argv_envp(argv, envp_out)¶

Parameters:

argv (str) –
envp_out (str) –

Return type:

bool

classmethod new()¶

Returns:: A new PackageKitGlib.Client instance
Return type:: PackageKitGlib.Client

PackageKitGlib.Client is a nice GObject.Object wrapper for PackageKit and makes writing frontends easy.

New in version 0.5.2.

accept_eula(eula_id, cancellable, progress_callback, *progress_user_data)¶

Parameters:

eula_id (str) – the eula_id we are agreeing to
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

We may want to agree to a EULA dialog if one is presented.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

accept_eula_async(eula_id, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

eula_id (str) – the eula_id we are agreeing to
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

We may want to agree to a EULA dialog if one is presented.

New in version 0.5.2.

adopt(transaction_id, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_id (str) – a transaction ID such as “/21_ebcbdaae_data”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Adopt a transaction.

Warning: this function is synchronous, and will block. Do not use it in GUI applications.

New in version 0.5.3.

adopt_async(transaction_id, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_id (str) – a transaction ID such as “/21_ebcbdaae_data”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Adopt a transaction which allows the caller to monitor the state or cancel it.

New in version 0.5.2.

depends_on(filters, package_ids, recursive, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
recursive (bool) – If we should search recursively for depends
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get the packages that depend this one, i.e. child.parent.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

depends_on_async(filters, package_ids, recursive, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
recursive (bool) – If we should search recursively for depends
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get the packages that depend this one, i.e. child->parent.

New in version 0.5.2.

download_packages(package_ids, directory, cancellable, progress_callback, *progress_user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
directory (str) – the location where packages are to be downloaded
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Downloads package files to a specified location.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

download_packages_async(package_ids, directory, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
directory (str) – the location where packages are to be downloaded
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Downloads package files to a specified location.

New in version 0.5.2.

generic_finish(res)¶

Parameters:: res (Gio.AsyncResult) – the Gio.AsyncResult
Raises:: GLib.Error
Returns:: the PackageKitGlib.Results, or None. Free with GObject.Object.unref()
Return type:: PackageKitGlib.Results

Gets the result from the asynchronous function.

New in version 0.5.2.

get_background()¶

Returns:: The background status.
Return type:: bool

Gets the background value.

New in version 0.6.10.

get_cache_age()¶

Returns:: The cache age in seconds
Return type:: int

Gets the maximum cache age value.

New in version 0.6.10.

get_categories(cancellable, progress_callback, *progress_user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get a list of all categories supported.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_categories_async(cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get a list of all categories supported.

New in version 0.5.2.

get_details(package_ids, cancellable, progress_callback, *progress_user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get details of a package, so more information can be obtained for GUI or command line tools.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_details_async(package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get details of a package, so more information can be obtained for GUI or command line tools.

New in version 0.5.2.

get_details_local(files, cancellable, progress_callback, *progress_user_data)¶

Parameters:

files ([str]) – a null terminated array of filenames
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get details of a local package, so more information can be obtained for GUI or command line tools.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.8.17.

get_details_local_async(files, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

files ([str]) – a null terminated array of filenames
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get details of a package, so more information can be obtained for GUI or command line tools.

New in version 0.8.17.

get_details_with_deps_size()¶

Returns:: whether the PackageKitGlib.Client.get_details_async() should include dependencies download sizes for packages, which are not installed.
Return type:: bool

Gets the client details-with-deps-size value.

New in version 1.2.7.

get_distro_upgrades(cancellable, progress_callback, *progress_user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

This method should return a list of distribution upgrades that are available. It should not return updates, only major upgrades.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_distro_upgrades_async(cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

This method should return a list of distribution upgrades that are available. It should not return updates, only major upgrades.

New in version 0.5.2.

get_files(package_ids, cancellable, progress_callback, *progress_user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get the file list (i.e. a list of files installed) for the specified package.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_files_async(package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get the file list (i.e. a list of files installed) for the specified package.

New in version 0.5.2.

get_files_local(files, cancellable, progress_callback, *progress_user_data)¶

Parameters:

files ([str]) – a null terminated array of filenames
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get file list of a local package, so more information can be obtained for GUI or command line tools.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.9.1.

get_files_local_async(files, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

files ([str]) – a null terminated array of filenames
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get file list of a package, so more information can be obtained for GUI or command line tools.

New in version 0.9.1.

get_idle()¶

Returns:: if this client is idle.
Return type:: bool

Gets if the transaction client idle value.

New in version 0.6.10.

get_interactive()¶

Returns:: if the transaction is due to run interactivly.
Return type:: bool

Gets the client interactive value.

New in version 0.6.10.

get_locale()¶

Returns:: The locale.
Return type:: str

Gets the locale used for this transaction.

New in version 0.6.10.

get_old_transactions(number, cancellable, progress_callback, *progress_user_data)¶

Parameters:

number (int) – the number of past transactions to return, or 0 for all
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get the old transaction list, mainly used for the transaction viewer.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_old_transactions_async(number, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

number (int) – the number of past transactions to return, or 0 for all
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get the old transaction list, mainly used for the transaction viewer.

New in version 0.5.2.

get_packages(filters, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get the list of packages from the backend

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_packages_async(filters, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get the list of packages from the backend

New in version 0.5.2.

get_progress(transaction_id, cancellable)¶

Parameters:

transaction_id (str) – The transaction id
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Progress

Get the progress of a transaction.

Warning: this function is synchronous, and will block. Do not use it in GUI applications.

New in version 0.5.3.

get_progress_async(transaction_id, cancellable, callback_ready, *user_data)¶

Parameters:

transaction_id (str) – a transaction ID such as “/21_ebcbdaae_data”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Find the current state of a transaction.

New in version 0.5.2.

get_progress_finish(res)¶

Parameters:: res (Gio.AsyncResult) – the Gio.AsyncResult
Raises:: GLib.Error
Returns:: the PackageKitGlib.Progress, or None. Free with GObject.Object.unref()
Return type:: PackageKitGlib.Progress

Gets the result from the asynchronous function.

New in version 0.5.2.

get_repo_list(filters, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.DEVELOPMENT or PackageKitGlib.FilterEnum.NONE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get the list of repositories installed on the system.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_repo_list_async(filters, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.DEVELOPMENT or PackageKitGlib.FilterEnum.NONE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get the list of repositories installed on the system.

New in version 0.5.2.

get_update_detail(package_ids, cancellable, progress_callback, *progress_user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get details about the specific update, for instance any CVE urls and severity information.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_update_detail_async(package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get details about the specific update, for instance any CVE urls and severity information.

New in version 0.5.2.

get_updates(filters, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.DEVELOPMENT or PackageKitGlib.FilterEnum.NONE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get a list of all the packages that can be updated for all repositories.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

get_updates_async(filters, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.DEVELOPMENT or PackageKitGlib.FilterEnum.NONE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get a list of all the packages that can be updated for all repositories.

New in version 0.5.2.

install_files(transaction_flags, files, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
files ([str]) – a file such as “/home/hughsie/Desktop/hal-devel-0.10.0.rpm”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Install a file locally, and get the deps from the repositories. This is useful for double clicking on a .rpm or .deb file.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.8.1.

install_files_async(transaction_flags, files, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
files ([str]) – a file such as “/home/hughsie/Desktop/hal-devel-0.10.0.rpm”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Install a file locally, and get the deps from the repositories. This is useful for double clicking on a .rpm or .deb file.

New in version 0.8.1.

install_packages(transaction_flags, package_ids, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Install a package of the newest and most correct version.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.8.1.

install_packages_async(transaction_flags, package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Install a package of the newest and most correct version.

New in version 0.8.1.

install_signature(type, key_id, package_id, cancellable, progress_callback, *progress_user_data)¶

Parameters:

type (PackageKitGlib.SigTypeEnum) – the signature type, e.g. PackageKitGlib.SigTypeEnum.GPG
key_id (str) – a key ID such as “0df23df”
package_id (str) – a signature_id structure such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Install a software repository signature of the newest and most correct version.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

install_signature_async(type, key_id, package_id, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

type (PackageKitGlib.SigTypeEnum) – the signature type, e.g. PackageKitGlib.SigTypeEnum.GPG
key_id (str) – a key ID such as “0df23df”
package_id (str) – a signature_id structure such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Install a software repository signature of the newest and most correct version.

New in version 0.5.2.

refresh_cache(force, cancellable, progress_callback, *progress_user_data)¶

Parameters:

force (bool) – if we should aggressively drop caches
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Refresh the cache, i.e. download new metadata from a remote URL so that package lists are up to date. This action may take a few minutes and should be done when the session and system are idle.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

refresh_cache_async(force, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

force (bool) – if we should aggressively drop caches
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Refresh the cache, i.e. download new metadata from a remote URL so that package lists are up to date. This action may take a few minutes and should be done when the session and system are idle.

New in version 0.5.2.

remove_packages(transaction_flags, package_ids, allow_deps, autoremove, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
allow_deps (bool) – if other dependent packages are allowed to be removed from the computer
autoremove (bool) – if other packages installed at the same time should be tried to remove
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Remove a package (optionally with dependancies) from the system. If allow_deps is set to False, and other packages would have to be removed, then the transaction would fail.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.8.1.

remove_packages_async(transaction_flags, package_ids, allow_deps, autoremove, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
allow_deps (bool) – if other dependent packages are allowed to be removed from the computer
autoremove (bool) – if other packages installed at the same time should be tried to remove
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Remove a package (optionally with dependancies) from the system. If allow_deps is set to False, and other packages would have to be removed, then the transaction would fail.

New in version 0.8.1.

repair_system(transaction_flags, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_flags (int) – if only trusted packages should be installed
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

This transaction will try to recover from a broken package management system: e.g. the installation of a package with unsatisfied dependencies has been forced by using a low level tool (rpm or dpkg) or the system was shutdown during processing an installation.

The backend will decide what is best to do.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.8.1.

repair_system_async(transaction_flags, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

This transaction will try to recover from a broken package management system: e.g. the installation of a package with unsatisfied dependencies has been forced by the user using a low level tool (rpm or dpkg) or the system was shutdown during processing an installation.

The backend will decide what is best to do.

New in version 0.8.1.

repo_enable(repo_id, enabled, cancellable, progress_callback, *progress_user_data)¶

Parameters:

repo_id (str) – a repo_id structure such as “livna-devel”
enabled (bool) – if we should enable the repository
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Enable or disable the repository.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

repo_enable_async(repo_id, enabled, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

repo_id (str) – a repo_id structure such as “livna-devel”
enabled (bool) – if we should enable the repository
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Enable or disable the repository.

New in version 0.5.2.

repo_remove(transaction_flags, repo_id, autoremove, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_flags (int) – transaction flags
repo_id (str) – a repo_id structure such as “livna-devel”
autoremove (bool) – If packages should be auto-removed
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Removes a repo and optionally the packages installed from it.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.9.1.

repo_remove_async(transaction_flags, repo_id, autoremove, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_flags (int) – transaction flags
repo_id (str) – a repo_id structure such as “livna-devel”
autoremove (bool) – If packages should be auto-removed
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Removes a repo and optionally the packages installed from it.

New in version 0.9.1.

repo_set_data(repo_id, parameter, value, cancellable, progress_callback, *progress_user_data)¶

Parameters:

repo_id (str) – a repo_id structure such as “livna-devel”
parameter (str) – the parameter to change
value (str) – what we should change it to
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

We may want to set a repository parameter. NOTE: this is free text, and is left to the backend to define a format.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

repo_set_data_async(repo_id, parameter, value, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

repo_id (str) – a repo_id structure such as “livna-devel”
parameter (str) – the parameter to change
value (str) – what we should change it to
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

We may want to set a repository parameter. NOTE: this is free text, and is left to the backend to define a format.

New in version 0.5.2.

required_by(filters, package_ids, recursive, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
recursive (bool) – If we should search recursively for requires
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Get the packages that require this one, i.e. parent.child.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

required_by_async(filters, package_ids, recursive, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
recursive (bool) – If we should search recursively for requires
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Get the packages that require this one, i.e. parent->child.

New in version 0.5.2.

resolve(filters, packages, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
packages ([str]) – an array of package names to resolve, e.g. “gnome-system-tools”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Resolve a package name into a package_id. This can return installed and available packages and allows you find out if a package is installed locally or is available in a repository.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

resolve_async(filters, packages, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
packages ([str]) – an array of package names to resolve, e.g. “gnome-system-tools”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Resolve a package name into a package_id. This can return installed and available packages and allows you find out if a package is installed locally or is available in a repository.

New in version 0.5.2.

search_details(filters, values, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – free text to search for, for instance, “power”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Search all detailed summary information to try and find a keyword. Think of this as PackageKitGlib.Client.search_names(), but trying much harder and taking longer.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.5.

search_details_async(filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – free text to search for, for instance, “power”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Search all detailed summary information to try and find a keyword. Think of this as PackageKitGlib.Client.search_names(), but trying much harder and taking longer.

New in version 0.5.5.

search_files(filters, values, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – file to search for, for instance, “/sbin/service”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Search for packages that provide a specific file.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.5.

search_files_async(filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – file to search for, for instance, “/sbin/service”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Search for packages that provide a specific file.

New in version 0.5.5.

search_groups(filters, values, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – a group enum to search for, for instance, “system-tools”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Return all packages in a specific group.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.5.

search_groups_async(filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – a group enum to search for, for instance, “system-tools”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Return all packages in a specific group.

New in version 0.5.5.

search_names(filters, values, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – free text to search for, for instance, “power”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Search all the locally installed files and remote repositories for a package that matches a specific name.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.5.

search_names_async(filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – free text to search for, for instance, “power”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Search all the locally installed files and remote repositories for a package that matches a specific name.

New in version 0.5.5.

set_background(background)¶

Parameters:: background (bool) – if the transaction is a background transaction

Sets the background value for the client. A background transaction is usually scheduled at a lower priority and is usually given less network and disk performance.

New in version 0.6.10.

set_cache_age(cache_age)¶

Parameters:: cache_age (int) – the cache age to set in seconds, where GObject.G_MAXUINT means cache “never expires”

Sets the maximum cache age value for the client.

New in version 0.6.10.

set_details_with_deps_size(details_with_deps_size)¶

Parameters:: details_with_deps_size (bool) – the value to set

Sets whether the PackageKitGlib.Client.get_details_async() should include dependencies download sizes for packages, which are not installed.

New in version 1.2.7.

set_interactive(interactive)¶

Parameters:: interactive (bool) – the value to set

Sets the interactive value for the client. Interactive transactions are usually allowed to ask the user questions.

New in version 0.6.10.

set_locale(locale)¶

Parameters:: locale (str) – the locale to set, e.g. “en_GB.UTF-8”

Sets the locale to be used for the client. This may affect returned results.

New in version 0.6.10.

update_packages(transaction_flags, package_ids, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

Update specific packages to the newest available versions.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.8.1.

update_packages_async(transaction_flags, package_ids, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
package_ids ([str]) – a null terminated array of package_id structures such as “hal;0.0.1;i386;fedora”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

Update specific packages to the newest available versions.

New in version 0.8.1.

upgrade_system(transaction_flags, distro_id, upgrade_kind, cancellable, progress_callback, *progress_user_data)¶

Parameters:

transaction_flags (int) – transaction flags
distro_id (str) – a distro ID such as “fedora-14”
upgrade_kind (PackageKitGlib.UpgradeKindEnum) – a PackageKitGlib.UpgradeKindEnum such as PackageKitGlib.UpgradeKindEnum.COMPLETE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

This transaction will upgrade the distro to the next version, which may involve just downloading the installer and setting up the boot device, or may involve doing an on-line upgrade.

The backend will decide what is best to do.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 1.0.10.

upgrade_system_async(transaction_flags, distro_id, upgrade_kind, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

transaction_flags (int) – a transaction type bitfield
distro_id (str) – a distro ID such as “fedora-14”
upgrade_kind (PackageKitGlib.UpgradeKindEnum) – a PackageKitGlib.UpgradeKindEnum such as PackageKitGlib.UpgradeKindEnum.COMPLETE
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

This transaction will update the distro to the next version, which may involve just downloading the installer and setting up the boot device, or may involve doing an on-line upgrade.

The backend will decide what is best to do.

New in version 1.0.10.

what_provides(filters, values, cancellable, progress_callback, *progress_user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – a search term such as “sound/mp3”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback

Raises:

GLib.Error

Returns:

a PackageKitGlib.Results object, or None for error

Return type:

PackageKitGlib.Results

This should return packages that provide the supplied attributes. This method is useful for finding out what package(s) provide a modalias or GStreamer codec string.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

New in version 0.5.3.

what_provides_async(filters, values, cancellable, progress_callback, progress_user_data, callback_ready, *user_data)¶

Parameters:

filters (int) – a #PkBitfield such as PackageKitGlib.FilterEnum.GUI | PackageKitGlib.FilterEnum.FREE or PackageKitGlib.FilterEnum.NONE
values ([str]) – a search term such as “sound/mp3”
cancellable (Gio.Cancellable or None) – a Gio.Cancellable or None
progress_callback (PackageKitGlib.ProgressCallback) – the function to run when the progress changes
progress_user_data (object or None) – data to pass to progress_callback
callback_ready (Gio.AsyncReadyCallback or None) – the function to run on completion
user_data (object or None) – the data to pass to callback_ready

This should return packages that provide the supplied attributes. This method is useful for finding out what package(s) provide a modalias or GStreamer codec string.

New in version 0.5.2.

do_changed() virtual¶

Property Details¶

PackageKitGlib.Client.props.background¶

Name:: background
Type:: bool
Default Value:: False
Flags:: READABLE, WRITABLE

New in version 0.5.3.

PackageKitGlib.Client.props.cache_age¶

Name:: cache-age
Type:: int
Default Value:: 4294967295
Flags:: READABLE, WRITABLE

The cache age in seconds, where GObject.G_MAXUINT means cache “never expires”

New in version 0.6.10.

PackageKitGlib.Client.props.details_with_deps_size¶

Name:: details-with-deps-size
Type:: bool
Default Value:: False
Flags:: READABLE, WRITABLE

New in version 1.2.7.

PackageKitGlib.Client.props.idle¶

Name:: idle
Type:: bool
Default Value:: True
Flags:: READABLE

if there are no transactions in progress on this client

New in version 0.5.4.

PackageKitGlib.Client.props.interactive¶

Name:: interactive
Type:: bool
Default Value:: True
Flags:: READABLE, WRITABLE

New in version 0.5.4.

PackageKitGlib.Client.props.locale¶

Name:: locale
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

New in version 0.5.3.