PackageKitGlib.Client

g GObject.Object GObject.Object PackageKitGlib.Client PackageKitGlib.Client GObject.Object->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

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

Get a list of all categories supported.

New in version 0.5.2.

get_details(package_ids, cancellable, progress_callback, *progress_user_data)
Parameters:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

Get the list of packages from the backend

New in version 0.5.2.

get_progress(transaction_id, cancellable)
Parameters:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

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:
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:

Return all packages in a specific group.

New in version 0.5.5.

search_names(filters, values, cancellable, progress_callback, *progress_user_data)
Parameters:
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:

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:
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:

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:
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:

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:
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:

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

Whether there are transactions in progress on this client or not

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.