gcloud 0.4.1 → 0.5.0

data/lib/gcloud/resource_manager/project/list.rb

@@ -0,0 +1,91 @@
+#--
+# Copyright 2015 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 Gcloud
+  module ResourceManager
+    class Project
+      ##
+      # Project::List is a special case Array with additional values.
+      class List < DelegateClass(::Array)
+        ##
+        # If not empty, indicates that there are more projects that match
+        # the request and this value should be passed to continue.
+        attr_accessor :token
+
+        ##
+        # Create a new Project::List with an array of Project instances.
+        def initialize arr = []
+          super arr
+        end
+
+        ##
+        # Whether there a next page of projects.
+        def next?
+          !token.nil?
+        end
+
+        ##
+        # Retrieve the next page of projects.
+        def next
+          return nil unless next?
+          ensure_manager!
+          @manager.projects token: token
+        end
+
+        ##
+        # Retrieves all projects by repeatedly loading pages until #next?
+        # returns false. Returns the list instance for method chaining.
+        #
+        # === Example
+        #
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   resource_manager = gcloud.resource_manager
+        #   projects = resource_manager.projects.all # Load all projects
+        #
+        def all
+          while next?
+            next_projects = self.next
+            push(*next_projects)
+            self.token = next_projects.token
+          end
+          self
+        end
+
+        ##
+        # New Projects::List from a response object.
+        def self.from_response resp, manager #:nodoc:
+          projects = new(Array(resp.data["projects"]).map do |gapi_object|
+            Project.from_gapi gapi_object, manager.connection
+          end)
+          projects.instance_eval do
+            @token = resp.data["nextPageToken"]
+            @manager = manager
+          end
+          projects
+        end
+
+        protected
+
+        ##
+        # Raise an error unless an active connection is available.
+        def ensure_manager!
+          fail "Must have active connection" unless @manager
+        end
+      end
+    end
+  end
+end

data/lib/gcloud/resource_manager/project/updater.rb

@@ -0,0 +1,137 @@
+#--
+# Copyright 2015 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.
+
+require "time"
+require "gcloud/resource_manager/errors"
+
+module Gcloud
+  module ResourceManager
+    class Project
+      ##
+      # = Project Updater
+      #
+      # This object is used by Project#update when passed a block. These methods
+      # are used to update the project data in a single API call.
+      #
+      #   require "gcloud"
+      #
+      #   gcloud = Gcloud.new
+      #   resource_manager = gcloud.resource_manager
+      #   project = resource_manager.project "tokyo-rain-123"
+      #   project.update do |p|
+      #     p.name = "My Project"
+      #     p.labels["env"] = "production"
+      #   end
+      #
+      class Updater < DelegateClass(Project)
+        ##
+        # Create an Updater object.
+        def initialize project #:nodoc:
+          super project
+        end
+
+        ##
+        # Updates the user-assigned name of the project. This field is optional
+        # and can remain unset.
+        #
+        # Allowed characters are: lowercase and uppercase letters, numbers,
+        # hyphen, single-quote, double-quote, space, and exclamation point.
+        #
+        # === Example
+        #
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   resource_manager = gcloud.resource_manager
+        #   project = resource_manager.project "tokyo-rain-123"
+        #   project.update do |p|
+        #     p.name = "My Project"
+        #   end
+        #
+        def name= new_name
+          gapi["name"] = new_name
+        end
+
+        ##
+        # The labels associated with this project.
+        #
+        # Label keys must be between 1 and 63 characters long and must conform
+        # to the following regular expression:
+        # <code>[a-z]([-a-z0-9]*[a-z0-9])?</code>.
+        #
+        # Label values must be between 0 and 63 characters long and must conform
+        # to the regular expression <code>([a-z]([-a-z0-9]*[a-z0-9])?)?</code>.
+        #
+        # No more than 256 labels can be associated with a given resource.
+        # (+Hash+)
+        #
+        # === Example
+        #
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   resource_manager = gcloud.resource_manager
+        #   project = resource_manager.project "tokyo-rain-123"
+        #   project.update do |p|
+        #     p.labels["env"] = "production"
+        #   end
+        #
+        def labels
+          gapi["labels"]
+        end
+
+        ##
+        # Updates the labels associated with this project.
+        #
+        # Label keys must be between 1 and 63 characters long and must conform
+        # to the following regular expression:
+        # <code>[a-z]([-a-z0-9]*[a-z0-9])?</code>.
+        #
+        # Label values must be between 0 and 63 characters long and must conform
+        # to the regular expression <code>([a-z]([-a-z0-9]*[a-z0-9])?)?</code>.
+        #
+        # No more than 256 labels can be associated with a given resource.
+        # (+Hash+)
+        #
+        # === Example
+        #
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   resource_manager = gcloud.resource_manager
+        #   project = resource_manager.project "tokyo-rain-123"
+        #   project.update do |p|
+        #     p.labels = { "env" => "production" }
+        #   end
+        #
+        def labels= new_labels
+          gapi["labels"] = new_labels
+        end
+
+        ##
+        # Create an Updater object.
+        def self.from_project project #:nodoc:
+          dupe_gapi = project.gapi.dup
+          dupe_gapi = dupe_gapi.to_hash if dupe_gapi.respond_to? :to_hash
+          if dupe_gapi["labels"].respond_to? :to_hash
+            dupe_gapi["labels"] = dupe_gapi["labels"].to_hash
+          end
+          dupe_project = Project.from_gapi dupe_gapi, nil # no way to update
+          Updater.new dupe_project
+        end
+      end
+    end
+  end
+end

data/lib/gcloud/storage/bucket.rb

@@ -374,7 +374,7 @@ module Gcloud
       #
       # === Returns
       #
-      # Array of Gcloud::Storage::File (Gcloud::Storage::File::List)
+      # Array of Gcloud::Storage::File (See Gcloud::Storage::File::List)
       #
       # === Examples
       #

data/lib/gcloud/storage/bucket/cors.rb

@@ -13,6 +13,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+require "delegate"
+
 module Gcloud
   module Storage
     class Bucket

data/lib/gcloud/storage/bucket/list.rb

@@ -13,6 +13,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+require "delegate"
+
 module Gcloud
   module Storage
     class Bucket

data/lib/gcloud/storage/file/list.rb

@@ -13,6 +13,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+require "delegate"
+
 module Gcloud
   module Storage
     class File

data/lib/gcloud/storage/project.rb

@@ -103,7 +103,7 @@ module Gcloud
       #
       # === Returns
       #
-      # Array of Gcloud::Storage::Bucket (Gcloud::Storage::Bucket::List)
+      # Array of Gcloud::Storage::Bucket (See Gcloud::Storage::Bucket::List)
       #
       # === Examples
       #

data/lib/gcloud/version.rb

@@ -16,5 +16,5 @@
 #--
 # Google Cloud Version
 module Gcloud
-  VERSION = "0.4.1"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gcloud
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Silvano Luciani
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-20 00:00:00.000000000 Z
+date: 2015-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: beefcake
@@ -299,6 +299,14 @@ files:
 - lib/gcloud/pubsub/subscription/list.rb
 - lib/gcloud/pubsub/topic.rb
 - lib/gcloud/pubsub/topic/list.rb
+- lib/gcloud/resource_manager.rb
+- lib/gcloud/resource_manager/connection.rb
+- lib/gcloud/resource_manager/credentials.rb
+- lib/gcloud/resource_manager/errors.rb
+- lib/gcloud/resource_manager/manager.rb
+- lib/gcloud/resource_manager/project.rb
+- lib/gcloud/resource_manager/project/list.rb
+- lib/gcloud/resource_manager/project/updater.rb
 - lib/gcloud/storage.rb
 - lib/gcloud/storage/bucket.rb
 - lib/gcloud/storage/bucket/acl.rb