Current File : //lib/python2.7/site-packages/salt/utils/boto3mod.pyc
�
���^c @@ s� 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 m Z d d l
m Z d d l m
Z
d d l m Z d d l Z d d l Z y_ d d l Z d d l Z d d l Z d d l Z d d l Z e j d � j e j � e Z Wn e k
re Z n Xe j e � Z d Z! d � Z" d
� Z# d � Z$ d d e d d d d d � Z& d
� Z' d d d d d d � Z( d d � Z) d � Z* d � Z+ d d � Z, d � Z- d d d d d � Z. d � Z/ d � Z0 d � Z1 d S( u�
Boto3 Common Utils
=================
Note: This module depends on the dicts packed by the loader and,
therefore, must be accessed via the loader or from the __utils__ dict.
The __utils__ dict will not be automatically available to execution modules
until 2015.8.0. The `salt.utils.compat.pack_dunder` helper function
provides backwards compatibility.
This module provides common functionality for the boto execution modules.
The expected usage is to call `apply_funcs` from the `__virtual__` function
of the module. This will bring properly initilized partials of `_get_conn`
and `_cache_id` into the module's namespace.
Example Usage:
.. code-block:: python
def __virtual__():
# only required in 2015.2
salt.utils.compat.pack_dunder(__name__)
__utils__['boto.apply_funcs'](__name__, 'vpc')
def test():
conn = _get_conn()
vpc_id = _cache_id('test-vpc')
.. versionadded:: 2015.8.0
i ( t absolute_importt print_functiont unicode_literalsN( t partial( t range( t SaltInvocationError( t sixu boto3c C@ s& t j j j � } | t k r" t S| S( ug
Only load if boto libraries exist and if boto libraries are greater than
a given version.
( t saltt utilst versionst check_boto_reqst Truet __virtualname__( t has_boto( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt __virtual__H s c C@ sR | t k r t | St j d i � } | | k r: | | S| t k rN t | Sd S( u*
Look up the value for an option.
u masterN( t __opts__t
__pillar__t get( t valuet master_opts( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt _optionS s c C@ s� | rx t | t j � r' t | � } n t | t � r? | } n | j d d � } | j d d � } | j d d � } n | r� t | d � r� t | d � } n | s� d } t j d | � n | r� t | d � r� t | d � } n | rt | d � rt | d � } n d j | � } | ru| | | } t j
rYt j j
j | � } n | t j | � j � } n
| | } | | | | f S(
Nu keyu keyidu regionu .regionu us-east-1u Assuming default region %su .keyu .keyidu boto_{0}:( t
isinstanceR t string_typesR t dictR t Nonet logt infot formatt PY3R R t stringutilst to_bytest hashlibt md5t hexdigest( t servicet regiont keyt keyidt profilet _profilet labelt hash_stringt cxkey( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt _get_profile` s2
c @ s� t | | | | | � \ } }
}
}
| rB d j | | | � } n d j | | � } | r� | t k rq t | =t S� t j � k r� t � f d � t j � D� � } t j � t j | � t St Sn � r� � t | <t St j
| � S( u
Cache, invalidate, or retrieve an AWS resource id keyed by name.
.. code-block:: python
__utils__['boto.cache_id']('ec2', 'myinstance',
'i-a1b2c3',
profile='custom_profile')
u {0}:{1}:{2}:idu
{0}:{1}:idc 3@ s- | ]# \ } } | � k r | | f Vq d S( N( ( t .0t kt v( t resource_id( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pys <genexpr>� s ( R+ R t __context__R t valuesR t itemst cleart updatet FalseR ( R" t namet sub_resourceR/ t
invalidateR# R$ R% R& R* t _t ctx( ( R/ s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt cache_id� s&
"
c C@ s
t t | � S( u�
Returns a partial `cache_id` function for the provided service.
.. code-block:: python
cache_id = __utils__['boto.cache_id_func']('ec2')
cache_id('myinstance', 'i-a1b2c3')
instance_id = cache_id('myinstance')
( R R; ( R" ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt
cache_id_func� s
c C@ s
| p | } t | | | | | � \ } } } } | d } | t k rN t | Sy| t j j d | d | d | � } | d k r� t d j | � � � n | j | � } | d k r� t d j | � � � n Wn/ t j
j k
r� t d j | | � � � n X| t | <| S( u�
Return a boto connection for the service.
.. code-block:: python
conn = __utils__['boto.get_connection']('ec2', profile='custom_profile')
u :conn3t aws_access_key_idt aws_secret_access_keyt region_nameu Region "{0}" is not valid.u` No authentication credentials found when attempting to make boto {0} connection to region "{1}".N( R+ R0 t boto3t sessiont SessionR R R t clientt botot exceptiont NoAuthHandlerFound( R" t moduleR# R$ R% R& R* RA t conn( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt get_connection� s,
c C@ s t t | d | �S( u�
Returns a partial `get_connection` function for the provided service.
.. code-block:: python
get_conn = __utils__['boto.get_connection_func']('ec2')
conn = get_conn()
RG ( R RI ( R" RG ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt get_connection_func� s c C@ s( t | | d d | � \ } } } } | S( ue
Retrieve the region for a particular AWS service based on configured region and/or profile.
N( R+ R ( R" R# R& R9 ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt
get_region� s $c C@ sS i } d } t j rt | d � r4 | j | d <n t | d � rS | j | d <n t j | � d k r~ t j | � | d <n t | d � r� | j d k r� | j | d <n d | k r� d | k r� d j | d | d � } q/d | k r� | d } q/d | k r/| d } q/n t j r/| j
d } n i | d 6} | rO| | d <n | S(
Nu u statusu reasonu messageu
error_codeu codeu {0}: {1}i u aws( R t PY2t hasattrt statust reasont text_typet
error_codeR R R t args( t et awst messaget r( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt get_error� s.
i c @ s9 t | � � t � f d � t | � D� � o8 t � � S( ub
Tests that exactly N items in an iterable are "truthy" (neither None,
False, nor 0).
c 3@ s | ] } t � � Vq d S( N( t any( R, t j( t i( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pys <genexpr> s ( t itert allR RX ( t lt n( ( RZ s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt exactly_n s c C@ s
t | � S( N( R_ ( R] ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt exactly_one s u _get_connu _cache_idu _exactly_onec C@ sb t j | } t | | t | d | �� t | | t | � � | d k r^ t | | t � n d S( u�
Assign _get_conn and _cache_id functions to the named module.
.. code-block:: python
_utils__['boto.assign_partials'](__name__, 'ec2')
RG N( t syst modulest setattrRJ R< R R` ( t modnameR" RG t get_conn_funcnamet cache_id_funcnamet exactly_one_funcnamet mod( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt assign_funcs s
c o@ sl | j d d � } | j d d � } xA t rg | | | � } | j | � } | V| sZ Pn | | | <q' Wd S( u Retrieve full set of values from a boto3 API call that may truncate
its results, yielding each page as it is obtained.
u marker_flagu
NextMarkeru
marker_argu MarkerN( t popR R ( t functionRR t kwargst marker_flagt
marker_argt rett marker( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt
paged_call0 s c C@ su t | t t f � r) t d � | D� � St | t � rR t d � | j � D� � St | t j � rq t j | � S| S( Nc s@ s | ] } t | � Vq d S( N( t ordered( R, t x( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pys <genexpr>A s c s@ sH | ]> \ } } t | t j � r0 t j | � n | t | � f Vq d S( N( R R R RP Rr ( R, R- R. ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pys <genexpr>C s ( R t listt tuplet sortedR R2 R R RP ( t obj( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyRr ? s
c C@ s t | � t | � k S( uI Compare two parsed JSON objects, given non-ordering in JSON objects
( Rr ( t leftt right( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt json_objs_equalI s (2 t __doc__t
__future__R R R R t loggingRa t functoolsR t salt.ext.six.movesR t salt.exceptionsR t salt.extR t salt.utils.stringutilsR t salt.utils.versionsRD R@ t boto.exceptiont
boto3.sessiont botocoret getLoggert setLevelt CRITICALR t HAS_BOTOt ImportErrorR5 t __name__R R R R R+ R R; R< RI RJ RK RW R_ R` Ri Rq Rr Rz ( ( ( s7 /usr/lib/python2.7/site-packages/salt/utils/boto3mod.pyt <module>! sT
" $
%
Mini Shell