New quickstarts. (#226)

* New quickstarts.

* Address comments.

Author: jmdobry

handwritten/datastore/samples/package.json

@@ -15,5 +15,8 @@
   },
   "devDependencies": {
     "mocha": "^3.0.2"
+  },
+  "engines": {
+    "node": ">=4.3.2"
   }
 }

handwritten/datastore/samples/quickstart.js

@@ -1,15 +1,17 @@
-// Copyright 2016, Google, Inc.
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//    http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+/**
+ * Copyright 2016, Google, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 
 'use strict';
 
@@ -34,8 +36,11 @@ const taskKey = datastoreClient.key([kind, id]);
 
 // Retrieves the entity
 datastoreClient.get(taskKey, (err, entity) => {
-  if (!err) {
-    // The entity was retrieved successfully
+  if (err) {
+    console.error(err);
+    return;
   }
+
+  console.log(`Entity: ${entity.key.id}`);
 });
 // [END datastore_quickstart]

handwritten/datastore/samples/system-test/quickstart.test.js

@@ -1,15 +1,17 @@
-// Copyright 2015-2016, Google, Inc.
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//    http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+/**
+ * Copyright 2016, Google, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 
 'use strict';
 
@@ -47,15 +49,19 @@ describe(`datastore:quickstart`, () => {
         return key;
       },
 
-      get: (_key) => {
+      get: (_key, _callback) => {
         assert.equal(_key, key);
+        assert.equal(typeof _callback, 'function');
 
         datastore.get(_key, (err, entity) => {
+          _callback(err, entity);
           assert.ifError(err);
           assert.notEqual(entity, undefined);
           assert.notEqual(entity.key, undefined);
           assert.equal(entity.key.kind, kind);
           assert.deepEqual(entity.data, { message: message });
+          assert.equal(console.log.calledOnce, true);
+          assert.deepEqual(console.log.firstCall.args, [`Entity: ${entity.key.id}`]);
           done();
         });
       }

handwritten/datastore/samples/test/quickstart.test.js

@@ -1,39 +1,45 @@
-// Copyright 2015-2016, Google, Inc.
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//    http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
+/**
+ * Copyright 2016, Google, Inc.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 
 'use strict';
 
 const proxyquire = require(`proxyquire`).noPreserveCache();
 
 describe(`datastore:quickstart`, () => {
   let datastoreMock, DatastoreMock;
+  const error = new Error(`error`);
+  const mockKey = {};
 
   before(() => {
     datastoreMock = {
-      get: sinon.stub().yields(null, { key: 1234567890 }),
-      key: sinon.stub.returns(`task/1234`)
+      get: sinon.stub().yields(error),
+      key: sinon.stub().returns(mockKey)
     };
     DatastoreMock = sinon.stub().returns(datastoreMock);
   });
 
-  it(`should get a task from Datastore`, () => {
+  it(`should handle error`, () => {
     proxyquire(`../quickstart`, {
       '@google-cloud/datastore': DatastoreMock
     });
 
     assert.equal(DatastoreMock.calledOnce, true);
     assert.deepEqual(DatastoreMock.firstCall.args, [{ projectId: 'YOUR_PROJECT_ID' }]);
     assert.equal(datastoreMock.get.calledOnce, true);
-    assert.deepEqual(datastoreMock.get.firstCall.args.slice(0, -1), [datastoreMock.key(['Task', 1234567890])]);
+    assert.deepEqual(datastoreMock.get.firstCall.args.slice(0, -1), [mockKey]);
+    assert.equal(console.error.calledOnce, true);
+    assert.deepEqual(console.error.firstCall.args, [error]);
   });
 });