File Explorer

1# package.py2# Module defining the dnf.Package class.3#4# Copyright (C) 2012-2016 Red Hat, Inc.5#6# This copyrighted material is made available to anyone wishing to use,7# modify, copy, or redistribute it subject to the terms and conditions of8# the GNU General Public License v.2, or (at your option) any later version.9# This program is distributed in the hope that it will be useful, but WITHOUT10# ANY WARRANTY expressed or implied, including the implied warranties of11# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General12# Public License for more details.  You should have received a copy of the13# GNU General Public License along with this program; if not, write to the14# Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA15# 02110-1301, USA.  Any Red Hat trademarks that are incorporated in the16# source code or documentation are not subject to the GNU General Public17# License and may only be used or replicated with the express permission of18# Red Hat, Inc.19#20 21""" Contains the dnf.Package class. """22 23from __future__ import absolute_import24from __future__ import unicode_literals25 26from dnf.i18n import _27 28import binascii29import dnf.exceptions30import dnf.rpm31import dnf.yum.misc32import hawkey33import libdnf.error34import libdnf.utils35import logging36import os37import rpm38 39logger = logging.getLogger("dnf")40 41 42class Package(hawkey.Package):43    """ Represents a package. #:api """44 45    DEBUGINFO_SUFFIX = "-debuginfo"  # :api46    DEBUGSOURCE_SUFFIX = "-debugsource"  # :api47 48    def __init__(self, initobject, base):49        super(Package, self).__init__(initobject)50        self.base = base51        self._priv_chksum = None52        self._repo = None53        self._priv_size = None54 55    @property56    def _chksum(self):57        if self._priv_chksum:58            return self._priv_chksum59        if self._from_cmdline:60            chksum_type = dnf.yum.misc.get_default_chksum_type()61            try:62                chksum_val = libdnf.utils.checksum_value(chksum_type, self.location)63            except libdnf.error.Error as e:64                raise dnf.exceptions.MiscError(str(e))65            return (hawkey.chksum_type(chksum_type),66                    binascii.unhexlify(chksum_val))67        return super(Package, self).chksum68 69    @_chksum.setter70    def _chksum(self, val):71        self._priv_chksum = val72 73    @property74    def _from_cmdline(self):75        return self.reponame == hawkey.CMDLINE_REPO_NAME76 77    @property78    def _from_system(self):79        return self.reponame == hawkey.SYSTEM_REPO_NAME80 81    @property82    def _from_repo(self):83        """84        For installed packages returns id of repository from which the package was installed85        prefixed with '@' (if such information is available in the history database). Otherwise86        returns id of repository the package belongs to (@System for installed packages of unknown87        origin)88        """89        pkgrepo = None90        if self._from_system:91            pkgrepo = self.base.history.repo(self)92        if pkgrepo:93            return '@' + pkgrepo94        return self.reponame95 96    @property97    def from_repo(self):98        # :api99        if self._from_system:100            return self.base.history.repo(self)101        return ""102 103    @property104    def _header(self):105        """106        Returns the header of a locally present rpm package file. As opposed to107        self.get_header(), which retrieves the header of an installed package108        from rpmdb.109        """110        return dnf.rpm._header(self.localPkg())111 112    @property113    def _size(self):114        if self._priv_size:115            return self._priv_size116        return super(Package, self).size117 118    @_size.setter119    def _size(self, val):120        self._priv_size = val121 122    @property123    def _pkgid(self):124        if self.hdr_chksum is None:125            return None126        (_, chksum) = self.hdr_chksum127        return binascii.hexlify(chksum)128 129    @property130    def source_name(self):131        # :api132        """133        returns name of source package134        e.g. krb5-libs -> krb5135        """136        if self.sourcerpm is not None:137            # trim suffix first138            srcname = dnf.util.rtrim(self.sourcerpm, ".src.rpm")139            # sourcerpm should be in form of name-version-release now, so we140            # will strip the two rightmost parts separated by dash.141            # Using rtrim with version and release of self is not sufficient142            # because the package can have different version to the source143            # package.144            srcname = srcname.rsplit('-', 2)[0]145        else:146            srcname = None147        return srcname148 149    @property150    def debug_name(self):151        # :api152        """153        Returns name of the debuginfo package for this package.154        If this package is a debuginfo package, returns its name.155        If this package is a debugsource package, returns the debuginfo package156        for the base package.157        e.g. kernel-PAE -> kernel-PAE-debuginfo158        """159        if self.name.endswith(self.DEBUGINFO_SUFFIX):160            return self.name161 162        name = self.name163        if self.name.endswith(self.DEBUGSOURCE_SUFFIX):164            name = name[:-len(self.DEBUGSOURCE_SUFFIX)]165 166        return name + self.DEBUGINFO_SUFFIX167 168    @property169    def debugsource_name(self):170        # :api171        """172        Returns name of the debugsource package for this package.173        e.g. krb5-libs -> krb5-debugsource174        """175        # assuming self.source_name is None only for a source package176        src_name = self.source_name if self.source_name is not None else self.name177        return src_name + self.DEBUGSOURCE_SUFFIX178 179    def get_header(self):180        """181        Returns the rpm header of the package if it is installed. If not182        installed, returns None. The header is not cached, it is retrieved from183        rpmdb on every call. In case of a failure (e.g. when the rpmdb changes184        between loading the data and calling this method), raises an instance185        of PackageNotFoundError.186        """187        if not self._from_system:188            return None189 190        try:191            # RPMDBI_PACKAGES stands for the header of the package192            return next(self.base._ts.dbMatch(rpm.RPMDBI_PACKAGES, self.rpmdbid))193        except StopIteration:194            raise dnf.exceptions.PackageNotFoundError("Package not found when attempting to retrieve header", str(self))195 196    @property197    def source_debug_name(self):198        # :api199        """200        returns name of debuginfo package for source package of given package201        e.g. krb5-libs -> krb5-debuginfo202        """203        # assuming self.source_name is None only for a source package204        src_name = self.source_name if self.source_name is not None else self.name205        return src_name + self.DEBUGINFO_SUFFIX206 207    @property # yum compatibility attribute208    def idx(self):209        """ Always type it to int, rpm bindings expect it like that. """210        return int(self.rpmdbid)211 212    @property # yum compatibility attribute213    def repoid(self):214        return self.reponame215 216    @property # yum compatibility attribute217    def pkgtup(self):218        return (self.name, self.arch, str(self.e), self.v, self.r)219 220    @property # yum compatibility attribute221    def repo(self):222        if self._repo:223            return self._repo224        return self.base.repos[self.reponame]225 226    @repo.setter227    def repo(self, val):228        self._repo = val229 230    @property231    def reason(self):232        if self.repoid != hawkey.SYSTEM_REPO_NAME:233            return None234        return self.base.history.rpm.get_reason_name(self)235 236    @property # yum compatibility attribute237    def relativepath(self):238        return self.location239 240    @property # yum compatibility attribute241    def a(self):242        return self.arch243 244    @property # yum compatibility attribute245    def e(self):246        return self.epoch247 248    @property # yum compatibility attribute249    def v(self):250        return self.version251 252    @property # yum compatibility attribute253    def r(self):254        return self.release255 256    @property # yum compatibility attribute257    def ui_from_repo(self):258        return self.reponame259 260    # yum compatibility method261    def evr_eq(self, pkg):262        return self.evr_cmp(pkg) == 0263 264    # yum compatibility method265    def evr_gt(self, pkg):266        return self.evr_cmp(pkg) > 0267 268    # yum compatibility method269    def evr_lt(self, pkg):270        return self.evr_cmp(pkg) < 0271 272    # yum compatibility method273    def getDiscNum(self):274        return self.medianr275 276    # yum compatibility method277    def localPkg(self):278        """ Package's location in the filesystem.279 280            For packages in remote repo returns where the package will be/has281            been downloaded.282        """283        if self._from_cmdline:284            return self.location285        loc = self.location286        if self.repo._repo.isLocal() and self.baseurl and self.baseurl.startswith('file://'):287            return os.path.join(self.get_local_baseurl(), loc.lstrip("/"))288        if not self._is_local_pkg():289            loc = os.path.basename(loc)290        return os.path.join(self.pkgdir, loc.lstrip("/"))291 292    def remote_location(self, schemes=('http', 'ftp', 'file', 'https')):293        # :api294        """295        The location from where the package can be downloaded from. Returns None for installed and296        commandline packages.297 298        :param schemes: list of allowed protocols. Default is ('http', 'ftp', 'file', 'https')299        :return: location (string) or None300        """301        if self._from_system or self._from_cmdline:302            return None303        return self.repo.remote_location(self.location, schemes)304 305    def _is_local_pkg(self):306        if self._from_system:307            return True308        if '://' in self.location and not self.location.startswith('file://'):309            # the package has a remote URL as its location310            return False311        return self._from_cmdline or \312            (self.repo._repo.isLocal() and (not self.baseurl or self.baseurl.startswith('file://')))313 314    @property315    def pkgdir(self):316        if (self.repo._repo.isLocal() and not self._is_local_pkg()):317            return self.repo.cache_pkgdir()318        else:319            return self.repo.pkgdir320 321    # yum compatibility method322    def returnIdSum(self):323        """ Return the chksum type and chksum string how the legacy yum expects324            it.325        """326        if self._chksum is None:327            return (None, None)328        (chksum_type, chksum) = self._chksum329        return (hawkey.chksum_name(chksum_type), binascii.hexlify(chksum).decode())330 331    # yum compatibility method332    def verifyLocalPkg(self):333        if self._from_system:334            raise ValueError("Can not verify an installed package.")335        if self._from_cmdline:336            return True # local package always verifies against itself337        (chksum_type, chksum) = self.returnIdSum()338        try:339            return libdnf.utils.checksum_check(chksum_type, self.localPkg(), chksum)340        except libdnf.error.Error as e:341            raise dnf.exceptions.MiscError(str(e))342