google.appengine.ext.blobstore.BlobMigrationRecord

Defines a model that records the result of a blob migration.

Inherits From: Model, expected_type

google.appengine.ext.blobstore.BlobMigrationRecord(
    parent=None, key_name=None, _app=None, _from_entity=False, **kwds
)

parent Parent instance for this instance or None, indicating a top- level instance.
key_name Name for new model instance.
_from_entity Intentionally undocumented.
kwds Keyword arguments mapping to properties of model. Also: key: Key instance for this instance, if provided makes parent and key_name redundant (they do not need to be set but if they are they must match the key).

new_blob_ref Property compatible with db.Model classes.

Add references to blobs to domain models using BlobReferenceProperty::

class Picture(db.Model):
  title = db.StringProperty()
  image = blobstore.BlobReferenceProperty()
  thumbnail = blobstore.BlobReferenceProperty()

To find the size of a picture using this model::

picture = Picture.get(picture_key)
print picture.image.size

BlobInfo objects are lazily loaded, so iterating over models for BlobKeys is efficient. The following sample code does not need to hit Datastore for each image key::

list_of_untitled_blobs = []
for picture in Picture.gql("WHERE title=''"):
  list_of_untitled_blobs.append(picture.image.key())

Methods

all

View source

@classmethod
all(
    **kwds
)

Returns a query over all instances of this model from the datastore.

Returns
Query that will retrieve all instances from entity collection.

delete

View source

delete(
    **kwargs
)

Deletes this entity from the datastore.

Args
config datastore_rpc.Configuration to use for this request.

Raises
TransactionFailedError if the data could not be committed.

dynamic_properties

View source

dynamic_properties()

Returns a list of all dynamic properties defined for instance.

entity_type

View source

@classmethod
entity_type()

Soon to be removed alias for kind.

fields

View source

@classmethod
fields()

Soon to be removed alias for properties.

from_entity

View source

@classmethod
from_entity(
    entity
)

Converts the entity representation of this model to an instance.

Converts datastore.Entity instance to an instance of cls.

Args
entity Entity loaded directly from datastore.

Raises
KindError when cls is incorrect model for entity.

get

View source

@classmethod
get(
    keys, **kwargs
)

Fetch instance from the datastore of a specific Model type using key.

We support Key objects and string keys (we convert them to Key objects automatically).

Useful for ensuring that specific instance types are retrieved from the datastore. It also helps that the source code clearly indicates what kind of object is being retrieved. Example:

story = Story.get(story_key)

Args
keys Key within datastore entity collection to find; or string key; or list of Keys or string keys.
config datastore_rpc.Configuration to use for this request.

Returns
If a single key was given: a Model instance associated with key for the provided class if it exists in the datastore, otherwise None. If a list of keys was given: a list where list[i] is the Model instance for keys[i], or None if no instance exists.

Raises
KindError if any of the retrieved objects are not instances of the type associated with call to get.

get_by_blob_key

View source

@classmethod
get_by_blob_key(
    old_blob_key
)

Fetches the BlobMigrationRecord for the given blob key.

Args
old_blob_key The blob key that was used in the previous app.

Returns
A instance of blobstore.BlobMigrationRecord or None.

get_by_id

View source

@classmethod
get_by_id(
    ids, parent=None, **kwargs
)

Returns instance of Model class by id.

Args
key_names A single id or a list of ids.
parent Parent of instances to get. Can be a model or key.
config datastore_rpc.Configuration to use for this request.

get_by_key_name

View source

@classmethod
get_by_key_name(
    key_names, parent=None, **kwargs
)

Returns instance of Model class by its key's name.

Args
key_names A single key-name or a list of key-names.
parent Parent of instances to get. Can be a model or key.
config datastore_rpc.Configuration to use for this request.

get_new_blob_key

View source

@classmethod
get_new_blob_key(
    old_blob_key
)

Looks up the new key for a blob.

Args
old_blob_key The original blob key.

Returns
The blobstore.BlobKey of the migrated blob.

get_or_insert

View source

@classmethod
get_or_insert(
    key_name, **kwds
)

Transactionally retrieve or create an instance of Model class.

This acts much like the Python dictionary setdefault() method, where we first try to retrieve a Model instance with the given key name and parent. If it's not present, then we create a new instance (using the *kwds supplied) and insert that with the supplied key name.

Subsequent calls to this method with the same key_name and parent will always yield the same entity (though not the same actual object instance), regardless of the *kwds supplied. If the specified entity has somehow been deleted separately, then the next call will create a new entity and return it.

If the parent keyword argument is supplied, it must be a Model instance. It will be used as the parent of the new instance of this Model class if one is created.

This method is especially useful for having just one unique entity for a specific identifier. Insertion/retrieval is done transactionally, which guarantees uniqueness.

Example usage:

class WikiTopic(db.Model): creation_date = db.DatetimeProperty(auto_now_add=True) body = db.TextProperty(required=True)

The first time through we'll create the new topic.

wiki_word = 'CommonIdioms' topic = WikiTopic.get_or_insert(wiki_word, body='This topic is totally new!') assert topic.key().name() == 'CommonIdioms' assert topic.body == 'This topic is totally new!'

The second time through will just retrieve the entity.

overwrite_topic = WikiTopic.get_or_insert(wiki_word, body='A totally different message!') assert topic.key().name() == 'CommonIdioms' assert topic.body == 'This topic is totally new!'

Args
key_name Key name to retrieve or create.
**kwds Keyword arguments to pass to the constructor of the model class if an instance for the specified key name does not already exist. If an instance with the supplied key_name and parent already exists, the rest of these arguments will be discarded.

Returns
Existing instance of Model class with the specified key_name and parent or a new one that has just been created.

Raises
TransactionFailedError if the specified Model instance could not be retrieved or created transactionally (due to high contention, etc).

gql

View source

@classmethod
gql(
    query_string, *args, **kwds
)

Returns a query using GQL query string.

See appengine/ext/gql for more information about GQL.

Args
query_string properly formatted GQL query string with the SELECT * FROM <entity> part omitted
*args rest of the positional arguments used to bind numeric references in the query.
**kwds dictionary-based arguments (for named parameters).

has_key

View source

has_key()

Determine if this model instance has a complete key.

When not using a fully self-assigned Key, ids are not assigned until the data is saved to the Datastore, but instances with a key name always have a full key.

Returns
True if the object has been persisted to the datastore or has a key or has a key_name, otherwise False.

instance_properties

View source

instance_properties()

Alias for dyanmic_properties.

is_saved

View source

is_saved()

Determine if entity is persisted in the datastore.

New instances of Model do not start out saved in the data. Objects which are saved to or loaded from the Datastore will have a True saved state.

Returns
True if object has been persisted to the datastore, otherwise False.

key

View source

key()

Unique key for this entity.

This property is only available if this entity is already stored in the datastore or if it has a full key, so it is available if this entity was fetched returned from a query, or after put() is called the first time for new entities, or if a complete key was given when constructed.

Returns
Datastore key of persisted entity.

Raises
NotSavedError when entity is not persistent.

kind

View source

@classmethod
kind()

Specifies the kind of blob that you are migrating.

Returns
The kind of blob that you are migrating

parent

View source

parent()

Get the parent of the model instance.

Returns
Parent of contained entity or parent provided in constructor, None if instance has no parent.

parent_key

View source

parent_key()

Get the parent's key.

This method is useful for avoiding a potential fetch from the datastore but still get information about the instance's parent.

Returns
Parent key of entity, None if there is no parent.

properties

View source

@classmethod
properties()

Returns a dictionary of all the properties defined for this model.

put

View source

put(
    **kwargs
)

Writes this model instance to the datastore.

If this instance is new, we add an entity to the datastore. Otherwise, we update this instance, and the key will remain the same.

Args
config datastore_rpc.Configuration to use for this request.

Returns
The key of the instance (either the existing key or a new key).

Raises
TransactionFailedError if the data could not be committed.

save

View source

save(
    **kwargs
)

Writes this model instance to the datastore.

If this instance is new, we add an entity to the datastore. Otherwise, we update this instance, and the key will remain the same.

Args
config datastore_rpc.Configuration to use for this request.

Returns
The key of the instance (either the existing key or a new key).

Raises
TransactionFailedError if the data could not be committed.

to_xml

View source

to_xml(
    _entity_class=google.appengine.api.datastore.Entity
)

Generate an XML representation of this model instance.

atom and gd:namespace properties are converted to XML according to their respective schemas. For more information, see:

http://www.atomenabled.org/developers/syndication/ https://developers.google.com/gdata/docs/1.0/elements