← Back
Editing: __init__.cpython-38.pyc
U �OX = � @ s� d Z ddlmZmZ ddlZddlZddlZejdk r<dZndZe Z dd� Z ze Z W n ek rp d d � Z Y nX d d � ZeG d d� de��Ze� ZG dd� de�ZeG dd� de��Zdd� Zdd� ZddlmZ dddgZdS )z0 Versions for Python packages. See L{Version}. � )�division�absolute_importN)� r FTc C s` t | ttf�std| ��tr>t | t�r2| �d�S | �d� n t | t�rR| �d�S | �d� | S )a Convert C{bytes} or C{unicode} to the native C{str} type, using ASCII encoding if conversion is necessary. @raise UnicodeError: The input string is not ASCII encodable/decodable. @raise TypeError: The input is neither C{bytes} nor C{unicode}. z %r is neither bytes nor unicode�ascii)� isinstance�bytes�unicode� TypeError�_PY3�decode�encode)�s� r �6/usr/lib/python3/dist-packages/incremental/__init__.py� _nativeString s r c C s | |k r dS | |krdS dS dS )z� Compare two objects. Returns a negative number if C{a < b}, zero if they are equal, and a positive number if C{a > b}. ���r � Nr )�a�br r r �_cmp7 s r c C s` t s| S dd� }dd� }dd� }dd� }d d � }d d � }|| _|| _|| _|| _|| _|| _| S ) z� Class decorator that ensures support for the special C{__cmp__} method. On Python 2 this does nothing. On Python 3, C{__eq__}, C{__lt__}, etc. methods are added to the class, relying on C{__cmp__} to implement their comparisons. c S s | � |�}|tkr|S |dkS �Nr ��__cmp__�NotImplemented��self�other�cr r r �__eq__S s z_comparable.<locals>.__eq__c S s | � |�}|tkr|S |dkS r r r r r r �__ne__Y s z_comparable.<locals>.__ne__c S s | � |�}|tkr|S |dk S r r r r r r �__lt___ s z_comparable.<locals>.__lt__c S s | � |�}|tkr|S |dkS r r r r r r �__le__e s z_comparable.<locals>.__le__c S s | � |�}|tkr|S |dkS r r r r r r �__gt__k s z_comparable.<locals>.__gt__c S s | � |�}|tkr|S |dkS r r r r r r �__ge__q s z_comparable.<locals>.__ge__)r r r" r! r# r r )�klassr r r r! r" r# r r r � _comparableF s r% c @ s e Zd ZdZdd� ZdS )�_infz: An object that is bigger than all other objects. c C s |t kr dS dS )z� @param other: Another object. @type other: any @return: 0 if other is inf, 1 otherwise. @rtype: C{int} r r )r& )r r r r r r � s z _inf.__cmp__N)�__name__� __module__� __qualname__�__doc__r r r r r r& � s r& c @ s e Zd ZdZdS )�IncomparableVersionsz- Two versions could not be compared. N)r' r( r) r* r r r r r+ � s r+ c @ s� e Zd ZdZd#dd�Zedd� �Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dd� Z dd� Zdd� Zdd� Zdd � ZeZeZd d � Zd d � Zd!d"� ZdS )$�Versiona* An encapsulation of a version for a project, with support for outputting PEP-440 compatible version strings. This class supports the standard major.minor.micro[rcN] scheme of versioning, with support for "local versions" which may include a SVN revision or Git SHA1 hash. Nc C sv |r|rt d��n |r.|s.|}tjdtdd� |dkrN|sF|sF|sF|rNt d��|| _|| _|| _|| _|| _|| _ dS )a� @param package: Name of the package that this is a version of. @type package: C{str} @param major: The major version number. @type major: C{int} or C{str} (for the "NEXT" symbol) @param minor: The minor version number. @type minor: C{int} @param micro: The micro version number. @type micro: C{int} @param release_candidate: The release candidate number. @type release_candidate: C{int} @param prerelease: The prerelease number. (Deprecated) @type prerelease: C{int} @param dev: The development release number. @type dev: C{int} z Please only return one of these.zvPassing prerelease to incremental.Version was deprecated in Incremental 16.9.0. Please pass release_candidate instead.� �� stacklevel�NEXTz;When using NEXT, all other values except Package must be 0.N) � ValueError�warnings�warn�DeprecationWarning�package�major�minor�micro�release_candidate�dev)r r5 r6 r7 r8 r9 � prereleaser: r r r �__init__� s" �zVersion.__init__c C s t jdtdd�f | jS )NzuAccessing incremental.Version.prerelease was deprecated in Incremental 16.9.0. Use Version.release_candidate instead.r- r. )r2 r3 r4 r9 �r r r r r; � s �zVersion.prereleasec C sB | � � }| �� }|s2| �� }|r>|dt|� 7 }n |d| 7 }|S )zx Return a string in canonical short version format, <major>.<minor>.<micro>[+rSVNVer/+gitsha1]. z+r�+)�base�_getGitVersion�_getSVNVersionr )r r �gitver�svnverr r r �short� s z Version.shortc C s | � � S )aT Return a PEP440-compatible "local" representation of this L{Version}. This includes a SVN revision or Git commit SHA1 hash, if available. Examples: - 14.4.0+r1223 - 1.2.3rc1+rb2e812003b5d5fcf08efd1dffed6afa98d44ac8c - 12.10.1 - 3.4.8rc2 - 11.93.0rc1dev3 )rD r= r r r �local� s z Version.localc C s | � � S )z� Return a PEP440-compatible "public" representation of this L{Version}. Examples: - 14.4.0 - 1.2.3rc1 - 14.2.1rc1dev9 - 16.04.0dev0 )r? r= r r r �public� s zVersion.publicc C s` | j dkr| j S | jdkr d}n d| jf }| jdkr<d}n d| jf }d| j | j| j||f S )zF Like L{short}, but without the +rSVNVer or @gitsha1. r0 N� zrc%szdev%sz %r.%d.%d%s%s)r6 r9 r: r7 r8 )r Zrcr: r r r r? s �z Version.basec C s� | � � }|rd| }| �� }|r(d| }| jd kr8d}n d| jf }| jd krTd}n d| jf }d| jj| j| j| j| j |||p�|f S )Nz #rG z, release_candidate=%rz, dev=%rz%s(%r, %r, %d, %d%s%s)%s) �_formatGitVersion�_formatSVNVersionr9 r: � __class__r' r5 r6 r7 r8 )r rB rC r9 r: r r r �__repr__ s0 � �zVersion.__repr__c C s d| j | �� f S )Nz[%s, version %s]�r5 rD r= r r r �__str__: s �zVersion.__str__c C s� t || j�stS | j�� |j�� kr8td| j|jf ��| jdkrHt}n| j}| jdkr^t}n| j}| j dkrtt}n| j }|jdkr�t}n|j}|jdkr�t}n|j}|j dkr�t}n|j }t || j | j ||f||j |j ||f�}|S )a� Compare two versions, considering major versions, minor versions, micro versions, then release candidates. Package names are case insensitive. A version with a release candidate is always less than a version without a release candidate. If both versions have release candidates, they will be included in the comparison. @param other: Another version. @type other: L{Version} @return: NotImplemented when the other object is not a Version, or one of -1, 0, or 1. @raise IncomparableVersions: when the package names of the versions differ. z%r != %rr0 N) r rJ r r5 �lowerr+ r6 r& r9 r: r r7 r8 ) r r r6 r9 r: Z othermajorZotherrcZotherdev�xr r r r ? sL � ��� zVersion.__cmp__c C s� t j�t j�|d��}t|d��}|�� �� }W 5 Q R X |�d�r�tt j�t j�||�d�d ���� }|�� }|�� W 5 Q R � S Q R X |S )NZHEAD�rzref: � r ) �os�path�abspath�join�open�read�strip� startswith�split)r Z directoryZheadFile�fZ headContentZcommitr r r � _parseGitDir� s ��zVersion._parseGitDirc C s� t j�| j�}|r�tj�|j�}tj�tj� |d��}dt� |�krX| � tj� |d��S tj�tj� |d��}||krzdS dt� |�kr�| � tj� |d��S |}qXdS )zQ Given a package directory, walk up and find the git commit sha. z..z.gitN) �sys�modules�getr5 rR rS �dirname�__file__rT rU �listdirr\ )r �modZbasepathZupOneZ upOneMorer r r r@ � s zVersion._getGitVersionc C sP ddl m} ||�j}|jD ].}t|d�r |�d�}|dk r |�d� S q dS )z� Given a readable file object which represents a .svn/entries file in format version 4, return the revision as a string. We do this by reading first XML element in the document that has a 'revision' attribute. r )�parse� getAttributeZrevisionNr )Zxml.dom.minidomrd ZdocumentElementZ childNodes�hasattrre r )r � entriesFilerd �docZnodeZrevr r r �_parseSVNEntries_4� s zVersion._parseSVNEntries_4c C s$ |� � |� � |� � |� � �� S )z� Given a readable file object which represents a .svn/entries file in format version 8, return the revision as a string. )�readlinerX )r rg r r r �_parseSVNEntries_8� s zVersion._parseSVNEntries_8c C s� t j�| j�}|r�tj�tj�|j�d�}tj� |�s:dS tj�|d�}tj� |�r�t |d��}|� � � � }W 5 Q R X t | d|�d� d�}n| j}|dkr�dS tj�|d�}t |d�}z z||�W �W S |�� X W n Y dS X dS ) a? Figure out the SVN revision number based on the existence of <package>/.svn/entries, and its contents. This requires discovering the format version from the 'format' file and parsing the entries file accordingly. @return: None or string containing SVN Revision number. z.svnN�format�rbZ_parseSVNEntries_r s Unknown�entries)r] r^ r_ r5 rR rS rU r` ra �existsrV rW rX �getattrr �_parseSVNEntriesTenPlus�close) r rc ZsvnZ formatFileZfObjrl �parserrg rn r r r rA � s0 � zVersion._getSVNVersionc C s | � � }|d krdS d|f S )NrG z (SVN r%s))rA �r Zverr r r rI � s zVersion._formatSVNVersionc C s | � � }|d krdS d|f S )NrG z (Git %s))r@ rt r r r rH � s zVersion._formatGitVersion)NNN)r' r( r) r* r< �propertyr; rD rE rF r? rK rM r r\ r@ ri rk Z_parseSVNEntries_9rq rA rI rH r r r r r, � s. � ' B *r, c C s d| j | �� f }|S )z� Get a friendly string for the given version object. @param version: A L{Version} object. @return: A string containing the package and short version number. z%s %srL )�version�resultr r r �getVersionString� s rx c C s� |sdS ddl m} |�| �}|�� |�� D ]P}|d dkr.i }t|d ��}t|�� |� W 5 Q R X |d �� | j_ dS q.t d��dS ) zF Get the version from the package listed in the Distribution. Nr )�build_pyr �_versionr- � __version__zNo _version.py found.) Zdistutils.commandry Zfinalize_optionsZfind_all_modulesrV �execrW rF Zmetadatarv � Exception)Zdist�keyword�valuery Z sp_command�itemZ version_filer[ r r r � _get_version s r� r )r{ r{ )r* Z __future__r r rR r] r2 � version_infor �strr r Zcmpr � NameErrorr% �objectr& r r+ r, rx r� rz r{ �__all__r r r r �<module> s4 > b
Save File
Cancel