require 'addressable/uri'
-
-require 'google/inflection'
+require 'multi_json'
+require 'active_support/inflector'
require 'google/api_client/discovery/resource'
require 'google/api_client/discovery/method'
require 'google/api_client/discovery/media'
##
# Creates a description of a particular version of a service.
#
- # @param [String] api
- # The identifier for the service. Note that while this frequently
- # matches the first segment of all of the service's RPC names, this
- # should not be assumed. There is no requirement that these match.
- # @param [String] version
- # The identifier for the service version.
- # @param [Hash] api_description
+ # @param [String] document_base
+ # Base URI for the service
+ # @param [Hash] discovery_document
# The section of the discovery document that applies to this service
# version.
#
def initialize(document_base, discovery_document)
@document_base = Addressable::URI.parse(document_base)
@discovery_document = discovery_document
- metaclass = (class <<self; self; end)
+ metaclass = (class << self; self; end)
self.discovered_resources.each do |resource|
- method_name = Google::INFLECTOR.underscore(resource.name).to_sym
+ method_name = ActiveSupport::Inflector.underscore(resource.name).to_sym
if !self.respond_to?(method_name)
metaclass.send(:define_method, method_name) { resource }
end
end
self.discovered_methods.each do |method|
- method_name = Google::INFLECTOR.underscore(method.name).to_sym
+ method_name = ActiveSupport::Inflector.underscore(method.name).to_sym
if !self.respond_to?(method_name)
metaclass.send(:define_method, method_name) { method }
end
end
end
+
+ # @return [String] unparsed discovery document for the API
+ attr_reader :discovery_document
##
# Returns the id of the service.
##
# Updates the hierarchy of resources and methods with the new base.
#
- # @param [Addressable::URI, #to_str, String] new_base
+ # @param [Addressable::URI, #to_str, String] new_method_base
# The new base URI to use for the service.
def method_base=(new_method_base)
@method_base = Addressable::URI.parse(new_method_base)
end
end
+ ##
+ # Returns the base URI for batch calls to this service.
+ #
+ # @return [Addressable::URI] The base URI that methods are joined to.
+ def batch_path
+ if @discovery_document['batchPath']
+ return @batch_path ||= (
+ self.document_base.join(Addressable::URI.parse('/' +
+ @discovery_document['batchPath']))
+ ).normalize
+ else
+ return nil
+ end
+ end
+
##
# A list of schemas available for this version of the API.
#
"#<%s:%#0x ID:%s>", self.class.to_s, self.object_id, self.id
)
end
+
+ ##
+ # Marshalling support - serialize the API to a string (doc base + original
+ # discovery document).
+ def _dump(level)
+ MultiJson.dump([@document_base.to_s, @discovery_document])
+ end
+
+ ##
+ # Marshalling support - Restore an API instance from serialized form
+ def self._load(obj)
+ new(*MultiJson.load(obj))
+ end
+
end
end
end