René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Feels like we've added a bit more complexity to the datastore API, comments?","articleBody":"Hi guys,\n\nI was reviewing the \"state of the world\" of the datastore API, and found a few things that seem (to me at least) a bit more complicated than they should be.\n\nA bit of this comes from the authentication stuff (which we have another open bug for) but I wanted to bring up a few things for discussion... If this issue gets out of control, we can move the discussion elsewhere, but I wanted to kick things off:\n### Create a new Person entity in the Datastore\n#### What I have to write\n\n``` python\nfrom gcloud import datastore\ndatastore.set_defaults()\nentity = datastore.Entity(key=datastore.Key('Person'))\nentity.update({'name': 'Jimmy'})\ndatastore.put([entity])\n```\n#### What I'd like to write\n\n``` python\nfrom gcloud import datastore\nentity = datastore.Entity('Person')\nentity.update({'name': 'Jimmy'})\nentity.put()\n```\n#### Key differences\n1. no `set_defaults()` (there's another issue open for this I believe)\n2. Create an entity of kind Person without lots more typing (or maybe we get the entity with `datastore.Kind('Person').get_entity()` ?)\n3. `.put` not requiring a list for a single entity\n### Get an existing Person (123) from the Datastore\n#### What I have to write\n\n``` python\nfrom gcloud import datastore\ndatastore.set_defaults()\nentity = datastore.get(datastore.Key('Person', 123))\n```\n#### What I'd like to write\n\n``` python\nfrom gcloud import datastore\ndatastore.set_defaults()\nentity = datastore.Kind('Person').get_by_id(123)\n```\n#### Key differences\n1. No `set_defaults`\n2. Equivalent of \"drilling down\" into a \"table\" (kind), and then a \"row\" (id)\n\n_(Not hugely concerned about this use case, but wanted to toss it out)_\n### Create a new Person using a specific set of credentials (`/home/creds.json`) to talk to a specific dataset (`'my-dataset'`) in the Datastore\n\n(Being looked into in PR https://github.com/GoogleCloudPlatform/gcloud-python/pull/641)\n#### What I have to write\n\n_(This is a best guess... I don't know if this code is even right... And even so, this code won't do the same thing if you ran it on App Engine because of the order of evaluation here: http://googlecloudplatform.github.io/gcloud-python/latest/gcloud-api.html#gcloud.credentials.get_credentials )_\n\n``` python\nimport sys\nsys.env['GOOGLE_APPLICATION_CREDENTIALS'] = '/home/creds.json'\n\nfrom gcloud import datastore\ndatastore.set_defaults()\nentity = datastore.Entity(key=datastore.Key('Person', dataset_id='my-dataset'))\nentity.update{'name': 'Jimmy'})\ndatastore.put(entity)\n```\n#### What I'd like to write\n\n``` python\nfrom gcloud import datastore\ndatastore.set_credentials('/home/creds.json')\ndataset = datastore.Dataset('my-dataset')\nentity = dataset.Entity('Person')\nentity.update({'name': 'Jimmy'})\nentity.put()\n```\n#### Key differences\n1. Simple in-code way to set which credentials file to use\n2. High-level concept of a dataset\n3. Datasets can provide Entities just like `datastore` would\n\n/cc @tseaver @dhermes @pcostell \n","author":{"url":"https://github.com/jgeewax","@type":"Person","name":"jgeewax"},"datePublished":"2015-02-15T19:02:59.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":10},"url":"https://github.com/647/google-cloud-python/issues/647"}