Merge pull request #93 from pcostell/v1beta3

Upgrade to v1beta3.

Author: pcostell

.gitignore

@@ -1,4 +1,2 @@
 *.p12
-
-ruby/**/*/datastore.yml
-Gemfile.lock
+*.pyc

README.md

@@ -9,62 +9,36 @@ The API is deliberately low-level to map to the underlying Datastore RPC model a
 
 This repository contains the source code of samples and developer
 resources related to Google Cloud Datastore:
-- [Service and protocol buffers messages definition][6]
-- [Python protocol buffers client library and samples][9]
-- [Java protocol buffers Java client library and samples][10]
-- [Node.js samples][11]
+
+- [RPC API reference][6]
+- [Python proto client library and samples][9]
+- [Java proto Java client library and samples][10]
 
 ## Samples
 
-### JSON
-- [Node.js][3], [todo.js][24]
-- [Ruby][21], [todos.rb][25]
-- [[Add yours here][16]]
+### Proto
 
-### Protobuf
 - [Python][1]
 - [Java][2]
 - [[Add yours here][16]]
 
 ## Client libraries
 
-### JSON
-
-- [Node.js][17]:
-
-```
-npm install googleapis
-```
-
-- [Ruby (google-api-client)][23]
-
-```
-gem install google-api-client
-```
-
-- [Ruby (ActiveDatastore)][22]
-
-```
-gem install active_datastore
-```
-
-- [Dart][26]
-- [[Add yours here][16]]
+### Proto
 
-### Protobuf
 - [Python][18] ([readthedocs][19]):
 
 ```
-pip install googledatastore
+pip install --pre googledatastore
 ```
 
-- Maven/Java ([javadoc][20]):
+- Maven/Java:
 
 ```
 <dependency>
-  <groupId>com.google.apis</groupId>
-  <artifactId>google-api-services-datastore-protobuf</artifactId>
-  <version>v1beta2-rev1-4.0.0</version>
+  <groupId>com.google.cloud.datastore</groupId>
+  <artifactId>datastore-v1beta3-proto-client</artifactId>
+  <version>1.0.0-beta</version>
 </dependency>
 ```
 
@@ -73,16 +47,16 @@ pip install googledatastore
 ## Documentation
 
 - [Getting Started][4]
-- [JSON API reference][5]
-- [Protocol Buffers API reference][6]
+- [JSON/REST API reference][5]
+- [RPC API reference][6]
 
 ## Filing Issues
 
 1. For production issues and support, see [Google Cloud Platform Support packages][13].
 1. For bugs or feature requests, please first look at [existing issues][14].
 1. When applicable, create a new [report][15].
 1. For bugs, detail the steps to reproduce the problem and the affected version number.
-1. For feature requests, articulate the usecase you are trying solve and describe current workaround.
+1. For feature requests, articulate the use case you are trying solve and describe current workaround.
 1. Make sure to annotate the issues with the appropriate labels.
 
 ## Contributing changes
@@ -94,27 +68,20 @@ pip install googledatastore
 - See [LICENSE][8]
 
 [1]: python/demos/trivial/adams.py
-[2]: java/demos/src/main/java/com/google/api/services/datastore/demos/trivial/Adams.java
-[3]: https://github.com/GoogleCloudPlatform/google-cloud-datastore/blob/master/nodejs/demos/trivial/adams.js
-[4]: https://developers.google.com/datastore
-[5]: https://developers.google.com/datastore/docs/apis/v1beta2/
-[6]: https://developers.google.com/datastore/docs/apis/v1beta2/proto
+[2]: java/demos/src/main/java/com/google/datastore/v1beta3/demos/trivial/Adams.java
+[4]: https://cloud.google.com/datastore
+[5]: https://cloud.google.com/datastore/reference/rest
+[6]: https://cloud.google.com/datastore/reference/rpc
 [7]: CONTRIB.md
 [8]: LICENSE
 [9]: python
 [10]: java
-[11]: nodejs
 [13]: https://cloud.google.com/support/packages
 [14]: https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues
 [15]: https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/new
 [16]: https://github.com/GoogleCloudPlatform/google-cloud-datastore/fork
 [17]: https://npmjs.org/package/googleapis
 [18]: https://pypi.python.org/pypi/googledatastore
 [19]: http://googledatastore.readthedocs.org
-[20]: https://developers.google.com/datastore/docs/apis/javadoc/
-[21]: ruby/demos/trivial/adams.rb
 [22]: https://github.com/sudhirj/active_datastore
 [23]: https://rubygems.org/gems/google-api-client
-[24]: nodejs/demos/todos/todo.js
-[25]: ruby/demos/todos/todos.rb
-[26]: https://github.com/dart-google-apis/dart_datastore_v1beta1_api_client

RELEASE_NOTES.md

@@ -1,65 +1,130 @@
-RELEASE NOTES
-=============
+# Release Notes
 
-v1beta2-rev1-4.0.0
-------------------
-- Switch to version 3.0.0b1 of protocol buffer compiler.
+Starting with the v1beta3 release:
 
-v1beta2-rev1-3.0.4
-------------------
-- Make the dependency requirements in the Python client more permissive.
+  - Release notes for the API and `gcd` tool can be found at:
+    <https://cloud.google.com.com/datastore/docs/release-notes>
+  - Release notes are grouped by library.
+
+## Java Client
+
+### java-v1beta3-1.0.0-beta
+
+  - Support for [Google Application Default Credentials](https://developers.google.com/identity/protocols/application-default-credentials).
+  - Fixes:
+    https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/37
+  - Environment variable `DATASTORE_DATASET_ID` is now `DATASTORE_PROJECT_ID`.
+  - Environment variable `DATASTORE_HOST` is now `DATASTORE_EMULATOR_HOST` and
+    its value no longer includes the URL scheme. For example:
+
+      `DATASTORE_EMULATOR_HOST=localhost:8080`
+
+    instead of:
+
+      `DATASTORE_HOST=http://localhost:8080`
+- `DatastoreHelper.getOptionsFromEnv()` now
+    supports automatic detection of the project ID when running on
+    Compute Engine.
+  - The client and generated proto classes are now in the
+    `com.google.datastore.v1beta3` Java package.
+  - The Maven artifacts are now found under groupId `com.google.cloud.datastore`.
+    The artifactIds are:
+      - `datastore-v1beta3-proto-client-parent`
+      - `datastore-v1beta3-proto-client`
+      - `datastore-v1beta3-protos`
+  - The versionIds no longer include the API version (e.g. `v1beta3`)
+    since it is now part of the artifactId.
+  - Updated `LocalDevelopmentDatastore` so it is in sync with the `gcd` tool.
+    - Fixes:
+      <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/53>
+
+## Python Client
+
+### python-5.0.0-beta (v1beta3)
+
+  - Support for [Google Application Default Credentials](https://developers.google.com/identity/protocols/application-default-credentials).
+  - Fixes:
+    <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/37>
+  - Environment variable `DATASTORE_DATASET_ID` is now `DATASTORE_PROJECT_ID`.
+  - Environment variable `DATASTORE_HOST` is now `DATASTORE_EMULATOR_HOST` and
+    its value no longer includes the URL scheme. For example:
+
+      `DATASTORE_EMULATOR_HOST=localhost:8080`
+
+    instead of:
+
+      `DATASTORE_HOST=http://localhost:8080`
+- `helper.set_value()` now supports `long` values.
+    - Fixes:
+      <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/49>
+
+## Other
+
+### v1beta3
+
+- Remove v1beta2-based Ruby and Node.js demos.
+- The protocol buffer definition of the API is now published at
+  <https://github.com/google/googleapis>.
+
+## Pre-v1beta3 Releases
+
+### v1beta2-rev1-3.0.2
 
-v1beta2-rev1-3.0.2
-------------------
 - Fix QuerySplitter to support small queries that do not need to be split.
 
-v1beta2-rev1-3.0.0
-------------------
+### v1beta2-rev1-3.0.0
+
 - Change to QuerySplitter interface.
   - This will not affect users of the interface, however is a breaking change for
-    any implements of the interface. This adds a method that allows specifying
-    the PartitionId so that namespace queries can be split.
+    any implementers of the interface. This adds a method that allows
+    specifying the PartitionId so that namespace queries can be split.
 - Modify helper functions in the Python client library to support long integers.
-  - Fixes: https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/49.
+  - Fixes:
+    <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/49>.
 - Check environment variables before creating a Compute Engine credential in Python and Java client libraries.
-  - Fixes: https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/37.
+  - Fixes:
+    <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/37>.
 - Bring LocalDevelopmentDatastore into sync with the current `gcd` command line tool options.
 - Renamed `DatastoreHelper.getOptionsfromEnv()` to `DatastoreHelper.getOptionsFromEnv()`.
 - Assign a PEP 440-compatible identifier to the Python client library package.
 
-v1beta2-rev1-2.1.1
-------------------
+### v1beta2-rev1-2.1.1
 - Update to latest App Engine SDK version.
-  - Fixes: https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/35.
+  - Fixes:
+    <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/35>.
+
+### v1beta2-rev1-2.1.0
 
-v1beta2-rev1-2.1.0
-------------------
 - Make Python client library thread-safe.
 - Fix propagation of `indexed` param to list values in Python helper.
 - Accept an optional HttpRequestInitializer in DatastoreOptions (Java).
 - Demonstrate JWT service account support in Node.js demo app.
 
-v1beta2-rev1-2.0.0
-------------------
+### v1beta2-rev1-2.0.0
+
 - API changes:
   - `BlindWrite` method merged into `Commit`.
   - Added `list_value` to `Value` and changed `value` to a non-repeated field in `Property`.
-  - In JSON API, string constants are now uppercase and underscore-separated instead of camel-cased (e.g. `LESS_THAN_OR_EQUAL` instead of `lessThanOrEqual`).
+  - In JSON API, string constants are now uppercase and underscore-separated
+    instead of camel-cased (e.g. `LESS_THAN_OR_EQUAL` instead of
+    `lessThanOrEqual`).
 - GQL changes:
   - New synthetic literals: `BLOB`, `BLOBKEY`, `DATETIME`, `KEY`.
   - Support for `IS NULL`.
   - Fixed partition ID handling for binding arguments.
 - Documentation changes:
   - All documentation has been updated to the v1beta2 API.
-  - Getting started guide for Node.js now uses v0.4.5 of google-api-nodejs-client.
-- Fixed partition ID handling for query requests that include an explicit partition ID.
+  - Getting started guide for Node.js now uses v0.4.5 of
+    google-api-nodejs-client.
+- Fixed partition ID handling for query requests that include an explicit
+  partition ID.
 - Fixed scopes in discovery document.
-  - https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/9
+  - <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/9>
 - Fixed an issue where command line tool didn't work for some locales.
-  - https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/12
+  - <https://github.com/GoogleCloudPlatform/google-cloud-datastore/issues/12>
+
+### v1beta1-rev2-1.0.1
 
-v1beta1-rev2-1.0.1
-------------------
 - GQL support.
 - Metadata query support.
 - Command line tool improvements.
@@ -71,6 +136,6 @@ v1beta1-rev2-1.0.1
 - Ruby samples.
 - Java helper for query splitting.
 
-v1beta1-rev1-1.0.0
-------------------
+### v1beta1-rev1-1.0.0
+
 - Initial release.