Use README.rst as 'long_description' for 'setup()'.

Fixes #440.
Add 'eventual' flag to 'Connection.lookup()'/'Connection.run_query()'.

Allows selecting EVENTUAL consistency, rather than the STRONG default.

Fixes #305.
Merge pull request #448 from tseaver/440-add_long_description_to_setup

Use README.rst as 'long_description' for 'setup()'.
Spell enumerated value more naturally.

Feedback from @dhermes:
https://github.com/GoogleCloudPlatform/gcloud-python/pull/449/files#r22115879
Improve variable names.

Feedback from @dhermes:
https://github.com/GoogleCloudPlatform/gcloud-python/pull/449/files#r22116090
DRY out read_options logic.

Feedback from @dhermes:
https://github.com/GoogleCloudPlatform/gcloud-python/pull/449#discussion_r22116623
https://github.com/GoogleCloudPlatform/gcloud-python/pull/449#discussion_r22116657
Merge pull request #449 from tseaver/305-lookup-run_query-eventual

Add 'eventual' flag to 'Connection.lookup()' / 'Connection.run_query()'.
Adding helper methods for implicit datastore environ.

By setting two environment variables

- GCLOUD_DATASET_ID
- GOOGLE_APPLICATION_CREDENTIALS

the user can call convenience methods in `gcloud.datastore` directly
without worrying about auth or the name of the dataset. The
goal is that in places like App Engine and Compute Engine, the
dataset ID can be implied without **any** user intervention.

Partially addresses #337.

NOTE: This still needs to be documented, but it's unclear
      where is appropriate. We also need to have documentation
      for auth (outside of CONTRIBUTING.md).