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);
+    });
+  });
+});