astra / doc /source /library /apt.package.rst
Lorenzob's picture
Upload folder using huggingface_hub
859a779 verified
raw
history blame
2.73 kB
:mod:`apt.package` --- Classes for package handling
====================================================
.. automodule:: apt.package
The Package class
-----------------
.. autoclass:: Package
:members:
.. note::
Several methods have been deprecated in version 0.7.9 of python-apt,
please see the :class:`Version` class for the new alternatives.
The Version class
-----------------
.. autoclass:: Version
:members:
Dependency Information
----------------------
.. autoclass:: BaseDependency
:members:
.. class:: Dependency
The dependency class represents a Or-Group of dependencies. It provides
an attribute to access the :class:`BaseDependency` object for the available
choices.
.. attribute:: or_dependencies
A list of :class:`BaseDependency` objects which could satisfy the
requirement of the Or-Group.
Origin Information
-------------------
.. class:: Origin
The :class:`Origin` class provides access to the origin of the package.
It allows you to check the component, archive, the hostname, and even if
this package can be trusted.
.. attribute:: archive
The archive (eg. unstable)
.. attribute:: component
The component (eg. main)
.. attribute:: label
The Label, as set in the Release file
.. attribute:: origin
The Origin, as set in the Release file
.. attribute:: site
The hostname of the site.
.. attribute:: trusted
Boolean value whether this is trustworthy. An origin can be trusted, if
it provides a GPG-signed Release file and the GPG-key used is in the
keyring used by apt (see apt-key).
The Record class
-----------------
.. autoclass:: Record
:members:
.. note::
.. versionchanged:: 0.7.100
This class is a subclass of :class:`collections.Mapping` when used
in Python 2.6 or newer.
.. describe:: record[name]
Return the value of the field with the name *name*.
.. describe:: name in record
Return whether a field *name* exists in record.
.. describe:: len(record)
The number of fields in the record
.. describe:: str(record)
Display the record as a string
Examples
---------
.. code-block:: python
import apt
cache = apt.Cache()
pkg = cache['python-apt'] # Access the Package object for python-apt
print('python-apt is trusted:', pkg.candidate.origins[0].trusted)
# Mark python-apt for install
pkg.mark_install()
print('python-apt is marked for install:', pkg.marked_install)
print('python-apt is (summary):', pkg.candidate.summary)
# Now, really install it
cache.commit()