semvec/pypi-packages huggingface dataset:
gclouddatastore 0.1.2
API Client library for Google Cloud Datastore
License: Apache 2.0

# Google Cloud Datastore

## Incredibly quick demo

You need a few packages, so take a look at requirements.txt and `pip install` them.

    $ pip install -r requirements.txt

Then you should be all set to run the demo...

    $ python demo/demo.py

## Doing this on your own

### Create a project

- Visit https://cloud.google.com/console
- Click the big red button that says "Create Project".
- In the name box, pick something friendly.
- In the ID box, pick something unique to you (ie, jgatsby-storage).

### Enable the Cloud Datastore

- Click on APIs & Auth, and scroll down to Google Cloud Datastore API.
- Click the "Off" button on the right to turn it into an "On" :)

### Enable a Service Account

- Click on Credentials (under APIs & Auth).
- Under the OAuth section (the first one) click the big red button that says "Create New Client ID".
- Choose Service Account, and click the blue button "Create Client ID".
- This will automatically download a private key, don't lose this.
- Rename this key something shorter... like "jgatsby-storage.key".
- Copy the long weird e-mail address (it's labeled "E-mail address" in the information for the service account you just created).

### Add some demo data (manually)

- Click on Cloud Datastore towards the bottom.
- Click the big red button that says "Create Entity".
- Leave Namespace alone (should be in the default one).
- For Kind, type in "Thing".
- Leave Key set to ID (this will automatically pick a numeric ID for you).
- In the first textbox, type in "name" (this is like one of the columns in a regular database).
- Leave it as a string, and indexed.
- For the value, type in "Computer".
- Click "Create Entity".

What you just did there is add an entity that equates to a Python object you'd construct like... Thing(name='Computer').

Feel free to add another Thing. Maybe a "Beer"? And a "Desk"?

### Write some code

You can use `demo/demo.py` as a reference.

    import gclouddatastore

    CLIENT_EMAIL = '<the e-mail address you copied>'
    KEY_PATH = './jgatsby-storage.key'  # Make this the path to the key that auto-downloaded.

    connection = gclouddatastore.get_connection(
        'jgatsby-storage',  # Make this the project ID you picked before.
        CLIENT_EMAIL, KEY_PATH)

    # This will print out all the Thing's you created.
    print connection.query('Thing').fetch()

### Yay, you're done

Go build cool stuff :)

## Hmm, that's not on the Google Cloud website...

You might notice that the other tutorials are a bit different.
This introduction is focused on you, on your home computer, with no interest
at all in using Google Compute Engine.