OwlCyberSecurity - MANAGER
Edit File: package.cpython-38.pyc
U &��c�� � @ st d Z ddlmZ ddlZddlZddlZddlZddlZddlZddl Z e z(ddl m Z ddl m Z ddlmZ W n0 ek r� ddlm Z ddlm Z mZ Y nX zdddlmZmZmZmZmZmZmZmZm Z m Z m Z m Z e e e e e e e e e e W nV ek �r` ddl Z G d d � d e!�Z"e"e#�Ze"e j �Z e"e j �Z dZd d � Z Y nX ddl$Z$ddl%Z&dd l'm(Z(m)Z) e( e) ddl$m*Z+ dZ,ej-j.dk�r�e/Z0dd� Z1G dd� de2�Z3G dd� de3�Z4G dd� de!�Z5G dd� dee5 �Z6G dd � d e!�Z7G d d � d e eef �Z8G d d � d e!�Z9G d!d"� d"e e9 �Z:G d#d$� d$e!�Z;e d%d&� �Z<e=d'k�rpe<� dS )(z"Functionality related to packages.� )�print_functionN)� BadStatusLine)� HTTPError)�urlopen)r r ) �Any�Iterable�Iterator�List�Optional�Set�Tuple�Union� no_type_check�overload�Mapping�Sequencec @ s e Zd ZdZdd� Zdd� ZdS )�GenericWrapperz-Takes a non-generic type and adds __getitem__c C s || _ d S �N��value)�selfr � r �-/usr/lib/python3/dist-packages/apt/package.py�__init__< s zGenericWrapper.__init__c C s | j S r r �r �keyr r r � __getitem__@ s zGenericWrapper.__getitem__N)�__name__� __module__� __qualname__�__doc__r r r r r r r : s r c C s | S r r )�argr r r r I s r )�AcquireProgress�InstallProgress)�gettext)�BaseDependency� Dependency�Origin�Package�Record�Version� VersionList� c C sL t j�| �rHt j�| �|krHt| �� }t�|�j|kW 5 Q R � S Q R X dS )z(Return ``True`` if the file is the same.F)�os�path�exists�getsize�open�apt_pkgZHashes�hashes)r. �sizer3 Zfobjr r r � _file_is_samea s "r5 c @ s e Zd ZdZdS )� FetchErrorz(Raised when a file could not be fetched.N�r r r r r r r r r6 j s r6 c @ s e Zd ZdZdS )�UntrustedErrorz/Raised when a file did not have a trusted hash.Nr7 r r r r r8 n s r8 c @ s� e Zd ZdZG dd� de�Zdd� Zdd� Zdd � Ze d d � �Z e d d � �Z e dd� �Z e dd� �Z e dd� �Ze dd� �Ze dd� �Ze dd� �Ze dd� �Zd S ) r% zA single dependency.c @ s e Zd ZdZdd� Zdd� ZdS )zBaseDependency.__dstraQ Compare helper for compatibility with old third-party code. Old third-party code might still compare the relation with the previously used relations (<<,<=,==,!=,>=,>>,) instead of the curently used ones (<,<=,=,!=,>=,>,). This compare helper lets < match to <<, > match to >> and = match to ==. c C s` t �| |�rdS t �| d�r(t �d|�S t �| d�r@t �d|�S t �| d�rXt �d|�S dS d S ) NT�<z<<�>z>>�=z==F)�str�__eq__�r �otherr r r r= ~ s z BaseDependency.__dstr.__eq__c C s | � |� S r )r= r> r r r �__ne__� s z BaseDependency.__dstr.__ne__N)r r r r r= r@ r r r r �__dstru s rA c C s || _ || _d S r )�_version�_dep)r �version�depr r r r � s zBaseDependency.__init__c C s d| j | jf S �Nz%s: %s��rawtype�rawstr�r r r r �__str__� s zBaseDependency.__str__c C s d| j | j| j| jf S )Nz;<BaseDependency: name:%r relation:%r version:%r rawtype:%r>)�name�relationrD rH rJ r r r �__repr__� s �zBaseDependency.__repr__c C s | j jjS )z The name of the target package.)rC Z target_pkgrL rJ r r r rL � s zBaseDependency.namec C s | � | jj�S )z�The relation (<, <=, =, !=, >=, >, '') in mathematical notation. The empty string will be returned in case of an unversioned dependency. )�_BaseDependency__dstrrC Z comp_typerJ r r r rM � s zBaseDependency.relationc C s | j jS )av The relation (<<, <=, =, !=, >=, >>, '') in Debian notation. The empty string will be returned in case of an unversioned dependency. For more details see the Debian Policy Manual on the syntax of relationship fields: https://www.debian.org/doc/debian-policy/ch-relationships.html#s-depsyntax # noqa .. versionadded:: 1.0.0 )rC Z comp_type_debrJ r r r � relation_deb� s zBaseDependency.relation_debc C s | j jS )z�The target version or an empty string. Note that the version is only an empty string in case of an unversioned dependency. In this case the relation is also an empty string. )rC Z target_verrJ r r r rD � s zBaseDependency.versionc C sJ g }| j �� }|D ]2}|j}| jjj}|�|�}t||�}|�|� q|S )zfA list of all Version objects which satisfy this dependency. .. versionadded:: 1.0.0 ) rC Z all_targetsZ parent_pkgrB �package�_pcacheZ_rawpkg_to_pkgr* �append)r �tversZ_tversZ_tver�_pkg�cache�pkg�tverr r r �target_versions� s z BaseDependency.target_versionsc C s dd� | j D �S )�iA list of all installed Version objects which satisfy this dep. .. versionadded:: 1.0.0 c S s g | ]}|j r|�qS r �� is_installed��.0rX r r r � <listcomp>� s z<BaseDependency.installed_target_versions.<locals>.<listcomp>�rY rJ r r r �installed_target_versions� s z(BaseDependency.installed_target_versionsc C s$ | j rd| j| j| j f S | jS dS )a� String represenation of the dependency. Returns the string representation of the dependency as it would be written in the debian/control file. The string representation does not include the type of the dependency. Example for an unversioned dependency: python3 Example for a versioned dependency: python3 >= 3.2 .. versionadded:: 1.0.0 z%s %s %sN)rD rL rP rJ r r r rI � s zBaseDependency.rawstrc C s | j jS )z�Type of the dependency. This should be one of 'Breaks', 'Conflicts', 'Depends', 'Enhances', 'PreDepends', 'Recommends', 'Replaces', 'Suggests'. Additional types might be added in the future. �rC Zdep_type_untranslatedrJ r r r rH � s zBaseDependency.rawtypec C s | j jdkS )z Whether this is a PreDepends.� PreDependsrb rJ r r r � pre_depend s zBaseDependency.pre_dependN)r r r r r< rO r rK rN �propertyrL rM rP rD rY ra rI rH rd r r r r r% r s. r% c sl e Zd ZdZ� fdd�Zdd� Zdd� Zedd � �Zed d � �Z ed d � �Z edd� �Z edd� �Z � Z S )r& aM Represent an Or-group of dependencies. Attributes defined here: or_dependencies - The possible choices rawstr - String represenation of the Or-group of dependencies rawtype - The type of the dependencies in the Or-group target_version - A list of Versions which satisfy this Or-group of deps c s t t| ��|� || _|| _d S r )�superr& r rB �_rawtype)r rD � base_depsrH �� __class__r r r s zDependency.__init__c C s d| j | jf S rF rG rJ r r r rK s zDependency.__str__c C s dd� dd� | D �� S )Nz<Dependency: [%s]>�, c s s | ]}t |�V qd S r )�repr�r^ �bdr r r � <genexpr> s z&Dependency.__repr__.<locals>.<genexpr>��joinrJ r r r rN s zDependency.__repr__c C s | S r r rJ r r r �or_dependencies s zDependency.or_dependenciesc C s d� dd� | D ��S )ax String represenation of the Or-group of dependencies. Returns the string representation of the Or-group of dependencies as it would be written in the debian/control file. The string representation does not include the type of the Or-group of dependencies. Example: python2 >= 2.7 | python3 .. versionadded:: 1.0.0 z | c s s | ] }|j V qd S r )rI rm r r r ro 2 s z$Dependency.rawstr.<locals>.<genexpr>rp rJ r r r rI $ s zDependency.rawstrc C s | j S )a Type of the Or-group of dependency. This should be one of 'Breaks', 'Conflicts', 'Depends', 'Enhances', 'PreDepends', 'Recommends', 'Replaces', 'Suggests'. Additional types might be added in the future. .. versionadded:: 1.0.0 )rg rJ r r r rH 4 s zDependency.rawtypec C s0 g }| D ]"}|j D ]}||kr|�|� qq|S )zlA list of all Version objects which satisfy this Or-group of deps. .. versionadded:: 1.0.0 )rY rS )r rT rn rX r r r rY B s zDependency.target_versionsc C s dd� | j D �S )rZ c S s g | ]}|j r|�qS r r[ r] r r r r_ W s z8Dependency.installed_target_versions.<locals>.<listcomp>r` rJ r r r ra P s z$Dependency.installed_target_versions)r r r r r rK rN re rr rI rH rY ra � __classcell__r r ri r r& s r& c @ s e Zd ZdZdd� Zdd� ZdS )r' a� The origin of a version. Attributes defined here: archive - The archive (eg. unstable) component - The component (eg. main) label - The Label, as set in the Release file origin - The Origin, as set in the Release file codename - The Codename, as set in the Release file site - The hostname of the site. trusted - Boolean value whether this is trustworthy. c C sb |j | _ |j| _|j| _|j| _|j| _|j| _|j| _|jj� |�}|rX|j rXd| _ nd| _ d S �NTF) �archive� component�label�originZcodename�siteZ not_automaticrR �_list� find_index� is_trusted�trusted)r rW � packagefile� indexfiler r r r g s zOrigin.__init__c C s d| j | j| j| j| j| jf S )NzH<Origin component:%r archive:%r origin:%r label:%r site:%r isTrusted:%r>)rv ru rx rw ry r} rJ r r r rN w s ��zOrigin.__repr__N)r r r r r rN r r r r r' Z s r' c @ sb e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z ddd�Z dd� Z dd� Z dS )r) a" Record in a Packages file Represent a record as stored in a Packages file. You can use this like a dictionary mapping the field names of the record to their values:: >>> record = Record("Package: python-apt\nVersion: 0.8.0\n\n") >>> record["Package"] 'python-apt' >>> record["Version"] '0.8.0' For example, to get the tasks of a package from a cache, you could do:: package.candidate.record["Tasks"].split() Of course, you can also use the :attr:`Version.tasks` property. c C s t �|�| _d S r )r2 Z TagSection�_rec)r Z record_strr r r r � s zRecord.__init__c C s t | j�S r )�hashr� rJ r r r �__hash__� s zRecord.__hash__c C s t | j�S r )r< r� rJ r r r rK � s zRecord.__str__c C s | j | S r �r� r r r r r � s zRecord.__getitem__c C s || j kS r r� r r r r � __contains__� s zRecord.__contains__c C s t | j�� �S r )�iterr� �keysrJ r r r �__iter__� s zRecord.__iter__c c s$ | j �� D ]}|| j | fV q dS )z6An iterator over the (key, value) items of the record.N)r� r� r r r r � iteritems� s zRecord.iteritemsNc C s | j �||�S )zReturn record[key] if key in record, else *default*. The parameter *default* must be either a string or None. )r� �get�r r �defaultr r r r� � s z Record.getc C s || j kS )z deprecated form of ``key in x``.r� r r r r �has_key� s zRecord.has_keyc C s t | j�S r )�lenr� rJ r r r �__len__� s zRecord.__len__)N)r r r r r r� rK r r� r� r� r� r� r� r r r r r) s r) c @ s e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dd� Zedd� �Zedd� �Zed d � �Zed d � �Zed d!� �Zed"d#� �Zed$d%� �Zed&d'� �Zed(d)� �Zed*d+� �Zed,d-� �Zed.d/� �Zed0d1� �Z ed2d3� �Z ed4d5� �Z ed6d7� �Z ed8d9� �Z ed:d;� �Z!d<d=� Z"ed>d?� �Z#ed@dA� �Z$edBdC� �Z%edDdE� �Z&edFdG� �Z'edHdI� �Z(edJdK� �Z)edLdM� �Z*edNdO� �Z+edPdQ� �Z,edRdS� �Z-dTdU� Z.edVdW� �Z/edXdY� �Z0dad\d]�Z1dbd_d`�Z2d[S )cr* z�Representation of a package version. The Version class contains all information related to a specific package version. .. versionadded:: 0.7.9 c C s || _ || _| j jj�| � d S r )rQ �_candrR Z _weakversions�add)r rQ �candr r r r � s zVersion.__init__c C s� z@| j j}|j j}||k r W dS ||kr.W dS t�| jj|j�W S tk r� zt�| jj|�W Y S tk r� t Y Y S X Y nX dS )a: Compares against another apt.Version object or a version string. This method behaves like Python 2's cmp builtin and returns an integer according to the outcome. The return value is negative in case of self < other, zero if self == other and positive if self > other. The comparison includes the package name and architecture if other is an apt.Version object. If other isn't an apt.Version object it'll be assumed that other is a version string (without package name/arch). .. versionchanged:: 1.0.0 ���� N) rQ �fullnamer2 �version_comparer� �ver_strrD �AttributeError� TypeError�NotImplemented)r r? Z self_nameZ other_namer r r �_cmp� s z Version._cmpc C s | � |�dkS �Nr �r� r> r r r r= � s zVersion.__eq__c C s | � |�dkS r� r� r> r r r �__ge__� s zVersion.__ge__c C s | � |�dkS r� r� r> r r r �__gt__� s zVersion.__gt__c C s | � |�dkS r� r� r> r r r �__le__� s zVersion.__le__c C s | � |�dk S r� r� r> r r r �__lt__ s zVersion.__lt__c C s. z| � |�dkW S tk r( t Y S X d S r� )r� r� r� r> r r r r@ s zVersion.__ne__c C s | j jS r )r� r� rJ r r r r� s zVersion.__hash__c C s d| j j| jf S )Nz%s=%s�rQ rL rD rJ r r r rK s zVersion.__str__c C s d| j j| jf S )Nz <Version: package:%r version:%r>r� rJ r r r rN s �zVersion.__repr__c C s* | j jj�| jjd �s td��| j jjS )z=Internal helper that moves the Records to the right position.r zCould not lookup record)rQ rR �_records�lookupr� � file_list� LookupErrorrJ r r r r� s zVersion._recordsc C s. | j j}| jjj�|j�d��r*| jjjS dS )z2Internal helper to get the translated description.r N)r� Ztranslated_descriptionrQ rR r� r� r� �pop)r Z desc_iterr r r �_translated_records" s zVersion._translated_recordsc C s | j jS )z.Return the size of the package when installed.)r� �installed_sizerJ r r r r� + s zVersion.installed_sizec C s | j jS )z$Return the homepage for the package.)r� �homepagerJ r r r r� 1 s zVersion.homepagec C s | j jS )z Return the size of the package.)r� r4 rJ r r r r4 7 s z Version.sizec C s | j jS )z/Return the architecture of the package version.)r� ZarchrJ r r r � architecture= s zVersion.architecturec C s t | jj�S )z:Return whether the version of the package is downloadable.)�boolr� � downloadablerJ r r r r� C s zVersion.downloadablec C s | j j}|dk o |jj| jjkS )zkReturn wether this version of the package is currently installed. .. versionadded:: 1.0.0 N)rQ � installedr� �id)r Zinst_verr r r r\ I s zVersion.is_installedc C s | j jS )z Return the version as a string.)r� r� rJ r r r rD S s zVersion.versionc C s | j }|dk r|jS dS )z0Return the short description (one line summary).N)r� Z short_desc)r �recordsr r r �summaryY s zVersion.summaryc C s | j jS )z"return the long description (raw).)r� � long_descrJ r r r �raw_description` s zVersion.raw_descriptionc C s | j jS )z"Return the section of the package.)r� �sectionrJ r r r r� f s zVersion.sectionc C sB d}| j }|dk r|jnd}|s0td�| jj S zt|t�sF|�d�}W n: tk r� } z td�| jj|f W Y �S d}~X Y nX t |� d��}t |� |D ]�}|� � dkr�|� d�s�|d7 }q�|�d �r�|� d�s�d |d d� }nd |d d� }n:|�d ��r0|� d��s |dk�r*|dd� }n|}n|}||7 }q�|S )z�Return the formatted long description. Return the formatted long description according to the Debian policy (Chapter 5.6.13). See http://www.debian.org/doc/debian-policy/ch-controlfields.html for more information. � Nz+Missing description for '%s'.Please report.�utf-8z<Invalid unicode in description for '%s' (%s). Please report.� �.z z z %s � z%s � r� )r� r� �_rQ rL � isinstance�unicode�decode�UnicodeDecodeErrorr� �split�next�strip�endswith� startswith)r Zdescr� �dsc�err�linesZraw_line�liner r r � descriptionl s@ � � zVersion.descriptionc C s4 z| j jp| jjW S tk r. | jj Y S X dS )z&Return the name of the source package.N)r� � source_pkgrQ � shortname� IndexErrorrJ r r r � source_name� s zVersion.source_namec C s4 z| j jp| jjW S tk r. | jj Y S X dS )z)Return the version of the source package.N)r� � source_verr� r� r� rJ r r r �source_version� s zVersion.source_versionc C s | j jS )z.Return the priority of the package, as string.)r� Z priority_strrJ r r r �priority� s zVersion.priorityc C s | j jjj�| j�S )z�Return the internal policy priority as a number. See apt_preferences(5) for more information about what it means. )rQ rR � _depcacheZpolicyZ get_priorityr� rJ r r r �policy_priority� s zVersion.policy_priorityc C s t | jj�S )z�Return a Record() object for this version. Return a Record() object for this version which provides access to the raw attributes of the candidate version )r) r� �recordrJ r r r r� � s zVersion.recordc G sr g }| j j}|D ]\}zB|| D ]4}g }|D ]}|�t| |�� q*|�t| ||�� q W q tk rj Y qX q|S )a( Return a list of Dependency objects for the given types. Multiple types can be specified. Possible types are: 'Breaks', 'Conflicts', 'Depends', 'Enhances', 'PreDepends', 'Recommends', 'Replaces', 'Suggests' Additional types might be added in the future. )r� � depends_listrS r% r& �KeyError)r �typesr� ZdependsZtype_Z dep_ver_listrh Zdep_orr r r �get_dependencies� s zVersion.get_dependenciesc C s dd� | j jD �S )z3 Return a list of names that this version provides.c S s g | ] }|d �qS )r r )r^ �pr r r r_ � s z$Version.provides.<locals>.<listcomp>)r� Z provides_listrJ r r r �provides� s zVersion.providesc C s | � d�S )z4Return the list of enhances for the package version.ZEnhances�r� rJ r r r �enhances� s zVersion.enhancesc C s | � dd�S )z/Return the dependencies of the package version.rc ZDependsr� rJ r r r � dependencies� s zVersion.dependenciesc C s | � d�S )z-Return the recommends of the package version.Z Recommendsr� rJ r r r � recommends� s zVersion.recommendsc C s | � d�S )z+Return the suggests of the package version.ZSuggestsr� rJ r r r �suggests� s zVersion.suggestsc C s, g }| j jD ]\}}|�t| j|�� q |S )z1Return a list of origins for the package version.)r� r� rS r' rQ )r �originsr~ �_unusedr r r r� s zVersion.originsc C s | j jS )zZReturn the path to the file inside the archive. .. versionadded:: 0.7.10 )r� �filenamerJ r r r r� s zVersion.filenamec C s | j jS )zKReturn the md5sum of the binary. .. versionadded:: 0.7.10 )r� Zmd5_hashrJ r r r �md5 s z Version.md5c C s | j jS )zLReturn the sha1sum of the binary. .. versionadded:: 0.7.10 )r� Z sha1_hashrJ r r r �sha1 s z Version.sha1c C s | j jS )zNReturn the sha256sum of the binary. .. versionadded:: 0.7.10 )r� Z sha256_hashrJ r r r �sha256% s zVersion.sha256c C s t | jd �� �S )z�Get the tasks of the package. A set of the names of the tasks this package belongs to. .. versionadded:: 0.8.0 ZTask)�setr� r� rJ r r r �tasks. s z Version.tasksc c s: | j jD ],\}}| jjj�|�}|r|�| jj�V qdS )zVReturn an iterator over all available urls. .. versionadded:: 0.7.10 N) r� r� rQ rR rz r{ � archive_urir� r� )r r~ r� r r r r �_uris9 s z Version._urisc C s t | �� �S )z^Return a list of all available uris for the binary. .. versionadded:: 0.7.10 )�listr� rJ r r r �urisD s z Version.urisc C s. zt t| �� ��W S tk r( Y dS X dS )zNReturn a single URI for the binary. .. versionadded:: 0.7.10 N)r� r� r� � StopIterationrJ r r r �uriM s z Version.urir� Nc C s@ |dkrt j�dd�}tj�| jj�}tj�||�}t || j | jj �r`t � d| � tj�|�S | jjd \}}| jjj�|�}|s�|r�|js�td| jj| jt|dd�f ��| js�td ��| jj } |s�| j s�td | ��t � |p�t j j �!� �} t j"| | j| | j ||d �} | �#� | j$| j%k�r4t&d | j'| j(f ��tj�|�S ) aC Fetch the binary version of the package. The parameter *destdir* specifies the directory where the package will be fetched to. The parameter *progress* may refer to an apt_pkg.AcquireProgress() object. If not specified or None, apt.progress.text.AcquireProgress() is used. The keyword-only parameter *allow_unauthenticated* specifies whether to allow unauthenticated downloads. If not specified, it defaults to the configuration option `APT::Get::AllowUnauthenticated`. .. versionadded:: 0.7.10 N� APT::Get::AllowUnauthenticatedF�"Ignoring already existing file: %sr �>Could not fetch %s %s source package: Source %r is not trusted�describez<unkown>zNo URI for this binary.�8The item %r could not be fetched: No trusted hash found.��destfile�$The item %r could not be fetched: %s))r2 �config�find_br- r. �basenamer� r� rq r5 r4 r3 �logging�debug�abspathr� r� rQ rR rz r{ r| r8 rL rD �getattrr� � ValueError�usable�Acquire�apt�progress�textr" � AcquireFile�run�status� STAT_DONEr6 r� � error_text) r �destdirr� �allow_unauthenticated�baser� Zpfile�offset�indexr3 �acqZacqfiler r r � fetch_binaryY sH � �� � � �zVersion.fetch_binaryTc C s |dkrt j�dd�}t �� }t �|p0tjj�� �}d}| j }|j pJ| j j } |j pX| jj} |�| �} | r~| |jkr~|�| �} qd| s�td| ��t� } |s�|jjs�td| j j| j|jjf ��|jD ]�} tj� | j�}tj� ||�}| j dkr�|}t || j | j!��rt"�#d| � q�|�s.| j!j$�s.td| ��| �%t j&||j�'| j�| j!| j ||d �� q�|�(� |dk�rxtd| ��|j)D ](}|j*|j+k�r~t,d |j-|j.f ���q~|�r�|j d t �/|j� }tj� ||�}t0�1d d ||g� tj�2|�S tj�2|�S dS )a9 Get the source code of a package. The parameter *destdir* specifies the directory where the source will be fetched to. The parameter *progress* may refer to an apt_pkg.AcquireProgress() object. If not specified or None, apt.progress.text.AcquireProgress() is used. The parameter *unpack* describes whether the source should be unpacked (``True``) or not (``False``). By default, it is unpacked. If *unpack* is ``True``, the path to the extracted directory is returned. Otherwise, the path to the .dsc file is returned. The keyword-only parameter *allow_unauthenticated* specifies whether to allow unauthenticated downloads. If not specified, it defaults to the configuration option `APT::Get::AllowUnauthenticated`. Nr� FzNo source for %rr� r� r� r� r� r� �-z dpkg-sourcez-x)3r2 r� r� � SourceRecordsr� r� r� r r" r� r� rQ r� r� r� r� r� rD r� r� r r| r8 rL r� �filesr- r. r� rq �typer5 r4 r3 r� r� r� rS r r� r �itemsr r r6 r� r Zupstream_version� subprocessZ check_callr� )r r r� Zunpackr �srcr r� r� r� r� Z source_lookupr Zfilr r� �itemZoutdirr r r � fetch_source� sn � �� � � � zVersion.fetch_source)r� NN)r� NTN)3r r r r r r� r= r� r� r� r� r@ r� rK rN re r� r� r� r� r4 r� r� r\ rD r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r* � s� 5 � 6 �r* c @ sd e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z ddd�Z dS )r+ a� Provide a mapping & sequence interface to all versions of a package. This class can be used like a dictionary, where version strings are the keys. It can also be used as a sequence, where integers are the keys. You can also convert this to a dictionary or a list, using the usual way of dict(version_list) or list(version_list). This is useful if you need to access the version objects multiple times, because they do not have to be recreated this way. Examples ('package.versions' being a version list): '0.7.92' in package.versions # Check whether 0.7.92 is a valid version. package.versions[0] # Return first version or raise IndexError package.versions[0:2] # Return a new VersionList for objects 0-2 package.versions['0.7.92'] # Return version 0.7.92 or raise KeyError package.versions.keys() # All keys, as strings. max(package.versions) Nc C s$ || _ |jj| _|r | j| | _d S r )�_packagerU Z version_list� _versions)r rQ Zslice_r r r r � s zVersionList.__init__c C s| t |t�r| �| j|�S zt| j| j| �W S tk rj | jD ]"}|j|krBt| j|� Y S qBY nX td| ��d S )NzVersion: %r not found.) r� �slicerj r r* r r� r� r� �r r �verr r r r � s zVersionList.__getitem__c C s dd� dd� | D �� S )Nz[%s]rk c s s | ]}t |�V qd S r )r< �r^ r r r r ro s z&VersionList.__str__.<locals>.<genexpr>rp rJ r r r rK s zVersionList.__str__c C s d| � � S )Nz<VersionList: %r>)r� rJ r r r rN s zVersionList.__repr__c s � fdd�� j D �S )z*Return an iterator over all value objects.c 3 s | ]}t � j|�V qd S r )r* r r rJ r r ro s z'VersionList.__iter__.<locals>.<genexpr>�r rJ r rJ r r� s zVersionList.__iter__c C s0 t |t�r|j}| jD ]}|j|kr dS qdS rt )r� r* rD r r� r r r r r� s zVersionList.__contains__c C s t | �t |�kS r )r� r> r r r r= " s zVersionList.__eq__c C s t | j�S r )r� r rJ r r r r� & s zVersionList.__len__c C s dd� | j D �S )z*Return a list of all versions, as strings.c S s g | ] }|j �qS r )r� r r r r r_ / s z$VersionList.keys.<locals>.<listcomp>r rJ r r r r� , s zVersionList.keysc C s( z | | W S t k r" | Y S X dS )z Return the key or the default.N)r� r� r r r r� 1 s zVersionList.get)N)N)r r r r r r rK rN r� r� r= r� r� r� r r r r r+ � s r+ c @ s� e Zd ZdZdd� Zdd� Zdd� Zdd � Zed d � �Z e j d d � �Z ed d� �Z edd� �Z edd� �Z edd� �Zedd� �Zedd� �Zdd� Zedd � �Zed d � �Zed d � �Zed!d"� �Zed#d$� �Zed%d&� �Zed'd(� �Zed)d*� �Zed+d,� �Zed-d.� �Zed/d0� �Z dJd2d3�Z ed4d5� �Z ed6d7� �Z ed8d9� �Z ed:d;� �Z!d<d=� Z"dKd@dA�Z#dLdBdC�Z$dMdDdE�Z%dNdFdG�Z&dHdI� Z'd1S )Or( z�Representation of a package in a cache. This class provides methods and properties for working with a package. It lets you mark the package for installation, check if it is installed, and much more. c C s || _ || _d| _dS )z Init the Package object r� N)rU rR � _changelog)r ZpcacheZpkgiterr r r r B s zPackage.__init__c C s | j S r �rL rJ r r r rK I s zPackage.__str__c C s d| j j| j j| j jf S )Nz(<Package: name:%r architecture=%r id:%r>)rU rL r� r� rJ r r r rN M s �zPackage.__repr__c C s | j |j k S r r r> r r r r� R s zPackage.__lt__c C s& | j j�| j�}|dk r"t| |�S dS )z�Return the candidate version of the package. This property is writeable to allow you to set the candidate version of the package. Just assign a Version() object, and it will be set as the candidate version. N)rR r� Zget_candidate_verrU r* )r r� r r r � candidateV s zPackage.candidatec C s, | j �� | j j�| j|j� | j �� dS )z)Set the candidate version of the package.N)rR �cache_pre_changer� Zset_candidate_verrU r� �cache_post_change)r rD r r r r d s c C s | j jdk rt| | j j�S dS )z`Return the currently installed version of the package. .. versionadded:: 0.7.9 N)rU � current_verr* rJ r r r r� l s zPackage.installedc C s | j �d�S )a} Return the name of the package, possibly including architecture. If the package is not part of the system's preferred architecture, return the same as :attr:`fullname`, otherwise return the same as :attr:`shortname` .. versionchanged:: 0.7.100.3 As part of multi-arch, this field now may include architecture information. T�rU Z get_fullnamerJ r r r rL w s z Package.namec C s | j �d�S )z�Return the name of the package, including architecture. Note that as for :meth:`architecture`, this returns the native architecture for Architecture: all packages. .. versionadded:: 0.7.100.3Fr# rJ r r r r� � s zPackage.fullnamec C s | j jS )zZReturn the name of the package, without architecture. .. versionadded:: 0.7.100.3)rU rL rJ r r r r� � s zPackage.shortnamec C s | j jS )znReturn a uniq ID for the package. This can be used eg. to store additional information about the pkg.)rU r� rJ r r r r� � s z Package.idc C s | j jS )z>Return True if the package is an essential part of the system.)rU � essentialrJ r r r r$ � s zPackage.essentialc C s | j jS )a Return the Architecture of the package. Note that for Architecture: all packages, this returns the native architecture, as they are internally treated like native packages. To get the concrete architecture, look at the :attr:`Version.architecture` attribute. .. versionchanged:: 0.7.100.3 This is now the package's architecture in the multi-arch sense, previously it was the architecture of the candidate version and deprecated. )rU r� rJ r r r r� � s zPackage.architecturec C s | j j�| j�S )z5Return ``True`` if the package is marked for install.)rR r� �marked_installrU rJ r r r r% � s zPackage.marked_installc C s | j j�| j�S )z5Return ``True`` if the package is marked for upgrade.)rR r� �marked_upgraderU rJ r r r r& � s zPackage.marked_upgradec C s | j j�| j�S )z4Return ``True`` if the package is marked for delete.)rR r� � marked_deleterU rJ r r r r' � s zPackage.marked_deletec C s | j j�| j�S )z2Return ``True`` if the package is marked for keep.)rR r� � marked_keeprU rJ r r r r( � s zPackage.marked_keepc C s | j j�| j�S )z! Package is marked for downgrade )rR r� �marked_downgraderU rJ r r r r) � s zPackage.marked_downgradec C s | j j�| j�S )z7Return ``True`` if the package is marked for reinstall.)rR r� �marked_reinstallrU rJ r r r r* � s zPackage.marked_reinstallc C s | j jdk S )z,Return ``True`` if the package is installed.N)rU r" rJ r r r r\ � s zPackage.is_installedc C s | j o| jj�| j�S )z-Return ``True`` if the package is upgradable.)r\ rR r� � is_upgradablerU rJ r r r r+ � s �zPackage.is_upgradablec C s | j s | jo| jj�| j�S )z�Return ``True`` if the package is no longer required. If the package has been installed automatically as a dependency of another package, and if no packages depend on it anymore, the package is no longer required. )r\ r% rR r� Z is_garbagerU rJ r r r �is_auto_removable� s �zPackage.is_auto_removablec C s | j j�| j�S )z@Return whether the package is marked as automatically installed.)rR r� �is_auto_installedrU rJ r r r r- � s zPackage.is_auto_installedc C st | j | jfD ]b}d| }z<t|d��(}|�� �d��d�W 5 Q R � W S Q R X W q tk rl Y q Y q X q g S )z�Return a list of files installed by the package. Return a list of unicode names of the files which have been installed by this package z/var/lib/dpkg/info/%s.list�rbr� r� )rL r� r1 �readr� r� �EnvironmentError)r rL r. r� r r r �installed_files� s 0 zPackage.installed_filesNc C s� | j dkr| j S | js td�S |dkrv| jjd jdkr>d}n8| jjd jdkrVd}n td�}t|t�rl|S |�d �S | jj}d }| jj }| jj }z t � � }W n t k r� Y nTX |�|��r|js�q�| jj |jkr�|j}|j }�qt �|j|�dkr�|j}|j }q�|�d d �} t| �d k�r(| d }~ |d } |�d ��rJd |d } |�dd �} t| �d k�rvd�| d d� �}~ ||| ||d� }t�� } �z �z@t�d� |�r�|�� �r�W W ���dS t|�} d}dt�|� }|�r�|�� �r�W W ���dS | � � }|�s�q�|�d �}t� ||�}|�r�t | j dd�}|�rRd|k�rR|�dd �d }|� d �}|�r|d|k�r||�dd �d }|�r�t �||�dk�r��q�||7 }�q�t|�dk�r�td�}t|t��s�|�d �}|| _ W n� t!k �rF | jjd jdk�rtd�||f }ntd�}t|t��r0| Y W �hS |�d � Y W �VS Y nL t"t#fk �r� td�}t|t��rz| Y W � S |�d � Y W � S Y nX W 5 t�| � X | j S )a� Download the changelog of the package and return it as unicode string. The parameter *uri* refers to the uri of the changelog file. It may contain multiple named variables which will be substitued. These variables are (src_section, prefix, src_pkg, src_ver). An example is the Ubuntu changelog:: "http://changelogs.ubuntu.com/changelogs/pool" \ "/%(src_section)s/%(prefix)s/%(src_pkg)s" \ "/%(src_pkg)s_%(src_ver)s/changelog" The parameter *cancel_lock* refers to an instance of threading.Event, which if set, prevents the download. r� z$The list of changes is not availableNr ZDebianzshttp://packages.debian.org/changelogs/pool/%(src_section)s/%(prefix)s/%(src_pkg)s/%(src_pkg)s_%(src_ver)s/changelogZUbuntuzuhttp://changelogs.ubuntu.com/changelogs/pool/%(src_section)s/%(prefix)s/%(src_pkg)s/%(src_pkg)s_%(src_ver)s/changelogr� �main�/r� �libr, �:)� src_section�prefix�src_pkg�src_verr� z^%s \((.*)\)(.*)$rD z�The list of changes is not available yet. Please use http://launchpad.net/ubuntu/+source/%s/%s/+changelog until the changes become available or try again later.zOFailed to download the list of changes. Please check your Internet connection.)$r r r� r� rx r� r� r� r� r� r� r2 r � SystemErrorr� rD r� r� r� r� rq �socketZgetdefaulttimeoutZsetdefaulttimeoutZis_setr �re�escape�readline�matchr� r� �groupr �IOErrorr )r r� Z cancel_lock�resr8 r6 r� r9 Z src_recordsZ section_splitr7 Z src_ver_splitZtimeoutZchangelog_fileZ changelogZregexpZline_rawr� r? r� Z changelog_verr r r � get_changelog s� � �� � zPackage.get_changelogc C s t | �S )zcReturn a VersionList() object for all available versions. .. versionadded:: 0.7.9 )r+ rJ r r r �versions� s zPackage.versionsc C s | j j�| j�S )z5Return True if the to-be-installed package is broken.)rR r� �is_inst_brokenrU rJ r r r rE � s zPackage.is_inst_brokenc C s | j j�| j�S )z/Return True if the installed package is broken.)rR r� � is_now_brokenrU rJ r r r rF � s zPackage.is_now_brokenc C s | j jtjkS )z8Checks whether the package is is the config-files state.)rU Z current_stater2 ZCURSTATE_CONFIG_FILESrJ r r r �has_config_files� s zPackage.has_config_filesc C s( | j �� | j j�| j� | j �� dS )zMark a package for keep.N)rR r r� � mark_keeprU r! rJ r r r rH � s zPackage.mark_keepTFc C sv | j �� | j j�| j|� |rh| j jjdkrht�| j j�}|�| j� |� | j� |� | j� |� � | j � � dS )a+ Mark a package for deletion. If *auto_fix* is ``True``, the resolver will be run, trying to fix broken packages. This is the default. If *purge* is ``True``, remove the configuration files of the package as well. The default is to keep the configuration. r N) rR r r� � mark_deleterU � broken_countr2 �ProblemResolver�clear�protect�remove�resolver! )r �auto_fix�purgeZfixr r r rI � s zPackage.mark_deletec C sn | j �� | j j�| j||� |r`| j jjdkr`t�| j j�}|�| j� |� | j� |� d� | j � � dS )a0 Mark a package for install. If *autoFix* is ``True``, the resolver will be run, trying to fix broken packages. This is the default. If *autoInst* is ``True``, the dependencies of the packages will be installed automatically. This is the default. If *fromUser* is ``True``, this package will not be marked as automatically installed. This is the default. Set it to False if you want to be able to automatically remove the package at a later stage when no other package depends on it. r TN) rR r r� � mark_installrU rJ r2 rK rL rM rO r! )r rP Z auto_inst� from_userZfixerr r r rR � s zPackage.mark_installc C s< | j r$| j}| j|d� | �|� ntj�d| jj � dS )zMark a package for upgrade.)rS z4MarkUpgrade() called on a non-upgradeable pkg: '%s' N) r+ r- rR � mark_auto�sys�stderr�writerU rL )r rS �autor r r � mark_upgrade s �zPackage.mark_upgradec C s | j j�| j|� dS )a Mark a package as automatically installed. Call this function to mark a package as automatically installed. If the optional parameter *auto* is set to ``False``, the package will not be marked as automatically installed anymore. The default is ``True``. N)rR r� rT rU )r rX r r r rT s zPackage.mark_autoc C s | j j�||� dS )a Commit the changes. The parameter *fprogress* refers to a apt_pkg.AcquireProgress() object, like apt.progress.text.AcquireProgress(). The parameter *iprogress* refers to an InstallProgress() object, as found in apt.progress.base. N)rR r� �commit)r Z fprogressZ iprogressr r r rZ & s zPackage.commit)NN)TF)TTT)T)T)(r r r r r rK rN r� re r �setterr� rL r� r� r� r$ r� r% r& r' r( r) r* r\ r+ r, r- r1 rC rD rE rF rG rH rI rR rY rT rZ r r r r r( : sx / r( c C s� t d� ddl} t�� tjj�� }t�|�}|d }t d|j � t d|j � t d|j j � t d|j j � t d |j j � t d |j j � t d |j j � t d |j j � t d |j j � t d|j � t d|j j � t d|j j � t d|j j � t d|j j � t d|j j � t d|j j � t d|j j � |j jD ] }t d�dd� |jD ��� �qHt d|j j � t d|j j � t d|j j � t |d � � � d D ]`}t d |� |D ]*}|j �r�| �!dd �d k�r�|�"|� �q�t d |j#j$ � t d!|j#j% � �q�t � d D ]�}t d"| � t�|�}|�&� D ]N}| �!dd �d k�r:z|| �'|� W n" t(k �r� t d#| � Y nX �q:t d |j#j$ � t d$|j#j) � �qdS )%z Self-test.z Self-test for the Package modulr Nz apt-utilsz Name: %s zID: %s zPriority (Candidate): %s zPriority (Installed): %s zInstalled: %s zCandidate: %s zCandidateDownloadable: %szCandidateOrigins: %szSourcePkg: %s z Section: %s z Summary: %sz Description (formatted) : %sz Description (unformatted): %szInstalledSize: %s zPackageSize: %s zDependencies: %szRecommends: %s�,c s s& | ] }d |j |j|j|jf V qdS )z%s (%s) (%s) (%s)N)rL rD rM rd )r^ �or r r ro N s ��z_test.<locals>.<genexpr>zarch: %sz homepage: %szrec: Z2vcard)TFz8Running install on random upgradable pkgs with AutoFix: r� z Broken: %s zInstCount: %s z.Randomly remove some packages with AutoFix: %szError trying to remove: %s z DelCount: %s )*�print�randomr2 Zinitr� r� r Z OpProgressZCacherL r� r r� r� rD r� r� r� r� r� r� r� r� r4 r� r� rq rr r� r� r� rC r+ ZrandintrR r� rJ Z inst_countr� rI r: Z del_count)r_ r� rV rW rE �irL r r r �_test3 sf � ra �__main__)>r Z __future__r r� r- rU r< r; r Z threadingZ http.clientr Z urllib.errorr Zurllib.requestr � ImportErrorZhttplibZurllib2�typingr r r r r r r r r r r r � collections�objectr r� r2 Zapt.progress.textr� Zapt.progress.baser" r# r$ r� �__all__� version_info�majorr< r� r5 � Exceptionr6 r8 r% r& r' r) r* r+ r( ra r r r r r �<module> s� 8 S%D !Z | :