/usr/lib/python2.6/site-packages/boto/s3/
/usr/lib/python2.6/site-packages/boto/s3
NameSizeModeActions
acl.py57270644editdlrm
acl.pyc60930644editdlrm
acl.pyo60930644editdlrm
bucket.py793690644editdlrm
bucket.pyc707340644editdlrm
bucket.pyo706880644editdlrm
bucketlistresultset.py67960644editdlrm
bucketlistresultset.pyc57470644editdlrm
bucketlistresultset.pyo57470644editdlrm
bucketlogging.py31830644editdlrm
bucketlogging.pyc29060644editdlrm
bucketlogging.pyo29060644editdlrm
connection.py261920644editdlrm
connection.pyc237440644editdlrm
connection.pyo236070644editdlrm
cors.py89410644editdlrm
cors.pyc80180644editdlrm
cors.pyo80180644editdlrm
deletemarker.py20870644editdlrm
deletemarker.pyc15010644editdlrm
deletemarker.pyo15010644editdlrm
key.py823190644editdlrm
key.pyc660280644editdlrm
key.pyo660280644editdlrm
keyfile.py44270644editdlrm
keyfile.pyc50100644editdlrm
keyfile.pyo50100644editdlrm
lifecycle.py82540644editdlrm
lifecycle.pyc92330644editdlrm
lifecycle.pyo92330644editdlrm
multidelete.py47570644editdlrm
multidelete.pyc49800644editdlrm
multidelete.pyo49800644editdlrm
multipart.py120490644editdlrm
multipart.pyc119560644editdlrm
multipart.pyo119560644editdlrm
prefix.py16610644editdlrm
prefix.pyc12430644editdlrm
prefix.pyo12430644editdlrm
resumable_download_handler.py155950644editdlrm
resumable_download_handler.pyc103360644editdlrm
resumable_download_handler.pyo103360644editdlrm
tagging.py17320644editdlrm
tagging.pyc36880644editdlrm
tagging.pyo36880644editdlrm
user.py19680644editdlrm
user.pyc15140644editdlrm
user.pyo15140644editdlrm
website.py106070644editdlrm
website.pyc123110644editdlrm
website.pyo123110644editdlrm
__init__.py23450644editdlrm
__init__.pyc18070644editdlrm
__init__.pyo18070644editdlrm
Edit: /usr/lib/python2.6/site-packages/boto/s3/key.pyc (66028B)
*ITc@sjddkZddkZddkZddkZddkZddkZddkZddkZddk Z ddkl Z ddk Z ddk lZlZlZlZddklZddklZddklZddklZddklZdd klZdd k lZdd k lZlZdd k lZdd k l Z de!fdYZ"dS(iN(tmd5(tBytesIOtsixturllibt encodebytes(tBotoClientError(tStorageDataError(tPleaseRetryException(tProvider(tKeyFile(tUser(t UserAgent(t compute_md5t compute_hash(tfind_matching_headers(tmerge_headers_by_nametKeycBseZdZdZdZeiidddZe dddd d d d d gZ e Z x'e D]Z e i e iddqdWe e ddddgBZdVdVdZdZdZedZdZdZeeeZdZdZeeeZdZdZeeeZdZdZ eee Z!d Z"d!Z#e$d"Z%d#Z&d$Z'dVd%dVdVd&Z(dVdVd'Z)d(dVdVdVd)Z*e$Z+e$d*Z,d+Z-e-Z.d,d-Z/dVe0d.Z1dVe$e$e$e0d/Z2d0Z3d1Z4dVd2Z5dVd3Z6d4Z7d5Z8d6Z9dVd7Z:dVd8Z;dVd9Z<dVd:Z=dVd;Z>d<Z?dVd=Z@dVd>ZAd?dVe0e$dVe$dVdVe$e$d@ ZBdVdVdAdVe$dVdBZCdVdVdAdVe$dVdVdCZDe$dDZEdVdEZFdVe0dVdAdVe$dVdVdFZGdVe0dVdAdVdVe$dVe$dVe$dG ZHdVe0dVdAdVdVe$e$dHZIdVe0dVdAdVdVe$e$dIZJdVdVdAe$dVdVdVdJZKdVdVdAe$dVdVdVdVdVdK ZLdVdVdAdLZMdVdVdAe$dVdVdVdMZNdVdVdAe$dVdVdVdNZOdVdVdAe$dVdVdVdOZPdVdPZQdVdVdQZRdRZSdVdSZTdVdTZUdVdUZVRS(WsC 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. sapplication/octet-streams %s tBototkey_buffer_sizei s cache-controlscontent-dispositionscontent-encodingscontent-languages content-md5s content-types x-robots-tagtexpirest-t_s last-modifiedscontent-lengthtdatetetagcCs||_||_h|_d|_|i|_d|_d|_d|_ d|_ d|_ t |_ d|_d|_d|_d|_d|_d|_d|_d|_d|_t |_d|_d|_d|_h|_dS(N(tbuckettnametmetadatatNonet cache_controltDefaultContentTypet content_typetcontent_encodingtcontent_dispositiontcontent_languagetfilenameRtFalset is_latestt last_modifiedtownert_storage_classtpathtresptmodetsizet version_idtsource_version_idt delete_markert encryptedtongoing_restoret expiry_datet local_hashes(tselfRR((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt__init__is2                        cCs[|iod|ii|if}nd|i}t|tp|id}n|S(Nu usutf-8(RRt isinstancetstrtencode(R3R((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt__repr__s   cCs|S(N((R3((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt__iter__scCs4d}|io |iio|iii}n|S(N(RRt connectiontprovider(R3R;((s//usr/lib/python2.6/site-packages/boto/s3/key.pyR;scCs|iS(N(R(R3((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt_get_keyscCs ||_dS(N(R(R3tvalue((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt_set_keyscCs7d|ijo#|idoti|idSdS(NR(R2tbinasciitb2a_hex(R3((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt_get_md5scCsL|oti||id|i|ii|i}|p|itn|S(s By providing a next method, the key object supports use as an iterator. For example, you can now say: for bytes in key: write bytes to a file or whatever All of the HTTP connection stuff is handled for you. (RR)R|t BufferSizeRt StopIteration(R3tdata((s//usr/lib/python2.6/site-packages/boto/s3/key.pytnextws   icCsU|i|djo|ii}n|ii|}|p|in|S(Ni(RR)R|R(R3R+R((s//usr/lib/python2.6/site-packages/boto/s3/key.pyR|s  c Cs|djo,|i|ii|idtdtd|S|djo,|i|ii|idtdtd|Std|dS(s 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. RMtreduced_redundancyt preserve_acltvalidate_dst_buckettREDUCED_REDUNDANCYsInvalid storage class: %sN(tcopyRRR#R_R(R3tnew_storage_classt dst_bucketR((s//usr/lib/python2.6/site-packages/boto/s3/key.pytchange_storage_classs    c Csc|iii||}|o d}n |i}|i||ii|i|d|d|d|S(s 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 Rt storage_classRt encrypt_key(RR:tlookupRtcopy_keyR( R3Rtdst_keyRRRRRR((s//usr/lib/python2.6/site-packages/boto/s3/key.pyRs/    cCs,|djot||_|iSdSdS(NtOwner(R R&R(R3RtattrsR:((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt startElements cCs|djo ||_n|djo ||_n|djo'|djo t|_qt|_n|djo ||_nv|djot||_nV|djo ||_n<|djon+|d jo ||_ nt |||dS( NRtETagtIsLatestR]t LastModifiedtSizet StorageClassRt VersionId( RRR_R$R#R%RR+RR,tsetattr(R3RR=R:((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt endElements&                cCst|ii|id|S(st Returns True if the key exists :rtype: bool :return: Whether the key exists on S3 Rt(tboolRRR(R3Rt((s//usr/lib/python2.6/site-packages/boto/s3/key.pytexistsscCs"|ii|id|id|S(s) Delete this key from S3 R,Rt(Rt delete_keyRR,(R3Rt((s//usr/lib/python2.6/site-packages/boto/s3/key.pytdeletescCs|ii|S(N(Rtget(R3R((s//usr/lib/python2.6/site-packages/boto/s3/key.pyt get_metadata"scCs|idjo||ids csdj o$ijoin+djoioidnh}tiid|od|ds s versionId=%ss%s=%st&RvRxRyiig?s$Out of space for destination file %stRangei(RRR:RtappendRRR,RtparsetquotetjoinRR+RRRRtwriteRORRterrnotENOSPCRRRVR2R(R3RRtRRR"R,RyRRRxRRRqRRRRpRERte((Rs//usr/lib/python2.6/site-packages/boto/s3/key.pyR#s   #   &   (     .%  cCs|i||||dtS(s 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. R"(R$R_(R3RRtRR((s//usr/lib/python2.6/site-packages/boto/s3/key.pytget_torrent_filesc Csp|idj o\|o)|i|||||d|d|ql|i||||d|d|d|ndS(s 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. R"R,RN(RRR$( R3RRtRRR"R,tres_download_handlerR((s//usr/lib/python2.6/site-packages/boto/s3/key.pytget_contents_to_file2s6 c Csy^t|dii} z;| ~ } |i| |||d|d|d|d|WdQXWn#tj oti|nX|idj odyJt i i |i} t t i i | } ti| i| | fWqtj oqXndS(sK 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 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. twbR"R,R0RN(RRRR1t ExceptionRtremoveR%RtemailRt parsedate_tzRt mktime_tztutimeR( R3R"RtRRR"R,R0RRoRtmodified_tupletmodified_stamp((s//usr/lib/python2.6/site-packages/boto/s3/key.pytget_contents_to_filenamers"6& c Csat}|i||||d|d|d||i} |dj o| i|} n| S(so 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 R"R,RN(RR1tgetvalueRRG( R3RtRRR"R,RtencodingRR=((s//usr/lib/python2.6/site-packages/boto/s3/key.pytget_contents_as_strings6   cCs<|id|}|ii|||i|d|dS(s 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! RtN(Rtacltadd_email_grantR(R3t permissiont email_addressRtR((s//usr/lib/python2.6/site-packages/boto/s3/key.pyR@scCsB|id|}|ii||d||i|d|dS(s 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. Rtt display_nameN(RR?tadd_user_grantR(R3RAtuser_idRtRCR((s//usr/lib/python2.6/site-packages/boto/s3/key.pyRDscCsst|tjo1t}xP|D]}|i|iq#Wn,h}x"|D]}||||iq>W|i}h}xd|D]\}|idp|ido"|iddidd} n|} |||| RqRARDRRIRLRWRRRSRRXR[R#RaRsRuRRRRRRt__next__R|R_RRRRRRRRRRRRRRRRRRRRRR RRRR!R$R#R/R1R;R>R@RDRKRQRYR[(((s//usr/lib/python2.6/site-packages/boto/s3/key.pyR0s              5      #9              M *   3   U   @  ?   4  K ; D=    (#t email.utilsR5R,RRRRRR?RRt boto.utilsRt boto.compatRRRRtboto.exceptionRRRt boto.providerRtboto.s3.keyfileR t boto.s3.userR R R R RRtobjectR(((s//usr/lib/python2.6/site-packages/boto/s3/key.pyts,          "