added get project call https://cloud.google.com/compute/docs/reference/v1/projects

Author: Ashley

packages/compute/src/index.js

@@ -50,6 +50,12 @@ var Network = require('./network.js');
  */
 var Operation = require('./operation.js');
 
+/**
+ * @type {module: compute/project}
+ * @private
+ */
+var Project = require('./project.js');
+
 /**
  * @type {module:compute/region}
  * @private
@@ -1734,6 +1740,84 @@ Compute.prototype.getOperations = function(options, callback) {
 Compute.prototype.getOperationsStream =
   common.paginator.streamify('getOperations');
 
+  /**
+   * Return the regions available to your project.
+   *
+   * @resource [Project Overview]{@link https://cloud.google.com/compute/docs/projects}
+   *
+   * @param {function} callback - The callback function.
+   * @param {?error} callback.err - An error returned while making this request.
+   * @param {module:compute/project} callback.project - Project objects with
+   *     details
+   * @param {object} callback.apiResponse - The full API response.
+   *
+   * @example
+   * gce.getProject(function(err, project) {
+   *   // `project` is an object with metadata
+   * });
+   *
+   *
+   *
+   * //-
+   * // If the callback is omitted, we'll return a Promise.
+   * //-
+   * gce.getProject().then(function(data) {
+   *   var project = data[0];
+   * });
+   */
+   Compute.prototype.getProject = function(options, callback) {
+     var self = this;
+
+     if (is.fn(options)) {
+       callback = options;
+       options = {};
+     }
+
+     this.request({
+       uri: '',
+       qs: options
+     }, function(err, resp) {
+
+       if (err) {
+         callback(err, null, null, resp);
+         return;
+       }
+
+       var project = new Project(self);
+       project.metadata = resp;
+
+       callback(null, project, null, resp);
+     });
+   };
+
+   /**
+    * Get a list of global {module:compute/project} objects as a readable object
+    * stream.
+    *
+    * @return {stream}
+    *
+    * @example
+    * gce.getProjectStream()
+    *   .on('error', console.error)
+    *   .on('data', function(operation) {
+    *     // `operation` is a `Operation` object.
+    *   })
+    *   .on('end', function() {
+    *     // All operations retrieved.
+    *   });
+    *
+    * //-
+    * // If you anticipate many results, you can end a stream early to prevent
+    * // unnecessary processing and API requests.
+    * //-
+    * gce.getProjectStream()
+    *   .on('data', function(operation) {
+    *     this.end();
+    *   });
+    */
+   Compute.prototype.getProjectStream =
+     common.paginator.streamify('getProject');
+
 /**
  * Return the regions available to your project.
  *
@@ -2632,6 +2716,21 @@ Compute.prototype.operation = function(name) {
   return new Operation(this, name);
 };
 
+/**
+ * Get a reference to your Google Compute Engine project.
+ *
+ * @resource [Projects Overview]{@link https://cloud.google.com/compute/docs/reference/v1/projects}
+ *
+ * @param {string} name - Name of the existing operation.
+ * @return {module:compute/project}
+ *
+ * @example
+ * var project = gce.project();
+ */
+Compute.prototype.project = function() {
+  return new Project(this);
+};
+
 /**
  * Get a reference to a Google Compute Engine region.
  *
@@ -2771,6 +2870,7 @@ common.util.promisifyAll(Compute, {
     'machineType',
     'network',
     'operation',
+    'project',
     'region',
     'rule',
     'service',
@@ -2785,6 +2885,7 @@ Compute.Firewall = Firewall;
 Compute.HealthCheck = HealthCheck;
 Compute.Network = Network;
 Compute.Operation = Operation;
+Compute.Project = Project;
 Compute.Region = Region;
 Compute.Rule = Rule;
 Compute.Service = Service;

packages/compute/src/project.js

@@ -0,0 +1,71 @@
+/*!
+ * Copyright 2016 Google Inc. All Rights Reserved.
+ *
+ * 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.
+ */
+
+/*!
+ * @module compute/project
+ */
+
+'use strict';
+
+var common = require('@google-cloud/common');
+var util = require('util');
+
+/*! Developer Documentation
+ *
+ * @param {module:compute} compute - Compute object this project belongs to.
+ */
+/**
+ * A Projects object allows you to interact with your Google Compute Engine
+ * project.
+ *
+ * @resource [Projects Overview]{@link https://cloud.google.com/compute/docs/projects}
+ * @resource [Projects Resource]{@link https://cloud.google.com/compute/docs/reference/v1/projects}
+ *
+ * @constructor
+ * @alias module:compute/project
+ *
+ * @example
+ * var gcloud = require('google-cloud')({
+ *   keyFilename: '/path/to/keyfile.json',
+ *   projectId: 'grape-spaceship-123'
+ * });
+ *
+ * var gce = gcloud.compute();
+ *
+ * var project = gce.project();
+ *
+ */
+function Project(compute) {
+    common.ServiceObject.call(this, {
+      parent: compute,
+      baseUrl: '/',
+      id: compute.projectId
+    });
+
+
+    this.name = compute.projectId;
+}
+
+util.inherits(Project, common.ServiceObject);
+
+/*! Developer Documentation
+ *
+ * All async methods (except for streams) will return a Promise in the event
+ * that a callback is omitted.
+ */
+common.util.promisifyAll(Project);
+
+module.exports = Project;

packages/compute/system-test/compute.js

@@ -739,6 +739,30 @@ describe('Compute', function() {
     });
   });
 
+  describe('project', function() {
+    it('should get the project', function(done) {
+      compute.getProject(function(err, project) {
+        assert.ifError(err);
+        assert(project.metadata);
+        done();
+      });
+    });
+
+    it('should get a list of machine types in stream mode', function(done) {
+      var resultsMatched = 0;
+
+      compute.getProjectStream()
+        .on('error', done)
+        .on('data', function() {
+          resultsMatched++;
+        })
+        .on('end', function() {
+          assert(resultsMatched > 0);
+          done();
+        });
+    });
+  });
+
   describe('regions', function() {
     it('should get a list of regions', function(done) {
       compute.getRegions(function(err, regions) {

packages/compute/test/index.js

@@ -46,6 +46,7 @@ var fakeUtil = extend({}, util, {
       'machineType',
       'network',
       'operation',
+      'project',
       'region',
       'rule',
       'service',
@@ -106,6 +107,10 @@ function FakeOperation() {
   this.calledWith_ = slice.call(arguments);
 }
 
+function FakeProject() {
+  this.calledWith_ = slice.call(arguments);
+}
+
 function FakeRegion() {
   this.calledWith_ = slice.call(arguments);
   this.address = function() { return {}; };
@@ -155,6 +160,7 @@ describe('Compute', function() {
       './health-check.js': FakeHealthCheck,
       './network.js': FakeNetwork,
       './operation.js': FakeOperation,
+      './project.js': FakeProject,
       './region.js': FakeRegion,
       './rule.js': FakeRule,
       './service.js': FakeServiceClass,

packages/compute/test/project.js

@@ -0,0 +1,84 @@
+/**
+ * Copyright 2016 Google Inc. All Rights Reserved.
+ *
+ * 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';
+
+var assert = require('assert');
+var extend = require('extend');
+var nodeutil = require('util');
+var proxyquire = require('proxyquire');
+var ServiceObject = require('@google-cloud/common').ServiceObject;
+var util = require('@google-cloud/common').util;
+
+var promisified = false;
+var fakeUtil = extend({}, util, {
+  promisifyAll: function(Class) {
+    if (Class.name === 'Project') {
+      promisified = true;
+    }
+  }
+});
+
+function FakeServiceObject() {
+  this.calledWith_ = arguments;
+  ServiceObject.apply(this, arguments);
+}
+
+nodeutil.inherits(FakeServiceObject, ServiceObject);
+
+describe('Project', function() {
+  var Project;
+  var project;
+
+  var PROJECT_ID = 'project-1';
+  var COMPUTE = {
+    projectId: PROJECT_ID,
+    authConfig: { a: 'b', c: 'd' }
+  };
+
+  before(function() {
+    Project = proxyquire('../src/project.js', {
+      '@google-cloud/common': {
+        ServiceObject: FakeServiceObject,
+        util: fakeUtil
+      }
+    });
+  });
+
+  beforeEach(function() {
+    project = new Project(COMPUTE);
+  });
+
+  describe('instantiation', function() {
+    it('should promisify all the things', function() {
+      assert(promisified);
+    });
+
+    it('should localize the name', function() {
+      assert.strictEqual(project.name, PROJECT_ID);
+    });
+
+    it('should inherit from ServiceObject', function() {
+      assert(project instanceof ServiceObject);
+
+      var calledWith = project.calledWith_[0];
+
+      assert.strictEqual(calledWith.parent, COMPUTE);
+      assert.strictEqual(calledWith.baseUrl, '/');
+      assert.strictEqual(calledWith.id, PROJECT_ID);
+    });
+  });
+});