gcloud 0.12.2 → 0.20.0

data/lib/gcloud/dns/change.rb

@@ -1,158 +0,0 @@
-# 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 "gcloud/dns/change/list"
-require "time"
-
-module Gcloud
-  module Dns
-    ##
-    # # DNS Change
-    #
-    # Represents a request containing additions or deletions or records.
-    # Additions and deletions can be done in bulk, in a single atomic
-    # transaction, and take effect at the same time in each authoritative DNS
-    # server.
-    #
-    # @example
-    #   require "gcloud"
-    #
-    #   gcloud = Gcloud.new
-    #   dns = gcloud.dns
-    #   zone = dns.zone "example-com"
-    #   zone.changes.each do |change|
-    #     puts "Change includes #{change.additions.count} additions " \
-    #          "and #{change.additions.count} deletions."
-    #   end
-    #
-    class Change
-      ##
-      # @private The Zone object this Change belongs to.
-      attr_accessor :zone
-
-      ##
-      # @private The Google API Client object.
-      attr_accessor :gapi
-
-      ##
-      # @private Create an empty Change object.
-      def initialize
-        @zone = nil
-        @gapi = {}
-      end
-
-      ##
-      # Unique identifier for the resource; defined by the server.
-      #
-      def id
-        @gapi.id
-      end
-
-      ##
-      # The records added in this change request.
-      #
-      def additions
-        Array(@gapi.additions).map { |gapi| Record.from_gapi gapi }
-      end
-
-      ##
-      # The records removed in this change request.
-      #
-      def deletions
-        Array(@gapi.deletions).map { |gapi| Record.from_gapi gapi }
-      end
-
-      ##
-      # Status of the operation. Values are `"done"` and `"pending"`.
-      #
-      def status
-        @gapi.status
-      end
-
-      ##
-      # Checks if the status is `"done"`.
-      def done?
-        return false if status.nil?
-        "done".casecmp(status).zero?
-      end
-
-      ##
-      # Checks if the status is `"pending"`.
-      def pending?
-        return false if status.nil?
-        "pending".casecmp(status).zero?
-      end
-
-      ##
-      # The time that this operation was started by the server.
-      #
-      def started_at
-        Time.parse @gapi.start_time
-      rescue
-        nil
-      end
-
-      ##
-      # Reloads the change with updated status from the DNS service.
-      def reload!
-        ensure_service!
-        @gapi = zone.service.get_change @zone.id, id
-      end
-      alias_method :refresh!, :reload!
-
-      ##
-      # Refreshes the change until the status is `done`.
-      # The delay between refreshes will incrementally increase.
-      #
-      # @example
-      #   require "gcloud"
-      #
-      #   gcloud = Gcloud.new
-      #   dns = gcloud.dns
-      #   zone = dns.zone "example-com"
-      #   change = zone.change 1234567890
-      #   change.done? #=> false
-      #   change.wait_until_done!
-      #   change.done? #=> true
-      #
-      def wait_until_done!
-        backoff = ->(retries) { sleep 2 * retries + 5 }
-        retries = 0
-        until done?
-          backoff.call retries
-          retries += 1
-          reload!
-        end
-      end
-
-      ##
-      # @private New Change from a Google API Client object.
-      def self.from_gapi gapi, zone
-        new.tap do |f|
-          f.gapi = gapi
-          f.zone = zone
-        end
-      end
-
-      protected
-
-      ##
-      # Raise an error unless an active service is available.
-      def ensure_service!
-        fail "Must have active connection" unless zone && zone.service
-      end
-    end
-  end
-end

data/lib/gcloud/dns/change/list.rb

@@ -1,173 +0,0 @@
-# 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 "delegate"
-
-module Gcloud
-  module Dns
-    class Change
-      ##
-      # Change::List is a special case Array with additional values.
-      class List < DelegateClass(::Array)
-        ##
-        # If not empty, indicates that there are more changes that match
-        # the request and this value should be passed to continue.
-        attr_accessor :token
-
-        ##
-        # @private Create a new Change::List with an array of Change instances.
-        def initialize arr = []
-          super arr
-        end
-
-        ##
-        # Whether there a next page of changes.
-        #
-        # @return [Boolean]
-        #
-        # @example
-        #   require "gcloud"
-        #
-        #   gcloud = Gcloud.new
-        #   dns = gcloud.dns
-        #   zone = dns.zone "example-com"
-        #
-        #   changes = zone.changes
-        #   if changes.next?
-        #     next_changes = changes.next
-        #   end
-        #
-        def next?
-          !token.nil?
-        end
-
-        ##
-        # Retrieve the next page of changes.
-        #
-        # @return [Change::List]
-        #
-        # @example
-        #   require "gcloud"
-        #
-        #   gcloud = Gcloud.new
-        #   dns = gcloud.dns
-        #   zone = dns.zone "example-com"
-        #
-        #   changes = zone.changes
-        #   if changes.next?
-        #     next_changes = changes.next
-        #   end
-        #
-        def next
-          return nil unless next?
-          ensure_zone!
-          @zone.changes token: token, max: @max, order: @order
-        end
-
-        ##
-        # Retrieves all changes by repeatedly loading {#next} until {#next?}
-        # returns `false`. Calls the given block once for each change, which is
-        # passed as the parameter.
-        #
-        # An Enumerator is returned if no block is given.
-        #
-        # This method may make several API calls until all changes are
-        # retrieved. Be sure to use as narrow a search criteria as possible.
-        # Please use with caution.
-        #
-        # @param [Integer] request_limit The upper limit of API requests to make
-        #   to load all changes. Default is no limit.
-        # @yield [change] The block for accessing each change.
-        # @yieldparam [Change] change The change object.
-        #
-        # @return [Enumerator]
-        #
-        # @example Iterating each change by passing a block:
-        #   require "gcloud"
-        #
-        #   gcloud = Gcloud.new
-        #   dns = gcloud.dns
-        #   zone = dns.zone "example-com"
-        #   changes = zone.changes
-        #
-        #   changes.all do |change|
-        #     puts change.name
-        #   end
-        #
-        # @example Using the enumerator by not passing a block:
-        #   require "gcloud"
-        #
-        #   gcloud = Gcloud.new
-        #   dns = gcloud.dns
-        #   zone = dns.zone "example-com"
-        #   changes = zone.changes
-        #
-        #   all_names = changes.all.map do |change|
-        #     change.name
-        #   end
-        #
-        # @example Limit the number of API calls made:
-        #   require "gcloud"
-        #
-        #   gcloud = Gcloud.new
-        #   dns = gcloud.dns
-        #   zone = dns.zone "example-com"
-        #   changes = zone.changes
-        #
-        #   changes.all(request_limit: 10) do |change|
-        #     puts change.name
-        #   end
-        #
-        def all request_limit: nil
-          request_limit = request_limit.to_i if request_limit
-          unless block_given?
-            return enum_for(:all, request_limit: request_limit)
-          end
-          results = self
-          loop do
-            results.each { |r| yield r }
-            if request_limit
-              request_limit -= 1
-              break if request_limit < 0
-            end
-            break unless results.next?
-            results = results.next
-          end
-        end
-
-        ##
-        # @private New Changes::List from a response object.
-        def self.from_gapi gapi, zone, max = nil, order = nil
-          changes = new(Array(gapi.changes).map do |g|
-            Change.from_gapi g, zone
-          end)
-          changes.instance_variable_set "@token", gapi.next_page_token
-          changes.instance_variable_set "@zone",  zone
-          changes.instance_variable_set "@max",   max
-          changes.instance_variable_set "@order", order
-          changes
-        end
-
-        protected
-
-        ##
-        # Raise an error unless an active connection is available.
-        def ensure_zone!
-          fail "Must have active connection" unless @zone
-        end
-      end
-    end
-  end
-end

data/lib/gcloud/dns/credentials.rb

@@ -1,29 +0,0 @@
-# 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 "gcloud/credentials"
-
-module Gcloud
-  module Dns
-    ##
-    # @private Represents the Oauth2 signing logic for DNS.
-    class Credentials < Gcloud::Credentials
-      SCOPE = ["https://www.googleapis.com/auth/ndev.clouddns.readwrite"]
-      PATH_ENV_VARS = %w(DNS_KEYFILE GCLOUD_KEYFILE GOOGLE_CLOUD_KEYFILE)
-      JSON_ENV_VARS = %w(DNS_KEYFILE_JSON GCLOUD_KEYFILE_JSON
-                         GOOGLE_CLOUD_KEYFILE_JSON)
-    end
-  end
-end

data/lib/gcloud/dns/importer.rb

@@ -1,183 +0,0 @@
-# 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 "zonefile"
-require "gcloud/dns/record"
-
-module Gcloud
-  module Dns
-    ##
-    # @private
-    # # DNS Importer
-    #
-    # Reads a [DNS zone
-    # file](https://en.wikipedia.org/wiki/Zone_file) and parses it, creating a
-    # collection of Record instances. The returned records are unsaved,
-    # as they are not yet associated with a Zone. Use {Zone#import} to add zone
-    # file records to a Zone.
-    #
-    # Because the Google Cloud DNS API only accepts a single resource record for
-    # each `name` and `type` combination (with multiple `data` elements), the
-    # zone file's records are merged as necessary. During this merge, the lowest
-    # `ttl` of the merged records is used. If none of the merged records have a
-    # `ttl` value, the zone file's global TTL is used for the record.
-    #
-    # The following record types are supported: A, AAAA, CNAME, MX, NAPTR, NS,
-    # PTR, SOA, SPF, SRV, and TXT.
-    class Importer
-      ##
-      # Creates a new Importer that immediately parses the provided zone file
-      # data and creates Record instances.
-      #
-      # @param [String, IO] path_or_io The path to a zone file on the
-      #   filesystem, or an IO instance from which zone file data can be read.
-      #
-      def initialize zone, path_or_io
-        @zone = zone
-        @merged_zf_records = {}
-        @records = []
-        @zonefile = create_zonefile path_or_io
-        merge_zonefile_records
-        from_zonefile_records
-        @records.unshift soa_record
-      end
-
-      ##
-      # Returns the Record instances created from the zone file.
-      #
-      # @param [String, Array<String>] only Include only records of this type or
-      #   types.
-      # @param [String, Array<String>] except Exclude records of this type or
-      #   types.
-      #
-      # @return [Array<Record>] An array of unsaved {Record} instances
-      #
-      def records only: nil, except: nil
-        ret = @records
-        ret = ret.select { |r| Array(only).include? r.type } if only
-        ret = ret.reject { |r| Array(except).include? r.type } if except
-        ret
-      end
-
-      protected
-
-      ##
-      # The zonefile library returns a two-element array in which the first
-      # element is a symbol type (:a, :mx, and so on), and the second element
-      # is an array containing the records of that type. Group the records by
-      # name and type instead.
-      def merge_zonefile_records
-        @zonefile.records.map do |r|
-          type = r.first
-          type = :aaaa if type == :a4
-          r.last.each do |zf_record|
-            name = Service.fqdn(zf_record[:name], @zonefile.origin)
-            key = [name, type]
-            (@merged_zf_records[key] ||= []) << zf_record
-          end
-        end
-      end
-
-      ##
-      # Convert the grouped records to single array of records, merging records
-      # of the same name and type into a single record with an array of rrdatas.
-      def from_zonefile_records
-        @records = @merged_zf_records.map do |key, zf_records|
-          ttl = ttl_from_zonefile_records zf_records
-          data = zf_records.map do |zf_record|
-            data_from_zonefile_record(key[1], zf_record)
-          end
-          @zone.record key[0], key[1], ttl, data
-        end
-      end
-
-      def soa_record
-        zf_soa = @zonefile.soa
-        ttl = ttl_to_i(zf_soa[:ttl]) || ttl_to_i(@zonefile.ttl)
-        data = data_from_zonefile_record :soa, zf_soa
-        @zone.record zf_soa[:origin], "SOA", ttl, data
-      end
-
-      ##
-      # From a collection of records, take the lowest ttl
-      def ttl_from_zonefile_records zf_records
-        ttls = zf_records.map do |zf_record|
-          ttl_to_i(zf_record[:ttl])
-        end
-        min_ttl = ttls.compact.sort.first
-        min_ttl || ttl_to_i(@zonefile.ttl)
-      end
-
-      # rubocop:disable all
-      # Rubocop's line-length and branch condition restrictions prevent
-      # the most straightforward approach to converting zonefile's records
-      # to our own. So disable rubocop for this operation.
-
-      def data_from_zonefile_record type, zf_record
-        case type.to_s.upcase
-        when "A"
-          "#{zf_record[:host]}"
-        when "AAAA"
-          "#{zf_record[:host]}"
-        when "CNAME"
-          "#{zf_record[:host]}"
-        when "MX"
-          "#{zf_record[:pri]} #{zf_record[:host]}"
-        when "NAPTR"
-          "#{zf_record[:order]} #{zf_record[:preference]} #{zf_record[:flags]} #{zf_record[:service]} #{zf_record[:regexp]} #{zf_record[:replacement]}"
-        when "NS"
-          "#{zf_record[:host]}"
-        when "PTR"
-          "#{zf_record[:host]}"
-        when "SOA"
-          "#{zf_record[:primary]} #{zf_record[:email]} #{zf_record[:serial]} #{zf_record[:refresh]} #{zf_record[:retry]} #{zf_record[:expire]} #{zf_record[:minimumTTL]}"
-        when "SPF"
-          "#{zf_record[:data]}"
-        when "SRV"
-          "#{zf_record[:pri]} #{zf_record[:weight]} #{zf_record[:port]} #{zf_record[:host]}"
-        when "TXT"
-          "#{zf_record[:text]}"
-        else
-          fail ArgumentError, "record type '#{type}' is not supported"
-        end
-      end
-
-      # rubocop:enable all
-
-      MULTIPLIER = { "s" => (1),
-                     "m" => (60),
-                     "h" => (60 * 60),
-                     "d" => (60 * 60 * 24),
-                     "w" => (60 * 60 * 24 * 7) } # :nodoc:
-
-      def ttl_to_i ttl
-        if ttl.respond_to?(:to_int) || ttl.to_s =~ /\A\d+\z/
-          return ttl.to_i
-        elsif (m = /\A(\d+)(w|d|h|m|s)\z/.match ttl)
-          return m[1].to_i * MULTIPLIER[m[2]].to_i
-        end
-        nil
-      end
-
-      def create_zonefile path_or_io # :nodoc:
-        if path_or_io.respond_to? :read
-          Zonefile.new path_or_io.read
-        else
-          Zonefile.from_file path_or_io
-        end
-      end
-    end
-  end
-end