a !f2@s$dZddlmZGdddeZdS)z>Class for representing a single entity in the Cloud Datastore.)_ensure_tuple_or_listcsZeZdZdZdfdd ZfddZdd Zed d Zed d Z fddZ Z S)EntityalEntities are akin to rows in a relational database An entity storing the actual instance of data. Each entity is officially represented with a :class:`gcloud.datastore.key.Key` class, however it is possible that you might create an Entity with only a partial Key (that is, a Key with a Kind, and possibly a parent, but without an ID). In such a case, the datastore service will automatically assign an ID to the partial key. Entities in this API act like dictionaries with extras built in that allow you to delete or persist the data stored on the entity. Entities are mutable and act like a subclass of a dictionary. This means you could take an existing entity and change the key to duplicate the object. Use :func:`gcloud.datastore.get` to retrieve an existing entity. >>> from gcloud import datastore >>> client = datastore.Client() >>> client.get(key) You can the set values on the entity just like you would on any other dictionary. >>> entity['age'] = 20 >>> entity['name'] = 'JJ' >>> entity And you can convert an entity to a regular Python dictionary with the ``dict`` builtin: >>> dict(entity) {'age': 20, 'name': 'JJ'} .. note:: When saving an entity to the backend, values which are "text" (``unicode`` in Python2, ``str`` in Python3) will be saved using the 'text_value' field, after being encoded to UTF-8. When retrieved from the back-end, such values will be decoded to "text" again. Values which are "bytes" (``str`` in Python2, ``bytes`` in Python3), will be saved using the 'blob_value' field, without any decoding / encoding step. :type key: :class:`gcloud.datastore.key.Key` :param key: Optional key to be set on entity. :type exclude_from_indexes: tuple of string :param exclude_from_indexes: Names of fields whose values are not to be indexed for this entity. Ncs.tt|||_ttd||_i|_dS)Nexclude_from_indexes)superr__init__keysetr_exclude_from_indexes _meanings)selfrr __class__rX/var/www/html/python-backend/venv/lib/python3.9/site-packages/gcloud/datastore/entity.pyrOs zEntity.__init__csBt|tsdS|j|jko@|j|jko@|j|jko@tt||S)zCompare two entities for equality. Entities compare equal if their keys compare equal, and their properties compare equal. :rtype: boolean :returns: True if the entities compare equal, else False. F) isinstancerrr r r__eq__r otherr rrrXs    z Entity.__eq__cCs || S)zCompare two entities for inequality. Entities compare equal if their keys compare equal, and their properties compare equal. :rtype: boolean :returns: False if the entities compare equal, else True. )rrrrr__ne__is z Entity.__ne__cCs|jr|jjSdS)a;Get the kind of the current entity. .. note:: This relies entirely on the :class:`gcloud.datastore.key.Key` set on the entity. That means that we're not storing the kind of the entity at all, just the properties and a pointer to a Key which knows its Kind. N)rkindr rrrrts z Entity.kindcCs t|jS)zNames of fields which are *not* to be indexed for this entity. :rtype: sequence of field names :returns: The set of fields excluded from indexes. ) frozensetr rrrrrszEntity.exclude_from_indexescs6|jr d|jjtt|fSdtt|SdS)Nz z )rpathrr__repr__rr rrrs  zEntity.__repr__)Nr) __name__ __module__ __qualname____doc__rrrpropertyrrr __classcell__rrr rrs9    rN)rZgcloud._helpersrdictrrrrrs