a
    hbòfÈ|  ã                   @   sX  d dl mZmZmZ d dlZd dlZd dlZd dlZddlm	Z	m
Z
 ddlmZ ddlmZ ddlmZmZmZ erÊd dlmZmZmZmZmZmZmZmZmZ eeef Zeeeef Zeeege f Z!G d	d
„ d
e"ƒZ#G dd„ de
ej$e%ƒƒZ&G dd„ de&ƒZ'G dd„ de'ƒZ(dd„ Z)G dd„ de'ƒZ*e +d¡Z,dd„ Z-dd„ Z.G dd„ de&ƒZ/dS )é    )Úabsolute_importÚdivisionÚprint_functionNé   )Ústring_typesÚwith_metaclass)ÚTYPE_CHECKING)Úcanonicalize_version)ÚVersionÚLegacyVersionÚparse)	ÚListÚDictÚUnionÚIterableÚIteratorÚOptionalÚCallableÚTupleÚ	FrozenSetc                   @   s   e Zd ZdZdS )ÚInvalidSpecifierzH
    An invalid specifier was found, users should refer to PEP 440.
    N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__© r   r   úd/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/setuptools/_vendor/packaging/specifiers.pyr   "   s   r   c                   @   s€   e Zd Zejdd„ ƒZejdd„ ƒZejdd„ ƒZejdd„ ƒZej	d	d
„ ƒZ
e
jdd
„ ƒZ
ejddd„ƒZejddd„ƒZdS )ÚBaseSpecifierc                 C   s   dS )zŽ
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        Nr   ©Úselfr   r   r   Ú__str__)   s    zBaseSpecifier.__str__c                 C   s   dS )zF
        Returns a hash value for this Specifier like object.
        Nr   r   r   r   r   Ú__hash__1   s    zBaseSpecifier.__hash__c                 C   s   dS )zq
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        Nr   ©r   Úotherr   r   r   Ú__eq__8   s    zBaseSpecifier.__eq__c                 C   s   dS )zu
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        Nr   r"   r   r   r   Ú__ne__@   s    zBaseSpecifier.__ne__c                 C   s   dS )zg
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr   r   r   r   r   ÚprereleasesH   s    zBaseSpecifier.prereleasesc                 C   s   dS )zd
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr   ©r   Úvaluer   r   r   r&   P   s    Nc                 C   s   dS )zR
        Determines if the given item is contained within this specifier.
        Nr   ©r   Úitemr&   r   r   r   ÚcontainsX   s    zBaseSpecifier.containsc                 C   s   dS )z•
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        Nr   )r   Úiterabler&   r   r   r   Úfilter_   s    zBaseSpecifier.filter)N)N)r   r   r   ÚabcÚabstractmethodr    r!   r$   r%   Úabstractpropertyr&   Úsetterr+   r-   r   r   r   r   r   (   s    





r   c                   @   s¬   e Zd Zi Zd"dd„Zdd„ Zdd„ Zed	d
„ ƒZdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ Zedd„ ƒZedd„ ƒZedd„ ƒZejdd„ ƒZdd„ Zd#dd„Zd$d d!„ZdS )%Ú_IndividualSpecifierÚ Nc                 C   sF   | j  |¡}|std |¡ƒ‚| d¡ ¡ | d¡ ¡ f| _|| _d S )NzInvalid specifier: '{0}'ÚoperatorÚversion)Ú_regexÚsearchr   ÚformatÚgroupÚstripÚ_specÚ_prereleases)r   Úspecr&   Úmatchr   r   r   Ú__init__l   s    þz_IndividualSpecifier.__init__c                 C   s0   | j d urd | j¡nd}d | jjt| ƒ|¡S )Nú, prereleases={0!r}r3   z<{0}({1!r}{2})>)r<   r8   r&   Ú	__class__r   Ústr©r   Úprer   r   r   Ú__repr__z   s
    ÿýz_IndividualSpecifier.__repr__c                 C   s   dj | jŽ S )Nz{0}{1})r8   r;   r   r   r   r   r    „   s    z_IndividualSpecifier.__str__c                 C   s   | j d t| j d ƒfS )Nr   r   )r;   r	   r   r   r   r   Ú_canonical_specˆ   s    z$_IndividualSpecifier._canonical_specc                 C   s
   t | jƒS ©N)ÚhashrF   r   r   r   r   r!   �   s    z_IndividualSpecifier.__hash__c                 C   sR   t |tƒr6z|  t|ƒ¡}W qF ty2   t Y S 0 nt || jƒsFtS | j|jkS rG   )Ú
isinstancer   rA   rB   r   ÚNotImplementedrF   r"   r   r   r   r$   ‘   s    
z_IndividualSpecifier.__eq__c                 C   sR   t |tƒr6z|  t|ƒ¡}W qF ty2   t Y S 0 nt || jƒsFtS | j|jkS rG   )rI   r   rA   rB   r   rJ   r;   r"   r   r   r   r%   �   s    
z_IndividualSpecifier.__ne__c                 C   s   t | d | j| ¡ƒ}|S )Nz_compare_{0})Úgetattrr8   Ú
_operators)r   ÚopÚoperator_callabler   r   r   Ú_get_operator©   s    ÿz"_IndividualSpecifier._get_operatorc                 C   s   t |ttfƒst|ƒ}|S rG   )rI   r   r
   r   ©r   r5   r   r   r   Ú_coerce_version°   s    z$_IndividualSpecifier._coerce_versionc                 C   s
   | j d S )Nr   ©r;   r   r   r   r   r4   ¶   s    z_IndividualSpecifier.operatorc                 C   s
   | j d S )Nr   rR   r   r   r   r   r5   »   s    z_IndividualSpecifier.versionc                 C   s   | j S rG   ©r<   r   r   r   r   r&   À   s    z _IndividualSpecifier.prereleasesc                 C   s
   || _ d S rG   rS   r'   r   r   r   r&   Å   s    c                 C   s
   |   |¡S rG   ©r+   ©r   r*   r   r   r   Ú__contains__Ê   s    z!_IndividualSpecifier.__contains__c                 C   s>   |d u r| j }|  |¡}|jr&|s&dS |  | j¡}||| jƒS ©NF)r&   rQ   Úis_prereleaserO   r4   r5   )r   r*   r&   Únormalized_itemrN   r   r   r   r+   Î   s    

z_IndividualSpecifier.containsc                 c   s„   d}g }d|d ur|ndi}|D ]F}|   |¡}| j|fi |¤Žr |jr\|s\| js\| |¡ q d}|V  q |s€|r€|D ]
}|V  qtd S )NFr&   T)rQ   r+   rX   r&   Úappend)r   r,   r&   ÚyieldedÚfound_prereleasesÚkwr5   Úparsed_versionr   r   r   r-   ä   s"    
ÿÿz_IndividualSpecifier.filter)r3   N)N)N)r   r   r   rL   r?   rE   r    ÚpropertyrF   r!   r$   r%   rO   rQ   r4   r5   r&   r1   rV   r+   r-   r   r   r   r   r2   h   s,   







r2   c                   @   sv   e Zd ZdZe de d ejejB ¡Zdddddd	d
œZ	dd„ Z
dd„ Zdd„ Zdd„ Zdd„ Zdd„ Zdd„ ZdS )ÚLegacySpecifieraÛ  
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        ú^\s*ú\s*$ÚequalÚ	not_equalÚless_than_equalÚgreater_than_equalÚ	less_thanÚgreater_than)ú==ú!=ú<=ú>=ú<ú>c                 C   s   t |tƒstt|ƒƒ}|S rG   )rI   r   rB   rP   r   r   r   rQ      s    
zLegacySpecifier._coerce_versionc                 C   s   ||   |¡kS rG   ©rQ   ©r   Úprospectiver=   r   r   r   Ú_compare_equal&  s    zLegacySpecifier._compare_equalc                 C   s   ||   |¡kS rG   ro   rp   r   r   r   Ú_compare_not_equal*  s    z"LegacySpecifier._compare_not_equalc                 C   s   ||   |¡kS rG   ro   rp   r   r   r   Ú_compare_less_than_equal.  s    z(LegacySpecifier._compare_less_than_equalc                 C   s   ||   |¡kS rG   ro   rp   r   r   r   Ú_compare_greater_than_equal2  s    z+LegacySpecifier._compare_greater_than_equalc                 C   s   ||   |¡k S rG   ro   rp   r   r   r   Ú_compare_less_than6  s    z"LegacySpecifier._compare_less_thanc                 C   s   ||   |¡kS rG   ro   rp   r   r   r   Ú_compare_greater_than:  s    z%LegacySpecifier._compare_greater_thanN)r   r   r   Ú
_regex_strÚreÚcompileÚVERBOSEÚ
IGNORECASEr6   rL   rQ   rr   rs   rt   ru   rv   rw   r   r   r   r   r`     s    ú	r`   c                    s   t  ˆ ¡‡ fdd„ƒ}|S )Nc                    s   t |tƒsdS ˆ | ||ƒS rW   )rI   r
   rp   ©Úfnr   r   ÚwrappedC  s    
z)_require_version_compare.<locals>.wrapped)Ú	functoolsÚwraps)r~   r   r   r}   r   Ú_require_version_compare?  s    r‚   c                	   @   s¸   e Zd ZdZe de d ejejB ¡Zdddddd	d
ddœZ	e
dd„ ƒZe
dd„ ƒZe
dd„ ƒZe
dd„ ƒZe
dd„ ƒZe
dd„ ƒZe
dd„ ƒZdd„ Zedd„ ƒZejdd„ ƒZd S )!Ú	Specifiera  
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        ra   rb   Ú
compatiblerc   rd   re   rf   rg   rh   Ú	arbitrary)ú~=ri   rj   rk   rl   rm   rn   ú===c                 C   sN   d  tt dd„ t|ƒ¡ƒd d… ¡}|d7 }|  d¡||ƒoL|  d¡||ƒS )NÚ.c                 S   s   |   d¡ o|   d¡ S )NÚpostÚdev)Ú
startswith©Úxr   r   r   Ú<lambda>É  ó    z/Specifier._compare_compatible.<locals>.<lambda>éÿÿÿÿú.*rl   ri   )ÚjoinÚlistÚ	itertoolsÚ	takewhileÚ_version_splitrO   )r   rq   r=   Úprefixr   r   r   Ú_compare_compatible¹  s    þÿûÿ
ÿzSpecifier._compare_compatiblec           	      C   sz   |  d¡rVt|jƒ}t|d d… ƒ}tt|ƒƒ}|d t|ƒ… }t||ƒ\}}||kS t|ƒ}|jsnt|jƒ}||kS d S )Nr‘   éþÿÿÿ)Úendswithr
   Úpublicr–   rB   ÚlenÚ_pad_versionÚlocal)	r   rq   r=   Ú
split_specÚsplit_prospectiveÚshortened_prospectiveÚpadded_specÚpadded_prospectiveÚspec_versionr   r   r   rr   Ö  s    

ÿ
zSpecifier._compare_equalc                 C   s   |   ||¡ S rG   )rr   rp   r   r   r   rs   ÿ  s    zSpecifier._compare_not_equalc                 C   s   t |jƒt |ƒkS rG   ©r
   r›   rp   r   r   r   rt     s    z"Specifier._compare_less_than_equalc                 C   s   t |jƒt |ƒkS rG   r¥   rp   r   r   r   ru     s    z%Specifier._compare_greater_than_equalc                 C   s<   t |ƒ}||k sdS |js8|jr8t |jƒt |jƒkr8dS dS ©NFT)r
   rX   Úbase_version©r   rq   Úspec_strr=   r   r   r   rv     s    zSpecifier._compare_less_thanc                 C   s^   t |ƒ}||ksdS |js8|jr8t |jƒt |jƒkr8dS |jd urZt |jƒt |jƒkrZdS dS r¦   )r
   Úis_postreleaser§   rž   r¨   r   r   r   rw   1  s    
zSpecifier._compare_greater_thanc                 C   s   t |ƒ ¡ t |ƒ ¡ kS rG   )rB   Úlowerrp   r   r   r   Ú_compare_arbitraryR  s    zSpecifier._compare_arbitraryc                 C   sR   | j d ur| j S | j\}}|dv rN|dkr@| d¡r@|d d… }t|ƒjrNdS dS )N)ri   rl   rk   r†   r‡   ri   r‘   r™   TF)r<   r;   rš   r   rX   )r   r4   r5   r   r   r   r&   V  s    


zSpecifier.prereleasesc                 C   s
   || _ d S rG   rS   r'   r   r   r   r&   p  s    N)r   r   r   rx   ry   rz   r{   r|   r6   rL   r‚   r˜   rr   rs   rt   ru   rv   rw   r¬   r_   r&   r1   r   r   r   r   rƒ   M  s<   ]ø

(




 
rƒ   z^([0-9]+)((?:a|b|c|rc)[0-9]+)$c                 C   s@   g }|   d¡D ],}t |¡}|r0| | ¡ ¡ q| |¡ q|S )Nrˆ   )ÚsplitÚ_prefix_regexr7   ÚextendÚgroupsrZ   )r5   Úresultr*   r>   r   r   r   r–   y  s    
r–   c              
   C   sæ   g g  }}|  tt dd„ | ¡ƒ¡ |  tt dd„ |¡ƒ¡ |  | t|d ƒd … ¡ |  |t|d ƒd … ¡ | ddgtdt|d ƒt|d ƒ ƒ ¡ | ddgtdt|d ƒt|d ƒ ƒ ¡ ttj|Ž ƒttj|Ž ƒfS )Nc                 S   s   |   ¡ S rG   ©ÚisdigitrŒ   r   r   r   rŽ   Š  r�   z_pad_version.<locals>.<lambda>c                 S   s   |   ¡ S rG   r²   rŒ   r   r   r   rŽ   ‹  r�   r   r   Ú0)rZ   r“   r”   r•   rœ   ÚinsertÚmaxÚchain)ÚleftÚrightÚ
left_splitÚright_splitr   r   r   r�   …  s    
,,r�   c                   @   sŒ   e Zd Zddd„Zdd„ Zdd„ Zd	d
„ Zdd„ Zdd„ Zdd„ Z	dd„ Z
dd„ Zedd„ ƒZejdd„ ƒZdd„ Zddd„Zd dd„ZdS )!ÚSpecifierSetr3   Nc              	   C   sl   dd„ |  d¡D ƒ}tƒ }|D ]8}z| t|ƒ¡ W q tyT   | t|ƒ¡ Y q0 qt|ƒ| _|| _d S )Nc                 S   s   g | ]}|  ¡ r|  ¡ ‘qS r   )r:   ©Ú.0Úsr   r   r   Ú
<listcomp>ž  r�   z)SpecifierSet.__init__.<locals>.<listcomp>ú,)	r­   ÚsetÚaddrƒ   r   r`   Ú	frozensetÚ_specsr<   )r   Ú
specifiersr&   Úsplit_specifiersÚparsedÚ	specifierr   r   r   r?   ™  s    
zSpecifierSet.__init__c                 C   s*   | j d urd | j¡nd}d t| ƒ|¡S )Nr@   r3   z<SpecifierSet({0!r}{1})>)r<   r8   r&   rB   rC   r   r   r   rE   °  s
    ÿýzSpecifierSet.__repr__c                 C   s   d  tdd„ | jD ƒƒ¡S )NrÁ   c                 s   s   | ]}t |ƒV  qd S rG   )rB   r½   r   r   r   Ú	<genexpr>¼  r�   z'SpecifierSet.__str__.<locals>.<genexpr>)r’   ÚsortedrÅ   r   r   r   r   r    º  s    zSpecifierSet.__str__c                 C   s
   t | jƒS rG   )rH   rÅ   r   r   r   r   r!   ¾  s    zSpecifierSet.__hash__c                 C   s˜   t |tƒrt|ƒ}nt |tƒs"tS tƒ }t| j|jB ƒ|_| jd u rX|jd urX|j|_n<| jd urv|jd u rv| j|_n| j|jkrŒ| j|_ntdƒ‚|S )NzFCannot combine SpecifierSets with True and False prerelease overrides.)rI   r   r¼   rJ   rÄ   rÅ   r<   Ú
ValueError)r   r#   rÉ   r   r   r   Ú__and__Â  s     





ÿzSpecifierSet.__and__c                 C   s6   t |ttfƒrtt|ƒƒ}nt |tƒs*tS | j|jkS rG   ©rI   r   r2   r¼   rB   rJ   rÅ   r"   r   r   r   r$   Ú  s
    
zSpecifierSet.__eq__c                 C   s6   t |ttfƒrtt|ƒƒ}nt |tƒs*tS | j|jkS rG   rÎ   r"   r   r   r   r%   ã  s
    
zSpecifierSet.__ne__c                 C   s
   t | jƒS rG   )rœ   rÅ   r   r   r   r   Ú__len__ì  s    zSpecifierSet.__len__c                 C   s
   t | jƒS rG   )ÚiterrÅ   r   r   r   r   Ú__iter__ð  s    zSpecifierSet.__iter__c                 C   s.   | j d ur| j S | jsd S tdd„ | jD ƒƒS )Nc                 s   s   | ]}|j V  qd S rG   ©r&   r½   r   r   r   rÊ     r�   z+SpecifierSet.prereleases.<locals>.<genexpr>)r<   rÅ   Úanyr   r   r   r   r&   ô  s
    
zSpecifierSet.prereleasesc                 C   s
   || _ d S rG   rS   r'   r   r   r   r&     s    c                 C   s
   |   |¡S rG   rT   rU   r   r   r   rV     s    zSpecifierSet.__contains__c                    sL   t ˆ ttfƒstˆ ƒ‰ ˆd u r$| j‰ˆs2ˆ jr2dS t‡ ‡fdd„| jD ƒƒS )NFc                 3   s   | ]}|j ˆ ˆd �V  qdS )rÒ   NrT   r½   ©r*   r&   r   r   rÊ   *  r�   z(SpecifierSet.contains.<locals>.<genexpr>)rI   r   r
   r   r&   rX   ÚallrÅ   r)   r   rÔ   r   r+     s    
zSpecifierSet.containsc                 C   s°   |d u r| j }| jr6| jD ]}|j|t|ƒd�}q|S g }g }|D ]P}t|ttfƒs^t|ƒ}n|}t|tƒrnqB|jrˆ|sˆ|s’| 	|¡ qB| 	|¡ qB|s¨|r¨|d u r¨|S |S d S )NrÒ   )
r&   rÅ   r-   ÚboolrI   r   r
   r   rX   rZ   )r   r,   r&   r=   Úfilteredr\   r*   r^   r   r   r   r-   ,  s*    




zSpecifierSet.filter)r3   N)N)N)r   r   r   r?   rE   r    r!   rÍ   r$   r%   rÏ   rÑ   r_   r&   r1   rV   r+   r-   r   r   r   r   r¼   ˜  s"   

		


 ýr¼   )0Ú
__future__r   r   r   r.   r€   r”   ry   Z_compatr   r   Z_typingr   Úutilsr	   r5   r
   r   r   Útypingr   r   r   r   r   r   r   r   r   ÚParsedVersionrB   ÚUnparsedVersionrÖ   ÚCallableOperatorrÌ   r   ÚABCMetaÚobjectr   r2   r`   r‚   rƒ   rz   r®   r–   r�   r¼   r   r   r   r   Ú<module>   s4   ,@  8  +
