ޣdZddlmZddlmZddlmZGddeZGddeZGd d eZ Gd d eZ Gd de Z GddeZ Gdde Z Gdde ZGdde ZGdde ZGdde ZGdde ZGdde ZGdd e ZGd!d"eZGd#d$e ZGd%d&e ZGd'd(e ZGd)d*e Zy+),z8Gsutil API for interacting with cloud storage providers.)absolute_import)division)unicode_literalsc ,eZdZdZ d.dZdZd/dZd/dZd0dZd Z d1d Z d2d Z d0d Z d3d Z d/dZGddeZGddeZ d2dZ d1dZ d/dZ d1dZ d2dZGddeZddddej0ddddddf dZ d4dZ d5dZ d6dZ d7dZ d3d Z d1d!Z d1d"Z d0d#Z!d0d$Z"d0d%Z# d3d&Z$d0d'Z%d0d(Z&d)Z'd*Z(d+Z) d8d,Z*d-Z+y)9CloudApiayAbstract base class for interacting with cloud storage providers. Implementations of the gsutil Cloud API are not guaranteed to be thread-safe. Behavior when calling a gsutil Cloud API instance simultaneously across threads is undefined and doing so will likely cause errors. Therefore, a separate instance of the gsutil Cloud API should be instantiated per-thread. Nrc ||_||_||_||_||_||_||_||_| |_y)aFPerforms necessary setup for interacting with the cloud storage provider. Args: bucket_storage_uri_class: boto storage_uri class, used by APIs that provide boto translation or mocking. logger: logging.logger for outputting log messages. status_queue: Queue for relaying status to UI. provider: Default provider prefix describing cloud storage provider to connect to. debug: Debug level for the API implementation (0..3). http_headers (dict|None): Arbitrary headers to be included in every request. trace_token: Google internal trace token to pass to the API implementation (string). perf_trace_token: Performance trace token to use when making API calls. user_project: Project to be billed for this request. N) bucket_storage_uri_classlogger status_queueproviderdebug http_headers trace_tokenperf_trace_token user_project) selfr r r r r rrrrs "platform/gsutil/gslib/cloud_api.py__init__zCloudApi.__init__sI4%=D!DK$DDMDJ$D"D,D$Dctd)z%Returns the service account email id.z'GetServiceAccountId must be overridden.NotImplementedErrorrs rGetServiceAccountIdzCloudApi.GetServiceAccountIdCs G HHrctd)aGets Bucket metadata. Args: bucket_name: Name of the bucket. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Bucket metadata fields, for example, ['logging', 'defaultObjectAcl'] Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Bucket object. zGetBucket must be overloadedrr bucket_namer fieldss r GetBucketzCloudApi.GetBucketGs" < ==rctd)aReturns an IAM policy for the specified Bucket. Args: bucket_name: Name of the bucket. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only the IAM policy fields specified. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with the cloud storage providers. Returns: Policy object of the bucket. z%GetBucketIamPolicy must be overloadedrrs rGetBucketIamPolicyzCloudApi.GetBucketIamPolicyZ E FFrctd)aSets an IAM policy for the specified Bucket. Args: bucket_name: Name of the bucket. policy: A Policy object describing the IAM policy. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with the cloud storage providers. Returns: Policy object of the bucket. May differ from input Policy. z%SetBucketIamPolicy must be overloadedr)rrpolicyr s rSetBucketIamPolicyzCloudApi.SetBucketIamPolicylr"rc td)aWSign a url using service account's system managed private key. Args: method: The HTTP method to be used with the signed URL. duration: timedelta for which the constructed signed URL should be valid. path: String path to the bucket or object for signing, in the form 'bucket' or 'bucket/object'. generation: If not None, specifies a version of an object for signing. logger: logging.Logger for warning and debug output. region: Geographic region in which the requested resource resides. signed_headers: Dict containing the header info like host content-type etc. string_to_sign_debug: If true AND logger is enabled for debug level, print string to sign to debug. Used to differentiate user's signed URL from the probing permissions-check signed URL. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. CommandException for errors because of invalid account used for signing. Returns: The signed url. zSignUrl must be overloadedr) rmethoddurationpath generationr regionsigned_headersstring_to_sign_debugs rSignUrlzCloudApi.SignUrl~s4 : ;;rctd)aLists bucket metadata for the given project. Args: project_id: Project owning the buckets, default from config if None. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these metadata fields for the listing, for example: ['items/logging', 'items/defaultObjectAcl']. Note that the WildcardIterator class should be used to list buckets instead of calling this function directly. It amends the fields definition from get-like syntax such as ['logging', 'defaultObjectAcl'] so that the caller does not need to prepend 'items/' or specify fields necessary for listing (like nextPageToken). Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Iterator over Bucket objects. zListBuckets must be overloadedr)r project_idr rs r ListBucketszCloudApi.ListBucketss0 > ??rctd)aUpdates bucket metadata for the bucket with patch semantics. Args: bucket_name: Name of bucket to update. metadata: Bucket object defining metadata to be updated. canned_acl: Canned ACL to apply to the bucket. canned_def_acl: Canned default object ACL to apply to the bucket. preconditions: Preconditions for the request. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Bucket metadata fields. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Bucket object describing new bucket metadata. zPatchBucket must be overloadedr)rrmetadata canned_aclcanned_def_acl preconditionsr rs r PatchBucketzCloudApi.PatchBuckets6 > ??rctd)aLocks the Retention Policy on the bucket. Args: bucket_name: Name of bucket to update. metageneration: Bucket metageneration to use as a precondition. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ServiceException for errors interacting with cloud storage providers. Returns: None z&LockRetentionPolicy must be overloadedr)rrmetagenerationr s rLockRetentionPolicyzCloudApi.LockRetentionPolicys F GGrctd)aCreates a new bucket with the specified metadata. Args: bucket_name: Name of the new bucket. project_id: Project owner of the new bucket, default from config if None. metadata: Bucket object defining new bucket metadata. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Bucket metadata fields. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Bucket object describing new bucket metadata. zCreateBucket must be overloadedr)rrr0r3r rs r CreateBucketzCloudApi.CreateBuckets. ? @@rctd)aDeletes a bucket. Args: bucket_name: Name of the bucket to delete. preconditions: Preconditions for the request. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: None. zDeleteBucket must be overloadedr)rrr6r s r DeleteBucketzCloudApi.DeleteBuckets ? @@rceZdZdZdZdZy)CloudApi.CsObjectOrPrefixTypez1Enum class for describing CsObjectOrPrefix types.objectprefixN)__name__ __module__ __qualname____doc__OBJECTPREFIXrrCsObjectOrPrefixTyper@ s; F FrrJceZdZdZdZy)CloudApi.CsObjectOrPrefixz(Container class for ListObjects results.c ||_||_y)zStores a ListObjects result. Args: data: Root object, either an apitools Object or a string Prefix. datatype: CsObjectOrPrefixType of data. N)datadatatype)rrNrOs rrz"CloudApi.CsObjectOrPrefix.__init__sdidmrNrCrDrErFrrIrrCsObjectOrPrefixrLs 2rrQctd)aLists objects (with metadata) and prefixes in a bucket. Args: bucket_name: Bucket containing the objects. prefix: Prefix for directory-like behavior. delimiter: Delimiter for directory-like behavior. all_versions: If true, list all object versions. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these metadata fields for the listing, for example: ['items/acl', 'items/updated', 'prefixes']. Note that the WildcardIterator class should be used to list objects instead of calling this function directly. It amends the fields definition from get-like syntax such as ['acl', 'updated'] so that the caller does not need to prepend 'items/' or specify any fields necessary for listing (such as prefixes or nextPageToken). Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Iterator over CsObjectOrPrefix wrapper class. zListObjects must be overloadedr)rrrB delimiter all_versionsr rs r ListObjectszCloudApi.ListObjectssB > ??rctd)a;Gets IAM policy for specified Object. Args: bucket_name: Bucket containing the object. object_name: Name of the object. generation: Generation of the object to retrieve. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only the IAM policy fields specified. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Object IAM policy. z%GetObjectIamPolicy must be overloadedrrr object_namer*r rs rGetObjectIamPolicyzCloudApi.GetObjectIamPolicyB. E FFrctd)aSSets IAM policy for specified Object. Args: bucket_name: Bucket containing the object. object_name: Name of the object. policy: IAM Policy object. generation: Generation of the object to which the IAM policy will apply. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Policy object of the object. May differ from input Policy. z%SetObjectIamPolicy must be overloadedr)rrrXr$r*r s rSetObjectIamPolicyzCloudApi.SetObjectIamPolicy[rZrctd)aGets object metadata. If decryption is supported by the implementing class, this function will read decryption keys from configuration and appropriately retry requests to encrypted objects with the correct key. Args: bucket_name: Bucket containing the object. object_name: Object name. generation: Generation of the object to retrieve. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Object metadata fields, for example, ['acl', 'updated']. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Object object. z$GetObjectMetadata must be overloadedrrWs rGetObjectMetadatazCloudApi.GetObjectMetadatats8 D EErc td)aUpdates object metadata with patch semantics. Args: bucket_name: Bucket containing the object. object_name: Object name for object. metadata: Object object defining metadata to be updated. canned_acl: Canned ACL to be set on the object. generation: Generation (or version) of the object to update. preconditions: Preconditions for the request. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Object metadata fields. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Updated object metadata. z&PatchObjectMetadata must be overloadedr) rrrXr3r4r*r6r rs rPatchObjectMetadatazCloudApi.PatchObjectMetadatas: F GGrceZdZdZdZdZy)CloudApi.DownloadStrategyz,Enum class for specifying download strategy.oneshot resumableN)rCrDrErFONE_SHOT RESUMABLErIrrDownloadStrategyrbs6HIrrgFctd)aGets object data. Args: bucket_name: Bucket containing the object. object_name: Object name. download_stream: Stream to send the object data to. provider: Cloud storage provider to connect to. If not present, class-wide default is used. generation: Generation of the object to retrieve. object_size: Total size of the object being downloaded. compressed_encoding: If true, object is stored with a compressed encoding. download_strategy: Cloud API download strategy to use for download. start_byte: Starting point for download (for resumable downloads and range requests). Can be set to negative to request a range of bytes (python equivalent of [:-3]) end_byte: Ending byte number, inclusive, for download (for range requests). If None, download the rest of the object. progress_callback: Optional callback function for progress notifications. Receives calls with arguments (bytes_transferred, total_size). serialization_data: Implementation-specific JSON string of a dict containing serialization information for the download. digesters: Dict of {string : digester}, where string is a name of a hash algorithm, and digester is a validation digester that supports update(bytes) and digest() using that algorithm. Implementation can set the digester value to None to indicate bytes were not successfully digested on-the-fly. decryption_tuple: Optional utils.encryption_helper.CryptoKeyWrapper for decrypting an encrypted object. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Content-encoding string if it was detected that the server sent an encoded object during transfer, None otherwise. z!GetObjectMedia must be overloadedr)rrrXdownload_streamr r* object_sizecompressed_encodingdownload_strategy start_byteend_byteprogress_callbackserialization_data digestersdecryption_tuples rGetObjectMediazCloudApi.GetObjectMediasj A BBrc td)aUploads object data and metadata. Args: upload_stream: Seekable stream of object data. object_metadata: Object metadata for new object. Must include bucket and object name. canned_acl: Optional canned ACL to apply to object. Overrides ACL set in object_metadata. size: Optional object size. preconditions: Preconditions for the request. progress_callback: Optional callback function for progress notifications. Receives calls with arguments (bytes_transferred, total_size). encryption_tuple: Optional utils.encryption_helper.CryptoKeyWrapper for encrypting the uploaded object. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Object metadata fields. gzip_encoded: Whether to use gzip transport encoding for the upload. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Object object for newly created destination object. zUploadObject must be overloadedr) r upload_streamobject_metadatar4sizer6roencryption_tupler r gzip_encodeds r UploadObjectzCloudApi.UploadObjectsL ? @@rc td)aUploads object data and metadata. Args: upload_stream: Stream of object data. May not be seekable. object_metadata: Object metadata for new object. Must include bucket and object name. canned_acl: Optional canned ACL to apply to object. Overrides ACL set in object_metadata. preconditions: Preconditions for the request. progress_callback: Optional callback function for progress notifications. Receives calls with arguments (bytes_transferred, total_size), but fills in only bytes_transferred. encryption_tuple: Optional utils.encryption_helper.CryptoKeyWrapper for encrypting the uploaded object. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Object metadata fields. gzip_encoded: Whether to use gzip transport encoding for the upload. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Object object for newly created destination object. z(UploadObjectStreaming must be overloadedr) rrurvr4r6rorxr rrys rUploadObjectStreamingzCloudApi.UploadObjectStreamingsJ H IIrc td)aUploads object data and metadata using a resumable upload strategy. Args: upload_stream: Seekable stream of object data. object_metadata: Object metadata for new object. Must include bucket and object name. canned_acl: Optional canned ACL to apply to object. Overrides ACL set in object_metadata. size: Total size of the object. preconditions: Preconditions for the request. serialization_data: Dict of {'url' : UploadURL} allowing for uploads to be resumed. tracker_callback: Callback function taking a upload URL string. Guaranteed to be called when the implementation gets an upload URL, allowing the caller to resume the upload across process breaks by saving the upload URL in a tracker file. progress_callback: Optional callback function for progress notifications. Receives calls with arguments (bytes_transferred, total_size). encryption_tuple: Optional utils.encryption_helper.CryptoKeyWrapper for encrypting the uploaded object. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Object metadata fields when the upload is complete. gzip_encoded: Whether to use gzip transport encoding for the upload. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Object object for newly created destination object. z(UploadObjectResumable must be overloadedr) rrurvr4rwr6rptracker_callbackrorxr rrys rUploadObjectResumablezCloudApi.UploadObjectResumable>s` H IIrc td)aCopies an object in the cloud. Args: src_obj_metadata: Object metadata for source object. Must include bucket name, object name, and etag. dst_obj_metadata: Object metadata for new object. Must include bucket and object name. src_generation: Generation of the source object to copy. canned_acl: Optional canned ACL to apply to destination object. Overrides ACL set in dst_obj_metadata. preconditions: Destination object preconditions for the request. progress_callback: Optional callback function for progress notifications. Receives calls with arguments (bytes_transferred, total_size). max_bytes_per_call: Integer describing maximum number of bytes to rewrite per service call. encryption_tuple: Optional utils.encryption_helper.CryptoKeyWrapper for encrypting the destination object. decryption_tuple: Optional utils.encryption_helper.CryptoKeyWrapper for decrypting the source object. If supplied without encryption_tuple, destination object will be written without customer-supplied encryption. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Object metadata fields. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Object object for newly created destination object. zCopyObject must be overloadedr) rsrc_obj_metadatadst_obj_metadatasrc_generationr4r6romax_bytes_per_callrxrrr rs r CopyObjectzCloudApi.CopyObjectrsZ = >>rctd)aComposes an object in the cloud. Args: src_objs_metadata: List of ComposeRequest.SourceObjectsValueListEntries specifying the objects to compose. dst_obj_metadata: Metadata for the destination object including bucket and object name. preconditions: Destination object preconditions for the request. encryption_tuple: Optional utils.encryption_helper.CryptoKeyWrapper for decrypting source objects and encrypting the destination object. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Object metadata fields. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Composed object metadata. z ComposeObject must be overloadedr)rsrc_objs_metadatarr6rxr rs r ComposeObjectzCloudApi.ComposeObjects: @ AArctd)aRDeletes an object. Args: bucket_name: Name of the containing bucket. object_name: Name of the object to delete. preconditions: Preconditions for the request. generation: Generation (or version) of the object to delete; if None, deletes the live object. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: None. zDeleteObject must be overloadedr)rrrXr6r*r s r DeleteObjectzCloudApi.DeleteObjects0 ? @@rctd)aCreates a notification subscription for changes to objects in a bucket. Args: bucket_name: Bucket containing the objects. address: Address to which to send notifications. channel_id: Unique ID string for the channel. token: If present, token string is delivered with each notification. provider: Cloud storage provider to connect to. If not present, class-wide default is used. fields: If present, return only these Channel metadata fields. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Channel object describing the notification subscription. zWatchBucket must be overloadedr)rraddress channel_idtokenr rs r WatchBucketzCloudApi.WatchBuckets2 > ??rctd)aStops a notification channel. Args: channel_id: Unique ID string for the channel. resource_id: Version-agnostic ID string for the channel. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: None. zStopChannel must be overloadedr)rr resource_idr s r StopChannelzCloudApi.StopChannels > ??rctd)aLists object change notifications for a bucket. Args: bucket_name: Bucket containing the objects provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: None. zListChannels must be overloadedrrrr s r ListChannelszCloudApi.ListChannelss ? @@rctd)aGet the GCS-owned service account representing this project. Args: project_number: the project in question. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ServiceException for errors interacting with cloud storage providers. Returns: Service account object (with email_address string field) z+GetProjectServiceAccount must be overloadedr)rproject_numberr s rGetProjectServiceAccountz!CloudApi.GetProjectServiceAccounts K LLrctd)a$Creates a new notification with the specified parameters. Args: bucket_name: (Required) Name of the bucket. pubsub_topic: (Required) Cloud Pub/Sub topic to which to publish. payload_format: (Required) payload format, must be 'JSON' or 'NONE'. event_types: (Opt) List of event type filters, e.g. 'OBJECT_FINALIZE'. custom_attributes: (Opt) Dictionary of custom attributes. object_name_prefix: (Opt) Filter on object name. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: Notification object describing new notificationConfig z+CreateNotificationConfig must be overloadedr)rr pubsub_topicpayload_format event_typescustom_attributesobject_name_prefixr s rCreateNotificationConfigz!CloudApi.CreateNotificationConfig(s6 K LLrctd)aDeletes a notification. Args: bucket_name: (Required) Name of the bucket. notification: (Required) Integer name of the notification. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Returns: None z+DeleteNotificationConfig must be overloadedr)rr notificationr s rDeleteNotificationConfigz!CloudApi.DeleteNotificationConfigEs K LLrctd)aLists notification configs in a bucket. Args: bucket_name: Name of the bucket. provider: Cloud storage provider to connect to. If not present, class-wide default is used. Raises: ArgumentException for errors during input validation. ServiceException for errors interacting with cloud storage providers. Yields: List of notification objects. z)ListNotificationConfig must be overloadedrrs rListNotificationConfigsz CloudApi.ListNotificationConfigsWs I JJrctd)aCreates a new HMAC key for the specified service account. Args: project_id: Project ID owning the service account for which the key is to be created. service_account_email: Email address of the service account for which to create a key. Raises: NotImplementedError: not implemented TODO(tuckerkirven) Returns The key metadata and the secret key material. z CreateHmacKey must be overloadedr)rr0service_account_emails r CreateHmacKeyzCloudApi.CreateHmacKeyhs @ AArctd)zDeletes an HMAC key. Args: project_id: Project ID owning the requested key. access_id: Name of the HMAC key to be deleted. Raises: NotImplementedError: not implemented TODO(tuckerkirven) z DeleteHmacKey must be overloadedrrr0 access_ids r DeleteHmacKeyzCloudApi.DeleteHmacKeyys @ AArctd)aQRetrieves an HMAC key's metadata. Args: project_id: Project ID owning the service account of the requested key. access_id: Name of the HMAC key for which the metadata is being requested. Raises: NotImplementedError: not implemented TODO(tuckerkirven) Returns: Metadata for the specified key. zGetHmacKey must be overloadedrrs r GetHmacKeyzCloudApi.GetHmacKeys = >>rctd)aLists HMAC keys matching the criteria. Args: project_id: Name of the project from which to list HMAC keys. service_account_email: If present, only keys for the given service account will be returned. show_deleted_keys: If set, show keys in the DELETED state. Raises: NotImplementedError: not implemented TODO(tuckerkirven) Yields: List of HMAC key metadata objects. zListHmacKeys must be overloadedr)rr0rshow_deleted_keyss r ListHmacKeyszCloudApi.ListHmacKeyss" ? @@rctd)aUpdates the state of an HMAC key. Args: project_id: Project ID owning the service account of the updated key. access_id: Name of the HMAC key being updated. state: The state to which the key should be updated. etag: None or a string matching the key's etag to ensure the appropriate version of the key is updated. Raises: NotImplementedError: not implemented TODO(tuckerkirven) Returns: The updated key metadata. z UpdateHmacKey must be overloadedr)rr0rstateetags r UpdateHmacKeyzCloudApi.UpdateHmacKeys @ AAr)NrNNNNNNN)NNN)NNNNN)NNNN)NNNNNNNF)NNNNNNF) NNNNNNNNNF) NNNNNNNNN)F),rCrDrErFrrrr!r%r.r1r7r:r<r>rArJrQrUrYr\r^r`rgrersrzr|rrrrrrrrrrrrrrrrrIrrrrsB  $ "%HI>&G$G$<8@:"!% $@:H&#   A2A$V   # !@L%)"& $ G:%)"& G8$(!%# FD&*%)(,#'!%H># $!%).'7'@'@ !"'+(,#&*5Ct#!%%)$(  %&AV(,*..2-1%)#').%JT(,!%*./3-1.2-1%)#').0Jn!% ##'$("&"&-?d#'%)! BD"&" A< @6@$A"M(,01526(,M:M$K"B" B ?$&+A&BrrceZdZdZddZy) PreconditionszGPreconditions class for specifying preconditions to cloud API requests.Nc ||_||_y)aHInstantiates a Preconditions object. Args: gen_match: Perform request only if generation of target object matches the given integer. Ignored for bucket requests. meta_gen_match: Perform request only if metageneration of target object/bucket matches the given integer. N) gen_matchmeta_gen_match)rrrs rrzPreconditions.__init__sDN(DrrrPrIrrrrs O )rrceZdZdZy)EncryptionExceptionz@Exception raised when an encrypted resource cannot be decrypted.NrCrDrErFrIrrrrsHrrc"eZdZdZdZdZdZy)ArgumentExceptionzException raised when arguments to a Cloud API method are invalid. This exception is never raised as a result of a failed call to a cloud storage provider. c<tj|||_yr) Exceptionrreason)rrs rrzArgumentException.__init__s tDKrct|Srstrrs r__repr__zArgumentException.__repr__ t9rcL|jjd|jS)Nz: ) __class__rCrrs r__str__zArgumentException.__str__s~~.. <Exception raised for res. downloads that can be retried later.NrrIrrrrFrrceZdZdZy)ResumableUploadExceptionzHException raised for res. uploads that can be retried w/ same upload ID.NrrIrrrrrrrceZdZdZy)!ResumableUploadStartOverExceptionzGException raised for res. uploads that can be retried w/ new upload ID.NrrIrrrr sOrrceZdZdZy)ResumableUploadAbortExceptionzDException raised for resumable uploads that cannot be retried later.NrrIrrrr sLrrceZdZdZy)AuthenticationExceptionz>Exception raised for errors during the authentication process.NrrIrrrrrrrceZdZdZy)PreconditionExceptionz+Exception raised for precondition failures.NrrIrrrrs3rrceZdZdZy)NotFoundExceptionz4Exception raised when a resource is not found (404).NrrIrrrrsrs?&'aBvaBH )F ) I)I= =$Q*Qy22 02G!:GQ8QP(APM$4MG.G4,4=(=#/#F(F*,'7r