google-api-client 0.50.0 → 0.53.0

data/lib/google/apis/options.rb

@@ -1,116 +0,0 @@
-# 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,
-      :open_timeout_sec,
-      :read_timeout_sec,
-      :send_timeout_sec,
-      :log_http_requests,
-      :transparent_gzip_decompression)
-
-    RequestOptions = Struct.new(
-      :authorization,
-      :retries,
-      :header,
-      :normalize_unicode,
-      :skip_serialization,
-      :skip_deserialization,
-      :api_format_version,
-      :use_opencensus,
-      :quota_project,
-      :query)
-
-    # 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
-      # @!attribute [rw] log_http_requests
-      #   @return [Boolean] True if raw HTTP requests should be logged
-      # @!attribute [rw] open_timeout_sec
-      #   @return [Fixnum] How long, in seconds, before failed connections time out
-      # @!attribute [rw] read_timeout_sec
-      #   @return [Fixnum] How long, in seconds, before requests time out
-      # @!attribute [rw] transparent_gzip_decompression
-      # @return [Boolean] True if gzip compression needs to be enabled
-      # 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] header
-      #   @return [Hash<String,String>] Additional HTTP headers to include in requests.
-      # @!attribute [rw] normalize_unicode
-      #   @return [Boolean] True if unicode strings should be normalized in path parameters.
-      # @!attribute [rw] skip_serialization
-      #   @return [Boolean] True if body object should be treated as raw text instead of an object.
-      # @!attribute [rw] skip_deserialization
-      #   @return [Boolean] True if response should be returned in raw form instead of deserialized.
-      # @!attribute [rw] api_format_version
-      #   @return [Fixnum] Version of the error format to request/expect.
-      # @!attribute [rw] use_opencensus
-      #   @return [Boolean] Whether OpenCensus spans should be generated for requests. Default is true.
-      # @!attribute [rw] quota_project
-      #   @return [String] Project ID to charge quota, or `nil` to default to the credentials-specified project.
-      # @!attribute [rw] query
-      #   @return [Hash<String,String>] Additional HTTP URL query parameters 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.log_http_requests = false
-    ClientOptions.default.application_name = 'unknown'
-    ClientOptions.default.application_version = '0.0.0'
-    ClientOptions.default.transparent_gzip_decompression = true
-    RequestOptions.default.retries = 0
-    RequestOptions.default.normalize_unicode = false
-    RequestOptions.default.skip_serialization = false
-    RequestOptions.default.skip_deserialization = false
-    RequestOptions.default.api_format_version = nil
-    RequestOptions.default.use_opencensus = true
-    RequestOptions.default.quota_project = nil
-  end
-end

data/lib/google/apis.rb

@@ -1,58 +0,0 @@
-# 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 get the logger if present.
-    # Setting the ENV variable 'GOOGLE_API_USE_RAILS_LOGGER' to false will force the client
-    # to use its own logger.
-    #
-    # @return [Logger]
-    def self.rails_logger
-      if 'true' == ENV.fetch('GOOGLE_API_USE_RAILS_LOGGER', 'true') &&
-          defined?(::Rails) &&
-          ::Rails.respond_to?(:logger) &&
-          !::Rails.logger.nil?
-        ::Rails.logger
-      else
-        nil
-      end
-    end
-  end
-end

data/rakelib/devsite/devsite_builder.rb

@@ -1,126 +0,0 @@
-require "pathname"
-require "tmpdir"
-
-require_relative "repo_metadata.rb"
-
-class DevsiteBuilder
-  def initialize build_tag = nil
-    @build_tag = build_tag || latest_tag
-    @output_dir = "doc"
-  end
-
-  def build tag
-    checkout_tag tag
-    doc_path = tmp_dir + @output_dir
-    FileUtils.remove_dir doc_path if Dir.exist? doc_path
-    markup = "--markup markdown --markup-provider redcarpet"
-
-    Dir.chdir tmp_dir do
-      cmds = ["-o #{@output_dir}", markup]
-      cmd "yard --verbose #{cmds.join ' '}"
-    end
-    metadata.build doc_path
-  end
-
-  def upload
-    Dir.chdir tmp_dir + @output_dir do
-      opts = [
-        "--credentials=#{ENV['KOKORO_KEYSTORE_DIR']}/73713_docuploader_service_account",
-        "--staging-bucket=#{ENV.fetch 'STAGING_BUCKET', 'docs-staging'}",
-        "--metadata-file=./docs.metadata"
-      ]
-      cmd "python3 -m docuploader upload . #{opts.join ' '}"
-    end
-  end
-
-  def publish tag = nil
-    build(tag || @build_tag)
-    upload
-  end
-
-  def publish_if_missing tag = nil
-    tag ||= @build_tag
-    puts tag
-    puts missing? tag
-    publish tag if missing? tag
-  end
-
-  def missing? tag
-    require "httparty"
-
-    url = "https://googleapis.dev/ruby/google-api-client/v#{version tag}/index.html"
-    response = HTTParty.get url
-    response.code != 200
-  rescue StandardError
-    true
-  end
-
-  def cmd line
-    puts line
-    output = `#{line}`
-    puts output
-    output
-  end
-
-  def metadata
-    return @metadata if @metadata
-
-    metadata_json = "#{tmp_dir}/.repo-metadata.json"
-    @metadata = RepoMetadata.from_source metadata_json if File.file? metadata_json
-    @metadata ||= RepoMetadata.from_source "name"              => "google-api-client",
-                                           "distribution-name" => "google-api-client",
-                                           "language"          => "ruby"
-    @metadata["version"] = "v#{version @build_tag}"
-    @metadata
-  end
-
-  def checkout_tag git_tag
-    Dir.chdir tmp_dir do
-      `git checkout tags/#{git_tag} -b v#{version git_tag}`
-    end
-  end
-
-  def version git_tag
-    m = git_tag.match(/(\d+\.\d+\.\d+)/)
-    return m if m.nil?
-    m[0]
-  end
-
-  def versions
-    Dir.chdir tmp_dir do
-      tags.map { |t| version t }.reject(&:nil?).sort_by { |v| Gem::Version.new v }.reverse
-    end
-  end
-
-  def tags
-    Dir.chdir tmp_dir do
-      `git tag`.split "\n"
-    end
-  end
-
-  def latest_version
-    @latest_version ||= versions.first
-  end
-
-  def latest_tag
-    @latest_tag ||= tags.select { |t| t.include? latest_version }.min_by(&:size)
-  end
-
-  def tmp_dir
-    return @tmp_dir if @tmp_dir
-
-    tmp = Dir.tmpdir
-    dir_name = "google-api-ruby-client"
-    @tmp_dir = Pathname.new(tmp) + dir_name
-    FileUtils.remove_dir @tmp_dir if Dir.exist? @tmp_dir
-
-    Dir.chdir tmp do
-      `git clone https://github.com/googleapis/google-api-ruby-client.git`
-    end
-    Dir.chdir @tmp_dir do
-      `git fetch`
-    end
-
-    @tmp_dir
-  end
-end

data/rakelib/devsite/link_checker.rb

@@ -1,64 +0,0 @@
-require "open3"
-
-class LinkChecker
-  def initialize
-    @failed = false
-  end
-
-  def run
-    job_info
-    git_commit = ENV.fetch "KOKORO_GITHUB_COMMIT", "master"
-
-    markdown_files = Dir.glob "**/*.md"
-    broken_markdown_links = check_links(markdown_files,
-                                        "https://github.com/googleapis/google-api-ruby-client/tree/#{git_commit}",
-                                        " --skip '^(?!(\\Wruby.*google|.*google.*\\Wruby|.*cloud\\.google\\.com))'")
-
-    broken_devsite_links = check_links(["google-api-client"],
-                                       "https://googleapis.dev/ruby",
-                                       "/latest/ --recurse --skip https:.*github.*")
-
-    puts_broken_links broken_markdown_links
-    puts_broken_links broken_devsite_links
-  end
-
-  def check_links location_list, base, tail
-    broken_links = Hash.new { |h, k| h[k] = [] }
-    location_list.each do |location|
-      out, err, st = Open3.capture3 "npx linkinator #{base}/#{location}#{tail}"
-      puts out
-      unless st.to_i.zero?
-        @failed = true
-        puts err
-      end
-      checked_links = out.split "\n"
-      checked_links.select! { |link| link =~ /\[\d+\]/ && !link.include?("[200]") }
-      unless checked_links.empty?
-        @failed = true
-        broken_links[location] += checked_links
-      end
-    end
-    broken_links
-  end
-
-  def puts_broken_links link_hash
-    link_hash.each do |location, links|
-      puts "#{location} contains the following broken links:"
-      links.each { |link| puts "  #{link}" }
-      puts ""
-    end
-  end
-
-  def job_info
-    line_length = "Using Ruby - #{RUBY_VERSION}".length + 8
-    puts
-    puts "#" * line_length
-    puts "### Using Ruby - #{RUBY_VERSION} ###"
-    puts "#" * line_length
-    puts
-  end
-
-  def exit_status
-    @failed ? 1 : 0
-  end
-end

data/rakelib/devsite/repo_metadata.rb

@@ -1,56 +0,0 @@
-require "json"
-
-class RepoMetadata
-  attr_accessor :data
-
-  def initialize data
-    @data = data
-    normalize_data!
-  end
-
-  def allowed_fields
-    [
-      "name", "version", "language", "distribution-name",
-      "product-page", "github-repository", "issue-tracker"
-    ]
-  end
-
-  def build output_directory
-    fields = @data.to_a.map { |kv| "--#{kv[0]} #{kv[1]}" }
-    Dir.chdir output_directory do
-      cmd "python3 -m docuploader create-metadata #{fields.join ' '}"
-    end
-  end
-
-  def normalize_data!
-    @data.delete_if { |k, _| !allowed_fields.include?(k) }
-  end
-
-  def [] key
-    data[key]
-  end
-
-  def []= key, value
-    @data[key] = value
-  end
-
-  def cmd line
-    puts line
-    output = `#{line}`
-    puts output
-    output
-  end
-
-  def self.from_source source
-    if source.is_a? RepoMetadata
-      data = source.data
-    elsif source.is_a? Hash
-      data = source
-    elsif File.file? source
-      data = JSON.parse File.read(source)
-    else
-      raise "Source must be a path, hash, or RepoMetadata instance"
-    end
-    RepoMetadata.new data
-  end
-end

data/rakelib/metrics.rake

@@ -1,22 +0,0 @@
-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

@@ -1,10 +0,0 @@
-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

@@ -1,11 +0,0 @@
-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

@@ -1,11 +0,0 @@
-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/cli/.env

@@ -1,4 +0,0 @@
-GOOGLE_API_KEY=AIzaSyC6GvjvPlEzJpTW2bW2t0MPHQTfltTosHk
-GOOGLE_CLIENT_ID=479164972499-i7j6av7bp2s4on5ltb7pj2lb2iu5a8gi.apps.googleusercontent.com
-GOOGLE_CLIENT_SECRET=JBotCTG5biFWGz43jdQSZaa3
-GOOGLE_APPLICATION_CREDENTIALS=~/Downloads/ruby-samples-cred.json

data/samples/cli/Gemfile

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

data/samples/cli/README.md

@@ -1,51 +0,0 @@
-# API Samples
-
-This directory contains a small but growing collection of samples for various
-APIs. Each sample can be run on the command line from the `google-api-samples`
-script.
-
-Contributions of new samples are welcome.
-
-# Setup
-
-Depending on which particular samples you want to run, different
-steps may be required. Some samples, like Pub/Sub, require a service account,
-others like Drive, Calendar, and YouTube require an OAuth Client ID. And in
-some cases like Translate, only an API key is needed.
-
-* Create a project at https://console.developers.google.com
-* Go to the `API Manager` and enable the APIs you'd like to try
-* Go to `Credentials` and create the appropriate type of credential for the sample
-    * For keys, use 'Server key' as the type
-    * For OAuth Client IDs, use 'Other' as the type
-    * For service accounts, use the 'JSON' key type
-
-Additional details on how to enable APIs and create credentials can be
-found in the help guide in the console.
-
-
-## Example Environment Settings
-
-For convenience, application credentials can be read from the shell environment
-or placed in a .env file.
-
-After setup, your .env file might look something like:
-
-```
-GOOGLE_API_KEY=AIzaSyC6GvjvPlEzJpTW2bW2t0MPHXXXXXXXXXX
-GOOGLE_CLIENT_ID=479164972499-i7j6av7bp2s4on5ltb7pjXXXXXXXXXX.apps.googleusercontent.com
-GOOGLE_CLIENT_SECRET=JBotCTG5biFWGzXXXXXXXXXX
-GOOGLE_APPLICATION_CREDENTIALS=~/ruby-samples-cred.json
-```
-
-# Running the samples
-
-To list the available sample modules, run the script:
-```
-google-api-samples
-```
-
-To get help on a specific set of samples, run:
-```
-google-api-samples help <module>
-```

data/samples/cli/google-api-samples

@@ -1,32 +0,0 @@
-#!/usr/bin/env ruby
-
-$:.unshift(File.expand_path("../lib", __FILE__))
-
-require 'thor'
-require 'dotenv'
-
-
-# Small script to allow executing samples from the command line.
-# Each sample is loaded as a subcommand.
-#
-# Example usage:
-#
-#     google-api-samples drive upload myfile.txt
-#
-#
-class App < Thor
-
-  # Load all the samples and register them as subcommands
-  Dir.glob('./lib/samples/*.rb').each do |file|
-    require file
-  end
-
-  Samples.constants.each do |const|
-    desc const.downcase, "#{const} samples"
-    subcommand const.downcase, Samples.const_get(const)
-  end
-
-end
-
-Dotenv.load
-App.start(ARGV)

data/samples/cli/lib/base_cli.rb

@@ -1,95 +0,0 @@
-# Copyright 2016 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 'googleauth/stores/file_token_store'
-require 'fileutils'
-require 'thor'
-require 'os'
-
-# Base command line module for samples. Provides authorization support,
-# either using application default credentials or user authorization
-# depending on the use case.
-class BaseCli < Thor
-  include Thor::Actions
-
-  OOB_URI = 'urn:ietf:wg:oauth:2.0:oob'
-
-  class_option :user, :type => :string
-  class_option :api_key, :type => :string
-
-  no_commands do
-
-    # Returns the path to the client_secrets.json file.
-    def client_secrets_path
-      return ENV['GOOGLE_CLIENT_SECRETS'] if ENV.has_key?('GOOGLE_CLIENT_SECRETS')
-      return well_known_path_for('client_secrets.json')
-    end
-
-    # Returns the path to the token store.
-    def token_store_path
-      return ENV['GOOGLE_CREDENTIAL_STORE'] if ENV.has_key?('GOOGLE_CREDENTIAL_STORE')
-      return well_known_path_for('credentials.yaml')
-    end
-
-    # Builds a path to a file in $HOME/.config/google (or %APPDATA%/google,
-    # on Windows)
-    def well_known_path_for(file)
-      if OS.windows?
-        dir = ENV.fetch('HOME'){ ENV['APPDATA']}
-        File.join(dir, 'google', file)
-      else
-        File.join(ENV['HOME'], '.config', 'google', file)
-      end
-    end
-
-    # Returns application credentials for the given scope.
-    def application_credentials_for(scope)
-      Google::Auth.get_application_default(scope)
-    end
-
-    # Returns user credentials for the given scope. Requests authorization
-    # if requrired.
-    def user_credentials_for(scope)
-      FileUtils.mkdir_p(File.dirname(token_store_path))
-
-      if ENV['GOOGLE_CLIENT_ID']
-        client_id = Google::Auth::ClientId.new(ENV['GOOGLE_CLIENT_ID'], ENV['GOOGLE_CLIENT_SECRET'])
-      else
-        client_id = Google::Auth::ClientId.from_file(client_secrets_path)
-      end
-      token_store = Google::Auth::Stores::FileTokenStore.new(:file => token_store_path)
-      authorizer = Google::Auth::UserAuthorizer.new(client_id, scope, token_store)
-
-      user_id = options[:user] || 'default'
-
-      credentials = authorizer.get_credentials(user_id)
-      if credentials.nil?
-        url = authorizer.get_authorization_url(base_url: OOB_URI)
-        say "Open the following URL in your browser and authorize the application."
-        say url
-        code = ask "Enter the authorization code:"
-        credentials = authorizer.get_and_store_credentials_from_code(
-          user_id: user_id, code: code, base_url: OOB_URI)
-      end
-      credentials
-    end
-
-    # Gets the API key of the client
-    def api_key
-      ENV['GOOGLE_API_KEY'] || options[:api_key]
-    end
-
-  end
-end