|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/boto/gs/__pycache__/ |
Upload File : |
o
ckF[#� � @ s| d dl Z d dlZd dlZd dlZd dlmZ d dlmZ d dlm Z
d dl m Z d dl
mZ d dl
mZ G dd � d e
�Z dS )
� N)�StringIO)�BotoClientError)�Key)�KeyFile)� compute_hash)�get_utf8_valuec sV e Zd ZdZd;� fdd� Zdd� Zdd� Zd<d
d �Zd d
� Zdd� Z d=� fdd� Z
d>dd�Z d>dd�Z d?dd�Z
d@dd�Zd?d d �Zd d � Zd d!� Zd?d"d#�Zd$d%� Z & dAd'd(�Z & dBd)d*�Z & dCd+d,�Z� fd-d.�Z dDd/d0�ZdEd1d2�ZdEd3d4�Z dDd5d6�Z dDd7d8�Z dEd9d:�Z � Z S )Fr a�
Represents a key (object) in a GS bucket.
:ivar bucket: The parent :class:`boto.gs.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 GS.
:ivar owner: The ID of the owner of this object.
:ivar storage_class: The storage class of the object. Currently, one of:
STANDARD | DURABLE_REDUCED_AVAILABILITY.
:ivar md5: The MD5 hash of the contents of the object.
:ivar size: The size, in bytes, of the object.
:ivar generation: The generation number of the object.
:ivar metageneration: The generation number of the object metadata.
:ivar encrypted: Whether the object is encrypted while at rest on
the server.
:ivar cloud_hashes: Dictionary of checksums as supplied by the storage
provider.
Nc s0 t t| �j||d� || _d | _i | _d | _d S )N)�bucket�name)�superr �__init__�
generation�meta_generation� cloud_hashes�component_count)�selfr r r �� __class__� �-/usr/lib/python3/dist-packages/boto/gs/key.pyr A s
z Key.__init__c C sJ | j r| jrd| j | jf }nd}| jr d| jj| j|f S d| j|f S )Nz#%s.%s� z<Key: %s,%s%s>z<Key: None,%s%s>)r �metagenerationr r )r �ver_strr r r �__repr__H s z Key.__repr__c C s� |dkr || _ d S |dkr|| _d S |dkr$|dkr d| _d S d| _d S |dkr-|| _d S |dkr8t|�| _d S |d krA|| _d S |d
krGd S |d krP|| _d S |d krY|| _d S |d
krb|| _ d S t
| ||� d S )Nr �ETag�IsLatest�trueTF� LastModified�Size� StorageClass�Owner� VersionId�
Generation�MetaGeneration) r �etag� is_latest�
last_modified�int�size�
storage_class�
version_idr r �setattr)r r �value�
connectionr r r �
endElementR s.
zKey.endElementFc C s |� dd �| _|� dd �| _d S )Nzx-goog-metageneration�x-goog-generation)� getheaderr r )r �resp�forcer r r �handle_version_headersm s zKey.handle_version_headersc C s d S �Nr )r �responser r r �handle_restore_headersq s zKey.handle_restore_headersc C s� |D ]N\}}|dkr%|� d�D ]}|�� � dd�\}}t�|�| j|< qq|dkr/t|�| _q|dkr7|| _q|dkr?|| _q|dkrIt|�| _ q|d krP|| _
qd S )
Nz x-goog-hash�,�=� zx-goog-component-countr. z x-goog-stored-content-encodingz x-goog-stored-content-lengthzx-goog-storage-class) �split�strip�binascii�
a2b_base64r r& r r �content_encodingr' r( )r �headers�keyr+ � hash_pair�alg�
b64_digestr r r �handle_addl_headerst s$ � ��zKey.handle_addl_headersr c s< | j r|r |d7 }|d| j 7 }tt| �j||||d� 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.
�&�
generation=%s)r> �
query_args�override_num_retries�response_headersN)r r
r � open_read)r r> rF rG rH r r r rI � s
�z
Key.open_read�
c
C s4 d }
| j r d| j g}
| j||||||| |
d� d S )NrE )r> �cb�num_cbrG rH � hash_algsrF )r �_get_file_internal) r �fpr> rK rL �torrentr) rG rH rM rF r r r �get_file� s
�z Key.get_filec
C sN | j dur%|r|j| ||||||| d� dS | j|||||||| d� dS dS )aG
Retrieve an object from GCS using the name of the Key object as the
key in GCS. 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 GCS 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/sMkcC for details.
N)rP r) rM )rP r) rH rM )r rQ )
r rO r> rK rL rP r) �res_download_handlerrH rM r r r �get_contents_to_file� s
/
�
��zKey.get_contents_to_filec C s" t |||d�\}}}|| _||fS )at
:type fp: file
:param fp: File pointer to the file to hash. The file
pointer will be reset to the same position before the
method returns.
:type algorithm: zero-argument constructor for hash objects that
implements update() and digest() (e.g. hashlib.md5)
: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.
)r' �hash_algorithm)r r' )r rO � algorithmr' �
hex_digestrB � data_sizer r r r � s
�zKey.compute_hashc
C s | j ||||||||d� dS )a;
Upload a file to GCS.
: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: 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.
:type hash_algs: dictionary
:param hash_algs: (optional) Dictionary of hash algorithms and
corresponding hashing class that implements update() and digest().
Defaults to {'md5': hashlib.md5}.
)r> rK rL rF �chunked_transferr' rM N)�_send_file_internal) r rO r> rK rL rF rX r' rM r r r � send_file s
-
�z
Key.send_filec C s | j j| j| j| j|d�S )N)r) r r> )r �
delete_keyr r) r )r r> r r r �delete= s �z
Key.deletec C �" | � � }|�||� | �|� 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 GS.
:type permission: string
:param permission: The permission being granted. Should be one of:
READ|FULL_CONTROL
See http://code.google.com/apis/storage/docs/developer-guide.html#authorization
for more details on permissions.
:type email_address: string
:param email_address: The email address associated with the Google
account to which you are granting the permission.
N)�get_acl�add_email_grant�set_acl)r �
permission�
email_address�aclr r r r_ B � zKey.add_email_grantc C r] )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 GS.
:type permission: string
:param permission: The permission being granted. Should be one of:
READ|FULL_CONTROL
See http://code.google.com/apis/storage/docs/developer-guide.html#authorization
for more details on permissions.
:type user_id: string
:param user_id: The canonical user id associated with the GS account to
which you are granting the permission.
N)r^ �add_user_grantr` )r ra �user_idrc r r r re W rd zKey.add_user_grantc C s* | j |d�}|�||� | j||d� dS )a�
Convenience method that provides a quick way to add an email group
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 GS.
:type permission: string
:param permission: The permission being granted. Should be one of:
READ|FULL_CONTROL
See http://code.google.com/apis/storage/docs/developer-guide.html#authorization
for more details on permissions.
:type email_address: string
:param email_address: The email address associated with the Google
Group to which you are granting the permission.
)r> N)r^ �add_group_email_grantr` )r ra rb r> rc r r r rg l s zKey.add_group_email_grantc C r] )a�
Convenience method that provides a quick way to add a canonical group
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 GS.
:type permission: string
:param permission: The permission being granted. Should be one of:
READ|FULL_CONTROL
See http://code.google.com/apis/storage/docs/developer-guide.html#authorization
for more details on permissions.
:type group_id: string
:param group_id: The canonical group id associated with the Google
Groups account you are granting the permission to.
N)r^ �add_group_grantr` )r ra �group_idrc r r r rh � rd zKey.add_group_grantTc C s� | j jj} |r
| r
td��|pi }|r||| j< |
r"|�dtj� n1t|t �sS|�
� }
|�dtj � |�
� |
krN|�dtj� |�
� |
krN|�|
� t d��|�|
� t
|d�r\|j| _| j dur�t|t �r�|�� }|j|�
� } | | _t�d|j�r�|j�d�}|t�t�|��f}| r�| | _n|�
� }
|�dtj � |�
� |
| _|�|
� | j} |du r�| �|| �}|d | _|d | _ | jdu r�| j| _|s�| j � | j�r�dS | dur�t | �|d < |r�|� | ||||� dS | j ||||| d
� dS dS ) a
Store an object in GS using the name of the Key object as the
key in GS and the contents of the file pointed to by 'fp' as the
contents.
:type fp: file
:param fp: The file whose contents are to be uploaded.
:type headers: dict
:param headers: (optional) Additional HTTP headers to be sent with the
PUT request.
:type replace: bool
:param replace: (optional) 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: (optional) 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: (optional) A canned ACL policy that will be applied to
the new key in GS.
:type md5: tuple
:param md5: (optional) 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.
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 res_upload_handler: :py:class:`boto.gs.resumable_upload_handler.ResumableUploadHandler`
:param res_upload_handler: (optional) If provided, this handler will
perform the upload.
: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.
Notes:
1. The "size" parameter currently cannot be used when a
resumable upload handler is given but is still useful for
uploading part of a file as implemented by the parent class.
2. At present Google Cloud Storage does not support multipart
uploads.
: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).
:type if_generation: int
:param if_generation: (optional) If set to a generation number, the
object will only be written to if its current generation number is
this value. If set to the value 0, the object will only be written
if it doesn't already exist.
:rtype: int
:return: The number of bytes written to the key.
TODO: At some point we should refactor the Bucket and Key classes,
to move functionality common to all providers into a parent class,
and provider-specific functionality into subclasses (rather than
just overriding/sharing code the way it currently works).
z1"size" param not supported for resumable uploads.r z8fp is at EOF. Use rewind option or seek() to data start.r Nz^"[a-fA-F0-9]{32}"$�"r8 �x-goog-if-generation-match)r' ) r r, �providerr �
acl_header�seek�os�SEEK_SET�
isinstancer �tell�SEEK_END�AttributeError�hasattrr �path�getkeyr' �re�matchr# r: �base64� b64encoder; � unhexlify� compute_md5�md5� base64md5�lookup�strrZ )r rO r> �replacerK rL �policyr~ �res_upload_handlerr' �rewind�
if_generationrl �sposr? r# r r r �set_contents_from_file� sf
Y�
�zKey.set_contents_from_filec C sR i | _ t|d��} | j| ||||||| |
d� W d � dS 1 s"w Y dS )a
Store an object in GS using the name of the Key object as the
key in GS 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 GS.
:type headers: dict
:param headers: (optional) Additional headers to pass along with the
request to GS.
:type replace: bool
:param replace: (optional) If True, replaces the contents of the file
if it already exists.
:type cb: function
:param cb: (optional) 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: :py:attribute:`boto.gs.acl.CannedACLStrings`
:param policy: (optional) A canned ACL policy that will be applied to
the new key in GS.
:type md5: tuple
:param md5: (optional) 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.
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 res_upload_handler: :py:class:`boto.gs.resumable_upload_handler.ResumableUploadHandler`
:param res_upload_handler: (optional) If provided, this handler will
perform the upload.
:type if_generation: int
:param if_generation: (optional) If set to a generation number, the
object will only be written to if its current generation number is
this value. If set to the value 0, the object will only be written
if it doesn't already exist.
�rb�r� N)� local_hashes�openr� ) r �filenamer> r� rK rL r� r~ �reduced_redundancyr� r� rO r r r �set_contents_from_filenameH s > �"�z Key.set_contents_from_filenamec
C s> d| _ d| _tt|��} | j| |||||||d�}
| �� |
S )aA
Store an object in GCS using the name of the Key object as the
key in GCS 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 GCS 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.gs.acl.CannedACLStrings`
:param policy: A canned ACL policy that will be applied to the
new key in GCS.
: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 if_generation: int
:param if_generation: (optional) If set to a generation number, the
object will only be written to if its current generation number is
this value. If set to the value 0, the object will only be written
if it doesn't already exist.
Nr� )r~ r r r r� �close) r �sr> r� rK rL r� r~ r� rO �rr r r �set_contents_from_string� s 6 �z Key.set_contents_from_stringc sN |� dd�}|dur|�di �}t|�|d< ||d< tt| �j|i |�� dS )a1
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 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 if_generation: int
:param if_generation: (optional) If set to a generation number, the
object will only be written to if its current generation number is
this value. If set to the value 0, the object will only be written
if it doesn't already exist.
r� Nr> rk )�pop�getr� r
r �set_contents_from_stream)r �args�kwargsr� r> r r r r� � s 9 z Key.set_contents_from_streamc C s, | j dur| j j|| j||||d� dS dS )a� Sets the ACL for this object.
:type acl_or_str: string or :class:`boto.gs.acl.ACL`
:param acl_or_str: A canned ACL string (see
:data:`~.gs.acl.CannedACLStrings`) or an ACL object.
:type headers: dict
:param headers: Additional headers to set during the request.
:type generation: int
:param generation: If specified, sets the ACL for a specific generation
of a versioned object. If not specified, the current version is
modified.
:type if_generation: int
:param if_generation: (optional) If set to a generation number, the acl
will only be updated if its current generation number is this value.
:type if_metageneration: int
:param if_metageneration: (optional) If set to a metageneration number,
the acl will only be updated if its current metageneration number is
this value.
N�r> r r� �if_metageneration)r r` r )r �
acl_or_strr> r r� r� r r r r`
s
��z Key.set_aclc C �" | j dur| j j| j||d�S dS )aQ Returns the ACL of this object.
:param dict headers: Additional headers to set during the request.
:param int generation: If specified, gets the ACL for a specific
generation of a versioned object. If not specified, the current
version is returned.
:rtype: :class:`.gs.acl.ACL`
N�r> r )r r^ r �r r> r r r r r^ , �
��z Key.get_aclc C r� )aG Returns the ACL string of this object.
:param dict headers: Additional headers to set during the request.
:param int generation: If specified, gets the ACL for a specific
generation of a versioned object. If not specified, the current
version is returned.
:rtype: str
Nr� )r � get_xml_aclr r� r r r r� ; r� zKey.get_xml_aclc C �( | j dur| j j|| j||||d�S dS )a` Sets this objects's ACL to an XML string.
:type acl_str: string
:param acl_str: A string containing the ACL XML.
:type headers: dict
:param headers: Additional headers to set during the request.
:type generation: int
:param generation: If specified, sets the ACL for a specific generation
of a versioned object. If not specified, the current version is
modified.
:type if_generation: int
:param if_generation: (optional) If set to a generation number, the acl
will only be updated if its current generation number is this value.
:type if_metageneration: int
:param if_metageneration: (optional) If set to a metageneration number,
the acl will only be updated if its current metageneration number is
this value.
Nr� )r � set_xml_aclr �r �acl_strr> r r� r� r r r r� J s
��zKey.set_xml_aclc C r� )a� Sets this objects's ACL using a predefined (canned) value.
:type acl_str: string
:param acl_str: A canned ACL string. See
:data:`~.gs.acl.CannedACLStrings`.
:type headers: dict
:param headers: Additional headers to set during the request.
:type generation: int
:param generation: If specified, sets the ACL for a specific generation
of a versioned object. If not specified, the current version is
modified.
:type if_generation: int
:param if_generation: (optional) If set to a generation number, the acl
will only be updated if its current generation number is this value.
:type if_metageneration: int
:param if_metageneration: (optional) If set to a metageneration number,
the acl will only be updated if its current metageneration number is
this value.
Nr� )r �set_canned_aclr r� r r r r� h s
��zKey.set_canned_aclc C s� g }|D ]$}|j j| j jkrtd��d}|jr dt|j� }|�d|j|f � qdd�|� }|p3i }|r:||d< | j jjdt | j j�t | j�|dt |�d �}|j
d
k sZ|j
d krh| j jj � |j
|j
|�� ��|�d �S )
a Create a new object from a sequence of existing objects.
The content of the object representing this Key will be the
concatenation of the given object sequence. For more detail, visit
https://developers.google.com/storage/docs/composite-objects
:type components list of Keys
:param components List of gs.Keys representing the component objects
:type content_type (optional) string
:param content_type Content type for the new composite object.
z+GCS does not support inter-bucket composingr z<Generation>%s</Generation>z(<Component><Name>%s</Name>%s</Component>z#<ComposeRequest>%s</ComposeRequest>z Content-Type�PUT�compose)r> rF �data�� i+ r. )r r r r r� �append�joinr, � make_requestr �statusrl �storage_response_error�reason�readr/ ) r �
components� content_typer> � compose_reqr? �generation_tag�compose_req_xmlr0 r r r r� � s< �����
�
z Key.compose)NNN)F)Nr NN)NNrJ FNNNNr3 )NNrJ NFNN)
NTNrJ NNNNFN) NTNrJ NNNNN)NTNrJ NNN)NNNN)NN) �__name__�
__module__� __qualname__�__doc__r r r- r2 r5 rC rI rQ rS r rZ r\ r_ re rg rh r� r� r� r� r` r^ r� r� r� r� �
__classcell__r r r r r " s|
�
�
�
;
�
2
� 3
�E
� @@
�
�
�#r )rz r; ro rx � boto.compatr �boto.exceptionr � boto.s3.keyr �S3Key�boto.s3.keyfiler �
boto.utilsr r r r r r �<module> s