a !f{@sFdZddlZddlmZGdddeZddZd d d Zd d ZdS)zVHelper functions for Cloud Storage utility classes. These are *not* part of the API. N)md5c@s^eZdZdZdddZeddZeddZd d Zdd d Z d dZ ddZ dddZ dS)_PropertyMixinzAbstract mixin for cloud storage classes with associated propertties. Non-abstract subclasses should implement: - client - path :type name: string :param name: The name of the object. NcCs||_i|_t|_dSN)name _propertiesset_changes)selfrr X/var/www/html/python-backend/venv/lib/python3.9/site-packages/gcloud/storage/_helpers.py__init__#sz_PropertyMixin.__init__cCstdS)z$Abstract getter for the object path.NNotImplementedErrorr r r r path(sz_PropertyMixin.pathcCstdS)z&Abstract getter for the object client.Nr rr r r client-sz_PropertyMixin.clientcCs|dur|j}|S)aCheck client or verify over-ride. :type client: :class:`gcloud.storage.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current object. :rtype: :class:`gcloud.storage.client.Client` :returns: The client passed in or the currently bound client. N)r)r rr r r _require_client2s z_PropertyMixin._require_clientcCs6||}ddi}|jjd|j||d}||dS)aReload properties from Cloud Storage. :type client: :class:`gcloud.storage.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current object. projectionZnoAclGET)methodr query_params_target_objectN)r connection api_requestr_set_properties)r rr api_responser r r reload@s z_PropertyMixin.reloadcCs|j|||j|<dS)aUpdate field of this object's properties. This method will only update the field provided and will not touch the other fields. It **will not** reload the properties from the server. The behavior is local only and syncing occurs via :meth:`patch`. :type name: string :param name: The field name to update. :type value: object :param value: The value being updated. N)raddr)r rvaluer r r _patch_propertyPs z_PropertyMixin._patch_propertycCs||_t|_dS)zSet the properties for the current object. :type value: dict or :class:`gcloud.storage.batch._FutureDict` :param value: The properties to be set. N)rrrr rr r r rbsz_PropertyMixin._set_propertiescsL|}tfddjD}|jjdj|ddid}|dS)a[Sends all changed properties in a PATCH request. Updates the ``_properties`` with the response from the backend. :type client: :class:`gcloud.storage.client.Client` or ``NoneType`` :param client: the client to use. If not passed, falls back to the ``client`` stored on the current object. c3s|]}|j|fVqdSr)r).0keyrr r xsz'_PropertyMixin.patch..PATCHrfull)rrdatarrN)rdictrrrrr)r rZupdate_propertiesrr rr patchls  z_PropertyMixin.patch)N)N)N) __name__ __module__ __qualname____doc__r propertyrrrrrrr(r r r r rs     rcs"fdd}fdd}t||S)zMCreate a property descriptor around the :class:`_PropertyMixin` helpers. cs |jS)zScalar property getter.)rgetr fieldnamer r _gettersz!_scalar_property.._gettercs||dS)zScalar property setter.N)rr r/r r _settersz!_scalar_property.._setter)r-)r0r1r2r r/r _scalar_propertys  r3 cCs0||}t|dkr,||||}q dS)aRead blocks from a buffer and update a hash with them. :type buffer_object: bytes buffer :param buffer_object: Buffer containing bytes used to update a hash object. :type hash_obj: object that implements update :param hash_obj: A hash object (MD5 or CRC32-C). :type digest_block_size: integer :param digest_block_size: The block size to write to the hash. Defaults to 8192. rN)readlenupdate) buffer_objecthash_objZdigest_block_sizeblockr r r _write_buffer_to_hashs   r;cCs"t}t|||}t|S)a Get MD5 hash of bytes (as base64). :type buffer_object: bytes buffer :param buffer_object: Buffer containing bytes used to compute an MD5 hash (as base64). :rtype: str :returns: A base64 encoded digest of the MD5 hash. )rr;digestbase64 b64encode)r8r9Z digest_bytesr r r _base64_md5hashs  r?)r4) r,r=hashlibrobjectrr3r;r?r r r r s  h