§
    ÎÑßj„  ã                   óö   — d 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mZ ddlZddlmZmZ ddlmZmZmZ ddlmZ ddlmZ g d	¢Zd
ZdZ G d„ d¦  «        Z G d„ d¦  «        Z G d„ de¦  «        Z dS )z0
Provides base classes for working with storage
é    N)ÚDictÚListÚTypeÚIteratorÚOptional)Újoin)ÚbÚhttplib)Ú
BaseDriverÚ
ConnectionÚConnectionUserAndKey)ÚLibcloudError)ÚObjectDoesNotExistError)ÚObjectÚ	ContainerÚStorageDriverÚ
CHUNK_SIZEÚDEFAULT_CONTENT_TYPEi   zapplication/octet-streamc                   óV   — e Zd ZdZd„ Zd„ Zd„ Zdd„Zdd	„Z	 	 	 dd
„Z	dd„Z
d„ Zd„ ZdS )r   z&
    Represents an object (BLOB).
    c                 óp   — || _         || _        || _        || _        |pi | _        |pi | _        || _        dS )au  
        :param name: Object name (must be unique per container).
        :type  name: ``str``

        :param size: Object size in bytes.
        :type  size: ``int``

        :param hash: Object hash.
        :type  hash: ``str``

        :param container: Object container.
        :type  container: :class:`libcloud.storage.base.Container`

        :param extra: Extra attributes.
        :type  extra: ``dict``

        :param meta_data: Optional object meta data.
        :type  meta_data: ``dict``

        :param driver: StorageDriver instance.
        :type  driver: :class:`libcloud.storage.base.StorageDriver`
        N)ÚnameÚsizeÚhashÚ	containerÚextraÚ	meta_dataÚdriver)Úselfr   r   r   r   r   r   r   s           úI/opt/saltstack/salt/lib/python3.11/site-packages/libcloud/storage/base.pyÚ__init__zObject.__init__1   sB   € ðB ˆŒ	ØˆŒ	ØˆŒ	Ø"ˆŒØ�[˜bˆŒ
Ø"˜ bˆŒØˆŒˆˆó    c                 ó8   — | j                              | ¬¦  «        S ©N)Úobj)r   Úget_object_cdn_url©r   s    r   Úget_cdn_urlzObject.get_cdn_urlZ   s   € àŒ{×-Ò-°$Ð-Ñ7Ô7Ð7r!   c                 ó8   — | j                              | ¬¦  «        S r#   )r   Úenable_object_cdnr&   s    r   Ú
enable_cdnzObject.enable_cdn^   s   € àŒ{×,Ò,°Ð,Ñ6Ô6Ð6r!   FTc                 ó>   — | j                              | |||¬¦  «        S )N)r$   Údestination_pathÚoverwrite_existingÚdelete_on_failure©r   Údownload_object)r   r,   r-   r.   s       r   ÚdownloadzObject.downloadb   s-   € àŒ{×*Ò*ØØ-Ø1Ø/ð	 +ñ 
ô 
ð 	
r!   Nc                 ó:   — | j                              | |¬¦  «        S )N)r$   Ú
chunk_size©r   Údownload_object_as_stream)r   r3   s     r   Ú	as_streamzObject.as_streamk   s   € àŒ{×4Ò4¸È*Ð4ÑUÔUÐUr!   c                 óB   — | j                              | |||||¬¦  «        S ©N)r$   r,   Ústart_bytesÚ	end_bytesr-   r.   ©r   Údownload_object_range)r   r,   r9   r:   r-   r.   s         r   Údownload_rangezObject.download_rangeo   s5   € ð Œ{×0Ò0ØØ-Ø#ØØ1Ø/ð 1ñ 
ô 
ð 	
r!   c                 ó>   — | j                              | |||¬¦  «        S ©N)r$   r9   r:   r3   ©r   Údownload_object_range_as_stream)r   r9   r:   r3   s       r   Úrange_as_streamzObject.range_as_stream�   s-   € àŒ{×:Ò:ØØ#ØØ!ð	 ;ñ 
ô 
ð 	
r!   c                 ó6   — | j                              | ¦  «        S ©N©r   Údelete_objectr&   s    r   ÚdeletezObject.deleteŠ   s   € àŒ{×(Ò(¨Ñ.Ô.Ð.r!   c                 ód   — d                      | j        | j        | j        | j        j        ¦  «        S )Nz4<Object: name={}, size={}, hash={}, provider={} ...>)Úformatr   r   r   r   r&   s    r   Ú__repr__zObject.__repr__Ž   s1   € ØE×LÒLØŒIØŒIØŒIØŒKÔñ	
ô 
ð 	
r!   ©FTrD   ©NFT©NN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r    r'   r*   r1   r6   r=   rB   rG   rJ   © r!   r   r   r   ,   sÉ   € € € € € ðð ð'ð 'ð 'ðR8ð 8ð 8ð7ð 7ð 7ð
ð 
ð 
ð 
ðVð Vð Vð Vð Ø Øð
ð 
ð 
ð 
ð$
ð 
ð 
ð 
ð/ð /ð /ð
ð 
ð 
ð 
ð 
r!   r   c                   ó„   — e Zd ZdZd„ Zdd„Zdd„Zd„ Zd„ Zd„ Z	dd
„Z
dd„Z	 dd„Zdd„Z	 	 	 dd„Zdd„Zd„ Zd„ Zd„ ZdS )r   zJ
    Represents a container (bucket) which can hold multiple objects.
    c                 ó4   — || _         |pi | _        || _        dS )a  
        :param name: Container name (must be unique).
        :type name: ``str``

        :param extra: Extra attributes.
        :type extra: ``dict``

        :param driver: StorageDriver instance.
        :type driver: :class:`libcloud.storage.base.StorageDriver`
        N)r   r   r   )r   r   r   r   s       r   r    zContainer.__init__œ   s!   € ð" ˆŒ	Ø�[˜bˆŒ
ØˆŒˆˆr!   Nc                 ó<   — | j                              | ||¬¦  «        S ©N)r   ÚprefixÚ	ex_prefix)r   Úiterate_container_objects©r   rW   rX   s      r   Úiterate_objectszContainer.iterate_objects±   s(   € àŒ{×4Ò4Ø 6°Yð 5ñ 
ô 
ð 	
r!   c                 ó<   — | j                              | ||¬¦  «        S rV   )r   Úlist_container_objectsrZ   s      r   Úlist_objectszContainer.list_objects·   s(   € àŒ{×1Ò1Ø 6°Yð 2ñ 
ô 
ð 	
r!   c                 ó8   — | j                              | ¬¦  «        S ©N)r   )r   Úget_container_cdn_urlr&   s    r   r'   zContainer.get_cdn_url½   s   € àŒ{×0Ò0¸4Ð0Ñ@Ô@Ð@r!   c                 ó8   — | j                              | ¬¦  «        S r`   )r   Úenable_container_cdnr&   s    r   r*   zContainer.enable_cdnÁ   s   € àŒ{×/Ò/¸$Ð/Ñ?Ô?Ð?r!   c                 óD   — | j                              | j        |¬¦  «        S )N)Úcontainer_nameÚobject_name)r   Ú
get_objectr   )r   rf   s     r   rg   zContainer.get_objectÅ   s   € àŒ{×%Ò%°T´YÈKÐ%ÑXÔXÐXr!   Tc                 óB   — | j                              || ||||¬¦  «        S )N)r   Úverify_hashÚheaders)r   Úupload_object)r   Ú	file_pathrf   r   ri   rj   s         r   rk   zContainer.upload_objectÉ   s3   € àŒ{×(Ò(ØØØØØ#Øð )ñ 
ô 
ð 	
r!   c                 ó@   — | j                              || |||¬¦  «        S )N)r   rj   )r   Úupload_object_via_stream)r   Úiteratorrf   r   rj   s        r   rn   z"Container.upload_object_via_streamÔ   s,   € àŒ{×3Ò3Ø�d˜K¨u¸gð 4ñ 
ô 
ð 	
r!   Fc                 ó>   — | j                              ||||¬¦  «        S )N)r-   r.   r/   ©r   r$   r,   r-   r.   s        r   r0   zContainer.download_objectÚ   s/   € ð Œ{×*Ò*ØØØ1Ø/ð	 +ñ 
ô 
ð 	
r!   c                 ó8   — | j                              ||¦  «        S rD   r4   ©r   r$   r3   s      r   r5   z#Container.download_object_as_streamå   s   € àŒ{×4Ò4°S¸*ÑEÔEÐEr!   c                 óB   — | j                              ||||||¬¦  «        S r8   r;   ©r   r$   r,   r9   r:   r-   r.   s          r   r<   zContainer.download_object_rangeé   s5   € ð Œ{×0Ò0ØØ-Ø#ØØ1Ø/ð 1ñ 
ô 
ð 	
r!   c                 ó>   — | j                              ||||¬¦  «        S r?   r@   ©r   r$   r9   r:   r3   s        r   rA   z)Container.download_object_range_as_streamü   s*   € àŒ{×:Ò:Ø ¸	Èjð ;ñ 
ô 
ð 	
r!   c                 ó6   — | j                              |¦  «        S rD   rE   ©r   r$   s     r   rF   zContainer.delete_object  s   € àŒ{×(Ò(¨Ñ-Ô-Ð-r!   c                 ó6   — | j                              | ¦  «        S rD   )r   Údelete_containerr&   s    r   rG   zContainer.delete  s   € àŒ{×+Ò+¨DÑ1Ô1Ð1r!   c                 óL   — d                      | j        | j        j        ¦  «        S )Nz!<Container: name={}, provider={}>)rI   r   r   r&   s    r   rJ   zContainer.__repr__
  s   € Ø2×9Ò9¸$¼)ÀTÄ[ÔEUÑVÔVÐVr!   rM   ©NTNrK   rD   rL   )rN   rO   rP   rQ   r    r[   r^   r'   r*   rg   rk   rn   r0   r5   r<   rA   rF   rG   rJ   rR   r!   r   r   r   —   sK  € € € € € ðð ðð ð ð*
ð 
ð 
ð 
ð
ð 
ð 
ð 
ðAð Að Að@ð @ð @ðYð Yð Yð	
ð 	
ð 	
ð 	
ð
ð 
ð 
ð 
ð RVð	
ð 	
ð 	
ð 	
ðFð Fð Fð Fð Ø Øð
ð 
ð 
ð 
ð&
ð 
ð 
ð 
ð.ð .ð .ð2ð 2ð 2ðWð Wð Wð Wð Wr!   r   c                   ó  — e Zd ZdZeZdZdZdZdZ	d„ Z
d„ Zd%d„Zd%d„Zd	„ Zd
„ Zd„ Zd„ Zd„ Zd„ Zd„ Zd„ Z	 d&d„Zd'd„Z	 	 	 d(d„Zd%d„Z	 	 	 d)d„Zd%d„Zd„ Zd„ Zd„ Zd'd„Z	 	 	 	 d*d„Z 	 	 	 	 	 	 d+d„Z!d'd„Z"d,d!„Z#d"„ Z$d'd#„Z%d-d$„Z&dS ).r   z.
    A base StorageDriver to derive from.
    NÚmd5Fc                 ó    — t          d¦  «        ‚)zÅ
        Return a iterator of containers for the given account

        :return: A iterator of Container instances.
        :rtype: ``iterator`` of :class:`libcloud.storage.base.Container`
        z2iterate_containers not implemented for this driver©ÚNotImplementedErrorr&   s    r   Úiterate_containersz StorageDriver.iterate_containers  s   € õ "Ð"VÑWÔWÐWr!   c                 óD   — t          |                      ¦   «         ¦  «        S )zŽ
        Return a list of containers.

        :return: A list of Container instances.
        :rtype: ``list`` of :class:`Container`
        )Úlistrƒ   r&   s    r   Úlist_containerszStorageDriver.list_containers&  s   € õ �D×+Ò+Ñ-Ô-Ñ.Ô.Ð.r!   c                 ó    — t          d¦  «        ‚)aÿ  
        Return a iterator of objects for the given container.

        :param container: Container instance
        :type container: :class:`libcloud.storage.base.Container`

        :param prefix: Filter objects starting with a prefix.
        :type  prefix: ``str``

        :param ex_prefix: (Deprecated.) Filter objects starting with a prefix.
        :type  ex_prefix: ``str``

        :return: A iterator of Object instances.
        :rtype: ``iterator`` of :class:`libcloud.storage.base.Object`
        z9iterate_container_objects not implemented for this driverr�   ©r   r   rW   rX   s       r   rY   z'StorageDriver.iterate_container_objects0  s   € õ" "Ð"]Ñ^Ô^Ð^r!   c                 óL   — t          |                      |||¬¦  «        ¦  «        S )aô  
        Return a list of objects for the given container.

        :param container: Container instance.
        :type container: :class:`libcloud.storage.base.Container`

        :param prefix: Filter objects starting with a prefix.
        :type  prefix: ``str``

        :param ex_prefix: (Deprecated.) Filter objects starting with a prefix.
        :type  ex_prefix: ``str``

        :return: A list of Object instances.
        :rtype: ``list`` of :class:`libcloud.storage.base.Object`
        )rW   rX   )r…   rY   rˆ   s       r   r]   z$StorageDriver.list_container_objectsC  s(   € õ" �D×2Ò2°9ÀVÐW`Ð2ÑaÔaÑbÔbÐbr!   c                 óB   — |rt          j        dt          ¦  «         |S |S )NzOThe ``ex_prefix`` argument is deprecated - please update code to use ``prefix``)ÚwarningsÚwarnÚDeprecationWarningrZ   s      r   Ú_normalize_prefix_argumentz(StorageDriver._normalize_prefix_argumentV  s3   € Øð 	ÝŒMð7å"ñô ð ð
 Ðàˆr!   c              #   óš   K  — |�!t          j        d| j        j        z  ¦  «         |D ]"}|�|j                             |¦  «        r|V — Œ#d S )NzgDriver %s does not implement native object filtering; falling back to filtering the full object stream.)r‹   rŒ   Ú	__class__rN   r   Ú
startswith)r   ÚobjectsrW   r$   s       r   Ú _filter_listed_container_objectsz.StorageDriver._filter_listed_container_objectsa  sp   è è € ØÐÝŒMð!à#'¤>Ô#:ñ;ñô ð ð ð 	ð 	ˆCØˆ~ ¤×!4Ò!4°VÑ!<Ô!<ˆ~Ø�	�	�	øð	ð 	r!   c                 ó    — t          d¦  «        ‚)zì
        Return a container instance.

        :param container_name: Container name.
        :type container_name: ``str``

        :return: :class:`Container` instance.
        :rtype: :class:`libcloud.storage.base.Container`
        ú*get_object not implemented for this driverr�   ©r   re   s     r   Úget_containerzStorageDriver.get_containerm  s   € õ "Ð"NÑOÔOÐOr!   c                 ó    — t          d¦  «        ‚)zæ
        Return a container CDN URL.

        :param container: Container instance
        :type  container: :class:`libcloud.storage.base.Container`

        :return: A CDN URL for this container.
        :rtype: ``str``
        z5get_container_cdn_url not implemented for this driverr�   ©r   r   s     r   ra   z#StorageDriver.get_container_cdn_urlz  s   € õ "Ð"YÑZÔZÐZr!   c                 ó    — t          d¦  «        ‚)a3  
        Return an object instance.

        :param container_name: Container name.
        :type  container_name: ``str``

        :param object_name: Object name.
        :type  object_name: ``str``

        :return: :class:`Object` instance.
        :rtype: :class:`libcloud.storage.base.Object`
        r•   r�   )r   re   rf   s      r   rg   zStorageDriver.get_object‡  s   € õ "Ð"NÑOÔOÐOr!   c                 ó    — t          d¦  «        ‚)zÏ
        Return an object CDN URL.

        :param obj: Object instance
        :type  obj: :class:`libcloud.storage.base.Object`

        :return: A CDN URL for this object.
        :rtype: ``str``
        z2get_object_cdn_url not implemented for this driverr�   ry   s     r   r%   z StorageDriver.get_object_cdn_url—  s   € õ "Ð"VÑWÔWÐWr!   c                 ó    — t          d¦  «        ‚)z²
        Enable container CDN.

        :param container: Container instance
        :type  container: :class:`libcloud.storage.base.Container`

        :rtype: ``bool``
        z4enable_container_cdn not implemented for this driverr�   r™   s     r   rc   z"StorageDriver.enable_container_cdn¤  s   € õ "Ð"XÑYÔYÐYr!   c                 ó    — t          d¦  «        ‚)z�
        Enable object CDN.

        :param obj: Object instance
        :type  obj: :class:`libcloud.storage.base.Object`

        :rtype: ``bool``
        z1enable_object_cdn not implemented for this driverr�   ry   s     r   r)   zStorageDriver.enable_object_cdn°  s   € õ "Ð"UÑVÔVÐVr!   Tc                 ó    — t          d¦  «        ‚)aƒ  
        Download an object to the specified destination path.

        :param obj: Object instance.
        :type obj: :class:`libcloud.storage.base.Object`

        :param destination_path: Full path to a file or a directory where the
                                 incoming file will be saved.
        :type destination_path: ``str``

        :param overwrite_existing: True to overwrite an existing file,
                                   defaults to False.
        :type overwrite_existing: ``bool``

        :param delete_on_failure: True to delete a partially downloaded file if
                                   the download was not successful (hash
                                   mismatch / file size).
        :type delete_on_failure: ``bool``

        :return: True if an object has been successfully downloaded, False
                 otherwise.
        :rtype: ``bool``
        z/download_object not implemented for this driverr�   rq   s        r   r0   zStorageDriver.download_object¼  s   € õ6 "Ð"SÑTÔTÐTr!   c                 ó    — t          d¦  «        ‚)a$  
        Return a iterator which yields object data.

        :param obj: Object instance
        :type obj: :class:`libcloud.storage.base.Object`

        :param chunk_size: Optional chunk size (in bytes).
        :type chunk_size: ``int``

        :rtype: ``iterator`` of ``bytes``
        z9download_object_as_stream not implemented for this driverr�   rs   s      r   r5   z'StorageDriver.download_object_as_streamÙ  s   € õ "Ð"]Ñ^Ô^Ð^r!   c                 ó    — t          d¦  «        ‚)a8  
        Download part of an object.

        :param obj: Object instance.
        :type obj: :class:`libcloud.storage.base.Object`

        :param destination_path: Full path to a file or a directory where the
                                 incoming file will be saved.
        :type destination_path: ``str``

        :param start_bytes: Start byte offset (inclusive) for the range
                            download. Offset is 0 index based so the first
                            byte in file file is "0".
        :type start_bytes: ``int``

        :param end_bytes: End byte offset (non-inclusive) for the range
                          download. If not provided, it will default to the
                          end of the file.
        :type end_bytes: ``int``

        :param overwrite_existing: True to overwrite an existing file,
                                   defaults to False.
        :type overwrite_existing: ``bool``

        :param delete_on_failure: True to delete a partially downloaded file if
                                   the download was not successful (hash
                                   mismatch / file size).
        :type delete_on_failure: ``bool``

        :return: True if an object has been successfully downloaded, False
                 otherwise.
        :rtype: ``bool``

        z5download_object_range not implemented for this driverr�   ru   s          r   r<   z#StorageDriver.download_object_rangeè  s   € õX "Ð"YÑZÔZÐZr!   c                 ó    — t          d¦  «        ‚)a  
        Return a iterator which yields range / part of the object data.

        :param obj: Object instance
        :type obj: :class:`libcloud.storage.base.Object`

        :param start_bytes: Start byte offset (inclusive) for the range
                            download. Offset is 0 index based so the first
                            byte in file file is "0".
        :type start_bytes: ``int``

        :param end_bytes: End byte offset (non-inclusive) for the range
                          download. If not provided, it will default to the
                          end of the file.
        :type end_bytes: ``int``

        :param chunk_size: Optional chunk size (in bytes).
        :type chunk_size: ``int``

        :rtype: ``iterator`` of ``bytes``
        z?download_object_range_as_stream not implemented for this driverr�   rw   s        r   rA   z-StorageDriver.download_object_range_as_stream  s   € õ. "Ð"cÑdÔdÐdr!   c                 ó    — t          d¦  «        ‚)a  
        Upload an object currently located on a disk.

        :param file_path: Path to the object on disk.
        :type file_path: ``str``

        :param container: Destination container.
        :type container: :class:`libcloud.storage.base.Container`

        :param object_name: Object name.
        :type object_name: ``str``

        :param verify_hash: Verify hash
        :type verify_hash: ``bool``

        :param extra: Extra attributes (driver specific). (optional)
        :type extra: ``dict``

        :param headers: (optional) Additional request headers,
            such as CORS headers. For example:
            headers = {'Access-Control-Allow-Origin': 'http://mozilla.com'}
        :type headers: ``dict``

        :rtype: :class:`libcloud.storage.base.Object`
        z-upload_object not implemented for this driverr�   )r   rl   r   rf   r   ri   rj   s          r   rk   zStorageDriver.upload_object/  s   € õF "Ð"QÑRÔRÐRr!   c                 ó    — t          d¦  «        ‚)a  
        Upload an object using an iterator.

        If a provider supports it, chunked transfer encoding is used and you
        don't need to know in advance the amount of data to be uploaded.

        Otherwise if a provider doesn't support it, iterator will be exhausted
        so a total size for data to be uploaded can be determined.

        Note: Exhausting the iterator means that the whole data must be
        buffered in memory which might result in memory exhausting when
        uploading a very large object.

        If a file is located on a disk you are advised to use upload_object
        function which uses fs.stat function to determine the file size and it
        doesn't need to buffer whole object in the memory.

        :param iterator: An object which implements the iterator interface.
        :type iterator: :class:`object`

        :param container: Destination container.
        :type container: :class:`libcloud.storage.base.Container`

        :param object_name: Object name.
        :type object_name: ``str``

        :param extra: (optional) Extra attributes (driver specific). Note:
            This dictionary must contain a 'content_type' key which represents
            a content type of the stored object.
        :type extra: ``dict``

        :param headers: (optional) Additional request headers,
            such as CORS headers. For example:
            headers = {'Access-Control-Allow-Origin': 'http://mozilla.com'}
        :type headers: ``dict``

        :rtype: ``libcloud.storage.base.Object``
        z8upload_object_via_stream not implemented for this driverr�   )r   ro   r   rf   r   rj   s         r   rn   z&StorageDriver.upload_object_via_streamT  s   € õP "Ð"\Ñ]Ô]Ð]r!   c                 ó    — t          d¦  «        ‚)zÇ
        Delete an object.

        :param obj: Object instance.
        :type obj: :class:`libcloud.storage.base.Object`

        :return: ``bool`` True on success.
        :rtype: ``bool``
        z-delete_object not implemented for this driverr�   ry   s     r   rF   zStorageDriver.delete_object~  s   € õ "Ð"QÑRÔRÐRr!   c                 ó    — t          d¦  «        ‚)zé
        Create a new container.

        :param container_name: Container name.
        :type container_name: ``str``

        :return: Container instance on success.
        :rtype: :class:`libcloud.storage.base.Container`
        z0create_container not implemented for this driverr�   r–   s     r   Úcreate_containerzStorageDriver.create_container‹  ó   € õ "Ð"TÑUÔUÐUr!   c                 ó    — t          d¦  «        ‚)zê
        Delete a container.

        :param container: Container instance
        :type container: :class:`libcloud.storage.base.Container`

        :return: ``True`` on success, ``False`` otherwise.
        :rtype: ``bool``
        z0delete_container not implemented for this driverr�   r™   s     r   r{   zStorageDriver.delete_container˜  r§   r!   c                 ó  — |pt           j        }t          |t          t          f¦  «        s|g}n|}|j        |v r |di |¤ŽS |j        t           j        k    rt          |j        d| ¬¦  «        ‚t          d|j        z  | ¬¦  «        ‚)a  
        Call passed callback and start transfer of the object'

        :param obj: Object instance.
        :type obj: :class:`Object`

        :param callback: Function which is called with the passed
            callback_kwargs
        :type callback: :class:`function`

        :param callback_kwargs: Keyword arguments which are passed to the
             callback.
        :type callback_kwargs: ``dict``

        :param response: Response instance.
        :type response: :class:`Response`

        :param success_status_code: Status code which represents a successful
                                    transfer (defaults to httplib.OK)
        :type success_status_code: ``int``

        :return: ``True`` on success, ``False`` otherwise.
        :rtype: ``bool``
        Ú )rf   Úvaluer   zUnexpected status code: %s©r«   r   NrR   )
r
   ÚOKÚ
isinstancer…   ÚtupleÚstatusÚ	NOT_FOUNDr   r   r   )r   r$   ÚcallbackÚcallback_kwargsÚresponseÚsuccess_status_codeÚsuccess_status_codess          r   Ú_get_objectzStorageDriver._get_object¥  s¢   € ð2 2Ð?µW´ZÐåÐ-µµe¨}Ñ=Ô=ð 	7Ø$7Ð#8Ð Ð à#6Ð àŒ?Ð2Ð2Ð2Ø�8Ð.Ð.˜oÐ.Ð.Ð.ØŒ_¥Ô 1Ò1Ð1Ý)°c´hÀbÐQUÐVÑVÔVÐVåÐ">À(Ä/Ñ"RÐ[_Ð`Ñ`Ô`Ð`r!   c                 óþ  — |pt           }t          j                             |¦  «        }|s3t          j                             |¦  «        st          d|z  | ¬¦  «        ‚|st          ||j        ¦  «        }	n|}	t          j                             |	¦  «        r|st          d|	z  dz   | ¬¦  «        ‚d}
t          |	d¦  «        5 }|j	         
                    |¦  «        D ]6}|                     t          |¦  «        ¦  «         |
t          |¦  «        z  }
Œ7	 ddd¦  «         n# 1 swxY w Y   |sOt          |j        ¦  «        t          |
¦  «        k    r*|r&	 t          j        |	¦  «         n# t"          $ r Y nw xY wdS d	S )
a"  
        Save object to the provided path.

        :param response: RawResponse instance.
        :type response: :class:`RawResponse`

        :param obj: Object instance.
        :type obj: :class:`Object`

        :param destination_path: Destination directory.
        :type destination_path: ``str``

        :param delete_on_failure: True to delete partially downloaded object if
                                  the download fails.
        :type delete_on_failure: ``bool``

        :param overwrite_existing: True to overwrite a local path if it already
                                   exists.
        :type overwrite_existing: ``bool``

        :param chunk_size: Optional chunk size
            (defaults to ``libcloud.storage.base.CHUNK_SIZE``, 8kb)
        :type chunk_size: ``int``

        :param partial_download: True if this is a range (partial) save,
                                 False otherwise.
        :type partial_download: ``bool``

        :return: ``True`` on success, ``False`` otherwise.
        :rtype: ``bool``
        zPath %s does not existr¬   zFile %s already exists, but zoverwrite_existing=Falser   ÚwbNFT)r   ÚosÚpathÚbasenameÚexistsr   Úpjoinr   ÚopenÚ	_responseÚiter_contentÚwriter	   ÚlenÚintr   ÚunlinkÚ	Exception)r   r´   r$   r,   r-   r.   r3   Úpartial_downloadÚ	base_namerl   Úbytes_transferredÚfile_handleÚchunks                r   Ú_save_objectzStorageDriver._save_objectÌ  s÷  € ðT  Ð-¥:ˆ
å”G×$Ò$Ð%5Ñ6Ô6ˆ	àð 	b¥¤§¢Ð0@Ñ!AÔ!Að 	bÝÐ&>ÐBRÑ&SÐ\`ÐaÑaÔaÐaàð 	)ÝÐ.°´Ñ9Ô9ˆIˆIà(ˆIåŒ7�>Š>˜)Ñ$Ô$ð 	Ð-?ð 	ÝØ4¸	ÑBÐE_Ñ_Øðñ ô ð ð
 Ðå�)˜TÑ"Ô"ð 	0 kØ!Ô+×8Ò8¸ÑDÔDð 0ð 0�Ø×!Ò!¥! E¡(¤(Ñ+Ô+Ð+Ø!¥S¨¡Z¤ZÑ/Ð!Ð!ð0ð	0ð 	0ð 	0ñ 	0ô 	0ð 	0ð 	0ð 	0ð 	0ð 	0ð 	0øøøð 	0ð 	0ð 	0ð 	0ð
  ð 
	¥C¨¬¡M¤MµSÐ9JÑ5KÔ5KÒ$KÐ$Kð !ð ðÝ”I˜iÑ(Ô(Ð(Ð(øÝ ð ð ð Ø�Dðøøøð �5àˆts%   ÃAD!Ä!D%Ä(D%ÅE+ Å+
E8Å7E8ÚPUTc
                 óâ  — |pi }|r1t           j                             |¦  «        st          d|z  ¦  «        ‚|�/t	          |d¦  «        st	          |d¦  «        st          d¦  «        ‚|                      |||¬¦  «        |d<   |rK| j                             ||||d¬	¦  «        }
|  	                    ||  
                    ¦   «         ¦  «        \  }}nšt          |d
¦  «        5 }| j                             ||||d¬	¦  «        }
ddd¦  «         n# 1 swxY w Y   t          |d
¦  «        5 }|  	                    ||  
                    ¦   «         ¦  «        \  }}ddd¦  «         n# 1 swxY w Y   |
||dœS )zˆ
        Helper function for setting common request headers and calling the
        passed in callback which uploads an object.
        zFile %s does not existNÚnextÚ__next__z-iterator object must implement next() method.)rl   zContent-TypeT)ÚmethodÚdatarj   ÚrawÚrb)r´   rÉ   Ú	data_hash)rº   r»   r½   ÚOSErrorÚhasattrÚAttributeErrorÚ_determine_content_typeÚ
connectionÚrequestÚ_hash_buffered_streamÚ_get_hash_functionr¿   )r   rf   Úcontent_typeÚrequest_pathÚrequest_methodrj   rl   ÚstreamÚchunkedÚ	multipartr´   Ústream_hashÚstream_lengthÚfile_streams                 r   Ú_upload_objectzStorageDriver._upload_object  s6  € ð  �-˜Rˆàð 	B�RœWŸ^š^¨IÑ6Ô6ð 	BÝÐ2°iÑ@ÑAÔAÐAàÐ¥g¨f°fÑ&=Ô&=ÐÅgÈfÐV`ÑFaÔFaÐÝ Ð!UÑVÔVÐVà"&×">Ò">Ø˜+°ð #?ñ #
ô #
ˆ�Ñð ð 	Ø”×.Ò.ØØ%ØØØð /ñ ô ˆHð *.×)CÒ)CØ˜×/Ò/Ñ1Ô1ñ*ô *Ñ&ˆK˜˜õ �i Ñ&Ô&ð ¨+Øœ?×2Ò2Ø Ø)Ø$Ø#Øð 3ñ ô �ðð ð ñ ô ð ð ð ð ð ð øøøð ð ð ð õ �i Ñ&Ô&ð ¨+Ø-1×-GÒ-GØ ×!8Ò!8Ñ!:Ô!:ñ.ô .Ñ*�˜]ðð ð ñ ô ð ð ð ð ð ð øøøð ð ð ð ð !Ø!.Ø$ð
ð 
ð 	
s$   Ã! DÄDÄDÄ(,E Å E$Å'E$c                 ó¨   — |r|S |p|}t           j        j                             |¦  «        \  }}| j        r|st          d|z  ¦  «        ‚|pt          S )NzUFile content-type could not be guessed for "%s" and no content_type value is provided)ÚlibcloudÚutilsÚfilesÚguess_file_mime_typeÚstrict_moderØ   r   )r   rÞ   rf   rl   r   Ú_s         r   rÙ   z%StorageDriver._determine_content_typeX  sv   € Øð 	 ØÐàÐ'˜KˆÝ"œ.Ô.×CÒCÀDÑIÔI‰ˆ�aàÔð 	 Lð 	Ý ð=Ø?CñDñô ð ð
 Ð3Õ3Ð3r!   é   c                 óÆ  — d}t          |d¦  «        st          |d¦  «        rÇt          |d¦  «        rE	 |                     d¦  «         n.# t          $ r!}|j        t          j        k    r|‚Y d }~nd }~ww xY wt
          j        j                             |¬¦  «        D ]6}| 	                    t          |¦  «        ¦  «         |t          |¦  «        z  }Œ7|                     ¦   «         |fS t          |d¦  «        sB|D ])}| 	                    |¦  «         |t          |¦  «        z   }Œ*|                     ¦   «         |fS |5  |                     |¦  «        }t          |¦  «        dk    rO|t          |¦  «        z   }| 	                    |¦  «         |                     |¦  «        }t          |¦  «        dk    °Od d d ¦  «         n# 1 swxY w Y   |                     ¦   «         |fS )Nr   rÐ   rÏ   Úseek)ro   Ú__exit__)r×   rñ   rÖ   ÚerrnoÚESPIPEré   rê   rë   Úread_in_chunksÚupdater	   rÃ   Ú	hexdigestÚread)	r   rá   ÚhasherÚ	blocksizeÚ	total_lenÚerË   ÚsÚbufs	            r   rÜ   z#StorageDriver._hash_buffered_streamg  s6  € Øˆ	å�6˜:Ñ&Ô&ð 	3­'°&¸&Ñ*AÔ*Að 	3õ �v˜vÑ&Ô&ð  ð Ø—K’K ‘N”N�N�NøÝð  ð  ð  Ø”w¥%¤,Ò.Ð.ð  ˜ð /Ð.Ð.Ð.Ð.øøøøð øøøõ "œÔ-×<Ò<ÀfÐ<ÑMÔMð (ð (�Ø—’�a ™hœhÑ'Ô'Ð'Ø�S ™ZœZÑ'�	�	à×$Ò$Ñ&Ô&¨	Ð2Ð2å�v˜zÑ*Ô*ð 	3Øð /ð /�Ø—’˜aÑ Ô Ð Ø%­¨A©¬Ñ.�	�	Ø×$Ò$Ñ&Ô&¨	Ð2Ð2àð 	-ð 	-Ø—+’+˜iÑ(Ô(ˆCÝ�c‘(”(˜Q’,�,Ø%­¨C©¬Ñ0�	Ø—’˜cÑ"Ô"Ð"Ø—k’k )Ñ,Ô,�õ �c‘(”(˜Q’,�,ð	-ð 	-ð 	-ñ 	-ô 	-ð 	-ð 	-ð 	-ð 	-ð 	-ð 	-øøøð 	-ð 	-ð 	-ð 	-ð × Ò Ñ"Ô" IÐ.Ð.s*   ´A
 Á

A5ÁA0Á0A5Ä>A8GÇGÇ	Gc                 ó˜   — 	  t          t          | j        ¦  «        ¦   «         }n%# t          $ r t	          d| j        z  ¦  «        ‚w xY w|S )zh
        Return instantiated hash function for the hash type supported by
        the provider.
        z$Invalid or unsupported hash type: %s)ÚgetattrÚhashlibÚ	hash_typerØ   ÚRuntimeError)r   Úfuncs     r   rÝ   z StorageDriver._get_hash_function’  s_   € ð
	ZØ3•7�7 D¤NÑ3Ô3Ñ5Ô5ˆDˆDøÝð 	Zð 	Zð 	ZÝÐEÈÌÑXÑYÔYÐYð	Zøøøð ˆs	   ‚"% ¥"Ac                 óˆ   — |dk     rt          d¦  «        ‚|�*||k    rt          d¦  «        ‚||k    rt          d¦  «        ‚dS )zo
        Method which validates that start_bytes and end_bytes arguments contain
        valid values.
        r   z"start_bytes must be greater than 0Nz*start_bytes must be smaller than end_byteszGstart_bytes and end_bytes can't be the same. end_bytes is non-inclusiveT)Ú
ValueError)r   r9   r:   s      r   Ú_validate_start_and_end_bytesz+StorageDriver._validate_start_and_end_bytesž  sc   € ð ˜Š?ˆ?ÝÐAÑBÔBÐBàÐ Ø˜YÒ&Ð&Ý Ð!MÑNÔNÐNØ 	Ò)Ð)Ý Ø`ñô ð ð ˆtr!   c                 óh   — d|z  }|�*|r|t          |¦  «        z  }n|t          |dz
  ¦  «        z  }|S )a"  
        Return range string which is used as a Range header value for range
        requests for drivers which follow standard Range header notation

        This returns range string in the following format:
        bytes=<start_bytes>-<end bytes>.

        For example:

        bytes=1-10
        bytes=0-2
        bytes=5-
        bytes=100-5000

        :param end_bytes_inclusive: True if "end_bytes" offset should be
        inclusive (aka opposite from the Python indexing behavior where the end
        index is not inclusive).
        z	bytes=%s-Né   )Ústr)r   r9   r:   Úend_bytes_inclusiveÚ	range_strs        r   Ú_get_standard_range_strz%StorageDriver._get_standard_range_str±  sJ   € ð(   ;Ñ/ˆ	àÐ Ø"ð 0Ø�S ™^œ^Ñ+�	�	à�S ¨Q¡Ñ/Ô/Ñ/�	àÐr!   rM   rK   rD   rL   r}   )FTNF)rÍ   NNNFF)rï   )NF)'rN   rO   rP   rQ   r   ÚconnectionClsr   r  Úsupports_chunked_encodingrí   rƒ   r†   rY   r]   rŽ   r“   r—   ra   rg   r%   rc   r)   r0   r5   r<   rA   rk   rn   rF   r¦   r{   r·   rÌ   rç   rÙ   rÜ   rÝ   r  r  rR   r!   r   r   r     sÆ  € € € € € ðð ð )€MØ€DØ€IØ %Ðð €KðXð Xð Xð/ð /ð /ð_ð _ð _ð _ð&cð cð cð cð&	ð 	ð 	ð
ð 
ð 
ðPð Pð Pð[ð [ð [ðPð Pð Pð Xð Xð Xð
Zð 
Zð 
Zð
Wð 
Wð 
Wð RVðUð Uð Uð Uð:_ð _ð _ð _ð( Ø Øð,[ð ,[ð ,[ð ,[ð\eð eð eð eð< ØØð#Sð #Sð #Sð #SðJ(^ð (^ð (^ð (^ðTSð Sð SðVð Vð VðVð Vð Vð%að %að %að %aðX !ØØØðOð Oð Oð Oðl ØØØØØð9
ð 9
ð 9
ð 9
ðv4ð 4ð 4ð 4ð)/ð )/ð )/ð )/ðV
ð 
ð 
ðð ð ð ð&ð ð ð ð ð r!   r   )!rQ   ró   r  Úos.pathrº   r‹   Útypingr   r   r   r   r   r   r¾   Úlibcloud.utils.filesré   Úlibcloud.utils.py3r	   r
   Úlibcloud.common.baser   r   r   Úlibcloud.common.typesr   Úlibcloud.storage.typesr   Ú__all__r   r   r   r   r   rR   r!   r   ú<module>r     s—  ðð ð ð €€€Ø €€€Ø €€€Ø €€€Ø 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø !Ð !Ð !Ð !Ð !Ð !à Ð Ð Ð Ø )Ð )Ð )Ð )Ð )Ð )Ð )Ð )Ø MÐ MÐ MÐ MÐ MÐ MÐ MÐ MÐ MÐ MØ /Ð /Ð /Ð /Ð /Ð /Ø :Ð :Ð :Ð :Ð :Ð :à
XÐ
XÐ
X€à€
ð 2Ð ðh
ð h
ð h
ð h
ð h
ñ h
ô h
ð h
ðVtWð tWð tWð tWð tWñ tWô tWð tWðn
ð 
ð 
ð 
ð 
�Jñ 
ô 
ð 
ð 
ð 
r!   