1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
: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
----------------------
.. class:: BaseDependency
The :class:`BaseDependency` class defines various attributes for accessing
the parts of a dependency. The attributes are as follows:
.. attribute:: name
The name of the dependency
.. attribute:: relation
The relation (>,>=,==,<,<=,)
.. attribute:: version
The version or None.
.. attribute:: pre_depend
Boolean value whether this is a pre-dependency.
.. 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()
|