Current File : //lib/python2.7/site-packages/salt/utils/versions.pyc
�
���^c @@ s3 d Z 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 d d l m Z
d d l Z d d l m Z e j e � Z d e f d � � YZ
d e
f d
� � YZ e d d e d � Z e d d e d � Z e d
� Z d d d d e d � Z d d d e e d � Z d S( uV
:copyright: Copyright 2017 by the SaltStack Team, see AUTHORS for more details.
:license: Apache 2.0, see LICENSE for more details.
salt.utils.versions
~~~~~~~~~~~~~~~~~~~
Version parsing based on distutils.version which works under python 3
because on python 3 you can no longer compare strings against integers.
i ( t absolute_importt print_functiont unicode_literalsN( t
StrictVersion( t LooseVersion( t sixR c B@ s e Z d � Z d � Z RS( c C@ s t j | | � d S( N( t _StrictVersiont parse( t selft vstring( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyR # s c C@ s1 t | t j � r! t | � } n t j | | � S( N( t
isinstanceR t string_typesR R t _cmp( R t other( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyR & s ( t __name__t
__module__R R ( ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyR " s R c B@ s& e Z d � Z e j r$ d � Z n RS( c C@ sf t j | | � t j rb g | j D]3 } t | t � rP t j | � j d � n | ^ q# | _ n d S( Ni (
t
_LooseVersionR R t PY3t versionR
t intt text_typet zfillt _str_version( R R t vp( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyR . s c C@ s� t | t j � r! t | � } n t } x1 | j | j D] } t | t � s8 t } Pq8 q8 W| t k rw t j | | � S| j
| j
k r� d S| j
| j
k r� d S| j
| j
k r� d Sd S( Ni i����i ( R
R R R t FalseR R t TrueR R R ( R R
t string_in_versiont part( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyR 7 s ( R R R R R R ( ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyR , s c
C@ s� t | t t j t j j f � s0 t d � � nN t | t � rT t j j | � } n* t | t j � r~ t j j j | � } n | d k r� d } n | d k r� t j j
} n t j j | � } | | k r-d d l } | j t
j | d � � } t d j d | j d | j d | j d
| j � � � n | t k r�d d � } t j }
| t _ t j | j d | j � | d
| �|
t _ n d S( u'
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 ``(0, 17)`` or ``Hydrogen``
or an instance of :class:`salt.version.SaltStackVersion`.
: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``.
um The 'version' argument should be passed as a tuple, string or an instance of 'salt.version.SaltStackVersion'.i i Ni u� 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.t filenamet linenot
until_versiont salt_versionc S@ s d j | | | j | � S( u
Replacement for warnings.formatwarning that disables the echoing of
the 'line' parameter.
u {0}:{1}: {2}: {3}
( t formatR ( t messaget categoryR R t line( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt _formatwarning� s R t
stacklevel( R
t tupleR R t saltR t SaltStackVersiont RuntimeErrort from_namet Nonet __version_info__t inspectt getframeinfot syst _getframeR R R t formatted_versionR t warningst
formatwarningt warn( R R! R" R% t _version_info_t _dont_call_warningst _version_R- t callerR$ t saved( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt
warn_untilN s@ c
C@ s2 t | t t j t j j f � s0 t d � � nN t | t � rT t j j | � } n* t | t j � r~ t j j j | � } n | d k r� d } n | d k r� t j j
} n t j j | � } | s� | j | j k r.d j d � | D� � } t
| d d j | j | � d | d | d | j d
| �n d S( u�
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``.
um The 'version' argument should be passed as a tuple, string or an instance of 'salt.version.SaltStackVersion'.i u , c s@ s | ] } d j | � Vq d S( u '{0}'N( R ( t .0t key( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pys <genexpr>� s R! uR The following parameter(s) have been deprecated and will be removed in '{0}': {1}.R" R% R5 R6 N( R
R& R R R' R R( R) R* R+ R, t infot joinR: R t string( t kwargsR R" R% R5 R6 R7 t arg_names( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt kwargs_warn_until� s2 " c @ s� � f d � } | | � } | | � } yX t | � t | � k rF d St | � t | � k rb d St | � t | � k r~ d SWn t k
r� } t j | � n Xd S( uT
Compares two version strings using salt.utils.versions.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 @ s0 � r# t j | � j d d � d St j | � S( Nu :i i����( R R t split( t x( t ignore_epoch( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt <lambda>� s i����i i N( R t Exceptiont logt exceptionR+ ( t pkg1t pkg2RE t normalizet exc( ( RE s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt version_cmp� s u u ==c C@ s i d d 6d d 6d d 6d d 6d d 6} | d k rU | | k rU t j d
| � t S| d
k rj t } n | | | d | �} | d
k r� t St | t j � s� t j d � t S| d k r� | | d k S| d k r� d } n | d k r� d } n | | | k Sd
S( u�
Compares two version numbers. Accepts a custom function to perform the
cmp-style version comparison, otherwise uses version_cmp().
i����u <i u <=u ==i u >=u >u !=u, Invalid operator '%s' for version comparisonRE u? The version comparison function did not return an integer/long.N( i����( i����i ( i ( i i ( i ( u !=( RH t errorR R+ RN R
t numberst Integral( t ver1t opert ver2t cmp_funcRE t cmp_mapt
cmp_result( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt compare s(
c
C@ s\ | t k r� y d d l } t } Wn t k
r; t } n X| d k rQ d } n | sp t | j | � d k r� t d j | � f Sn | t k rXy" d d l } d d l } t } Wn t k
r� t } n X| d k r� d } n | d k r� d } n | st | j | � d k r*t d j | � f St | j | � d k rXt d j | � f Sn t S(
u�
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.
i Nu 2.0.0i����u* A minimum version of boto {0} is required.u 1.2.6u 1.3.23u+ A minimum version of boto3 {0} is required.u- A minimum version of botocore {0} is required(
R t botot ImportErrorR R+ RN t __version__R t boto3t botocore(
t boto_vert boto3_vert botocore_vert
check_botot check_boto3RY t has_botoR\ R] t has_boto3( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt check_boto_reqs) s4
( t __doc__t
__future__R R R t loggingRP R/ R2 t distutils.versionR R R R t salt.versionR' t salt.extR t getLoggerR RH t DeprecationWarningR+ R R: RB RN RX R Re ( ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/versions.pyt <module> s6
$ T A $
Mini Shell