§
    ÎÑßj¨…  ã                   ó<  — d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlmZm	Z	m
Z
mZmZ d dlZd dlmZmZ d dlmZmZmZmZ d dlmZ d dlmZ d dlmZmZ d dlmZ g d	¢Zd
Z d
Z! G d„ d¦  «        Z" G d„ dej#        ¦  «        Z# G d„ d¦  «        Z$ G d„ de$¦  «        Z% G d„ de$¦  «        Z& G d„ de$¦  «        Z' G d„ d¦  «        Z( G d„ de(¦  «        Z) G d„ de(¦  «        Z* G d„ de(¦  «        Z+ G d„ d e+¦  «        Z, G d!„ d"e*¦  «        Z- G d#„ d$¦  «        Z.dS )%é    N)ÚAnyÚDictÚTypeÚUnionÚOptional)ÚLibcloudConnectionÚHttpLibResponseProxy)ÚETÚhttplibÚurlparseÚ	urlencode)Úlowercase_keys)ÚRetry)ÚLibcloudErrorÚMalformedResponseError)Úexception_from_message)ÚRETRY_FAILED_HTTP_REQUESTSÚ
BaseDriverÚ
ConnectionÚPollingConnectionÚConnectionKeyÚConnectionUserAndKeyÚCertificateConnectionÚResponseÚHTTPResponseÚJsonResponseÚXmlResponseÚRawResponseFc                   ó>   — e Zd ZdZed„ ¦   «         Zed„ ¦   «         ZdS )Ú
LazyObjectz6An object that doesn't get initialized until accessed.c                 ó@   ‡ ‡‡—  G ˆ ˆˆfd„d‰ ¦  «        } |¦   «         S )Nc                   ó4   •— e Zd ZdZd„ Zd„ Zd„ Zˆ ˆˆfd„ZdS )ú LazyObject._proxy.<locals>.ProxyNc                 ó   — d S ©N© ©Úselfs    úH/opt/saltstack/salt/lib/python3.11/site-packages/libcloud/common/base.pyÚ__init__z)LazyObject._proxy.<locals>.Proxy.__init__C   s   € à�ó    c                 óf   — t                               | d¦  «        ¦   «         }t          ||¦  «        S ©NÚ_get_lazy_obj)ÚobjectÚ__getattribute__Úgetattr)r(   ÚattrÚlazy_objs      r)   r0   z1LazyObject._proxy.<locals>.Proxy.__getattribute__G   s-   € Ý!×2Ò2°4¸ÑIÔIÑKÔK�Ý˜x¨Ñ.Ô.Ð.r+   c                 ól   — t                               | d¦  «        ¦   «         }t          |||¦  «         d S r-   )r/   r0   Úsetattr)r(   r2   Úvaluer3   s       r)   Ú__setattr__z,LazyObject._proxy.<locals>.Proxy.__setattr__K   s5   € Ý!×2Ò2°4¸ÑIÔIÑKÔK�Ý˜ $¨Ñ.Ô.Ð.Ð.Ð.r+   c                 óŠ   •— t                                | d¦  «        }|€$ ‰‰i ‰¤Ž}t                                | d|¦  «         |S )NÚ	_lazy_obj)r/   r0   r7   )r(   r3   ÚclsÚlazy_init_argsÚlazy_init_kwargss     €€€r)   r.   z.LazyObject._proxy.<locals>.Proxy._get_lazy_objO   sP   ø€ Ý!×2Ò2°4¸ÑEÔE�ØÐ#Ø"˜s NÐGÐ6FÐGÐG�HÝ×&Ò& t¨[¸(ÑCÔCÐCØ�r+   )Ú__name__Ú
__module__Ú__qualname__r9   r*   r0   r7   r.   ©r:   r;   r<   s   €€€r)   ÚProxyr#   @   sj   ø€ € € € € ØˆIðð ð ð/ð /ð /ð/ð /ð /ð ð  ð  ð  ð  ð  ð  ð  ð  r+   rA   r&   )r:   r;   r<   rA   s   ``` r)   Ú_proxyzLazyObject._proxy>   sP   øøø€ ð	 ð 	 ð 	 ð 	 ð 	 ð 	 ð 	 ð 	 ð 	 �Cñ 	 ô 	 ð 	 ð, ˆu‰wŒwˆr+   c                 ó   —  | j         |i |¤ŽS )z;Create a lazily instantiated instance of the subclass, cls.)rB   r@   s      r)   ÚlazyzLazyObject.lazyX   s   € ð ˆsŒz˜>Ð>Ð-=Ð>Ð>Ð>r+   N)r=   r>   r?   Ú__doc__ÚclassmethodrB   rD   r&   r+   r)   r    r    ;   sN   € € € € € Ø@Ð@àðð ñ „[ðð2 ð?ð ?ñ „[ð?ð ?ð ?r+   r    c                   ó   — e Zd Zdd„ZdS )r   Nc                 ó–   — | j         €dS | j        dk    r|                      ¦   «          dS t          j                             | |¦  «        S )NÚ ÚHEAD)ÚfpÚ_methodÚcloser   r   Úread)r(   Úamts     r)   rN   zHTTPResponse.readd   sF   € ØŒ7ˆ?Ø�2àŒ<˜6Ò!Ð!Ø�JŠJ‰LŒLˆLØ�2åÔ#×(Ò(¨¨sÑ3Ô3Ð3r+   r%   )r=   r>   r?   rN   r&   r+   r)   r   r   ^   s(   € € € € € ð4ð 4ð 4ð 4ð 4ð 4r+   r   c                   óP   — e Zd ZdZej        Zi ZdZdZ	dZ
dZdZd„ Zd„ Zd„ Zd„ ZdS )r   z/
    A base Response class to derive from.
    NFc                 óî  — || _         t          t          |j        ¦  «        ¦  «        | _        |j        | _        |j        | _        |j        | _        |j	        | _	        |j
        �.t          |j
        d¦  «        r|j
                             ¦   «         nd| _        |                      ¦   «         s.t          | j        |                      ¦   «         | j        ¬¦  «        ‚|                      ¦   «         | _        dS )zÞ
        :param response: HTTP response object. (optional)
        :type response: :class:`httplib.HTTPResponse`

        :param connection: Parent connection object.
        :type connection: :class:`.Connection`
        NÚstriprI   )ÚcodeÚmessageÚheaders)Ú
connectionr   ÚdictrU   ÚreasonÚerrorÚstatus_codeÚstatusÚrequestÚiter_contentÚtextÚhasattrrR   ÚbodyÚsuccessr   Úparse_errorÚ
parse_bodyr/   )r(   ÚresponserV   s      r)   r*   zResponse.__init__ƒ   sá   € ð %ˆŒõ &¥d¨8Ô+;Ñ&<Ô&<Ñ=Ô=ˆŒØ”_ˆŒ
ØÔ*ˆŒØÔ'ˆŒØ$Ô1ˆÔð Œ}Ð(­W°X´]ÀGÑ-LÔ-LÐ(ð ŒM×ÒÑ!Ô!Ð!àð 	Œ	ð �|Š|‰~Œ~ð 	Ý(Ø”[¨$×*:Ò*:Ñ*<Ô*<ÀdÄlðñ ô ð ð —o’oÑ'Ô'ˆŒˆˆr+   c                 ó"   — | j         �| j         ndS )z‰
        Parse response body.

        Override in a provider's subclass.

        :return: Parsed body.
        :rtype: ``str``
        NrI   ©r`   r'   s    r)   rc   zResponse.parse_body¢   s   € ð !œIÐ1ˆtŒyˆy°rÐ9r+   c                 ó   — | j         S )z�
        Parse the error messages.

        Override in a provider's subclass.

        :return: Parsed error.
        :rtype: ``str``
        rf   r'   s    r)   rb   zResponse.parse_error­   s   € ð ŒyÐr+   c                 óŠ   — ddl }| j        |j        j        |j        j        t
          j        t
          j        t
          j        fv S ©zý
        Determine if our request was successful.

        The meaning of this can be arbitrary; did we receive OK status? Did
        the node get created? Were we authenticated?

        :rtype: ``bool``
        :return: ``True`` or ``False``
        r   N©	Úrequestsr[   ÚcodesÚokÚcreatedr   ÚOKÚCREATEDÚACCEPTED©r(   rk   s     r)   ra   zResponse.success¸   óA   € ð 	ˆˆˆàŒ{ØŒNÔØŒNÔ"ÝŒJÝŒOÝÔð
ð 
ð 	
r+   )r=   r>   r?   rE   r   ro   r[   rU   r`   r/   rY   rV   Úparse_zero_length_bodyr*   rc   rb   ra   r&   r+   r)   r   r   o   s†   € € € € € ðð ð
 ŒZ€Fà€Gð €Dð €Fà€EØ€JØ"Ðð(ð (ð (ð>	:ð 	:ð 	:ð	ð 	ð 	ð
ð 
ð 
ð 
ð 
r+   r   c                   ó   — e Zd ZdZd„ ZeZdS )r   z4
    A Base JSON Response class to derive from.
    c                 óæ   — t          | j        ¦  «        dk    r| j        s| j        S 	 t          j        | j        ¦  «        }n/# t
          $ r" t          d| j        | j        j        ¬¦  «        ‚w xY w|S )Nr   zFailed to parse JSON©r`   Údriver)	Úlenr`   rt   ÚjsonÚloadsÚ	Exceptionr   rV   rx   ©r(   r`   s     r)   rc   zJsonResponse.parse_bodyÓ   s„   € ÝˆtŒy‰>Œ>˜QÒÐ tÔ'BÐØ”9Ðð	Ý”:˜dœiÑ(Ô(ˆDˆDøÝð 	ð 	ð 	Ý(Ø&¨T¬Y¸t¼Ô?Uðñ ô ð ð	øøøð ˆs   ¨A Á,A.N©r=   r>   r?   rE   rc   rb   r&   r+   r)   r   r   Î   s.   € € € € € ðð ð
ð 
ð 
ð €K€K€Kr+   r   c                   ó   — e Zd ZdZd„ ZeZdS )r   z3
    A Base XML Response class to derive from.
    c                 ób  — t          | j        ¦  «        dk    r| j        s| j        S 	 	 t          j        | j        ¦  «        }n<# t
          $ r/ t          j        | j                             d¦  «        ¦  «        }Y nw xY wn/# t          $ r" t          d| j        | j	        j
        ¬¦  «        ‚w xY w|S )Nr   zutf-8zFailed to parse XMLrw   )ry   r`   rt   r
   ÚXMLÚ
ValueErrorÚencoder|   r   rV   rx   r}   s     r)   rc   zXmlResponse.parse_bodyç   sÊ   € ÝˆtŒy‰>Œ>˜QÒÐ tÔ'BÐØ”9Ðð		ð9Ý”v˜dœiÑ(Ô(��øÝð 9ð 9ð 9å”v˜dœi×.Ò.¨wÑ7Ô7Ñ8Ô8���ð9øøøøøõ ð 	ð 	ð 	Ý(Ø%¨D¬I¸d¼oÔ>Tðñ ô ð ð	øøøð ˆs)   ©A ÁB  Á6A<Á9B  Á;A<Á<B  Â ,B,Nr~   r&   r+   r)   r   r   â   s.   € € € € € ðð ðð ð ð  €K€K€Kr+   r   c                   ó^   — e Zd Zdd„Zd„ Zed„ ¦   «         Zed„ ¦   «         Zed„ ¦   «         ZdS )r   Nc                 ó^  — d| _         d| _        i | _        d| _        d| _        || _        |�Vt          t          |j        ¦  «        ¦  «        | _        |j	        | _
        |j        | _        |j        | _        |j        | _        |                      ¦   «         s|                      ¦   «          dS dS )zm
        :param connection: Parent connection object.
        :type connection: :class:`.Connection`
        N)Ú_statusÚ	_responseÚ_headersÚ_errorÚ_reasonrV   r   rW   rU   rX   rY   rZ   r[   r\   r]   ra   rb   )r(   rV   rd   s      r)   r*   zRawResponse.__init__û   s¨   € ð
 ˆŒØˆŒØˆŒØˆŒØˆŒØ$ˆŒØÐÝ)­$¨xÔ/?Ñ*@Ô*@ÑAÔAˆDŒLØ!œˆDŒJØ"Ô.ˆDŒKØ#Ô+ˆDŒLØ (Ô 5ˆDÔà�|Š|‰~Œ~ð 	Ø×ÒÑÔÐÐÐð	ð 	r+   c                 óŠ   — ddl }| j        |j        j        |j        j        t
          j        t
          j        t
          j        fv S ri   rj   rr   s     r)   ra   zRawResponse.success  rs   r+   c                 óÒ   — | j         sZ| j        j                             ¦   «         }t          |¦  «        | _         |                      ¦   «         s|                      ¦   «          | j         S r%   )r‡   rV   Úgetresponser	   ra   rb   ©r(   rd   s     r)   rd   zRawResponse.response%  s[   € àŒ~ð 	#Ø”Ô1×=Ò=Ñ?Ô?ˆHÝ1°(Ñ;Ô;ˆDŒNØ—<’<‘>”>ð #Ø× Ò Ñ"Ô"Ð"ØŒ~Ðr+   c                 ó   — | j         j        S r%   )rd   r`   r'   s    r)   r`   zRawResponse.body.  s   € ð Œ}Ô!Ð!r+   c                 ó@   — | j         s| j        j        | _         | j         S r%   )rŠ   rd   rX   r'   s    r)   rX   zRawResponse.reason4  s    € àŒ|ð 	0Øœ=Ô/ˆDŒLØŒ|Ðr+   r%   )	r=   r>   r?   r*   ra   Úpropertyrd   r`   rX   r&   r+   r)   r   r   ú   sˆ   € € € € € ðð ð ð ð*
ð 
ð 
ð* ðð ñ „Xðð ð"ð "ñ „Xð"ð
 ðð ñ „Xðð ð r+   r   c                   ó  — e Zd ZdZeZeZeZ	e
ZdZdZdZdZdZdZdZdZdZdZdZ	 	 	 	 	 	 	 	 d d„Zd	„ Zd
„ Zd„ Zd„ Zd!d„Zd„ Zd„ Z	 	 	 	 	 	 	 	 d"d„Zde de!de"e e#f         de de$de$de%eef         fd„Z&d„ Z'd„ Z(d„ Z)d„ Z*d„ Z+d„ Z,dS )#r   z1
    A Base Connection class to derive from.
    Nz	127.0.0.1é»  é   FTc	                 óv  — |rdpd| _         g | _        i | _        | j        s|st	          d¦  «        ‚d| _        |r|| _        |�|| _        n| j         dk    rd| _        nd| _        |r.|                      |¦  «        \  | _        | _        | _         | _        |p| j	        | _	        || _
        || _        || _        d S )Nr”   r   z7Non https connections are not allowed (use secure=True)rI   r“   éP   )ÚsecureÚuaÚcontextÚallow_insecurer‚   Úrequest_pathÚhostÚportÚ_tuple_from_urlÚtimeoutÚretry_delayÚbackoffÚ	proxy_url)	r(   r—   rœ   r�   ÚurlrŸ   r¢   r    r¡   s	            r)   r*   zConnection.__init__R  sé   € ð �l Ð' aˆŒØˆŒØˆŒàÔ"ð 	[¨6ð 	[õ ÐYÑZÔZÐZàˆÔàð 	ØˆDŒIàÐØˆDŒIˆIàŒ{˜aÒÐØ�”	�	à�”	àð 	*ð ×$Ò$ SÑ)Ô)ñØ”	Ø”	Ø”ØÔ!ð Ð. $¤,ˆŒØ&ˆÔØˆŒØ"ˆŒˆˆr+   c                 óJ   — || _         | j                             |¬¦  «         dS )a  
        Set a HTTP / HTTPS proxy which will be used with this connection.

        :param proxy_url: Proxy URL (e.g. http://<hostname>:<port> without
                          authentication and
                          <scheme>://<username>:<password>@<hostname>:<port>
                          for basic auth authentication information.
        :type proxy_url: ``str``
        )r¢   N)r¢   rV   Úset_http_proxy)r(   r¢   s     r)   r¥   zConnection.set_http_proxy€  s,   € ð #ˆŒð
 	Œ×&Ò&°Ð&Ñ;Ô;Ð;Ð;Ð;r+   c                 ó\   — t          |t          ¦  «        st          d¦  «        ‚|| _        d S )Nz context needs to be a dictionary)Ú
isinstancerW   Ú	TypeErrorr™   )r(   r™   s     r)   Úset_contextzConnection.set_context‘  s/   € Ý˜'¥4Ñ(Ô(ð 	@ÝÐ>Ñ?Ô?Ð?àˆŒˆˆr+   c                 ó   — i | _         d S r%   )r™   r'   s    r)   Úreset_contextzConnection.reset_context—  s   € ØˆŒˆˆr+   c                 ó<  — d}d }t          j         |¦  «        \  }}}}}}	|dvr#t          d                     ||¦  «        ¦  «        ‚|dk    rd}d|v r'|                     d¦  «        \  }}t	          |¦  «        }|s|dk    rd}nd}|}
t	          |¦  «        }|
|||fS )	Nr”   )ÚhttpÚhttpszInvalid scheme: {} in url {}r­   r   ú:r–   r“   )r   r   ÚformatÚrsplitÚint)r(   r£   r—   r�   ÚschemeÚnetlocr›   ÚparamÚqueryÚfragmentrœ   s              r)   rž   zConnection._tuple_from_urlš  sÌ   € ØˆØˆÝ?GÔ?PÐQTÑ?UÔ?UÑ<ˆ�˜ e¨U°HàÐ*Ð*Ð*ÝÐ >× EÒ EÀfÈcÑ RÔ RÑSÔSÐSà�VÒÐØˆFà�&ˆ=ˆ=Ø!Ÿ=š=¨Ñ-Ô-‰LˆF�DÝ�t‘9”9ˆDàð 	Ø˜ÒÐØ��à�àˆÝ�4‰yŒyˆà�d˜F LÐ1Ð1r+   c                 óÈ  — d}| j         }t          | dd¦  «        r+|€)|                      t          | d¦  «        ¦  «        \  }}}}n/|�|                      |¦  «        \  }}}}n|p| j        }|p| j        }t          |¦  «        }t          |d¦  «        s|                     d|i¦  «         t          |d¦  «        s|                     d|i¦  «         t          |d¦  «        s|                     d| j         i¦  «         t          |d¦  «        s5t          | d¦  «        r%|                     dt          | d¦  «        i¦  «         t          |d¦  «        s5t          | d¦  «        r%|                     dt          | d¦  «        i¦  «         | j        r|                     d| j        i¦  «         | j	        r|                     d	| j	        i¦  «          | j
        d
i |¤Ž}|| _        dS )a  
        Establish a connection with the API server.

        :type host: ``str``
        :param host: Optional host to override our default

        :type port: ``int``
        :param port: Optional port to override our default

        :returns: A connection
        NÚbase_urlrœ   r�   r—   Úkey_fileÚ	cert_filerŸ   r¢   r&   )r—   r1   rž   rœ   r�   r²   r_   ÚupdaterŸ   r¢   Ú
conn_classrV   )r(   rœ   r�   r¹   ÚkwargsrV   r—   r›   s           r)   ÚconnectzConnection.connect´  s  € ð ˆ
Ø”ˆå�4˜ TÑ*Ô*ð 	%¨xÐ/?Ø/3×/CÒ/CÅGÈDÐR\ÑD]ÔD]Ñ/^Ô/^Ñ,ˆD�$˜  ØÐ!Ø/3×/CÒ/CÀHÑ/MÔ/MÑ,ˆD�$˜  àÐ$˜4œ9ˆDØÐ$˜4œ9ˆDõ �4‰yŒyˆå�v˜vÑ&Ô&ð 	*Ø�MŠM˜6 4˜.Ñ)Ô)Ð)å�v˜vÑ&Ô&ð 	*Ø�MŠM˜6 4˜.Ñ)Ô)Ð)å�v˜xÑ(Ô(ð 	3Ø�MŠM˜8 T¤[Ð1Ñ2Ô2Ð2å�v˜zÑ*Ô*ð 	C­w°t¸ZÑ/HÔ/Hð 	CØ�MŠM˜:¥w¨t°ZÑ'@Ô'@ÐAÑBÔBÐBå�v˜{Ñ+Ô+ð 	Eµ¸¸kÑ0JÔ0Jð 	EØ�MŠM˜;­°°kÑ(BÔ(BÐCÑDÔDÐDàŒ<ð 	5Ø�MŠM˜9 d¤lÐ3Ñ4Ô4Ð4àŒ>ð 	9Ø�MŠM˜;¨¬Ð7Ñ8Ô8Ð8à$�T”_Ð.Ð. vÐ.Ð.ˆ
ð %ˆŒˆˆr+   c                 óô   — d                      d„ | j        D ¦   «         ¦  «        }| j        r,d                     t          j        | j        j        |¦  «        }n d                     t          j        |¦  «        }|S )Nú c                 ó   — g | ]}d |z  ‘ŒS )z(%s)r&   )Ú.0Úxs     r)   ú
<listcomp>z*Connection._user_agent.<locals>.<listcomp>î  s   € Ð%BÐ%BÐ%B°Q f¨q¡jÐ%BÐ%BÐ%Br+   zlibcloud/{} ({}) {}zlibcloud/{} {})Újoinr˜   rx   r°   ÚlibcloudÚ__version__Úname)r(   Úuser_agent_suffixÚ
user_agents      r)   Ú_user_agentzConnection._user_agentí  sy   € ØŸHšHÐ%BÐ%B¸$¼'Ð%BÑ%BÔ%BÑCÔCÐàŒ;ð 	ZØ.×5Ò5ÝÔ$Ø”Ô Ø!ñô ˆJˆJð *×0Ò0µÔ1EÐGXÑYÔYˆJàÐr+   c                 ó:   — | j                              |¦  «         dS )zö
        Append a token to a user agent string.

        Users of the library should call this to uniquely identify their
        requests to a provider.

        :type token: ``str``
        :param token: Token to add to the user agent.
        N)r˜   Úappend)r(   Útokens     r)   Úuser_agent_appendzConnection.user_agent_appendû  s   € ð 	Œ�Š�uÑÔÐÐÐr+   ÚGETc
                 óº  — |€i }nt          j         |¦  «        }|€i }nt          j         |¦  «        }t          j                             dd¦  «        pt          }
|	�|	}
|                      |¦  «        }|| _        || _        || _        |  	                    |¦  «        }| j
        r|dk    r|                      |¬¦  «        }|                      |¦  «        }|                     d|                      ¦   «         i¦  «         |                     ddi¦  «         t          | j        ¦  «        }|d	vr"|                     d
d| j        |fz  i¦  «         n|                     d
| j        i¦  «         |r|                      |¦  «        }|                      ||¦  «        \  }}|rRd|v r'd                     |t+          |d¬¦  «        f¦  «        }n)d                     |t+          |d¬¦  «        f¦  «        }n|}| j        €|                      ¦   «          | j        }|
r7|                      | j        | j        | j        ¬¦  «        } || j        ¦  «        } |||||||¬¦  «        S )a<  
        Request a given `action`.

        Basically a wrapper around the connection
        object's `request` that does some helpful pre-processing.

        :type action: ``str``
        :param action: A path. This can include arguments. If included,
            any extra parameters are appended to the existing ones.

        :type params: ``dict``
        :param params: Optional mapping of additional parameters to send. If
            None, leave as an empty ``dict``.

        :type data: ``unicode``
        :param data: A body of data to send with the request.

        :type headers: ``dict``
        :param headers: Extra headers to add to the request
            None, leave as an empty ``dict``.

        :type method: ``str``
        :param method: An HTTP method such as "GET" or "POST".

        :type raw: ``bool``
        :param raw: True to perform a "raw" request aka only send the headers
                     and use the rawResponseCls class. This is used with
                     storage API when uploading a file.

        :type stream: ``bool``
        :param stream: True to return an iterator in Response.iter_content
                    and allow streaming of the response data
                    (for downloading large files)

        :param retry_failed: True if failed requests should be retried. This
                              argument can override module level constant and
                              environment variable value on per-request basis.

        :return: An :class:`Response` instance.
        :rtype: :class:`Response` instance

        NÚ#LIBCLOUD_RETRY_FAILED_HTTP_REQUESTSFrÑ   )Úparamsz
User-AgentzAccept-Encodingzgzip,deflate)r–   r“   ÚHostz%s:%dú?ú&T)Údoseq)r    rŸ   r¡   )r£   ÚmethodÚrawÚstreamrU   Údata)ÚcopyÚosÚenvironÚgetr   Úmorph_action_hookÚactionrÙ   rÜ   Úadd_default_paramsÚcache_bustingÚ_add_cache_busting_to_paramsÚadd_default_headersr¼   rÌ   r²   r�   rœ   Úencode_dataÚpre_connect_hookrÆ   r   rV   r¿   Ú_retryable_requestÚretryClsr    rŸ   r¡   )r(   râ   rÔ   rÜ   rU   rÙ   rÚ   rÛ   rz   Úretry_failedÚretry_enabledr�   r£   Úrequest_to_be_executedÚretry_requests                  r)   r\   zConnection.request  sŸ  € ðl ˆ>ØˆFˆFå”Y˜vÑ&Ô&ˆFàˆ?ØˆGˆGå”i Ñ(Ô(ˆGõ ŒJ�NŠNÐ@À%ÑHÔHð *Ý)ð 	ð Ð#Ø(ˆMà×'Ò'¨Ñ/Ô/ˆØˆŒØˆŒØˆŒ	ð ×(Ò(¨Ñ0Ô0ˆð Ôð 	F &¨E¢/ /Ø×6Ò6¸fÐ6ÑEÔEˆFð ×*Ò*¨7Ñ3Ô3ˆð 	�Š˜ d×&6Ò&6Ñ&8Ô&8Ð9Ñ:Ô:Ð:ð 	�ŠÐ)¨>Ð:Ñ;Ô;Ð;å�4”9‰~Œ~ˆà�yÐ Ð Ø�NŠN˜F G¨t¬y¸$Ð.?Ñ$?Ð@ÑAÔAÐAÐAà�NŠN˜F D¤IÐ.Ñ/Ô/Ð/àð 	*Ø×#Ò# DÑ)Ô)ˆDà×/Ò/°¸Ñ@Ô@‰ˆ�àð 	Ø�fˆ}ˆ}Ø—h’h ­	°&ÀÐ(EÑ(EÔ(EÐFÑGÔG��à—h’h ­	°&ÀÐ(EÑ(EÔ(EÐFÑGÔG��àˆCð Œ?Ð"Ø�LŠL‰NŒNˆNà!%Ô!8Ðàð 	LØ ŸMšMØ Ô,°d´lÈDÌLð *ñ ô ˆMð &3 ]°4Ô3JÑ%KÔ%KÐ"à%Ð%Ø˜F¨°FÀGÐRVð
ñ 
ô 
ð 	
r+   r£   rÜ   rU   rÙ   rÚ   rÛ   Úreturnc                 ó4  — 	 | j         €J ‚|r!| j                              ||||||¬¦  «         n| j                              |||||¬¦  «         nÊ# t          j        $ rq}t          |¦  «        }t          |dd ¦  «        }	|	dk    r0| j        j        }
|›d|
›d| j	        ›d�}t          j        |¦  «        ‚|  
                    ¦   «          |‚d }~wt          j        $ r:}|  
                    ¦   «          t          j        t          |¦  «        ¦  «        ‚d }~ww xY w|r$| j        }| | j                              ¦   «         dœ}n#| j        }| | j                              ¦   «         dœ}	  |d	i |¤Ž}|  
                    ¦   «          n# |  
                    ¦   «          w xY w|S )
N)rÙ   r£   r`   rU   rÚ   rÛ   )rÙ   r£   r`   rU   rÛ   Úerrnoéûÿÿÿz-. Perhaps "host" Connection class attribute (z7.connection) is set to an invalid, non-hostname value (z)?)rV   rd   r&   )rV   Úprepared_requestr\   ÚsocketÚgaierrorÚstrr1   Ú	__class__r=   rœ   r«   ÚsslÚSSLErrorÚrawResponseClsr�   ÚresponseCls)r(   r£   rÜ   rU   rÙ   rÚ   rÛ   ÚerT   rñ   Ú
class_nameÚmsgrû   r¾   rd   s                  r)   ré   zConnection._retryable_requestŠ  s  € ð'	'ð ”?Ð.Ð.Ð.àð Ø”×0Ò0Ø!ØØØ#ØØ!ð 1ñ ô ð ð ð ”×'Ò'Ø! s°¸wÈvð (ñ ô ð øøõ Œð 	ð 	ð 	Ý˜!‘f”fˆGÝ˜A˜w¨Ñ-Ô-ˆEà˜Š{ˆ{ð
 "œ^Ô4�
ð &- W W¨j¨j¨j¸$¼)¸)¸)ðEð õ
 ”o cÑ*Ô*Ð*Ø×ÒÑ Ô Ð ØˆGøøøøÝŒ|ð 	'ð 	'ð 	'Ø×ÒÑ Ô Ð Ý”,�s 1™vœvÑ&Ô&Ð&øøøøð	'øøøð ð 	UØÔ-ˆKØ$(°d´o×6QÒ6QÑ6SÔ6SÐTÐTˆFˆFàÔ*ˆKØ$(°d´o×6QÒ6QÑ6SÔ6SÐTÐTˆFð	!Ø"�{Ð,Ð, VÐ,Ð,ˆHð ×ÒÑ Ô Ð Ð øˆD×ÒÑ Ô Ð Ð øøøàˆs1   ‚AA ÁDÁA,C	Ã	DÃ5DÄDÅ"E? Å?Fc                 ó  — t           r
| j        |z   S t          j        | j                             d¦  «                             d¦  «        dz   |                     d¦  «        ¦  «        }|                     d¦  «        sd|z   S |S )as  
        Here we strip any duplicated leading or trailing slashes to
        prevent typos and other issues where some APIs don't correctly
        handle double slashes.

        Keep in mind that in some situations, "/" is a valid path name
        so we have a module flag which disables this behavior
        (https://github.com/apache/libcloud/issues/1529).
        ú/)ÚALLOW_PATH_DOUBLE_SLASHESr›   r   ÚurljoinÚlstripÚrstripÚ
startswith)r(   râ   r£   s      r)   rá   zConnection.morph_action_hookË  s…   € õ %ð 	.ð Ô$ vÑ-Ð-åÔ˜tÔ0×7Ò7¸Ñ<Ô<×CÒCÀCÑHÔHÈ3ÑNÐPV×P]ÒP]Ð^aÑPbÔPbÑcÔcˆà�~Š~˜cÑ"Ô"ð 	Ø˜‘9ÐàˆJr+   c                 ó   — |S )zŽ
        Adds default parameters (such as API key, version, etc.)
        to the passed `params`

        Should return a dictionary.
        r&   )r(   rÔ   s     r)   rã   zConnection.add_default_paramsá  s	   € ð ˆr+   c                 ó   — |S )zŽ
        Adds default headers (such as Authorization, X-Foo-Bar)
        to the passed `headers`

        Should return a dictionary.
        r&   )r(   rU   s     r)   ræ   zConnection.add_default_headersê  s	   € ð ˆr+   c                 ó
   — ||fS )aK  
        A hook which is called before connecting to the remote server.
        This hook can perform a final manipulation on the params, headers and
        url parameters.

        :type params: ``dict``
        :param params: Request parameters.

        :type headers: ``dict``
        :param headers: Request headers.
        r&   )r(   rÔ   rU   s      r)   rè   zConnection.pre_connect_hookó  s   € ð �wˆÐr+   c                 ó   — |S )zO
        Encode body data.

        Override in a provider's subclass.
        r&   )r(   rÜ   s     r)   rç   zConnection.encode_data  s	   € ð ˆr+   c                 óÜ   — t          j        t          j        d¦  «        ¦  «                             d¦  «        }t          |t          ¦  «        r||d<   n|                     d|f¦  «         |S )a(  
        Add cache busting parameter to the query parameters of a GET request.

        Parameters are only added if "cache_busting" class attribute is set to
        True.

        Note: This should only be used with *naughty* providers which use
        excessive caching of responses.
        é   Úasciizcache-busting)ÚbinasciiÚhexlifyrÞ   ÚurandomÚdecoder§   rW   rÎ   )r(   rÔ   Úcache_busting_values      r)   rå   z'Connection._add_cache_busting_to_params	  sh   € õ 'Ô.­r¬z¸!©}¬}Ñ=Ô=×DÒDÀWÑMÔMÐå�f�dÑ#Ô#ð 	BØ&9ˆF�?Ñ#Ð#à�MŠM˜?Ð,?Ð@ÑAÔAÐAàˆr+   ©TNNNNNNN)NNN)NNNrÑ   FFNN)-r=   r>   r?   rE   r   r½   r   rû   r   rú   r   rê   rV   rœ   r�   rŸ   r—   rx   râ   rä   r¡   r    rš   r*   r¥   r©   r«   rž   r¿   rÌ   rÐ   r\   rö   Úbytesr   r   Úboolr   ré   rá   rã   ræ   rè   rç   rå   r&   r+   r)   r   r   ;  s  € € € € € ðð ð $€Jà€KØ €NØ€HØ€JØ€DØ€DØ€GØ€FØ€FØ€FØ€MØ€GØ€Kà€Nð ØØØØØØØð,#ð ,#ð ,#ð ,#ð\<ð <ð <ð"ð ð ðð ð ð2ð 2ð 2ð47%ð 7%ð 7%ð 7%ðrð ð ð
ð 
ð 
ð ØØØØØØØðA
ð A
ð A
ð A
ðF?àð?ð ð?ð �c˜3�h”ð	?ð
 ð?ð ð?ð ð?ð 
ˆ{˜HÐ$Ô	%ð?ð ?ð ?ð ?ðBð ð ð,ð ð ðð ð ðð ð ðð ð ðð ð ð ð r+   r   c                   ó>   — e Zd ZdZdZdZdZ	 dd„Z	 dd„Zd	„ Z	d
„ Z
dS )r   zû
    Connection class which can also work with the async APIs.

    After initial requests, this class periodically polls for jobs status and
    waits until the job has finished.
    If job doesn't finish in timeout seconds, an Exception thrown.
    g      à?éÈ   r\   NrÑ   c                 óè  — t          | | j        ¦  «        }|                      ||||||¬¦  «        } |di |¤Ž}	|                      |	||¬¦  «        }t	          j        ¦   «         | j        z   }
d}t	          j        ¦   «         |
k     rT|sR |di |¤Ž}	|                      |	¬¦  «        }|st	          j        | j        ¦  «         t	          j        ¦   «         |
k     r|¯R|st          d| j        z  ¦  «        ‚|	S )aá  
        Perform an 'async' request to the specified path. Keep in mind that
        this function is *blocking* and 'async' in this case means that the
        hit URL only returns a job ID which is the periodically polled until
        the job has completed.

        This function works like this:

        - Perform a request to the specified path. Response should contain a
          'job_id'.

        - Returned 'job_id' is then used to construct a URL which is used for
          retrieving job status. Constructed URL is then periodically polled
          until the response indicates that the job has completed or the
          timeout of 'self.timeout' seconds has been reached.

        :type action: ``str``
        :param action: A path

        :type params: ``dict``
        :param params: Optional mapping of additional parameters to send. If
            None, leave as an empty ``dict``.

        :type data: ``unicode``
        :param data: A body of data to send with the request.

        :type headers: ``dict``
        :param headers: Extra headers to add to the request
            None, leave as an empty ``dict``.

        :type method: ``str``
        :param method: An HTTP method such as "GET" or "POST".

        :type context: ``dict``
        :param context: Context dictionary which is passed to the functions
                        which construct initial and poll URL.

        :return: An :class:`Response` instance.
        :rtype: :class:`Response` instance
        )râ   rÔ   rÜ   rU   rÙ   r™   )rd   r™   Úrequest_kwargsF)rd   z"Job did not complete in %s secondsr&   )
r1   Úrequest_methodÚget_request_kwargsÚget_poll_request_kwargsÚtimerŸ   Úhas_completedÚsleepÚpoll_intervalr   )r(   râ   rÔ   rÜ   rU   rÙ   r™   r\   r¾   rd   ÚendÚ	completeds               r)   Úasync_requestzPollingConnection.async_request*  s.  € õX ˜$ Ô 3Ñ4Ô4ˆØ×(Ò(ØØØØØØð )ñ 
ô 
ˆð �7Ð$Ð$˜VÐ$Ð$ˆØ×-Ò-Ø w¸vð .ñ 
ô 
ˆõ Œi‰kŒk˜DœLÑ(ˆØˆ	ÝŒi‰kŒk˜CÒÐ¨	ÐØ�wÐ(Ð( Ð(Ð(ˆHØ×*Ò*°HÐ*Ñ=Ô=ˆIØð /Ý”
˜4Ô-Ñ.Ô.Ð.õ	 Œi‰kŒk˜CÒÐ¨	Ðð ð 	WÝÐ DÈÌÑ UÑVÔVÐVàˆr+   c                 ó   — |||||dœ}|S )zh
        Arguments which are passed to the initial request() call inside
        async_request.
        )râ   rÔ   rÜ   rU   rÙ   r&   )r(   râ   rÔ   rÜ   rU   rÙ   r™   r¾   s           r)   r  z$PollingConnection.get_request_kwargsq  s&   € ð ØØØØð
ð 
ˆð ˆr+   c                 ó    — t          d¦  «        ‚)a²  
        Return keyword arguments which are passed to the request() method when
        polling for the job status.

        :param response: Response object returned by poll request.
        :type response: :class:`HTTPResponse`

        :param request_kwargs: Kwargs previously used to initiate the
                                  poll request.
        :type response: ``dict``

        :return ``dict`` Keyword arguments
        z'get_poll_request_kwargs not implemented©ÚNotImplementedError)r(   rd   r™   r  s       r)   r  z)PollingConnection.get_poll_request_kwargs�  s   € õ "Ð"KÑLÔLÐLr+   c                 ó    — t          d¦  «        ‚)zë
        Return job completion status.

        :param response: Response object returned by poll request.
        :type response: :class:`HTTPResponse`

        :return ``bool`` True if the job has completed, False otherwise.
        zhas_completed not implementedr%  rŽ   s     r)   r  zPollingConnection.has_completed‘  s   € õ "Ð"AÑBÔBÐBr+   )NNNrÑ   N)r=   r>   r?   rE   r  rŸ   r  r"  r  r  r  r&   r+   r)   r   r     s�   € € € € € ðð ð €MØ€GØ€Nð SWðEð Eð Eð EðP SWðð ð ð ð Mð Mð Mð 	Cð 	Cð 	Cð 	Cð 	Cr+   r   c                   ó4   ‡ — e Zd ZdZ	 	 	 	 	 	 	 	 dˆ fd„	Zˆ xZS )r   zH
    Base connection class which accepts a single ``key`` argument.
    TNc
           
      óh   •— t          ¦   «                              ||||||||	¬¦  «         || _        dS )zk
        Initialize `user_id` and `key`; set `secure` to an ``int`` based on
        passed value.
        )r—   rœ   r�   r£   rŸ   r¢   r¡   r    N)Úsuperr*   Úkey)r(   r+  r—   rœ   r�   r£   rŸ   r¢   r¡   r    r÷   s             €r)   r*   zConnectionKey.__init__¢  sK   ø€ õ  	‰Œ×ÒØØØØØØØØ#ð 	ñ 		
ô 		
ð 		
ð ˆŒˆˆr+   r  ©r=   r>   r?   rE   r*   Ú__classcell__©r÷   s   @r)   r   r   �  sa   ø€ € € € € ðð ð ØØØØØØØðð ð ð ð ð ð ð ð ð r+   r   c                   ó4   ‡ — e Zd ZdZ	 	 	 	 	 	 	 	 dˆ fd„	Zˆ xZS )r   zN
    Base connection class which accepts a single ``cert_file`` argument.
    TNc
           
      óh   •— t          ¦   «                              |||||||	|¬¦  «         || _        dS ©zc
        Initialize `cert_file`; set `secure` to an ``int`` based on
        passed value.
        ©r—   rœ   r�   r£   rŸ   r¡   r    r¢   N)r*  r*   r»   )r(   r»   r—   rœ   r�   r£   r¢   rŸ   r¡   r    r÷   s             €r)   r*   zCertificateConnection.__init__Ä  sK   ø€ õ  	‰Œ×ÒØØØØØØØ#Øð 	ñ 		
ô 		
ð 		
ð #ˆŒˆˆr+   r  r,  r.  s   @r)   r   r   ¿  sa   ø€ € € € € ðð ð ØØØØØØØð#ð #ð #ð #ð #ð #ð #ð #ð #ð #r+   r   c                   ó:   ‡ — e Zd ZdZdZ	 	 	 	 	 	 	 	 	 dˆ fd„	Zˆ xZS )ÚKeyCertificateConnectionz_
    Base connection class which accepts both ``key_file`` and ``cert_file``
    argument.
    NTc                 ój   •— t          ¦   «                              |||||||	|
|¬¦	  «	         || _        dS r1  )r*  r*   rº   )r(   rº   r»   r—   rœ   r�   r£   r¢   rŸ   r¡   r    Úca_certr÷   s               €r)   r*   z!KeyCertificateConnection.__init__ê  sN   ø€ õ$ 	‰Œ×ÒØØØØØØØØ#Øð 	ñ 
	
ô 
	
ð 
	
ð !ˆŒˆˆr+   )	TNNNNNNNN)r=   r>   r?   rE   rº   r*   r-  r.  s   @r)   r4  r4  â  sk   ø€ € € € € ðð ð
 €Hð ØØØØØØØØð!ð !ð !ð !ð !ð !ð !ð !ð !ð !r+   r4  c                   ó8   ‡ — e Zd ZdZdZ	 	 	 	 	 	 	 	 dˆ fd„	Zˆ xZS )r   zQ
    Base connection class which accepts a ``user_id`` and ``key`` argument.
    NTc                 ój   •— t          ¦   «                              |||||||	|
|¬¦	  «	         || _        d S )Nr2  )r*  r*   Úuser_id)r(   r9  r+  r—   rœ   r�   r£   rŸ   r¢   r¡   r    r÷   s              €r)   r*   zConnectionUserAndKey.__init__  sN   ø€ õ 	‰Œ×ÒØØØØØØØØ#Øð 	ñ 
	
ô 
	
ð 
	
ð ˆŒˆˆr+   r  )r=   r>   r?   rE   r9  r*   r-  r.  s   @r)   r   r     sh   ø€ € € € € ðð ð €Gð ØØØØØØØðð ð ð ð ð ð ð ð ð r+   r   c                   ó0   — e Zd ZdZeZ	 	 	 	 	 	 dd„Zd„ ZdS )r   zF
    Base driver class from which other classes can inherit from.
    NTc           	      ó¾  — || _         || _        || _        || _        || _        |                      ¦   «         }	|	                     |                     dd¦  «        |                     dd¦  «        |                     dd¦  «        |                     dd¦  «        dœ¦  «         | j         g}
| j        �|
                     | j        ¦  «         |
                     |¦  «         |	                     dd¦  «        p|}|�|
                     |¦  «         |�|
                     |¦  «          | j	        |
i |	¤Ž| _
        | | j
        _        | j
                             ¦   «          dS )a¶  
        :param    key:    API key or username to be used (required)
        :type     key:    ``str``

        :param    secret: Secret password to be used (required)
        :type     secret: ``str``

        :param    secure: Whether to use HTTPS or HTTP. Note: Some providers
                            only support HTTPS, and it is on by default.
        :type     secure: ``bool``

        :param    host: Override hostname used for connections.
        :type     host: ``str``

        :param    port: Override port used for connections.
        :type     port: ``int``

        :param    api_version: Optional API version. Only used by drivers
                                 which support multiple API versions.
        :type     api_version: ``str``

        :param region: Optional driver region. Only used by drivers which
                       support multiple regions.
        :type region: ``str``

        :rtype: ``None``
        rŸ   Nr    r¡   r¢   )rŸ   r    r¡   r¢   rœ   )r+  Úsecretr—   Úapi_versionÚregionÚ_ex_connection_class_kwargsr¼   ÚpoprÎ   ÚconnectionClsrV   rx   r¿   )r(   r+  r<  r—   rœ   r�   r=  r>  r¾   Úconn_kwargsÚargss              r)   r*   zBaseDriver.__init__4  s^  € ðN ˆŒØˆŒØˆŒØ&ˆÔØˆŒà×6Ò6Ñ8Ô8ˆØ×Òà!Ÿ:š: i°Ñ6Ô6Ø%Ÿzšz¨-¸Ñ>Ô>Ø!Ÿ:š: i°Ñ6Ô6Ø#ŸZšZ¨°TÑ:Ô:ð	ð ñ	
ô 	
ð 	
ð ”ˆzˆàŒ;Ð"Ø�KŠK˜œÑ$Ô$Ð$à�Š�FÑÔÐà�Š˜v tÑ,Ô,Ð4°ˆàÐØ�KŠK˜ÑÔÐàÐØ�KŠK˜ÑÔÐà,˜$Ô,¨dÐB°kÐBÐBˆŒØ!%ˆŒÔØŒ×ÒÑ!Ô!Ð!Ð!Ð!r+   c                 ó   — i S )zy
        Return extra connection keyword arguments which are passed to the
        Connection class constructor.
        r&   r'   s    r)   r?  z&BaseDriver._ex_connection_class_kwargs~  s	   € ð
 ˆ	r+   )NTNNNN)r=   r>   r?   rE   r   rA  r*   r?  r&   r+   r)   r   r   -  sa   € € € € € ðð ð "€Mð
 ØØØØØðH"ð H"ð H"ð H"ðTð ð ð ð r+   r   )/rÞ   rø   rÝ   rz   r  rô   r  Útypingr   r   r   r   r   rÇ   Úlibcloud.httpr   r	   Úlibcloud.utils.py3r
   r   r   r   Úlibcloud.utils.miscr   Úlibcloud.utils.retryr   Úlibcloud.common.typesr   r   Úlibcloud.common.exceptionsr   Ú__all__r   r  r    r   r   r   r   r   r   r   r   r   r4  r   r   r&   r+   r)   ú<module>rM     s  ðð  
€	€	€	Ø 
€
€
€
Ø €€€Ø €€€Ø €€€Ø €€€Ø €€€Ø 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3Ð 3à €€€Ø BÐ BÐ BÐ BÐ BÐ BÐ BÐ BØ ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ð ?Ø .Ð .Ð .Ð .Ð .Ð .Ø &Ð &Ð &Ð &Ð &Ð &Ø GÐ GÐ GÐ GÐ GÐ GÐ GÐ GØ =Ð =Ð =Ð =Ð =Ð =ðð ð €ð  #Ð ð "Ð ð ?ð  ?ð  ?ð  ?ð  ?ñ  ?ô  ?ð  ?ðF4ð 4ð 4ð 4ð 4�7Ô'ñ 4ô 4ð 4ð"\
ð \
ð \
ð \
ð \
ñ \
ô \
ð \
ð~ð ð ð ð �8ñ ô ð ð(ð ð ð ð �(ñ ô ð ð0>ð >ð >ð >ð >�(ñ >ô >ð >ðB_ð _ð _ð _ð _ñ _ô _ð _ðD}Cð }Cð }Cð }Cð }C˜
ñ }Cô }Cð }Cð@ð ð ð ð �Jñ ô ð ðD #ð  #ð  #ð  #ð  #˜Jñ  #ô  #ð  #ðF&!ð &!ð &!ð &!ð &!Ð4ñ &!ô &!ð &!ðRð ð ð ð ˜=ñ ô ð ðDVð Vð Vð Vð Vñ Vô Vð Vð Vð Vr+   