#!/usr/bin/env ruby bin_dir = File.expand_path("..", __FILE__) lib_dir = File.expand_path("../lib", bin_dir) $LOAD_PATH.unshift(lib_dir) $LOAD_PATH.uniq! OAUTH_SERVER_PORT = 12736 require 'rubygems' require 'optparse' require 'httpadapter' require 'webrick' require 'google/api_client/version' require 'google/api_client' ARGV.unshift('--help') if ARGV.empty? module Google class APIClient class CLI # Used for oauth login class OAuthVerifierServlet < WEBrick::HTTPServlet::AbstractServlet attr_reader :verifier def do_GET(request, response) $verifier ||= Addressable::URI.unencode_component( request.request_uri.to_s[/\?.*oauth_verifier=([^&$]+)(&|$)/, 1] || request.request_uri.to_s[/\?.*code=([^&$]+)(&|$)/, 1] ) response.status = WEBrick::HTTPStatus::RC_ACCEPTED # This javascript will auto-close the tab after the # verifier is obtained. response.body = <<-HTML You may close this window. HTML # Eww, hack! server = self.instance_variable_get('@server') server.stop if server end end # Initialize with default parameter values def initialize(argv) @options = { :command => 'execute', :rpcname => nil, :verbose => false } @argv = argv.clone if @argv.first =~ /^[a-z0-9][a-z0-9_-]*$/i self.options[:command] = @argv.shift end if @argv.first =~ /^[a-z0-9_-]+\.[a-z0-9_\.-]+$/i self.options[:rpcname] = @argv.shift end end attr_reader :options attr_reader :argv def command return self.options[:command] end def rpcname return self.options[:rpcname] end def parser @parser ||= OptionParser.new do |opts| opts.banner = "Usage: google-api " + "(execute | [command]) [options] [-- ]" opts.separator "\nAvailable options:" opts.on( "--scope ", String, "Set the OAuth scope") do |s| options[:scope] = s end opts.on( "--client-id ", String, "Set the OAuth client id or key") do |k| options[:client_credential_key] = k end opts.on( "--client-secret ", String, "Set the OAuth client secret") do |s| options[:client_credential_secret] = s end opts.on( "--api ", String, "Perform discovery on API") do |s| options[:api] = s end opts.on( "--api-version ", String, "Select api version") do |id| options[:version] = id end opts.on( "--content-type ", String, "Content-Type for request") do |f| # Resolve content type shortcuts case f when 'json' f = 'application/json' when 'xml' f = 'application/xml' when 'atom' f = 'application/atom+xml' when 'rss' f = 'application/rss+xml' end options[:content_type] = f end opts.on( "-u", "--uri ", String, "Sets the URI to perform a request against") do |u| options[:uri] = u end opts.on( "--discovery-uri ", String, "Sets the URI to perform discovery") do |u| options[:discovery_uri] = u end opts.on( "-m", "--method ", String, "Sets the HTTP method to use for the request") do |m| options[:http_method] = m end opts.on( "--requestor-id ", String, "Sets the email address of the requestor") do |e| options[:requestor_id] = e end opts.on("-v", "--verbose", "Run verbosely") do |v| options[:verbose] = v end opts.on("-h", "--help", "Show this message") do puts opts exit end opts.on("--version", "Show version") do puts "google-api-client (#{Google::APIClient::VERSION::STRING})" exit end opts.separator( "\nAvailable commands:\n" + " oauth-1-login Log a user into an API with OAuth 1.0a\n" + " oauth-2-login Log a user into an API with OAuth 2.0 d10\n" + " list List the methods available for an API\n" + " execute Execute a method on the API\n" + " irb Start an interactive client session" ) end end def parse! self.parser.parse!(self.argv) symbol = self.command.gsub(/-/, "_").to_sym if !COMMANDS.include?(symbol) STDERR.puts("Invalid command: #{self.command}") exit(1) end self.send(symbol) end def client require 'signet/oauth_1/client' require 'yaml' require 'irb' config_file = File.expand_path('~/.google-api.yaml') authorization = nil if File.exist?(config_file) config = open(config_file, 'r') { |file| YAML.load(file.read) } else config = {} end if config["mechanism"] authorization = config["mechanism"].to_sym end client = Google::APIClient.new(:authorization => authorization) case authorization when :oauth_1 if client.authorization && !client.authorization.kind_of?(Signet::OAuth1::Client) STDERR.puts( "Unexpected authorization mechanism: " + "#{client.authorization.class}" ) exit(1) end config = open(config_file, 'r') { |file| YAML.load(file.read) } client.authorization.client_credential_key = config["client_credential_key"] client.authorization.client_credential_secret = config["client_credential_secret"] client.authorization.token_credential_key = config["token_credential_key"] client.authorization.token_credential_secret = config["token_credential_secret"] when :oauth_2 if client.authorization && !client.authorization.kind_of?(Signet::OAuth2::Client) STDERR.puts( "Unexpected authorization mechanism: " + "#{client.authorization.class}" ) exit(1) end config = open(config_file, 'r') { |file| YAML.load(file.read) } client.authorization.scope = options[:scope] client.authorization.client_id = config["client_id"] client.authorization.client_secret = config["client_secret"] client.authorization.access_token = config["access_token"] client.authorization.refresh_token = config["refresh_token"] else # Dunno? end if options[:discovery_uri] if options[:api] && options[:version] client.register_discovery_uri( options[:api], options[:version], options[:discovery_uri] ) else STDERR.puts( 'Cannot register a discovery URI without ' + 'specifying an API and version.' ) exit(1) end end return client end def api_version(api_name, version) v = version if !version if client.preferred_version(api_name) v = client.preferred_version(api_name).version else v = 'v1' end end return v end COMMANDS = [ :oauth_1_login, :oauth_2_login, :list, :execute, :irb, :fuzz ] def oauth_1_login require 'signet/oauth_1/client' require 'launchy' require 'yaml' if options[:client_credential_key] && options[:client_credential_secret] config = { "mechanism" => "oauth_1", "scope" => options[:scope], "client_credential_key" => options[:client_credential_key], "client_credential_secret" => options[:client_credential_secret], "token_credential_key" => nil, "token_credential_secret" => nil } config_file = File.expand_path('~/.google-api.yaml') open(config_file, 'w') { |file| file.write(YAML.dump(config)) } exit(0) else $verifier = nil # TODO(bobaman): Cross-platform? logger = WEBrick::Log.new('/dev/null') server = WEBrick::HTTPServer.new( :Port => OAUTH_SERVER_PORT, :Logger => logger, :AccessLog => logger ) trap("INT") { server.shutdown } server.mount("/", OAuthVerifierServlet) oauth_client = Signet::OAuth1::Client.new( :temporary_credential_uri => 'https://www.google.com/accounts/OAuthGetRequestToken', :authorization_uri => 'https://www.google.com/accounts/OAuthAuthorizeToken', :token_credential_uri => 'https://www.google.com/accounts/OAuthGetAccessToken', :client_credential_key => 'anonymous', :client_credential_secret => 'anonymous', :callback => "http://localhost:#{OAUTH_SERVER_PORT}/" ) oauth_client.fetch_temporary_credential!(:additional_parameters => { :scope => options[:scope], :xoauth_displayname => 'Google API Client' }) # Launch browser Launchy::Browser.run(oauth_client.authorization_uri.to_s) server.start oauth_client.fetch_token_credential!(:verifier => $verifier) config = { "scope" => options[:scope], "client_credential_key" => oauth_client.client_credential_key, "client_credential_secret" => oauth_client.client_credential_secret, "token_credential_key" => oauth_client.token_credential_key, "token_credential_secret" => oauth_client.token_credential_secret } config_file = File.expand_path('~/.google-api.yaml') open(config_file, 'w') { |file| file.write(YAML.dump(config)) } exit(0) end end def oauth_2_login require 'signet/oauth_2/client' require 'launchy' require 'yaml' if !options[:client_credential_key] || !options[:client_credential_secret] STDERR.puts('No client ID and secret supplied.') exit(1) end if options[:access_token] config = { "mechanism" => "oauth_2", "scope" => options[:scope], "client_id" => options[:client_credential_key], "client_secret" => options[:client_credential_secret], "access_token" => options[:access_token], "refresh_token" => options[:refresh_token] } config_file = File.expand_path('~/.google-api.yaml') open(config_file, 'w') { |file| file.write(YAML.dump(config)) } exit(0) else $verifier = nil # TODO(bobaman): Cross-platform? logger = WEBrick::Log.new('/dev/null') server = WEBrick::HTTPServer.new( :Port => OAUTH_SERVER_PORT, :Logger => logger, :AccessLog => logger ) trap("INT") { server.shutdown } server.mount("/", OAuthVerifierServlet) oauth_client = Signet::OAuth2::Client.new( :authorization_uri => 'https://www.google.com/accounts/o8/oauth2/authorization', :token_credential_uri => 'https://www.google.com/accounts/o8/oauth2/token', :client_id => options[:client_credential_key], :client_secret => options[:client_credential_secret], :redirect_uri => "http://localhost:#{OAUTH_SERVER_PORT}/", :scope => options[:scope] ) # Launch browser Launchy::Browser.run(oauth_client.authorization_uri.to_s) server.start oauth_client.code = $verifier oauth_client.fetch_access_token! config = { "mechanism" => "oauth_2", "scope" => options[:scope], "client_id" => oauth_client.client_id, "client_secret" => oauth_client.client_secret, "access_token" => oauth_client.access_token, "refresh_token" => oauth_client.refresh_token } config_file = File.expand_path('~/.google-api.yaml') open(config_file, 'w') { |file| file.write(YAML.dump(config)) } exit(0) end end def list api_name = options[:api] unless api_name STDERR.puts('No API name supplied.') exit(1) end client = Google::APIClient.new(:authorization => nil) if options[:discovery_uri] if options[:api] && options[:version] client.register_discovery_uri( options[:api], options[:version], options[:discovery_uri] ) else STDERR.puts( 'Cannot register a discovery URI without ' + 'specifying an API and version.' ) exit(1) end end version = api_version(api_name, options[:version]) api = client.discovered_api(api_name, version) rpcnames = api.to_h.keys puts rpcnames.sort.join("\n") exit(0) end def execute client = self.client # Setup HTTP request data request_body = '' input_streams, _, _ = IO.select([STDIN], [], [], 0) request_body = STDIN.read || '' if input_streams headers = [] if options[:content_type] headers << ['Content-Type', options[:content_type]] elsif request_body # Default to JSON headers << ['Content-Type', 'application/json'] end if options[:uri] # Make request with URI manually specified uri = Addressable::URI.parse(options[:uri]) if uri.relative? STDERR.puts('URI may not be relative.') exit(1) end if options[:requestor_id] uri.query_values = uri.query_values.merge( 'xoauth_requestor_id' => options[:requestor_id] ) end method = options[:http_method] method ||= request_body == '' ? 'GET' : 'POST' method.upcase! request = [method, uri.to_str, headers, [request_body]] request = client.generate_authenticated_request(:request => request) response = client.transmit(request) status, headers, body = response puts body exit(0) else # Make request with URI generated from template and parameters if !self.rpcname STDERR.puts('No rpcname supplied.') exit(1) end api_name = options[:api] || self.rpcname[/^([^\.]+)\./, 1] version = api_version(api_name, options[:version]) api = client.discovered_api(api_name, version) method = api.to_h[self.rpcname] if !method STDERR.puts( "Method #{self.rpcname} does not exist for " + "#{api_name}-#{version}." ) exit(1) end parameters = self.argv.inject({}) do |accu, pair| name, value = pair.split('=', 2) accu[name] = value accu end if options[:requestor_id] parameters['xoauth_requestor_id'] = options[:requestor_id] end begin result = client.execute( :api_method => method, :parameters => parameters, :merged_body => request_body, :headers => headers ) status, headers, body = result.response puts body exit(0) rescue ArgumentError => e puts e.message exit(1) end end end def irb $client = self.client # Otherwise IRB will misinterpret command-line options ARGV.clear IRB.start(__FILE__) end def fuzz STDERR.puts('API fuzzing not yet supported.') if self.rpcname # Fuzz just one method else # Fuzz the entire API end exit(1) end def help puts self.parser exit(0) end end end end Google::APIClient::CLI.new(ARGV).parse!