OXIESEC PANEL
- Current Dir:
/
/
opt
/
gsutil
/
gslib
/
vendored
/
boto
/
boto
/
s3
/
__pycache__
Server IP: 2a02:4780:11:1594:0:ef5:22d7:a
Upload:
Create Dir:
Name
Size
Modified
Perms
📁
..
-
02/11/2025 08:19:48 AM
rwxr-xr-x
📄
__init__.cpython-39.pyc
1.66 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
acl.cpython-39.pyc
4.58 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
bucket.cpython-39.pyc
60.9 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
bucketlistresultset.cpython-39.pyc
4.54 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
bucketlogging.cpython-39.pyc
2.23 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
connection.cpython-39.pyc
19.94 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
cors.cpython-39.pyc
7.01 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
deletemarker.cpython-39.pyc
1.12 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
key.cpython-39.pyc
58.73 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
keyfile.cpython-39.pyc
3.78 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
lifecycle.cpython-39.pyc
9.59 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
multidelete.cpython-39.pyc
3.9 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
multipart.cpython-39.pyc
9.75 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
prefix.cpython-39.pyc
978 bytes
02/11/2025 08:19:48 AM
rw-r--r--
📄
tagging.cpython-39.pyc
2.71 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
user.cpython-39.pyc
1.17 KB
02/11/2025 08:19:48 AM
rw-r--r--
📄
website.cpython-39.pyc
9.92 KB
02/11/2025 08:19:48 AM
rw-r--r--
Editing: key.cpython-39.pyc
Close
a sFg�J � @ s< d dl mZ d dlZd dlZd dlZd dlZd dlZd dlZd dl Z d dl Z d dl Z d dlm Z d dl Zd dlmZmZmZmZ d dlmZ d dlmZ d dlmZ d dlmZ d d lmZ d d lmZ d d l m Z d d l m Z d d lm Z d dl Zd dl m!Z!m"Z" d dl m#Z# d dl m$Z$ d dl m%Z% G dd� de&�Z'dS )� )�print_functionN)�md5)�BytesIO�six�urllib� encodebytes��BotoClientError)�StorageDataError)�PleaseRetryException)�ResumableDownloadException)� ResumableTransferDisposition)�Provider)�KeyFile)�User)� UserAgent)� compute_md5� compute_hash)�find_matching_headers)�merge_headers_by_name)� print_to_fdc @ s� e Zd ZdZdZdZej�ddd�Z e g d��Z e � Z e D ]Z e �e �dd �� q:e e g d ��B Zd�d d �Zdd� Zdd� Zedd� �Zdd� Zdd� Zeee�Zdd� Zdd� Zeee�Zd d � Z d d � Z ee e �Z d d!� Z d"d#� Z ee e �Z!d$d%� Z"d&d'� Z#d(d)� Z$d�d+d,�Z%d-d.� Z&d/d0� Z'd�d2d3�Z(d�d4d5�Z)d�d7d8�Z*d*Z+d�d9d:�Z,d;d<� Z-e-Z.d�d>d?�Z/d�dAdB�Z0d�dCdD�Z1dEdF� Z2dGdH� Z3d�dIdJ�Z4d�dKdL�Z5dMdN� Z6dOdP� Z7dQdR� Z8d�dSdT�Z9d�dUdV�Z:d�dWdX�Z;d�dYdZ�Z<d�d[d\�Z=d]d^� Z>d�d_d`�Z?d�dadb�Z@d�ddde�ZAd�dgdh�ZBd�didj�ZCd�dkdl�ZDd�dmdn�ZEd�dodp�ZFd�dqdr�ZGd�dsdt�ZHd�dudv�ZId�dwdx�ZJd�dydz�ZKd�d{d|�ZLd�d}d~�ZMd�dd��ZNd�d�d��ZOd�d�d��ZPd�d�d��ZQd�d�� ZRd�d�d��ZSd�d�d��ZTd�d�d��ZUd S )��KeyaC Represents a key (object) in an S3 bucket. :ivar bucket: The parent :class:`boto.s3.bucket.Bucket`. :ivar name: The name of this Key object. :ivar metadata: A dictionary containing user metadata that you wish to store with the object or that has been retrieved from an existing object. :ivar cache_control: The value of the `Cache-Control` HTTP header. :ivar content_type: The value of the `Content-Type` HTTP header. :ivar content_encoding: The value of the `Content-Encoding` HTTP header. :ivar content_disposition: The value of the `Content-Disposition` HTTP header. :ivar content_language: The value of the `Content-Language` HTTP header. :ivar etag: The `etag` associated with this object. :ivar last_modified: The string timestamp representing the last time this object was modified in S3. :ivar owner: The ID of the owner of this object. :ivar storage_class: The storage class of the object. Currently, one of: STANDARD | REDUCED_REDUNDANCY | GLACIER :ivar md5: The MD5 hash of the contents of the object. :ivar size: The size, in bytes, of the object. :ivar version_id: The version ID of this object, if it is a versioned object. :ivar encrypted: Whether the object is encrypted while at rest on the server. zapplication/octet-streamz�<?xml version="1.0" encoding="UTF-8"?> <RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-03-01"> <Days>%s</Days> </RestoreRequest>�BotoZkey_buffer_sizei )z cache-controlzcontent-dispositionzcontent-encodingzcontent-language� content-md5� content-typez x-robots-tag�expires�-�_)z last-modified�content-length�date�etagNc C s� || _ || _i | _d | _| j| _d | _d | _d | _d | _ d | _ d| _ d | _ d | _ d | _d | _d | _d | _d | _d | _d | _d| _d | _d | _d | _i | _d S )NF)�bucket�name�metadataZ cache_control�DefaultContentType� content_type�content_encoding�content_disposition�content_language�filenamer � is_latest� last_modified�owner�_storage_class�path�resp�mode�size� version_id�source_version_id� delete_marker� encrypted�ongoing_restore� expiry_date� local_hashes)�selfr! r" � r: �./opt/gsutil/gslib/vendored/boto/boto/s3/key.py�__init__n s2 z Key.__init__c C s< | j rd| j j| jf }n d| j }t|t�s8|�d�}|S )Nz <Key: %s,%s>z<Key: None,%s>�utf-8)r! r" � isinstance�str�encode�r9 r" r: r: r; �__repr__� s z Key.__repr__c C s | S �Nr: �r9 r: r: r; �__iter__� s z Key.__iter__c C s d }| j r | j jr | j jj}|S rC )r! � connection�provider)r9 rG r: r: r; rG � s z Key.providerc C s | j S rC �r" rD r: r: r; �_get_key� s z Key._get_keyc C s || _ d S rC rH �r9 �valuer: r: r; �_set_key� s z Key._set_keyc C s( d| j v r$| j d r$t�| j d �S d S �Nr )r8 �binascii�b2a_hexrD r: r: r; �_get_md5� s z Key._get_md5c C s2 |rt �|�| jd< nd| jv r.| j�dd � d S rM )rN �a2b_hexr8 �poprJ r: r: r; �_set_md5� s z Key._set_md5c C sL d| j v rH| j d rH| j d }t|t�s2|�d�}t�|��d��d�S d S )Nr r= � )r8 r> �bytesr@ rN � b2a_base64�decode�rstrip)r9 r r: r: r; �_get_base64md5� s zKey._get_base64md5c C sB |r,t |tj�s|�d�}t�|�| jd< nd| jv r>| jd= d S )Nr= r )r> r � string_typesrW rN � a2b_base64r8 rJ r: r: r; �_set_base64md5� s zKey._set_base64md5c C sZ | j d u rT| jrTt| j�| j�d���}t|�rNt|d dd �rN|d j | _ nd| _ | j S )Nr= r r- �STANDARD)r- r! �listr" r@ �len�getattr)r9 Z list_itemsr: r: r; �_get_storage_class� s �zKey._get_storage_classc C s || _ d S rC )r- rJ r: r: r; �_set_storage_class� s zKey._set_storage_classc C s2 t �|�}t|�}|d dkr*|dd� }||fS )z� A utility function to create the 2-tuple (md5hexdigest, base64md5) from just having a precalculated md5_hexdigest. ���rT r )rN � unhexlifyr )r9 Z md5_hexdigest�digest� base64md5r: r: r; �get_md5_from_hexdigest� s zKey.get_md5_from_hexdigestc C s, | j jj}|jr"|�|jd �| _nd | _d S rC )r! rF rG � server_side_encryption_header� getheaderr5 �r9 r/ rG r: r: r; �handle_encryption_headers� s �z Key.handle_encryption_headersc C s@ | j jj}|jr<|�|jd �| _| jd u r<|�� dkr<d| _d S )N�awsr] )r! rF rG �storage_class_headerri r- �get_provider_namerj r: r: r; �handle_storage_class_header� s � �z Key.handle_storage_class_headerFc C s\ | j jj}| jd u s|r(|�|jd �| _|�|jd �| _|�|jd�dkrRd| _nd| _d S )N�false�trueTF)r! rF rG r2 ri �copy_source_version_idr3 r4 )r9 r/ �forcerG r: r: r; �handle_version_headers� s �zKey.handle_version_headersc C s� | j jj}|�|j�}|d u r"d S |�dd�}|D ]V}dd� |�d�D �\}}|�dd�}|dkrz|�� d krrd nd | _q2|d kr2|| _ q2d S ) N�,� c S s g | ] }|� � �qS r: )�strip)�.0�ir: r: r; � <listcomp> � z.Key.handle_restore_headers.<locals>.<listcomp>�=�"� zongoing-requestrq TFz expiry-date) r! rF rG ri �restore_header�split�replace�lowerr6 r7 )r9 �responserG �header�parts�part�key�valr: r: r; �handle_restore_headers s zKey.handle_restore_headersc C s dS )z� Used by Key subclasses to do additional, provider-specific processing of response headers. No-op for this base class. Nr: �r9 �headersr: r: r; �handle_addl_headers s zKey.handle_addl_headersr~ c C sz | j du �rvd| _| jjj}| jjjd| jj| j|||d�| _ | j jdk sV| j jdkrv| j �� }|� | j j| j j |��| j j }t j �||�| _|�� D ]�\}}|�� dkr�d|vr�t|�| _| j| _q�|�� d k�r t�d |�} t| �d ��| _t| �d ��} t| �d ��} | | d | _q�|�� tjv r�|| j|�� �dd�< q�| � | j � | � | j � | � | j � | � | j � � � dS )a� Open this key for reading :type headers: dict :param headers: Headers to pass in the web request :type query_args: string :param query_args: Arguments to pass in the query string (ie, 'torrent') :type override_num_retries: int :param override_num_retries: If not None will override configured num_retries parameter for underlying GET. :type response_headers: dict :param response_headers: A dictionary containing HTTP headers/values that will override any headers associated with the stored object in the response. See http://goo.gl/EWOPb for details. N�r�GET�� query_args�override_num_retries�� �+ r z Content-Rangez content-rangez(\d+)-(\d+)\/(\d+)� rv � r r )!r/ r0 r! rF rG � make_requestr" �status�read�storage_response_error�reason�msg�boto�utils�get_aws_metadatar# �itemsr� �intr1 �_size_of_range�re�search�groupr � base_fields�__dict__r� rt rk r� r� � getheaders) r9 r� r� r� �response_headersrG �bodyr" rK Zrange_informationZ start_rangeZ end_ranger: r: r; � open_read sF � �� � z Key.open_readc C s t d��dS )aK Open this key for writing. Not yet implemented :type headers: dict :param headers: Headers to pass in the write request :type override_num_retries: int :param override_num_retries: If not None will override configured num_retries parameter for underlying PUT. zNot ImplementedNr )r9 r� r� r: r: r; � open_write[ s zKey.open_writer� c C sN |dkr d| _ | j|||d� n*|dkr>d| _ | j||d� n td| ��d S )Nr� )r� r� r� �w)r� r� zInvalid mode: %s)r0 r� r� r )r9 r0 r� r� r� r: r: r; �openi s ��zKey.openc C s* | j r|s| j �� d| _ d| _d| _dS )a� Close this key. :type fast: bool :param fast: True if you want the connection to be closed without first reading the content. This should only be used in cases where subsequent calls don't need to return the content from the open HTTP connection. Note: As explained at http://docs.python.org/2/library/httplib.html#httplib.HTTPConnection.getresponse, callers must read the whole response before sending a new request to the server. Calling Key.close(fast=True) and making a subsequent request to the server will work because boto will get an httplib exception and close/reopen the connection. NT)r/ r� r0 �closed)r9 �fastr: r: r; �closex s z Key.closec C s* | � � | j�| j�}|s&| �� t�|S )a By providing a next method, the key object supports use as an iterator. For example, you can now say: for key_bytes in key: write bytes to a file or whatever All of the HTTP connection stuff is handled for you. )r� r/ r� � BufferSizer� � StopIteration)r9 �datar: r: r; �next� s zKey.nextr c C s8 | � � |dkr | j�� }n | j�|�}|s4| �� |S )Nr )r� r/ r� r� )r9 r1 r� r: r: r; r� � s zKey.readTc C sX |p | j j}|dkr*| j|| jdd|d�S |dkrH| j|| jdd|d�S td| ��dS )a� Change the storage class of an existing key. Depending on whether a different destination bucket is supplied or not, this will either move the item within the bucket, preserving all metadata and ACL info bucket changing the storage class or it will copy the item to the provided destination bucket, also preserving metadata and ACL info. :type new_storage_class: string :param new_storage_class: The new storage class for the Key. Possible values are: * STANDARD * REDUCED_REDUNDANCY :type dst_bucket: string :param dst_bucket: The name of a destination bucket. If not provided the current bucket of the key will be used. :type validate_dst_bucket: bool :param validate_dst_bucket: If True, will validate the dst_bucket by using an extra list request. r] FT)�reduced_redundancy� preserve_acl�validate_dst_bucket�REDUCED_REDUNDANCYzInvalid storage class: %sN)r! r" �copyr )r9 Znew_storage_class� dst_bucketr� � bucket_namer: r: r; �change_storage_class� s � ��zKey.change_storage_classc C sB | j j�||�}|rd}n| j}|j|| j j| j||||| jd�S )a� Copy this Key to another bucket. :type dst_bucket: string :param dst_bucket: The name of the destination bucket :type dst_key: string :param dst_key: The name of the destination key :type metadata: dict :param metadata: Metadata to be associated with new key. If metadata is supplied, it will replace the metadata of the source key being copied. If no metadata is supplied, the source key's metadata will be copied to the new key. :type reduced_redundancy: bool :param reduced_redundancy: If True, this will force the storage class of the new Key to be REDUCED_REDUNDANCY regardless of the storage class of the key being copied. The Reduced Redundancy Storage (RRS) feature of S3, provides lower redundancy at lower storage cost. :type preserve_acl: bool :param preserve_acl: If True, the ACL from the source key will be copied to the destination key. If False, the destination key will have the default ACL. Note that preserving the ACL in the new key object will require two additional API calls to S3, one to retrieve the current ACL and one to set that ACL on the new object. If you don't care about the ACL, a value of False will be significantly more efficient. :type encrypt_key: bool :param encrypt_key: If True, the new copy of the object will be encrypted on the server-side by S3 and will be stored in an encrypted form while at rest in S3. :type validate_dst_bucket: bool :param validate_dst_bucket: If True, will validate the dst_bucket by using an extra list request. :rtype: :class:`boto.s3.key.Key` or subclass :returns: An instance of the newly created key object r� )� storage_classr� � encrypt_key�src_version_id)r! rF �lookupr� �copy_keyr" r2 ) r9 r� �dst_keyr# r� r� r� r� r� r: r: r; r� � s / � �zKey.copyc C s |dkrt | �| _| jS d S d S )N�Owner)r r, )r9 r" �attrsrF r: r: r; � startElement s zKey.startElementc C s� |dkr|| _ n�|dkr || _nz|dkr@|dkr8d| _q�d| _nZ|dkrP|| _nJ|dkrdt|�| _n6|d krt|| _n&|d kr~n |d kr�|| _n t| ||� d S ) Nr �ETag�IsLatestrq TF� LastModified�Size� StorageClassr� � VersionId) r" r r* r+ r� r1 r� r2 �setattr)r9 r" rK rF r: r: r; � endElement s& zKey.endElementc C s t | jj| j|d��S )zt Returns True if the key exists :rtype: bool :return: Whether the key exists on S3 �r� )�boolr! r� r" r� r: r: r; �exists+ s z Key.existsc C s | j j| j| j|d�S )z) Delete this key from S3 )r2 r� )r! � delete_keyr" r2 r� r: r: r; �delete4 s �z Key.deletec C s | j �|�S rC )r# �getrA r: r: r; � get_metadata; s zKey.get_metadatac C sb |� � dkr|| jd< n"|� � dkr0|| jd< n || j|< |� � tjv r^|| j|� � �dd�< d S )Nr � Content-Typer � Content-MD5r r )r� r# r �base_user_settable_fieldsr� r� )r9 r" rK r: r: r; � set_metadata> s zKey.set_metadatac C s | j �|� d S rC )r# �update)r9 �dr: r: r; �update_metadataJ s zKey.update_metadatac C s" | j d ur | j j|| j|d� d S �Nr� )r! �set_aclr" �r9 �acl_strr� r: r: r; r� N s z Key.set_aclc C s | j d ur | j j| j|d�S d S r� )r! �get_aclr" r� r: r: r; r� R s z Key.get_aclc C s | j d ur | j j| j|d�S d S r� )r! � get_xml_aclr" r� r: r: r; r� V s zKey.get_xml_aclc C s" | j d ur | j j|| j|d�S d S r� )r! � set_xml_aclr" r� r: r: r; r� Z s zKey.set_xml_aclc C s | j �|| j|�S rC �r! �set_canned_aclr" r� r: r: r; r� ^ s zKey.set_canned_aclc C sH | j j�d| j j| j�}|jdkr,|�d�S | j�|j|j|� � ��dS )z�Return the redirect location configured for this key. If no redirect is configured (via set_redirect), then None will be returned. �HEAD�� � x-amz-website-redirect-locationN) r! rF r� r" r� ri rG r� r� r� )r9 r� r: r: r; � get_redirecta s � �zKey.get_redirectc C sb |du ri }n|� � }||d< | jj�d| jj| j|�}|jdkrFdS | j�|j|j|� � ��dS )aO Configure this key to redirect to another location. When the bucket associated with this key is accessed from the website endpoint, a 301 redirect will be issued to the specified `redirect_location`. :type redirect_location: string :param redirect_location: The location to redirect. Nr� �PUTr� T) r� r! rF r� r" r� rG r� r� r� )r9 Zredirect_locationr� r� r: r: r; � set_redirectp s � �zKey.set_redirectc C s | j �d| j|�S )Nz public-readr� r� r: r: r; � make_public� s zKey.make_publicr� c C s� | j jj} |p| j}|du r"i }n|�� }| r8| || j< | rTd| _| jrT| j|| j< | rbd|| j< t j � || j | �}| j j� ||| j j| j||||||� S )a$ Generate a URL to access this key. :type expires_in: int :param expires_in: How long the url is valid for, in seconds. :type method: string :param method: The method to use for retrieving the file (default is GET). :type headers: dict :param headers: Any headers to pass along in the request. :type query_auth: bool :param query_auth: If True, signs the request in the URL. :type force_http: bool :param force_http: If True, http will be used instead of https. :type response_headers: dict :param response_headers: A dictionary containing HTTP headers/values that will override any headers associated with the stored object in the response. See http://goo.gl/EWOPb for details. :type expires_in_absolute: bool :param expires_in_absolute: :type version_id: string :param version_id: The version_id of the object to GET. If specified this overrides any value in the key. :type policy: :class:`boto.s3.acl.CannedACLStrings` :param policy: A canned ACL policy that will be applied to the new key in S3. :type reduced_redundancy: bool :param reduced_redundancy: If True, this will set the storage class of the new Key to be REDUCED_REDUNDANCY. The Reduced Redundancy Storage (RRS) feature of S3, provides lower redundancy at lower storage cost. :type encrypt_key: bool :param encrypt_key: If True, the new copy of the object will be encrypted on the server-side by S3 and will be stored in an encrypted form while at rest in S3. :rtype: string :return: The URL to access the key Nr� �AES256)r! rF rG r2 r� � acl_headerr� rm rh r� r� � merge_metar# � generate_urlr" ) r9 � expires_in�methodr� Z query_authZ force_httpr� Zexpires_in_absoluter2 �policyr� r� rG r: r: r; r� � s, 6 �zKey.generate_url� c C s | j |||||||d� dS )at Upload a file to a key into a bucket on S3. :type fp: file :param fp: The file pointer to upload. The file pointer must point at the offset from which you wish to upload. ie. if uploading the full file, it should point at the start of the file. Normally when a file is opened for reading, the fp will point at the first byte. See the bytes parameter below for more info. :type headers: dict :param headers: The headers to pass along with the PUT request :type num_cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. Providing a negative integer will cause your callback to be called with each buffer read. :type query_args: string :param query_args: (optional) Arguments to pass in the query string. :type chunked_transfer: boolean :param chunked_transfer: (optional) If true, we use chunked Transfer-Encoding. :type size: int :param size: (optional) The Maximum number of bytes to read from the file pointer (fp). This is useful when uploading a file in multiple parts where you are splitting the file up into different ranges to be uploaded. If not specified, the default behaviour is to read all bytes from the file pointer. Less bytes may be available. �r� �cb�num_cbr� �chunked_transferr1 N)�_send_file_internal)r9 �fpr� r� r� r� r� r1 r: r: r; � send_file� s ' �z Key.send_filec sP �j jj�z ��� � W n ty2 d � d�_Y n0 �d u rJ�jsJdti�t�fdd��p\i D ���� �������� f dd�} |s�i }n|�� }t d|�D ] } || = q�t |d< �j dvrƈj |�j < t d |�r�td |��_t d |�r�td |��_t d |�} | �r<t| �d k�r.|| d d u �r.|| d = n td |��_nD�j�rvt��j�d �_�jd u �rj�j�_�j|d < n �j|d < �j�r��j|d< ��r�d|d< nt�j�|d< d�j j�� v �r��tj d�} �d u�r�| d< t f i | ��d |d< d|d< t j � |�j!��}�j jj"d�j j#�j#|| |d�} �j$| dd� ��%| �&� � d S ) NFr c 3 s | ]}|� | � fV qd S rC r: �rx �alg�� hash_algsr: r; � <genexpr> r{ z*Key._send_file_internal.<locals>.<genexpr>c sb �d ur ��� � kr ���� n�d u r8�jr8��d��i }tj�d|�rRd|d< tj�d|�rhd|d< | j||fi |�� |D ]}| �||| � q�| � � �j j j }d�j j _ t | dd�d k r�| �d� d}� �rX�r�} n�jr�j} nd} ��r| dk�rd �j } n<�dk�r6tt�| �j �d ��} n�dk �rFd } nd} d} � || � �} | �rz| �jk �rz��| �} n ���j�} t| t��s�| �d �} �d u �r�d�_| �r�t| �}||7 }��r�d| �d �}| �|d � | �| � | �d� n | �| � �D ]}�| �| � �q| �r:| |8 } | dk�r:�q�� �rj| d7 } | | k�s\| d k�rj� || � d} | �r�| �jk �r���| �} n ���j�} t| t��s�| �d �} �q�|�_�D ]}�| �� �j |< �q���r�| �d� | �d� � �r| dk�s| dk�r|dk�r� || � | �|� |�j j _ | � � }|�� }�� |���s^�� |j |j!|��|S )Nz9Cannot retry failed request. fp does not support seeking.�hostrv � skip_hostzaccept-encoding�skip_accept_encodingr � debuglevel� � � �?rc r= Tz%xs ; s s 0 )"�tell�seek�read_from_stream�storage_data_errorr� r� r � putrequest� putheader� endheadersr! rF �debugr` �set_debuglevelr1 r� r� �math�ceilr� r> rU r@ r_ �sendr� re r8 � getresponse� should_retryr� r� r� )� http_connr� r. r� r� �skipsr� � save_debug�data_len�cb_size�cb_country Z bytes_togo�chunkZ chunk_lenZchunk_len_bytesr� r� r� ) r� r� � digestersr� r� rG r9 r1 �sposr: r; �sender s� � � $ �z'Key._send_file_internal.<locals>.senderz User-Agent)Nr] zContent-EncodingzContent-Languager� rv r r� �chunkedzTransfer-EncodingzContent-Lengthz hmac-v4-s3)r� �hash_algorithmr1 �_sha256z 100-ContinueZExpectr� )r r� T)rs )'r! rF rG r �IOErrorr r �dictr� r r r- r� rm r r& r( r_ r% r. � mimetypes� guess_typer$ rf r? r1 �_required_auth_capability�hashlib�sha256r r� r� r� r# r� r" rt r� r� )r9 r� r� r� r� r� r� r1 r� r r� Zcontent_type_headers�kwargsr/ r: ) r� r� r r� r� r� rG r9 r1 r r; r� s~ y � � � � �zKey._send_file_internalc C s | j jj}|s*|jdv r dS |�d�r*dS d|j kr@dkr�n n�|�d�| _| j}t|t�rj|� d�}|�dd �}|�d d �}|�d d �}|d u r�|d u r�|d u r�| jd | kr�|� d | j| jf ��dS |jd k�r|� � }|� |j|j |�} | jdv �rtd| j |d��dS )N)i� i� T�locationr� r� r r= z/x-amz-server-side-encryption-customer-algorithmz+x-amz-server-side-encryption-aws-kms-key-idz x-goog-encryption-kms-key-namez"%s"z2ETag from S3 did not match computed MD5. %s vs. %si� )�RequestTimeoutzSaw %s, retrying)r� F)r! rF rG r� ri r r r> rU rW r r� r� r� � error_coder ) r9 r� r� rG r �-amz_server_side_encryption_customer_algorithmZ)amz_server_side_encryption_aws_kms_key_id� goog_customer_managed_encryptionr� �errr: r: r; r � sZ ����� �� � �zKey.should_retryc C s t ||d�\}}}|| _||fS )a� :type fp: file :param fp: File pointer to the file to MD5 hash. The file pointer will be reset to the same position before the method returns. :type size: int :param size: (optional) The Maximum number of bytes to read from the file pointer (fp). This is useful when uploading a file in multiple parts where the file is being split in place into different parts. Less bytes may be available. )r1 )r r1 )r9 r� r1 � hex_digest� b64_digest� data_sizer: r: r; r s zKey.compute_md5c C s� | j jj} | �� s"td| �� ��| jr2| jdkr:td��|du rFi }|rT||| j< |rpd| _| j rp| j|| j < | j dur�|s�| j � | j�r�dS | j |||||d| d� dS )a" Store an object using the name of the Key object as the key in cloud and the contents of the data stream pointed to by 'fp' as the contents. The stream object is not seekable and total size is not known. This has the implication that we can't specify the Content-Size and Content-MD5 in the header. So for huge uploads, the delay in calculating MD5 is avoided but with a penalty of inability to verify the integrity of the uploaded data. :type fp: file :param fp: the file whose contents are to be uploaded :type headers: dict :param headers: additional HTTP headers to be sent with the PUT request. :type replace: bool :param replace: If this parameter is False, the method will first check to see if an object exists in the bucket with the same key. If it does, it won't overwrite it. The default value is True which will overwrite the object. :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to GS and the second representing the total number of bytes that need to be transmitted. :type num_cb: int :param num_cb: (optional) If a callback is specified with the cb parameter, this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type policy: :class:`boto.gs.acl.CannedACLStrings` :param policy: A canned ACL policy that will be applied to the new key in GS. :type reduced_redundancy: bool :param reduced_redundancy: If True, this will set the storage class of the new Key to be REDUCED_REDUNDANCY. The Reduced Redundancy Storage (RRS) feature of S3, provides lower redundancy at lower storage cost. :type size: int :param size: (optional) The Maximum number of bytes to read from the file pointer (fp). This is useful when uploading a file in multiple parts where you are splitting the file up into different ranges to be uploaded. If not specified, the default behaviour is to read all bytes from the file pointer. Less bytes may be available. z$%s does not support chunked transferr~ zACannot determine the destination object name for the given streamNr� T)r� r1 ) r! rF rG �supports_chunked_transferr rn r" r� r� rm r� r� ) r9 r� r� r� r� r� r� r� r� r1 rG r: r: r; �set_contents_from_stream& s, = � �z Key.set_contents_from_streamc C s | j jj} |pi }|r ||| j< | r.d|| j< | rB|�dtj� nbt|t �s�|� � }|�dtj � |� � |kr�|�dtj� |� � |kr�|�|� t d��|�|� |r�d| _ | jr�| j || j< t|d�r�|j| _| j du�r|s�| �� r�d}d| _n�d}t|t ��rR|�� }|j|� � } | | _t�d |j��rR|j�d �}|t�t� |��f}|�sl| � || �}| j} nB| �rz| | _n4|� � }|�dtj � |� � | | _|�|� | j} |d | _ |d | _ | jdu �r�| j | _|�s�| j � | j��r�dS | j!||||| || d � | jS dS ) a� Store an object in S3 using the name of the Key object as the key in S3 and the contents of the file pointed to by 'fp' as the contents. The data is read from 'fp' from its current position until 'size' bytes have been read or EOF. :type fp: file :param fp: the file whose contents to upload :type headers: dict :param headers: Additional HTTP headers that will be sent with the PUT request. :type replace: bool :param replace: If this parameter is False, the method will first check to see if an object exists in the bucket with the same key. If it does, it won't overwrite it. The default value is True which will overwrite the object. :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type num_cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type policy: :class:`boto.s3.acl.CannedACLStrings` :param policy: A canned ACL policy that will be applied to the new key in S3. :type md5: A tuple containing the hexdigest version of the MD5 checksum of the file as the first element and the Base64-encoded version of the plain checksum as the second element. This is the same format returned by the compute_md5 method. :param md5: If you need to compute the MD5 for any reason prior to upload, it's silly to have to do it twice so this param, if present, will be used as the MD5 values of the file. Otherwise, the checksum will be computed. :type reduced_redundancy: bool :param reduced_redundancy: If True, this will set the storage class of the new Key to be REDUCED_REDUNDANCY. The Reduced Redundancy Storage (RRS) feature of S3, provides lower redundancy at lower storage cost. :type encrypt_key: bool :param encrypt_key: If True, the new copy of the object will be encrypted on the server-side by S3 and will be stored in an encrypted form while at rest in S3. :type size: int :param size: (optional) The Maximum number of bytes to read from the file pointer (fp). This is useful when uploading a file in multiple parts where you are splitting the file up into different ranges to be uploaded. If not specified, the default behaviour is to read all bytes from the file pointer. Less bytes may be available. :type rewind: bool :param rewind: (optional) If True, the file pointer (fp) will be rewound to the start before any bytes are read from it. The default behaviour is False which reads from the current position of the file pointer (fp). :rtype: int :return: The number of bytes written to the key. r� r z8fp is at EOF. Use rewind option or seek() to data start.r� r" NTFz^"[a-fA-F0-9]{32}"$r} rv r� )"r! rF rG r� rh r �os�SEEK_SETr> r r �SEEK_END�AttributeErrorr� rm �hasattrr" r. r3 r1 �getkeyr� �matchr rw �base64� b64encoderN rd r r rf r� r� )r9 r� r� r� r� r� r� r r� r� r� r1 �rewindrG r r� r� r r: r: r; �set_contents_from_file~ sr O �zKey.set_contents_from_filec C sJ t |d��,} | j| |||||||| d� W d � S 1 s<0 Y dS )a# Store an object in S3 using the name of the Key object as the key in S3 and the contents of the file named by 'filename'. See set_contents_from_file method for details about the parameters. :type filename: string :param filename: The name of the file that you want to put onto S3 :type headers: dict :param headers: Additional headers to pass along with the request to AWS. :type replace: bool :param replace: If True, replaces the contents of the file if it already exists. :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type policy: :class:`boto.s3.acl.CannedACLStrings` :param policy: A canned ACL policy that will be applied to the new key in S3. :type md5: A tuple containing the hexdigest version of the MD5 checksum of the file as the first element and the Base64-encoded version of the plain checksum as the second element. This is the same format returned by the compute_md5 method. :param md5: If you need to compute the MD5 for any reason prior to upload, it's silly to have to do it twice so this param, if present, will be used as the MD5 values of the file. Otherwise, the checksum will be computed. :type reduced_redundancy: bool :param reduced_redundancy: If True, this will set the storage class of the new Key to be REDUCED_REDUNDANCY. The Reduced Redundancy Storage (RRS) feature of S3, provides lower redundancy at lower storage cost. :type encrypt_key: bool :param encrypt_key: If True, the new copy of the object will be encrypted on the server-side by S3 and will be stored in an encrypted form while at rest in S3. :rtype: int :return: The number of bytes written to the key. �rb�r� N)r� r? ) r9 r) r� r� r� r� r� r r� r� r� r: r: r; �set_contents_from_filename0 s = �z Key.set_contents_from_filenamec C sD t |t�s|�d�}t|�} | j| |||||||| d� } | �� | S )ah Store an object in S3 using the name of the Key object as the key in S3 and the string 's' as the contents. See set_contents_from_file method for details about the parameters. :type headers: dict :param headers: Additional headers to pass along with the request to AWS. :type replace: bool :param replace: If True, replaces the contents of the file if it already exists. :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type num_cb: int :param num_cb: (optional) If a callback is specified with the num_cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type policy: :class:`boto.s3.acl.CannedACLStrings` :param policy: A canned ACL policy that will be applied to the new key in S3. :type md5: A tuple containing the hexdigest version of the MD5 checksum of the file as the first element and the Base64-encoded version of the plain checksum as the second element. This is the same format returned by the compute_md5 method. :param md5: If you need to compute the MD5 for any reason prior to upload, it's silly to have to do it twice so this param, if present, will be used as the MD5 values of the file. Otherwise, the checksum will be computed. :type reduced_redundancy: bool :param reduced_redundancy: If True, this will set the storage class of the new Key to be REDUCED_REDUNDANCY. The Reduced Redundancy Storage (RRS) feature of S3, provides lower redundancy at lower storage cost. :type encrypt_key: bool :param encrypt_key: If True, the new copy of the object will be encrypted on the server-side by S3 and will be stored in an encrypted form while at rest in S3. r= rA )r> rU r@ r r? r� ) r9 � string_datar� r� r� r� r� r r� r� r� r� r: r: r; �set_contents_from_strings s 9 �z Key.set_contents_from_stringc C s" | j ||||||||ddd� dS )aN Retrieves a file from an S3 Key :type fp: file :param fp: File pointer to put the data into :type headers: string :param: headers to send when retrieving the files :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type torrent: bool :param torrent: Flag for whether to get a torrent for the file :type override_num_retries: int :param override_num_retries: If not None will override configured num_retries parameter for underlying GET. :type response_headers: dict :param response_headers: A dictionary containing HTTP headers/values that will override any headers associated with the stored object in the response. See http://goo.gl/EWOPb for details. :type version_id: str :param version_id: The ID of a particular version of the object. If this parameter is not supplied but the Key object has a ``version_id`` attribute, that value will be used when retrieving the object. You can set the Key object's ``version_id`` attribute to None to always grab the latest version from a version-enabled bucket. N) r� r� r� �torrentr2 r� r� r� r� )�_get_file_internal) r9 r� r� r� r� rE r2 r� r� r: r: r; �get_file� s / �z Key.get_filec s� |d u r i }| j jj} | j jjdkr.d| j j_| p4g } |rD| �d� � d u rX|sXdti� t� fdd�� pji D ��} |d u r�| j}|r�| �d| � |r�|D ]"} | �d| tj� || �f � q�d � | �} | j d || |d � d}|�rf| j d u r�d}n| j }| j d u �r |d k�r d | j }n<|dk�rDtt�|| j |d ��}n|dk �rTd }nd}d}|||� z�| D ]�}tt�|�|dd� |t|�7 }| D ]}| | �|� �q�|�rl|dk�r�||k�r� �q�|d7 }||k�s�|d k�rl|||� d}�qlt| d��r&|| jk �r&td�|| j�tj��W nD t �yl } z*|j t j k�rVt d|j ��� W Y d }~n d }~0 0 |�r�|dk�s�|dk�r�|dk�r�|||� | D ]}| | �!� | j"|< �q�| j d u �r�|�s�d|v�r�|| _ | �#� | | j j_d S )Nrv r rE r c 3 s | ]}|� | � fV qd S rC r: r� r� r: r; r� � r{ z)Key._get_file_internal.<locals>.<genexpr>z versionId=%sz%s=%s�&r� r� rc r r r{ )�file�endr� z3Download stream truncated. Received {} of {} bytes.z$Out of space for destination file %sZRange)$r! rF r �appendr r# r2 r �parse�quote�joinr� r1 r� r� r r r r � ensure_binaryr_ r� r9 r� r �formatr �WAIT_BEFORE_RETRYr" �errno�ENOSPCr r" re r8 r� )r9 r� r� r� r� rE r2 r� r� r� r� r r r� r r r ry � key_bytesr� �er: r� r; rF � s� � � ���$ zKey._get_file_internalc C s | j ||||dd�S )a� Get a torrent file (see to get_file) :type fp: file :param fp: The file pointer of where to put the torrent :type headers: dict :param headers: Headers to be passed :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. T)rE )rG )r9 r� r� r� r� r: r: r; �get_torrent_file> s zKey.get_torrent_filec C sD | j dur@|r(|j| ||||||d� n| j|||||||d� dS )a� Retrieve an object from S3 using the name of the Key object as the key in S3. Write the contents of the object to the file pointed to by 'fp'. :type fp: File -like object :param fp: :type headers: dict :param headers: additional HTTP headers that will be sent with the GET request. :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type torrent: bool :param torrent: If True, returns the contents of a torrent file as a string. :type res_upload_handler: ResumableDownloadHandler :param res_download_handler: If provided, this handler will perform the download. :type response_headers: dict :param response_headers: A dictionary containing HTTP headers/values that will override any headers associated with the stored object in the response. See http://goo.gl/EWOPb for details. :type version_id: str :param version_id: The ID of a particular version of the object. If this parameter is not supplied but the Key object has a ``version_id`` attribute, that value will be used when retrieving the object. You can set the Key object's ``version_id`` attribute to None to always grab the latest version from a version-enabled bucket. N)rE r2 �rE r2 r� )r! rG ) r9 r� r� r� r� rE r2 �res_download_handlerr� r: r: r; �get_contents_to_fileY s 6 ��zKey.get_contents_to_filec C s� zHt |d��*} | j| |||||||d� W d � n1 s<0 Y W n tyf t�|� � Y n0 | jdur�z4tj�| j�} t tj� | ��} t� | j | | f� W n ty� Y n0 dS )aO Retrieve an object from S3 using the name of the Key object as the key in S3. Store contents of the object to a file named by 'filename'. See get_contents_to_file method for details about the parameters. :type filename: string :param filename: The filename of where to put the file contents :type headers: dict :param headers: Any additional headers to send in the request :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type num_cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type torrent: bool :param torrent: If True, returns the contents of a torrent file as a string. :type res_upload_handler: ResumableDownloadHandler :param res_download_handler: If provided, this handler will perform the download. :type response_headers: dict :param response_headers: A dictionary containing HTTP headers/values that will override any headers associated with the stored object in the response. See http://goo.gl/EWOPb for details. :type version_id: str :param version_id: The ID of a particular version of the object. If this parameter is not supplied but the Key object has a ``version_id`` attribute, that value will be used when retrieving the object. You can set the Key object's ``version_id`` attribute to None to always grab the latest version from a version-enabled bucket. �wb)rE r2 rX r� N) r� rY � Exceptionr5 �remover+ �emailr� � parsedate_tzr� � mktime_tz�utimer" ) r9 r) r� r� r� rE r2 rX r� r� Zmodified_tupleZmodified_stampr: r: r; �get_contents_to_filename� s$ 6 �( z Key.get_contents_to_filenamec C s< t � }| j|||||||d� |�� } |dur8| �|�} | S )ao Retrieve an object from S3 using the name of the Key object as the key in S3. Return the contents of the object as a string. See get_contents_to_file method for details about the parameters. :type headers: dict :param headers: Any additional headers to send in the request :type cb: function :param cb: a callback function that will be called to report progress on the upload. The callback should accept two integer parameters, the first representing the number of bytes that have been successfully transmitted to S3 and the second representing the size of the to be transmitted object. :type cb: int :param num_cb: (optional) If a callback is specified with the cb parameter this parameter determines the granularity of the callback by defining the maximum number of times the callback will be called during the file transfer. :type torrent: bool :param torrent: If True, returns the contents of a torrent file as a string. :type response_headers: dict :param response_headers: A dictionary containing HTTP headers/values that will override any headers associated with the stored object in the response. See http://goo.gl/EWOPb for details. :type version_id: str :param version_id: The ID of a particular version of the object. If this parameter is not supplied but the Key object has a ``version_id`` attribute, that value will be used when retrieving the object. You can set the Key object's ``version_id`` attribute to None to always grab the latest version from a version-enabled bucket. :type encoding: str :param encoding: The text encoding to use, such as ``utf-8`` or ``iso-8859-1``. If set, then a string will be returned. Defaults to ``None`` and returns bytes. :rtype: bytes or str :returns: The contents of the file as bytes or a string rW N)r rY �getvaluerW ) r9 r� r� r� rE r2 r� �encodingr� rK r: r: r; �get_contents_as_string� s 6� zKey.get_contents_as_stringc C s, | j |d�}|j�||� | j||d� dS )a Convenience method that provides a quick way to add an email grant to a key. This method retrieves the current ACL, creates a new grant based on the parameters passed in, adds that grant to the ACL and then PUT's the new ACL back to S3. :type permission: string :param permission: The permission being granted. Should be one of: (READ, WRITE, READ_ACP, WRITE_ACP, FULL_CONTROL). :type email_address: string :param email_address: The email address associated with the AWS account your are granting the permission to. :type recursive: boolean :param recursive: A boolean value to controls whether the command will apply the grant to all keys within the bucket or not. The default value is False. By passing a True value, the call will iterate through all keys in the bucket and apply the same grant to each key. CAUTION: If you have a lot of keys, this could take a long time! r� N)r� �acl�add_email_grantr� )r9 � permission� email_addressr� r� r: r: r; rf # s zKey.add_email_grantc C s0 | j |d�}|jj|||d� | j||d� dS )a Convenience method that provides a quick way to add a canonical user grant to a key. This method retrieves the current ACL, creates a new grant based on the parameters passed in, adds that grant to the ACL and then PUT's the new ACL back to S3. :type permission: string :param permission: The permission being granted. Should be one of: (READ, WRITE, READ_ACP, WRITE_ACP, FULL_CONTROL). :type user_id: string :param user_id: The canonical user id associated with the AWS account your are granting the permission to. :type display_name: string :param display_name: An option string containing the user's Display Name. Only required on Walrus. r� )� display_nameN)r� re �add_user_grantr� )r9 rg �user_idr� ri r� r: r: r; rj > s �zKey.add_user_grantc C sN t |�tkr,t� }|D ]}|�|�� � qn i }|D ]}|| ||�� < q4|S rC )�type�set�addr� )r9 r# Z norm_metadata�kr: r: r; �_normalize_metadataW s zKey._normalize_metadatac C s~ i }| j D ]4}t| |�r t| |�}|r |�dd�}|||�� < q | jj}| jD ]*}|�dd�}| j| |d||�� f < qN|S )z� Extracts metadata from existing URI into a dict, so we can overwrite/delete from it to form the new set of metadata to apply to a key. r r z%s%s)�%_underscore_base_user_settable_fieldsr9 r` r� r� rG �metadata_prefixr# )r9 r� r# Zunderscore_namerK � field_name�prefixr: r: r; �_get_remote_metadatab s �zKey._get_remote_metadatac C s� | � |�}| � |�}| �� }|�|� |D ]}||v r*||= q*| j}i }|D ]>}|�d�sd|�d�rz|�dd��dd�} n|} || || < qL|}|j| j| jj| j|||d� d S )Nz x-goog-meta-z x-amz-meta-r~ )r# r� r� )rp ru r� r! � startswithr� r� r" ) r9 � metadata_plus�metadata_minusr� r� r# �hZ src_bucketZrewritten_metadataZ rewritten_hr: r: r; �set_remote_metadatax s* ��zKey.set_remote_metadatac C sT | j jjd| j j| j| j| |dd�}|jdvrP| j jj}|�|j|j|� � ��dS )a Restore an object from an archive. :type days: int :param days: The lifetime of the restored object (must be at least 1 day). If the object is already restored then this parameter can be used to readjust the lifetime of the restored object. In this case, the days param is with respect to the initial time of the request. If the object has not been restored, this param is with respect to the completion time of the request. �POST�restore)r� r� r� )r� �� N) r! rF r� r" � RestoreBodyr� rG r� r� r� )r9 �daysr� r� rG r: r: r; r| � s � �z Key.restore)NN)F)Nr~ NN)NN)r� NNN)F)r )NT)NFFFT)N)N)N)N)N)N)N)N)N) r� NTFNFNNFF)NNr� NFN)NNr� NFNN)F)N)NTNr� NFNN) NTNr� NNFNFNF)NTNr� NNFF)NTNr� NNFF)NNr� FNNN) NNr� FNNNNN)NNr� )NNr� FNNN)NNr� FNNN)NNr� FNNN)N)NN)N)N)N)V�__name__� __module__� __qualname__�__doc__r$ r~ r� �config�getintr� rm r� rq �frn r� r� r< rB rE �propertyrG rI rL r� rP rS r rY r\ rf ra rb r� rg rk ro rt r� r� r� r� r� r� r� r� �__next__r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r4 r? rB rD rG rF rV rY ra rd rf rj rp ru rz r| r: r: r: r; r 5 s � � < � � % � < � P � + � N : � X � 3 � C � B � 6 � S � @ � I � A � � r )(� __future__r � email.utilsr] rR r' r$ r5 r� r< rN r r � boto.utilsr� � boto.compatr r r r �boto.exceptionr r r r r � boto.providerr �boto.s3.keyfiler � boto.s3.userr r r r r r r �objectr r: r: r: r; �<module> s6