google-api-client 0.8.7 → 0.9

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

@@ -0,0 +1,92 @@
+
+# <%= block_comment(api_method.description, 0, 1) %>
+<% for param in api_method.required_parameters -%>
+# @param [<% if param.repeated? %>Array<<%= param.generated_type %>>, <% end %><%= param.generated_type %>] <%= param.generated_name %>
+<%   if param.description -%>
+#   <%=  block_comment(param.description, 0, 3) %>
+<%   end -%>
+<% end -%>
+<% if api_method.request -%>
+# @param [<%= api.schemas[api_method.request._ref].generated_type %>] <%= api.schemas[api_method.request._ref].generated_name %>_object
+<% end -%>
+<% for param in api_method.optional_query_parameters -%>
+# @param [<% if param.repeated? %>Array<<%= param.generated_type %>>, <% end %><%= param.generated_type %>] <%= param.generated_name %>
+<%   if param.description -%>
+#   <%=  block_comment(param.description, 0, 3) %>
+<%   end -%>
+<% end -%>
+<% for param in api.parameters.values.reject {|p| p.name == 'key'} -%>
+# @param [<% if param.repeated? %>Array<<%= param.generated_type %>>, <% end %><%= param.generated_type %>] <%= param.generated_name %>
+<%   if param.description -%>
+#   <%= block_comment(param.description, 0, 3) %>
+<%   end -%>
+<% end -%>
+<% if api_method.supports_media_upload? -%>
+# @param [IO, String] upload_source
+#   IO stream or filename containing content to upload
+# @param [String] content_type
+#   Content type of the uploaded content.
+<% elsif api_method.supports_media_download? -%>
+# @param [IO, String] download_dest
+#   IO stream or filename to receive content download
+<% end -%>
+# @param [Google::Apis::RequestOptions] options
+#   Request-specific options
+#
+# @yield [result, err] Result & error if block supplied
+<% if api_method.response -%>
+# @yieldparam result [<%= api.schemas[api_method.response._ref].generated_type %>] parsed result object
+# @yieldparam err [StandardError] error object if request failed
+#
+# @return [<%= api.schemas[api_method.response._ref].generated_type %>]
+<% else -%>
+# @yieldparam result [NilClass] No result returned for this method
+# @yieldparam err [StandardError] error object if request failed
+#
+# @return [void]
+<% end -%>
+#
+# @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+# @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+# @raise [Google::Apis::AuthorizationError] Authorization is required
+def <%= api_method.generated_name %>(<% for param in api_method.required_parameters %><%= param.generated_name %>, <% end %><% if api_method.request %><%= api.schemas[api_method.request._ref].generated_name %>_object = nil, <% end %><% for param in api_method.optional_query_parameters %><%= param.generated_name %>: nil, <% end %><% for param in api.parameters.values.reject {|p| p.name == 'key'} %><%= param.generated_name %>: nil, <% end %><% if api_method.supports_media_upload? %>upload_source: nil, content_type: nil, <% elsif api_method.supports_media_download? %>download_dest: nil, <%  end  %>options: nil, &block)
+<% if api_method.supports_media_upload? -%>
+  if upload_source.nil?
+    command =  make_simple_command(:<%= api_method.http_method.downcase %>, '<%= api_method.path %>', options)
+  else
+    command = make_upload_command(:<%= api_method.http_method.downcase %>, '<%= api_method.path %>', options)
+    command.upload_source = upload_source
+    command.upload_content_type = content_type
+  end
+<% elsif api_method.supports_media_download? -%>
+  if download_dest.nil?
+    command =  make_simple_command(:<%= api_method.http_method.downcase %>, '<%= api_method.path %>', options)
+  else
+    command = make_download_command(:<%= api_method.http_method.downcase %>, '<%= api_method.path %>', options)
+    command.download_dest = download_dest
+  end
+<% else -%>
+  command =  make_simple_command(:<%= api_method.http_method.downcase %>, '<%= api_method.path %>', options)
+<% end -%>
+<% if api_method.request -%>
+  command.request_representation = <%= api.schemas[api_method.request._ref].generated_type %>::Representation
+  command.request_object = <%= api.schemas[api_method.request._ref].generated_name %>_object
+<% end -%>
+<% if api_method.response -%>
+<%   if api.force_alt_json? -%>
+  command.query['alt'] = 'json'
+<%   end -%>
+  command.response_representation = <%= api.schemas[api_method.response._ref].generated_type %>::Representation
+  command.response_class = <%= api.schemas[api_method.response._ref].generated_type %>
+<% end -%>
+<% for param in api_method.path_parameters -%>
+  command.params['<%= param.name %>'] = <%= param.generated_name %> unless <%= param.generated_name %>.nil?
+<% end -%>
+<% for param in api_method.query_parameters -%>
+  command.query['<%= param.name %>'] = <%= param.generated_name %> unless <%= param.generated_name %>.nil?
+<% end -%>
+<% for param in api.parameters.values.reject {|p| p.name == 'key'} -%>
+  command.query['<%= param.name %>'] = <%= param.generated_name %> unless <%= param.generated_name %>.nil?
+<% end -%>
+  execute_or_queue_command(command, &block)
+end

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/generator.rb

@@ -0,0 +1,70 @@
+# 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/discovery_v1'
+require 'google/apis/generator/annotator'
+require 'google/apis/generator/model'
+require 'google/apis/generator/template'
+require 'active_support/inflector'
+require 'yaml'
+
+module Google
+  module Apis
+    # Generates ruby classes for APIs from discovery documents
+    # @private
+    class Generator
+      Discovery = Google::Apis::DiscoveryV1
+
+      # Load templates
+      def initialize(api_names: nil)
+        @names = Google::Apis::Generator::Names.new(api_names || File.join(Google::Apis::ROOT, 'api_names.yaml'))
+        @module_template = Template.load('module.rb')
+        @service_template = Template.load('service.rb')
+        @classes_template = Template.load('classes.rb')
+        @representations_template = Template.load('representations.rb')
+      end
+
+      # Generates ruby source for an API
+      #
+      # @param [String] json
+      #  API Description, as JSON text
+      # @return [Hash<String,String>]
+      #  Hash of generated files keyed by path
+      def render(json)
+        api = parse_description(json)
+        Annotator.process(api, @names)
+        base_path = ActiveSupport::Inflector.underscore(api.qualified_name)
+        context = {
+          'api' => api
+        }
+        files = {}
+        files[base_path + '.rb'] = @module_template.render(context)
+        files[File.join(base_path, 'service.rb')] = @service_template.render(context)
+        files[File.join(base_path, 'classes.rb')] = @classes_template.render(context)
+        files[File.join(base_path, 'representations.rb')] = @representations_template.render(context)
+        files
+      end
+
+      # Dump mapping of API names
+      # @return [String] Mapping of paths to ruby names in YAML format
+      def dump_api_names
+        @names.dump
+      end
+
+      def parse_description(json)
+        Discovery::RestDescription::Representation.new(Discovery::RestDescription.new).from_json(json)
+      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/lib/google/apis.rb

@@ -0,0 +1,48 @@
+# 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/version'
+require 'logger'
+
+module Google
+  module Apis
+    ROOT = File.expand_path('..', File.dirname(__dir__))
+
+    # @!attribute [rw] logger
+    # @return [Logger] The logger.
+    def self.logger
+      @logger ||= rails_logger || default_logger
+    end
+
+    class << self
+      attr_writer :logger
+    end
+
+    private
+
+    # Create and configure a logger
+    # @return [Logger]
+    def self.default_logger
+      logger = Logger.new($stdout)
+      logger.level = Logger::WARN
+      logger
+    end
+
+    # Check to see if client is being used in a Rails environment and ge the logger if present
+    # @return [Logger]
+    def self.rails_logger
+      ::Rails.logger if defined?(::Rails) && ::Rails.respond_to?(:logger) && ::Rails.logger
+    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'