google-api-client 0.8.6 → 0.9

data/lib/google/apis/generator/templates/_representation.tmpl

@@ -0,0 +1,51 @@
+<% if cls.type == 'object' -%>
+
+class <%= cls.generated_class_name %>
+  # @private
+  class Representation < Google::Apis::Core::JsonRepresentation
+<%   if api.features && api.features.include?('dataWrapper') -%>
+    self.representation_wrap = lambda { |args| :data if args[:unwrap] == <%= cls.generated_type %> }
+<%   end -%>
+<%   if cls.variant -%>
+    def from_hash(hash, *args)
+      case hash['<%= cls.variant.discriminant %>']
+<%     for v in cls.variant.map -%>
+<%   ref = api.schemas[v._ref] %>
+      when '<%= v.type_value %>'
+        <%= ref.generated_type %>::Representation.new(<%= ref.generated_type %>.new).from_hash(hash, *args)
+<%     end -%>
+      end
+    end
+
+    def to_hash(*args)
+      case represented
+<%     for v in cls.variant.map -%>
+<%   ref = api.schemas[v._ref] %>
+      when <%= ref.generated_type %>
+        <%= ref.generated_type %>::Representation.new(represented).to_hash(*args)
+<%     end -%>
+      end
+    end
+<%   else -%>
+<%     for property in cls.properties.values -%>
+<%       if property.type == 'hash' -%>
+    hash :<%= property.generated_name %>, as: '<%= property.name %>'<%= include('representation_type', :lead => ', ', :type => property.additional_properties, :api => api) %>
+<%       elsif property.type == 'array' -%>
+    collection :<%= property.generated_name %>, as: '<%= property.name %>'<%= include('representation_type', :lead => ', ', :type => property.items, :api => api) %>
+<%       else -%>
+    property :<%= property.generated_name %>,<% if property.format == 'byte' %> :base64 => true,<%end%> as: '<%= property.name %>'<%= include('representation_type', :lead => ', ', :type => property, :api => api) %>
+<%       end -%>
+<%     end -%>
+<%   end -%>
+  end
+<%   for child_class in cls.properties.values -%>
+<%     if child_class._ref.nil? -%>
+<%= indent(include('representation', :cls => child_class, :api => api), 2) -%>
+<%     end -%>
+<%   end -%>
+end
+<% elsif cls.items && cls.items._ref.nil? -%>
+<%= include('representation', :cls => cls.items, :api => api) -%>
+<% elsif cls.additional_properties && cls.additional_properties._ref.nil? -%>
+<%= include('representation', :cls => cls.additional_properties, :api => api) -%>
+<% end -%>

data/lib/google/apis/generator/templates/_representation_stub.tmpl

@@ -0,0 +1,15 @@
+<% if cls.type == 'object' -%>
+
+class <%= cls.generated_class_name %>
+  class Representation < Google::Apis::Core::JsonRepresentation; end
+<%   for child_class in cls.properties.values -%>
+<%     if child_class._ref.nil? -%>
+<%= indent(include('representation_stub', :cls => child_class), 2) -%>
+<%     end -%>
+<%   end -%>
+end
+<% elsif cls.items && cls.items._ref.nil? -%>
+<%= include('representation_stub', :cls => cls.items, :api => api) -%>
+<% elsif cls.additional_properties && cls.additional_properties._ref.nil? -%>
+<%= include('representation_stub', :cls => cls.additional_properties, :api => api) -%>
+<% end -%>

data/lib/google/apis/generator/templates/_representation_type.tmpl

@@ -0,0 +1,10 @@
+<% if type.type == 'array' -%>
+<%= lead %>:class => Array do
+  include Representable::JSON::Collection
+  items<%= include('representation_type', :lead => ' ' , :type => type.items, :api => api) %>
+end
+<% elsif ['date', 'date-time'].include?(type.format) -%>
+<%= lead %>type: <%= type.generated_type %>
+<% elsif type.type == 'object' -%>
+<%= lead %>class: <%= type.generated_type %>, decorator: <%= type.generated_type %>::Representation
+<% end -%>

data/lib/google/{api_client/reference.rb → apis/generator/templates/classes.rb.tmpl}

@@ -1,4 +1,4 @@
-# Copyright 2010 Google Inc.
+# Copyright 2015 Google Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -12,16 +12,18 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'google/api_client/request'
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
 
 module Google
-  class APIClient
-    ##
-    # Subclass of Request for backwards compatibility with pre-0.5.0 versions of the library
-    # 
-    # @deprecated
-    #   use {Google::APIClient::Request} instead
-    class Reference < Request
+  module Apis
+    module <%= api.module_name %>
+<% for cls in api.schemas.values.partition(&:variant).flatten -%>
+<%= indent(include('class', :cls => cls, :api => api), 6) -%>
+<% end -%>
     end
   end
 end

data/lib/google/apis/generator/templates/module.rb.tmpl

@@ -0,0 +1,40 @@
+# Copyright 2015 Google Inc.
+#
+# 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 '<%= to_path(api.qualified_name) %>/service.rb'
+require '<%= to_path(api.qualified_name) %>/classes.rb'
+require '<%= to_path(api.qualified_name) %>/representations.rb'
+
+module Google
+  module Apis
+    # <%= api.title %>
+    #
+    # <%= block_comment(api.description, 4, 1) %>
+    #
+<% if api.documentation_link -%>
+    # @see <%= api.documentation_link %>
+<% end -%>
+    module <%= api.module_name %>
+      VERSION = '<%= api.version %>'
+      REVISION = '<%= api.revision %>'
+<% if api.auth && api.auth.oauth2 -%>
+<%   for scope_string, scope in api.auth.oauth2.scopes -%>
+
+      # <%= scope.description %>
+      <%= scope.constant %> = '<%= scope_string %>'
+<%   end -%>
+<% end -%>
+    end
+  end
+end

data/lib/google/apis/generator/templates/representations.rb.tmpl

@@ -0,0 +1,32 @@
+# Copyright 2015 Google Inc.
+#
+# 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 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module <%= api.module_name %>
+<% for cls in api.schemas.values.partition(&:variant).flatten -%>
+<%= indent(include('representation_stub', :cls => cls), 6) -%>
+<% end -%>
+<% for cls in api.schemas.values.partition(&:variant).flatten -%>
+<%= indent(include('representation', :cls => cls, :api => api), 6) -%>
+<% end -%>
+    end
+  end
+end

data/lib/google/apis/generator/templates/service.rb.tmpl

@@ -0,0 +1,60 @@
+# Copyright 2015 Google Inc.
+#
+# 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 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module <%= api.module_name  %>
+      # <%= api.title %>
+      #
+      # <%= block_comment(api.description, 6, 2) %>
+      #
+      # @example
+      #    require '<%= to_path(api.qualified_name) %>'
+      #
+      #    <%= api.name %> = <%= api.qualified_name %> # Alias the module
+      #    service = <%= api.name %>::<%= api.service_name %>.new
+      #
+<% if api.documentation_link -%>
+      # @see <%= api.documentation_link %>
+<% end -%>
+      class <%= api.service_name %> < Google::Apis::Core::BaseService
+<% for param in api.parameters.values.reject {|p| p.name == 'fields'} -%>
+        # @return [<%= param.generated_type %>]
+        #  <%= block_comment(param.description, 8, 2) %>
+        attr_accessor :<%= param.generated_name %>
+
+<% end -%>
+        def initialize
+          super('<%= api.root_url %>', '<%= api.service_path %>')
+        end
+<% for api_method in api.all_methods -%>
+<%= indent(include('method', :api_method => api_method, :api => api), 8) -%>
+<% end -%>
+
+        protected
+
+        def apply_command_defaults(command)
+<% for param in api.parameters.values.reject {|p| p.name == 'fields'} -%>
+          command.query['<%= param.name %>'] = <%= param.generated_name %> unless <%= param.generated_name %>.nil?
+<% end -%>
+        end
+      end
+    end
+  end
+end

data/lib/google/apis/options.rb

@@ -0,0 +1,85 @@
+# Copyright 2015 Google Inc.
+#
+# 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 Google
+  module Apis
+    # General options for API requests
+    ClientOptions =  Struct.new(
+      :application_name,
+      :application_version,
+      :proxy_url,
+      :use_net_http)
+
+    RequestOptions = Struct.new(
+      :authorization,
+      :retries,
+      :header,
+      :timeout_sec,
+      :open_timeout_sec)
+
+    # General client options
+    class ClientOptions
+      # @!attribute [rw] application_name
+      #   @return [String] Name of the application, for identification in the User-Agent header
+      # @!attribute [rw] application_version
+      #   @return [String] Version of the application, for identification in the User-Agent header
+      # @!attribute [rw] proxy_url
+      #   @return [String] URL of a proxy server
+
+      # Get the default options
+      # @return [Google::Apis::ClientOptions]
+      def self.default
+        @options ||= ClientOptions.new
+      end
+    end
+
+    # Request options
+    class RequestOptions
+      # @!attribute [rw] authorization
+      #   @return [Signet::OAuth2::Client, #apply(Hash)] OAuth2 credentials
+      # @!attribute [rw] retries
+      #   @return [Fixnum] Number of times to retry requests on server error
+      # @!attribute [rw] timeout_sec
+      #   @return [Fixnum] How long, in seconds, before requests time out
+      # @!attribute [rw] open_timeout_sec
+      #   @return [Fixnum] How long, in seconds, before failed connections time out
+      # @!attribute [rw] header
+      #   @return [Hash<String,String] Additional HTTP headers to include in requests
+
+      # Get the default options
+      # @return [Google::Apis::RequestOptions]
+      def self.default
+        @options ||= RequestOptions.new
+      end
+
+      def merge(options)
+        return self if options.nil?
+
+        new_options = dup
+        members.each do |opt|
+          opt = opt.to_sym
+          new_options[opt] = options[opt] unless options[opt].nil?
+        end
+        new_options
+      end
+    end
+    
+    ClientOptions.default.use_net_http = false
+    ClientOptions.default.application_name = 'unknown'
+    ClientOptions.default.application_version = '0.0.0'
+
+    RequestOptions.default.retries = 0
+    RequestOptions.default.open_timeout_sec = 20
+  end
+end

data/lib/google/apis/version.rb

@@ -0,0 +1,39 @@
+# Copyright 2015 Google Inc.
+#
+# 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 Google
+  module Apis
+    # Client library version
+    VERSION = '0.9'
+
+    # Current operating system
+    # @private
+    OS_VERSION = begin
+      if RUBY_PLATFORM =~ /mswin|win32|mingw|bccwin|cygwin/
+        `ver`.sub(/\s*\[Version\s*/, '/').sub(']', '').strip
+      elsif RUBY_PLATFORM =~ /darwin/i
+        "Mac OS X/#{`sw_vers -productVersion`}"
+      elsif RUBY_PLATFORM == 'java'
+        require 'java'
+        name = java.lang.System.getProperty('os.name')
+        version = java.lang.System.getProperty('os.version')
+        "#{name}/#{version}"
+      else
+        `uname -sr`.sub(' ', '/')
+      end
+    rescue
+      RUBY_PLATFORM
+    end
+  end
+end

data/rakelib/metrics.rake

@@ -0,0 +1,22 @@
+namespace :metrics do
+  task :lines do
+    lines, codelines, total_lines, total_codelines = 0, 0, 0, 0
+    for file_name in FileList['lib/**/*.rb', 'bin/generate-api']
+      f = File.open(file_name)
+      while line = f.gets
+        lines += 1
+        next if line =~ /^\s*$/
+        next if line =~ /^\s*#/
+        codelines += 1
+      end
+      puts "L: #{sprintf('%4d', lines)}, " +
+               "LOC #{sprintf('%4d', codelines)} | #{file_name}"
+      total_lines     += lines
+      total_codelines += codelines
+
+      lines, codelines = 0, 0
+    end
+
+    puts "Total: Lines #{total_lines}, LOC #{total_codelines}"
+  end
+end

data/rakelib/rubocop.rake

@@ -0,0 +1,10 @@
+require 'rubocop/rake_task'
+
+desc 'Run RuboCop on the lib directory'
+RuboCop::RakeTask.new(:rubocop) do |task|
+  task.patterns = ['lib/**/*.rb']
+  # only show the files with failures
+  task.formatters = ['progress']
+  # don't abort rake on failure
+  task.fail_on_error = false
+end

data/rakelib/spec.rake

@@ -0,0 +1,11 @@
+require 'rake/clean'
+require 'rspec/core/rake_task'
+
+CLOBBER.include('coverage')
+
+namespace :spec do
+  RSpec::Core::RakeTask.new(:all)
+end
+
+desc 'Alias to spec:all'
+task 'spec' => 'spec:all'

data/rakelib/yard.rake

@@ -0,0 +1,11 @@
+begin
+	require 'yard'
+	require 'yard/rake/yardoc_task'
+
+	YARD::Rake::YardocTask.new do |t|
+  	t.files   = ['lib/**/*.rb', 'generated/**/*.rb']
+  	t.options = ['--verbose', '--markup', 'markdown']
+	end
+rescue LoadError
+  puts "YARD not available"
+end

data/samples/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gem 'google-api-client', '~> 0.9.pre4'
+gem 'thor', '~> 0.19'
+gem 'os', '~> 0.9'
+gem 'rmail', '~> 1.1'
+gem 'dotenv'