google-api-client 0.8.7 → 0.9.pre1

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,79 @@
+# 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)
+
+    RequestOptions = Struct.new(
+      :authorization,
+      :retries,
+      :header,
+      :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] credentials
+      #   @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] 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
+        %w(authorization retries timeout_sec).each do |opt|
+          opt = opt.to_sym
+          new_options[opt] = options[opt] unless options[opt].nil?
+        end
+        new_options
+      end
+    end
+
+    ClientOptions.default.application_name = 'unknown'
+    ClientOptions.default.application_version = '0.0.0'
+
+    RequestOptions.default.retries = 0
+  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.pre1'
+
+    # 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/calendar/calendar.rb

@@ -0,0 +1,43 @@
+# 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 'googleauth'
+require 'google/apis/calendar_v3'
+
+Calendar = Google::Apis::CalendarV3
+
+calendar = Calendar::CalendarService.new
+calendar.authorization = Google::Auth.get_application_default([Calendar::AUTH_CALENDAR])
+
+# Create an event, adding any emails listed in the command line as attendees
+event = Calendar::Event.new(summary: 'A sample event',
+                            location: '1600 Amphitheatre Parkway, Mountain View, CA 94045',
+                            attendees: ARGV.map { |email| Calendar::EventAttendee.new(email: email) },
+                            start: Calendar::EventDateTime.new(date_time: DateTime.parse('2015-12-31T20:00:00')),
+                            end: Calendar::EventDateTime.new(date_time: DateTime.parse('2016-01-01T02:00:00')))
+event = calendar.insert_event('primary', event, send_notifications: true)
+puts "Created event '#{event.summary}' (#{event.id})"
+
+# List upcoming events
+events = calendar.list_events('primary', max_results: 10, single_events: true,
+                              order_by: 'startTime', time_min: Time.now.iso8601)
+puts "Upcoming events:"
+events.items.each do |evt|
+  start = event.start.date || event.start.date_time
+  puts "- #{event.summary} (#{start}) (ID: #{event.id})"
+end
+
+# Delete the event we created earlier
+calendar.delete_event('primary', event.id, send_notifications: true)
+puts "Event deleted"

data/samples/drive/drive.rb

@@ -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 'tempfile'
+require 'googleauth'
+require 'google/apis/drive_v2'
+
+Drive = Google::Apis::DriveV2
+
+drive = Drive::DriveService.new
+drive.authorization = Google::Auth.get_application_default([Drive::AUTH_DRIVE])
+
+# Insert a file
+file = drive.insert_file({title: 'drive.rb'}, upload_source: 'drive.rb')
+puts "Created file #{file.title} (#{file.id})"
+
+# Search for it
+files = drive.list_files(q: "title = 'drive.rb'")
+puts "Search results:"
+files.items.each do |file|
+  puts "- File: #{file.title} (#{file.id})"
+end
+
+# Read it back
+tmp = drive.get_file(file.id, download_dest: Tempfile.new('drive'))
+
+# Delete it
+drive.delete_file(file.id)
+puts "File deleted"