File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/versions.cpython-310.pyc
Back
o ;j�H � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z e� e�ZG dd� de jj�ZG dd� de�ZG dd� dej�Zd d d �Zeddd fd d �Zeddd fdd�Zeddd fdd�Zd dd�Zd dd�Z d dd�Zdd � Z dS )!z� salt.utils.versions ~~~~~~~~~~~~~~~~~~~ Version parsing based on `packaging.version` and `looseversion.LooseVersion` which works under python 3 because on python 3 you can no longer compare strings against integers. � Nc sX e Zd Z� fdd�Z� fdd�Z� fdd�Z� fdd�Z� fd d �Z� fd d �Z� Z S ) �Versionc � t |t�r t|�}t� �|�S �N)� isinstance�strr �super�__lt__��self�other�� __class__� �G/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/versions.pyr � zVersion.__lt__c r r )r r r r �__le__r r r r r r zVersion.__le__c r r )r r r r �__eq__r r r r r % r zVersion.__eq__c r r )r r r r �__ge__r r r r r * r zVersion.__ge__c r r )r r r r �__gt__r r r r r / r zVersion.__gt__c r r )r r r r �__ne__r r r r r 4 r zVersion.__ne__) �__name__� __module__� __qualname__r r r r r r � __classcell__r r r r r s r c s e Zd Z� fdd�Z� ZS )� StrictVersionc s4 t ddt� dt� dt� d�� t� j|i |�� d S )Ni� �'z�.StrictVersion' is no longer a subclass of 'distutils.versions.StrictVersion'. It's usage has been deprecated and should no longer be used. Please switch to 'z?.Version' which is a subclass of 'packaging.version.Version'. 'z-.StrictVersion' will be removed in {version}.)� warn_untilr r �__init__)r �args�kwargsr r r r ; s ��� zStrictVersion.__init__)r r r r r r r r r r : s r c s( e Zd Z� fdd�Z� fdd�Z� ZS )� LooseVersionc s" t � �|� dd� | jD �| _d S )Nc S s( g | ]}t |t�rt|��d �n|�qS )� )r �intr �zfill)�.0Zvpr r r � <listcomp>L s �z&LooseVersion.parse.<locals>.<listcomp>)r �parse�version� _str_version)r Zvstringr r r r& I s �zLooseVersion.parsec s� t |t�r t|�}d}| j|j D ] }t |t�s d} nq|du r't� �|�S | j|jkr/dS | j|jk r7dS | j|jkr?dS d S )NFTr ���� )r r r r' r" r �_cmpr( )r r Zstring_in_version�partr r r r+ P s" � �zLooseVersion._cmp)r r r r& r+ r r r r r r H s r c C s |� d|� d|j � d| � d�S )zg Replacement for warnings.formatwarning that disables the echoing of the 'line' parameter. �:z: � )r )�message�category�filename�lineno�liner r r �_format_warningg s r4 Fc C sp t | tjj�rtjj| j� } nIt | t�rtj�| �} n=t | t�r'tjj| � } n1t | t�rM| � � tjjj vrEt d� dd� tjj �� D ����tjj�| �} n t | tjj�sXt d��|du r^d}|du rftjj}tjj|� }|| kr�t�t�|d ��}dj |j|j| j|jd �}tj�d d �d kr�t |��tj� d |� d �� tj� � |du r�t j |j | jd�||d� dS dS )aV Helper function to raise a warning, by default, a ``DeprecationWarning``, until the provided ``version``, after which, a ``RuntimeError`` will be raised to remind the developers to remove the warning because the target version has been reached. :param version: The version info or name after which the warning becomes a ``RuntimeError``. For example ``(2019, 2)``, ``3000``, ``Hydrogen`` or an instance of :class:`salt.version.SaltStackVersion` or :class:`salt.version.SaltVersion`. :param message: The warning message to be displayed. :param category: The warning class to be thrown, by default ``DeprecationWarning`` :param stacklevel: There should be no need to set the value of ``stacklevel``. Salt should be able to do the right thing. :param _version_info_: In order to reuse this function for other SaltStack projects, they need to be able to provide the version info to compare to. :param _dont_call_warnings: This parameter is used just to get the functionality until the actual error is to be issued. When we're only after the salt version checks to raise a ``RuntimeError``. zhIncorrect spelling for the release name in the warn_utils call. Expecting one of these release names: {}c S s g | ]}|j �qS r )�name)r$ Zvsr r r r% � s z warn_until.<locals>.<listcomp>z�The 'version' argument should be passed as a tuple, integer, string or an instance of 'salt.version.SaltVersion' or 'salt.version.SaltStackVersion'.N� r* z�The warning triggered on filename '{filename}', line number {lineno}, is supposed to be shown until version {until_version} is released. Current version is now {salt_version}. Please remove the warning.)r1 r2 Z until_versionZ salt_version�!RAISE_DEPRECATIONS_RUNTIME_ERRORS�0�1r. F�r' �� stacklevel) r �saltr' Z SaltVersion�SaltStackVersion�infor" �tupler �lowerZLNAMES� RuntimeError�formatZSaltVersionsInfoZversions� from_name�__version_info__�inspect� getframeinfo�sys� _getframer1 r2 Zformatted_version�os�environ�get�stderr�write�flush�warnings�warn) r' r/ r0 r< �_version_info_�_dont_call_warnings� _version_�caller�deprecated_messager r r r o sZ ��� �� ��r c C s* d}t | ttjtjf�std�|���t | t�r tj�| |�} t | tj�r)| �� } |du r/d}|p7tj�� �� }|| kr|t� t � |d ��}dj|j| � � |� � d�|j |j| � � |� � d�f} tj�d d �d krmt| ��t j�d | � d �� t j�� |d u r�tj|j| � � |� � d�||d� dS dS )a� Helper function to raise a warning, by default, a ``DeprecationWarning``, until the provided ``date``, after which, a ``RuntimeError`` will be raised to remind the developers to remove the warning because the target date has been reached. :param date: A ``datetime.date`` or ``datetime.datetime`` instance. :param message: The warning message to be displayed. :param category: The warning class to be thrown, by default ``DeprecationWarning`` :param stacklevel: There should be no need to set the value of ``stacklevel``. Salt should be able to do the right thing. :param _dont_call_warnings: This parameter is used just to get the functionality until the actual error is to be issued. When we're only after the date checks to raise a ``RuntimeError``. z%Y%m%dz�The 'date' argument should be passed as a 'datetime.date()' or 'datetime.datetime()' objects or as string parserable by 'datetime.datetime.strptime()' with the following format '{}'.Nr6 r* z�{message} This warning(now exception) triggered on filename '{filename}', line number {lineno}, is supposed to be shown until {date}. Today is {today}. Please remove the warning.)�date�today)r/ r1 r2 rW rX r7 r8 r9 r. Fr; )r r �datetimerW rB rC �strptime�utcnowrF rG rH rI � isoformatr1 r2 rJ rK rL rM rN rO rP rQ ) rW r/ r0 r< Z _current_daterS Z _strptime_fmtrX rU rV r r r �warn_until_date� sJ �� �� ��r] c C s� t |tttjjf�std��t |t�rtjj|� }n t |t�r&tjj�|�}|du r,d}|du r4tjj}tjj|� }| sB|j |j kr^d� dd� | D ��}t |d� |j |�|||j |d� dS dS ) a� Helper function to raise a warning (by default, a ``DeprecationWarning``) when unhandled keyword arguments are passed to function, until the provided ``version_info``, after which, a ``RuntimeError`` will be raised to remind the developers to remove the ``**kwargs`` because the target version has been reached. This function is used to help deprecate unused legacy ``**kwargs`` that were added to function parameters lists to preserve backwards compatibility when removing a parameter. See :ref:`the deprecation development docs <deprecations>` for the modern strategy for deprecating a function parameter. :param kwargs: The caller's ``**kwargs`` argument value (a ``dict``). :param version: The version info or name after which the warning becomes a ``RuntimeError``. For example ``(0, 17)`` or ``Hydrogen`` or an instance of :class:`salt.version.SaltStackVersion`. :param category: The warning class to be thrown, by default ``DeprecationWarning`` :param stacklevel: There should be no need to set the value of ``stacklevel``. Salt should be able to do the right thing. :param _version_info_: In order to reuse this function for other SaltStack projects, they need to be able to provide the version info to compare to. :param _dont_call_warnings: This parameter is used just to get the functionality until the actual error is to be issued. When we're only after the salt version checks to raise a ``RuntimeError``. zmThe 'version' argument should be passed as a tuple, string or an instance of 'salt.version.SaltStackVersion'.N� z, c s s � | ] }d |� d �V qdS )r Nr )r$ �keyr r r � <genexpr>N s � z$kwargs_warn_until.<locals>.<genexpr>zPThe following parameter(s) have been deprecated and will be removed in '{}': {}.)r/ r0 r< rR rS )r r@ r r= r' r> rB rD rE r? �joinr rC �string)r r' r0 r< rR rS rT � arg_namesr r r �kwargs_warn_until s2 $� ��rd c s� � fdd�}|| �} ||�}z$t | �t |�k rW dS t | �t |�kr%W dS t | �t |�kr0W dS W dS tyJ } z t�|� W Y d}~dS d}~ww )aB Compares two version strings using `LooseVersion`. This is a fallback for providers which don't have a version comparison utility built into them. Return -1 if version1 < version2, 0 if version1 == version2, and 1 if version1 > version2. Return None if there was a problem making the comparison. c s � r t | ��dd�d S t | �S )Nr- r* r) )r �split)�x�� ignore_epochr r � normalizee s z version_cmp.<locals>.normalizer) r r* N)r � Exception�log� exception)Zpkg1Zpkg2rh ri �excr rg r � version_cmp\ s" ����rn � �==c C s� dddddd�}|dvr||vrt �d|� d S |d u r t}|| ||d �}|d u r+d S t|tj�s8t �d � d S |d krB||d vS |dk rId}n|dkrOd}||| v S )z� Compares two version numbers. Accepts a custom function to perform the cmp-style version comparison, otherwise uses version_cmp(). )r) )r) r )r )r r* )r* )�<z<=rp z>=�>)�!=z,Invalid operator '%s' for version comparisonFNrg z?The version comparison function did not return an integer/long.rs rp r) r* )rk �errorrn r �numbersZIntegral)Zver1ZoperZver2Zcmp_funcrh Zcmp_mapZ cmp_resultr r r �comparex s& rv Tc C s� |du r0zddl }d}W n ty d}Y nw | du r d} |r(t|j| �dkr0dd| � d�fS |du rzz ddl}ddl}d} W n tyK d} Y nw |du rRd }|du rXd }| rbt|j|�dkrjdd |� d�fS t|j|�dkrzdd |� d �fS dS )a� Checks for the version of various required boto libs in one central location. Most boto states and modules rely on a single version of the boto, boto3, or botocore libs. However, some require newer versions of any of these dependencies. This function allows the module to pass in a version to override the default minimum required version. This function is useful in centralizing checks for ``__virtual__()`` functions in the various, and many, boto modules and states. boto_ver The minimum required version of the boto library. Defaults to ``2.0.0``. boto3_ver The minimum required version of the boto3 library. Defaults to ``1.2.6``. botocore_ver The minimum required version of the botocore library. Defaults to ``1.3.23``. check_boto Boolean defining whether or not to check for boto deps. This defaults to ``True`` as most boto modules/states rely on boto, but some do not. check_boto3 Boolean defining whether or not to check for boto3 (and therefore botocore) deps. This defaults to ``True`` as most boto modules/states rely on boto3/botocore, but some do not. Tr NFz2.0.0r) zA minimum version of boto z is required.z1.2.6z1.3.23zA minimum version of boto3 z A minimum version of botocore z is required)�boto� ImportErrorrn � __version__�boto3�botocore) Zboto_verZ boto3_verZ botocore_verZ check_botoZ check_boto3rw Zhas_botorz r{ Z has_boto3r r r �check_boto_reqs� s@ � � � �r| c C s t j�| �S )zT A replacement for `pkg_resources.parse_version` which is being deprecated. )� packagingr' r& r: r r r r& � s r& r )F)ro rp ro NF)NNNTT) �__doc__rY rF �loggingru rJ rH rP Z looseversionZpackaging.versionr} Z salt.versionr= � getLoggerr rk r' r r r r4 �DeprecationWarningr r] rd rn rv r| r& r r r r �<module> sH �] �O � G # � L
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings