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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
# -*- encoding: utf-8 -*-
# Software Management Providers
#
# Copyright (C) 2012-2013 Red Hat, Inc. All rights reserved.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
#
# Authors: Michal Minar <miminar@redhat.com>
#
"""
Module holding an abstraction for RPM package.
"""
from datetime import datetime
import yum
from openlmi.software import util
class PackageInfo(object):
"""
Container for package metadata. It represents rpm package in yum
database. It's supposed to be passed from YumWorker to YumDB client
and vice-versa. Instances of YumAvailablePackage can not be exchanged
-- results in segfaults.
To speed up looking up of original yum package object on server, an
atribute "objid" is provided.
"""
__slots__ = (
"objid",
"name", "epoch", "version", "release", "architecture",
'summary', 'description', 'license', 'group', 'vendor',
"repoid", 'size',
'installed', # boolean
'install_time' # datetime instance
)
def __init__(self, objid, name, epoch, version, release, arch, **kwargs):
"""
@param objid is an in of original yum package object, which is used
by server for subsequent operations on this package requested by client
"""
self.objid = objid
self.name = name
self.epoch = epoch
self.version = version
self.release = release
self.architecture = arch
self.summary = kwargs.pop('summary', None)
self.description = kwargs.pop('description', None)
self.license = kwargs.pop('license', None)
self.group = kwargs.pop('group', None)
self.vendor = kwargs.pop('vendor', None)
self.repoid = kwargs.pop("repoid", None)
self.size = kwargs.pop('size', None)
if self.size is not None and not isinstance(self.size, (int, long)):
raise TypeError('size must be an integer')
self.installed = kwargs.pop('installed', None)
if self.installed is not None:
self.installed = bool(self.installed)
self.install_time = kwargs.pop('install_time', None)
if ( self.install_time is not None
and not isinstance(self.install_time, datetime)):
raise TypeError('install_time must be a datetime')
# *************************************************************************
# Properties
# *************************************************************************
@property
def ver(self):
"""Shortcut for version property."""
return self.version
@property
def rel(self):
"""Shortcut for release property."""
return self.release
@property
def arch(self):
"""Shortcut for architecture property."""
return self.architecture
@property
def nevra(self):
"""@return nevra of package with epoch always present."""
return self.get_nevra(with_epoch="ALWAYS")
@property
def evra(self):
"""@return evra of package."""
return "%s:%s-%s.%s" % (
self.epoch if self.epoch and self.epoch != "(none)" else "0",
self.version,
self.release,
self.architecture)
@property
def key_props(self):
"""
@return package properties as dictionary,
that uniquelly identify package in database
"""
return dict((k, getattr(self, k)) for k in (
'name', 'epoch', 'version', 'release', 'arch', 'repoid'))
# *************************************************************************
# Public methods
# *************************************************************************
def get_nevra(self, with_epoch='NOT_ZERO'):
"""
@param with_epoch may be one of:
"NOT_ZERO" - include epoch only if it's not zero
"ALWAYS" - include epoch always
"NEVER" - do not include epoch at all
@return nevra of package
"""
return util.make_nevra(self.name, self.epoch, self.version,
self.release, self.arch, with_epoch)
# *************************************************************************
# Special methods
# *************************************************************************
def __str__(self):
return self.nevra
def __getstate__(self):
"""
Used for serialization with pickle.
@return container content that will be serialized
"""
return dict((k, getattr(self, k)) for k in self.__slots__)
def __setstate__(self, state):
"""
Used for deserialization with pickle.
Restores the object from serialized form.
@param state is an object created by __setstate__() method
"""
for k, value in state.items():
setattr(self, k, value)
def make_package_from_db(pkg):
"""
Create instance of PackageInfo from instance of
yum.packages.YumAvailablePackage.
@return instance of PackageInfo
"""
metadata = dict((k, getattr(pkg, k)) for k in (
'summary', 'description', 'license', 'group', 'vendor', 'size',
'repoid'))
if isinstance(pkg, yum.rpmsack.RPMInstalledPackage):
metadata['installed'] = True
metadata['install_time'] = datetime.fromtimestamp(pkg.installtime)
else:
metadata['installed'] = False
res = PackageInfo(id(pkg), pkg.name, pkg.epoch, pkg.version, pkg.release,
pkg.arch, **metadata)
return res
|