google-apis 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 73ecd62e8a070f3007d0a70e89fba19c10fc5add
+  data.tar.gz: 07cdd1042f1446a7f7420269ac6b285d3188b7e3
+SHA512:
+  metadata.gz: 2fdd5bc568744355390ba7fa05aa1045aae105a8d05d6c2283234a6f73d471338654e7e3da8bd95eb55555d1fff085ac56e29e78fdf67bbd4d873c692fb68d63
+  data.tar.gz: ddb5c0ac76e8232a72cfbc10113e8355995115516ba613c1c6c711778bac20229ef5b987f0a18edbd135713b6659d42eac8dc8f4c3bc8deb78e453b78d624e95

data/.gitignore

@@ -0,0 +1,11 @@
+.DS_Store
+.bundle
+.yardoc
+.rvmrc
+Gemfile.lock
+doc
+pkg
+*.log
+*.p12
+*.yml
+test/coverage

data/CHANGELOG.rdoc

@@ -0,0 +1,5 @@
+= Google APIs CHANGELOG
+
+== Version 0.1.0 (February 10, 2015)
+
+* Initial release

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2015 Paul Engel
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,155 @@
+## Google APIs
+
+A thin layer on top of [Google::APIClient](https://github.com/google/google-api-ruby-client) for a more intuitive way of working (e.g. with BigQuery)
+
+### Installation
+
+Add `GoogleApis` in your `Gemfile`:
+
+    gem "google-apis"
+
+Run the following in your console to install with Bundler:
+
+    $ bundle install
+
+### Usage
+
+The easiest setup is to define an application-wide Google API connection followed by instantiating an API instance.
+
+Make sure you have created a Client ID (application type "Service account") at your projects API credentials page (https://console.developers.google.com/project/your_project_id/apiui/credential).
+
+Do not forget to download the private key by generating a P12 key file.
+
+```ruby
+[1] pry(main)> GoogleApis.connect :email_address => "lorem@developer.gserviceaccount.com", :private_key => "/path/to/private/key.p12"
+=> true
+[2] pry(main)> bq = Google::BigQuery.new :projectId => "your_project_id", :datasetId => "your_dataset_id"
+=> #<Google::BigQuery:0x007fc5c68647a8 v2:[datasets,jobs,projects,tabledata,tables] {projectId:"your_project_id",datasetId:"your_dataset_id"}>
+[3] pry(main)> bq.tables.list
+=> {"kind"=>"bigquery#tableList",
+ "etag"=>"\"Fo0B4r/LoR3M-1pSuM-D0loR-s1T-AM3t\"",
+ "tables"=>
+  [{"kind"=>"bigquery#table",
+    "id"=>"your_project_id:your_dataset_id.awesome_table_19820801",
+    "tableReference"=>{"projectId"=>"your_project_id", "datasetId"=>"your_dataset_id", "tableId"=>"awesome_table_19820801"},
+    "type"=>"TABLE"}],
+ "totalItems"=>1}
+[4] pry(main)> bq.jobs.query :query => "SELECT * FROM [your_dataset_id.awesome_table_19820801] LIMIT 5"
+=> {"kind"=>"bigquery#queryResponse",
+ "schema"=>
+  {"fields"=>
+    [{"name"=>"awesome_column1", "type"=>"STRING", "mode"=>"NULLABLE"},
+     {"name"=>"awesome_column2", "type"=>"STRING", "mode"=>"NULLABLE"},
+     {"name"=>"awesome_column3", "type"=>"STRING", "mode"=>"NULLABLE"},
+...
+```
+
+#### Easy API discovery info
+
+GoogleApis quickly displays the resources and methods a certain API provides.
+
+```ruby
+[5] pry(main)> bq
+=> #<Google::BigQuery:0x007fc5c68647a8 v2:[datasets,jobs,projects,tabledata,tables] {projectId:"your_project_id",datasetId:"your_dataset_id"}>
+[6] pry(main)> bq.jobs
+=> #<Google::BigQuery::Resource:0x007f8c09c60c68 v2:jobs:[get,getQueryResults,insert,list,query]>
+[7] pry(main)> bq.jobs[:query]
+=> {"id"=>"bigquery.jobs.query",
+ "path"=>"projects/{projectId}/queries",
+ "httpMethod"=>"POST",
+ "description"=>"Runs a BigQuery SQL query synchronously and returns query results if the query completes within a specified timeout.",
+ "parameters"=>{"projectId"=>{"type"=>"string", "description"=>"Project ID of the project billed for the query", "required"=>true, "location"=>"path"}},
+ "parameterOrder"=>["projectId"],
+ "request"=>{"$ref"=>"QueryRequest"},
+ "response"=>{"$ref"=>"QueryResponse"},
+ "scopes"=>["https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform"]}
+```
+
+#### Application-wide API connections (e.g. Google::BigQuery.connection)
+
+You can also configure an application-wide API connection. Let's say you also stored the connection configuration in `config/bigquery.yml`:
+
+```yaml
+---
+  email_address: lorem@developer.gserviceaccount.com
+  private_key: "/path/to/private/key.p12"
+  projectId: your_project_id
+  datasetId: your_dataset_id
+```
+
+```ruby
+[1] pry(main)> require "yaml"
+=> true
+[2] pry(main)> Google::BigQuery.connect YAML.load_file("config/bigquery.yml")
+=> #<Google::BigQuery:0x007fdc1c6823b0 v2:[datasets,jobs,projects,tabledata,tables] {projectId:"your_project_id",datasetId:"your_dataset_id"}>
+[3] pry(main)> Google::BigQuery.connection.jobs
+=> #<Google::BigQuery::Resource:0x007fdc1e94d5c0 v2:jobs:[get,getQueryResults,insert,list,query]>
+[4] pry(main)> Google::BigQuery.connection.select_rows "SELECT * FROM [your_dataset_id.awesome_table_19820801] LIMIT 2"
+=> [["1982-08-01", "Paul is awesome", "Paul", "Engel", 19],
+ ["1982-08-01", "GoogleApis is cool", "Google", "Apis", 82],
+ ["1982-08-01", "Hello world!", "Foo", "Bar", 8],
+ ["1982-08-01", "Try out this gem :)", "It's", "very easy", 1]]
+```
+
+### Using the console
+
+The GoogleApis repo is provided with `script/console` which you can use for development / testing purposes.
+
+Run the following command in your console:
+
+```ruby
+$ script/console
+Loading Google APIs development environment (0.1.0)
+[1] pry(main)> GoogleApis.connect :email_address => "lorem@developer.gserviceaccount.com", :private_key => "/path/to/private/key.p12"
+=> true
+[2] pry(main)> bq = Google::BigQuery.new :projectId => "your_project_id", :datasetId => "your_dataset_id"
+=> #<Google::BigQuery:0x007f8c09a05338 v2:[datasets,jobs,projects,tabledata,tables] {projectId:"your_project_id",datasetId:"your_dataset_id"}>
+```
+
+You can also define `script/config.yml` containing the connection config:
+
+```yaml
+---
+  email_address: lorem@developer.gserviceaccount.com
+  private_key: "/path/to/private/key.p12"
+```
+
+And immediately start instantiating a Google API:
+
+```ruby
+$ script/console
+Loading Google APIs development environment (0.1.0)
+[1] pry(main)> bq = Google::BigQuery.new :projectId => "your_project_id", :datasetId => "your_dataset_id"
+=> #<Google::BigQuery:0x007fa6c9cc3450 v2:[datasets,jobs,projects,tabledata,tables] {projectId:"your_project_id",datasetId:"your_dataset_id"}>
+```
+
+### Testing
+
+Run the following command for testing:
+
+    $ rake
+
+You can also run a single test file:
+
+    $ ruby test/unit/test_google_apis.rb
+
+### Contributing
+
+Please feel free to fork this repository and send in pull requests to help improve GoogleApis ;)
+
+### TODO
+
+* Add more Google API definitions (see [google-apis/lib/google_apis/api](https://github.com/archan937/google-apis/tree/master/lib/google_apis/api))
+* Add more tests
+
+### License
+
+Copyright (c) 2015 Paul Engel, released under the MIT License
+
+http://github.com/archan937 – http://twitter.com/archan937 – http://gettopup.com – pm_engel@icloud.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task :default => :test
+
+Rake::TestTask.new do |test|
+  test.pattern = "test/**/test_*.rb"
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/google-apis.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path("../lib/google_apis/version", __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.author        = "Paul Engel"
+  gem.email         = "pm_engel@icloud.com"
+  gem.summary       = %q{A thin layer on top of Google::APIClient (google-api-client) for a more intuitive way of working (e.g. with BigQuery)}
+  gem.description   = %q{A thin layer on top of Google::APIClient (google-api-client) for a more intuitive way of working (e.g. with BigQuery)}
+  gem.homepage      = "https://github.com/archan937/google-apis"
+
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name          = "google-apis"
+  gem.require_paths = ["lib"]
+  gem.version       = GoogleApis::VERSION
+
+  gem.add_dependency "google-api-client", "~> 0.8.2"
+
+  gem.add_development_dependency "rake"
+  gem.add_development_dependency "yard"
+  gem.add_development_dependency "pry"
+  gem.add_development_dependency "simplecov"
+  gem.add_development_dependency "minitest"
+  gem.add_development_dependency "mocha"
+end

data/lib/google-apis.rb

@@ -0,0 +1 @@
+require "google_apis"

data/lib/google_apis.rb

@@ -0,0 +1,20 @@
+require "google/api_client"
+
+require "google_apis/core_ext"
+require "google_apis/connection"
+require "google_apis/api"
+require "google_apis/version"
+
+module GoogleApis
+
+  class Error < StandardError; end
+
+  def self.connect(options)
+    @connection = Connection.new options
+  end
+
+  def self.connection
+    @connection
+  end
+
+end

data/lib/google_apis/api.rb

@@ -0,0 +1,4 @@
+require "google_apis/api/base"
+require "google_apis/api/big_query"
+require "google_apis/api/drive"
+require "google_apis/api/plus"

data/lib/google_apis/api/base.rb

@@ -0,0 +1,23 @@
+require "google_apis/api/base/class_methods"
+require "google_apis/api/base/instance_methods"
+require "google_apis/api/base/resource"
+
+module Google
+end
+
+module GoogleApis
+  class Api
+    module Base
+
+      def self.extended(base)
+        name = base.to_s.demodulize
+        Google.const_set name, base
+
+        base.instance_variable_set :@name, "Google::#{name}"
+        base.extend ClassMethods
+        base.send :include, InstanceMethods
+      end
+
+    end
+  end
+end

data/lib/google_apis/api/base/class_methods.rb

@@ -0,0 +1,53 @@
+module GoogleApis
+  class Api
+    module Base
+      module ClassMethods
+
+        def api(value = nil)
+          if value
+            @api = value
+          else
+            @api
+          end
+        end
+
+        def version(value = nil)
+          if value
+            @version = value
+          else
+            @version || 1
+          end
+        end
+
+        def auth_scope(value = nil)
+          if value
+            @auth_scope = value
+          else
+            @auth_scope
+          end
+        end
+
+        def connect(options)
+          @connection = new(options)
+        end
+
+        def connection
+          @connection
+        end
+
+        def name
+          @name
+        end
+
+        def inspect
+          name
+        end
+
+        def to_s
+          name
+        end
+
+      end
+    end
+  end
+end

data/lib/google_apis/api/base/instance_methods.rb

@@ -0,0 +1,46 @@
+module GoogleApis
+  class Api
+    module Base
+      module InstanceMethods
+
+        attr_accessor :connection, :discovered_api
+
+        def initialize(options = {})
+          options = options.symbolize_keys
+
+          config, default_params = options.partition{|(k, v)| [:email_address, :private_key].include?(k)}.collect{|x| Hash[x] unless x.empty?}
+          @connection = config ? GoogleApis::Connection.new(config) : GoogleApis.connection
+          raise Error, "Please ensure a Google API connection" unless @connection
+
+          @discovered_api = connection.discover_api self.class.api, self.class.version
+          @default_params = default_params || {}
+        end
+
+        def execute(api_method, *params)
+          params[0] = (params[0] || {}).symbolize_keys
+          params[0].reverse_merge!(@default_params)
+          connection.execute self.class, api_method, *params
+        end
+
+        def inspect
+          "#<#{self.class}:#{object_hexid} #{discovered_api.version}:[#{discovered_api.discovered_resources.collect(&:name).sort.join(",")}] {#{@default_params.collect{|k, v| "#{k}:#{v.inspect}"}.join(",")}}>"
+        end
+
+        def method_missing(name, *args)
+          if resource = find(name)
+            Resource.new self, resource
+          else
+            super
+          end
+        end
+
+      private
+
+        def find(name)
+          discovered_api.discovered_resources.detect{|x| x.name == name.to_s}
+        end
+
+      end
+    end
+  end
+end

data/lib/google_apis/api/base/resource.rb

@@ -0,0 +1,40 @@
+module GoogleApis
+  class Api
+    module Base
+      class Resource
+
+        attr_accessor :api, :discovered_resource
+
+        def initialize(api, discovered_resource)
+          @api = api
+          @discovered_resource = discovered_resource
+        end
+
+        def [](name)
+          if method = find(name)
+            method.discovery_document
+          end
+        end
+
+        def inspect
+          "#<#{api.class}::Resource:#{object_hexid} #{api.discovered_api.version}:#{discovered_resource.name}:[#{discovered_resource.discovered_methods.collect(&:name).sort.join(",")}]>"
+        end
+
+        def method_missing(name, *args)
+          if method = find(name)
+            api.execute method, *args
+          else
+            super
+          end
+        end
+
+      private
+
+        def find(name)
+          discovered_resource.discovered_methods.detect{|x| x.name == name.to_s}
+        end
+
+      end
+    end
+  end
+end

data/lib/google_apis/api/big_query.rb

@@ -0,0 +1,73 @@
+module GoogleApis
+  class Api
+    class BigQuery
+      extend Base
+
+      api "bigquery"
+      version 2
+      auth_scope "https://www.googleapis.com/auth/bigquery"
+
+      def select_rows(statement)
+        result = jobs.query :query => statement
+        types = result["schema"]["fields"].collect{|x| x["type"].downcase.to_sym}
+
+        (result["rows"] || []).collect do |row|
+          row["f"].inject([]) do |values, x|
+            values << parse_value(types[values.size], x["v"])
+          end
+        end
+      end
+
+      def select_values(query)
+        select_rows(query).collect{|x| x[0]}
+      end
+
+      def select_value(query)
+        row = select_rows(query)[0]
+        row[0] if row
+      end
+
+    private
+
+      def parse_value(type, value)
+        unless value == "NULL"
+          case type
+          when :string
+            parse_string_value value
+          when :integer
+            parse_integer_value value
+          when :float
+            parse_float_value value
+          when :boolean
+            parse_boolean_value value
+          when :timestamp
+            parse_timestamp_value value
+          else
+            raise NotImplementedError, "Cannot parse value of type #{type.inspect}"
+          end
+        end
+      end
+
+      def parse_string_value(value)
+        value
+      end
+
+      def parse_integer_value(value)
+        value.to_i
+      end
+
+      def parse_float_value(value)
+        value.to_f
+      end
+
+      def parse_boolean_value(value)
+        (value == "true") || (value == "1")
+      end
+
+      def parse_timestamp_value(value)
+        Time.at value.to_f.to_i
+      end
+
+    end
+  end
+end

data/lib/google_apis/api/drive.rb

@@ -0,0 +1,12 @@
+module GoogleApis
+  class Api
+    class Drive
+      extend Base
+
+      api "drive"
+      version 2
+      auth_scope "https://www.googleapis.com/auth/drive"
+
+    end
+  end
+end

data/lib/google_apis/api/plus.rb

@@ -0,0 +1,11 @@
+module GoogleApis
+  class Api
+    class Plus
+      extend Base
+
+      api "plus"
+      auth_scope "https://www.googleapis.com/auth/plus.me"
+
+    end
+  end
+end

data/lib/google_apis/connection.rb

@@ -0,0 +1,66 @@
+module GoogleApis
+  class Connection
+
+    def initialize(options)
+      options = options.symbolize_keys
+
+      @client = Google::APIClient.new(
+        :application_name => "rubygem:google-apis",
+        :application_version => GoogleApis::VERSION
+      )
+
+      key = Google::APIClient::PKCS12.load_key(
+        File.open(options[:private_key], "rb"),
+        options[:passphrase] || "notasecret"
+      )
+
+      @asserter = Google::APIClient::JWTAsserter.new(
+        options[:email_address],
+        nil,
+        key
+      )
+    end
+
+    def discover_api(name, version = 1)
+      @client.discovered_api name, "v#{version}"
+    end
+
+    def execute(api, api_method, *params)
+      authenticate!(api)
+
+      nested, top_level = params
+
+      if nested
+        parameter_keys = (api_method.discovery_document["parameters"] || {}).keys.collect(&:to_sym)
+        parameters, body_object = nested.partition{|k, v| parameter_keys.include?(k)}.collect{|x| Hash[x] unless x.empty?}
+      end
+
+      options = {:api_method => api_method}
+      options[:parameters] = parameters if parameters
+      options[:body_object] = body_object if body_object
+      options.merge!(top_level) if top_level
+
+      parse! @client.execute(options)
+    end
+
+  private
+
+    def authenticate!(api)
+      if !@client.authorization.access_token || @client.authorization.expired?
+        @asserter.scope = api.auth_scope
+        @client.authorization = @asserter.authorize
+      end
+    end
+
+    def parse!(response)
+      unless response.body.to_s.empty?
+        JSON.parse(response.body).tap do |data|
+          if error = data["error"]
+            raise Error, "#{error["code"]} #{error["message"]}"
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/google_apis/core_ext.rb

@@ -0,0 +1,2 @@
+require "google_apis/core_ext/kernel"
+require "google_apis/core_ext/hash"

data/lib/google_apis/core_ext/hash.rb

@@ -0,0 +1,15 @@
+unless Hash.method_defined?(:symbolize_keys)
+  class Hash
+    def symbolize_keys
+      inject({}){|h, (k, v)| h[k.to_sym] = v; h}
+    end
+  end
+end
+
+unless Hash.method_defined?(:reverse_merge!)
+  class Hash
+    def reverse_merge!(other)
+      replace other.merge(self)
+    end
+  end
+end

data/lib/google_apis/core_ext/kernel.rb

@@ -0,0 +1,7 @@
+module Kernel
+
+  def object_hexid
+    "0x" + (object_id << 1).to_s(16).rjust(14, "0")
+  end
+
+end

data/lib/google_apis/version.rb

@@ -0,0 +1,7 @@
+module GoogleApis
+  MAJOR = 0
+  MINOR = 1
+  TINY  = 0
+
+  VERSION = [MAJOR, MINOR, TINY].join(".")
+end

data/script/console

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+require "bundler"
+Bundler.require :default, :development
+
+if File.exists?(config = "script/config.yml")
+  require "yaml"
+  GoogleApis.connect YAML.load_file(config)
+end
+
+puts "Loading Google APIs development environment (#{GoogleApis::VERSION})"
+Pry.start

data/test/test_helper.rb

@@ -0,0 +1,11 @@
+require_relative "test_helper/coverage"
+
+require "minitest/autorun"
+require "mocha/setup"
+
+require "bundler"
+Bundler.require :default, :development
+
+def project_file(path)
+  File.expand_path "../../#{path}", __FILE__
+end

data/test/test_helper/coverage.rb

@@ -0,0 +1,11 @@
+if Dir.pwd == File.expand_path("../../..", __FILE__)
+
+require "simplecov"
+
+SimpleCov.coverage_dir "test/coverage"
+SimpleCov.start do
+  add_group "Library", "lib"
+  add_group "Tests", "test"
+end
+
+end

data/test/unit/api/base/test_class_methods.rb

@@ -0,0 +1,73 @@
+require_relative "../../../test_helper"
+
+module Unit
+  module Api
+    module Base
+      class TestClassMethods < Minitest::Test
+
+        class ClassApi
+          extend GoogleApis::Api::Base::ClassMethods
+        end
+
+        describe GoogleApis::Api::Base::ClassMethods do
+          describe ".api" do
+            describe "as reader" do
+              it "returns class instance variable @api" do
+                ClassApi.instance_variable_set :@api, "< api >"
+                assert_equal "< api >", ClassApi.api
+              end
+            end
+            describe "as writer" do
+              it "assigns class instance variable @api" do
+                ClassApi.instance_variable_set :@api, "< old api >"
+                ClassApi.api "< new api >"
+                assert_equal "< new api >", ClassApi.instance_variable_get(:@api)
+              end
+            end
+          end
+
+          describe ".version" do
+            describe "as reader" do
+              describe "when not set" do
+                it "returns 1" do
+                  ClassApi.instance_variable_set :@version, nil
+                  assert_equal 1, ClassApi.version
+                end
+              end
+              describe "when set" do
+                it "returns class instance variable @version" do
+                  ClassApi.instance_variable_set :@version, "< version >"
+                  assert_equal "< version >", ClassApi.version
+                end
+              end
+            end
+            describe "as writer" do
+              it "assigns class instance variable @version" do
+                ClassApi.instance_variable_set :@version, "< old version >"
+                ClassApi.version "< new version >"
+                assert_equal "< new version >", ClassApi.instance_variable_get(:@version)
+              end
+            end
+          end
+
+          describe ".auth_scope" do
+            describe "as reader" do
+              it "returns class instance variable @auth_scope" do
+                ClassApi.instance_variable_set :@auth_scope, "< auth_scope >"
+                assert_equal "< auth_scope >", ClassApi.auth_scope
+              end
+            end
+            describe "as writer" do
+              it "assigns class instance variable @auth_scope" do
+                ClassApi.instance_variable_set :@auth_scope, "< old auth_scope >"
+                ClassApi.auth_scope "< new auth_scope >"
+                assert_equal "< new auth_scope >", ClassApi.instance_variable_get(:@auth_scope)
+              end
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/test/unit/api/base/test_instance_methods.rb

@@ -0,0 +1,67 @@
+require_relative "../../../test_helper"
+
+module Unit
+  module Api
+    module Base
+      class TestInstanceMethods < Minitest::Test
+
+        class InstanceApi
+          extend GoogleApis::Api::Base
+        end
+
+        describe GoogleApis::Api::Base::InstanceMethods do
+          describe "#initialize" do
+            describe "when not having GoogleApis.connection defined" do
+              before do
+                GoogleApis.instance_variable_set :@connection, nil
+              end
+              describe "when passing connection options" do
+                it "instantiates its own connection" do
+                  connection = "< connection >"
+                  connection.expects(:discover_api)
+                  options = {
+                    :email_address => "< email_address >",
+                    :private_key => "< private_key >"
+                  }
+                  GoogleApis::Connection.expects(:new).with(options).returns(connection)
+                  assert_equal connection, InstanceApi.new(options).instance_variable_get(:@connection)
+                end
+              end
+              describe "when not passing connection options" do
+                it "raises an error" do
+                  assert_raises GoogleApis::Error do
+                    InstanceApi.new
+                  end
+                end
+              end
+            end
+            describe "when not having GoogleApis.connection defined" do
+              before do
+                GoogleApis.instance_variable_set :@connection, "< google-apis connection >"
+              end
+              describe "when passing connection options" do
+                it "instantiates its own connection" do
+                  connection = "< connection >"
+                  connection.expects(:discover_api)
+                  options = {
+                    :email_address => "< email_address >",
+                    :private_key => "< private_key >"
+                  }
+                  GoogleApis::Connection.expects(:new).with(options).returns(connection)
+                  assert_equal connection, InstanceApi.new(options).instance_variable_get(:@connection)
+                end
+              end
+              describe "when not passing connection options" do
+                it "uses GoogleApis.connection for its connection" do
+                  GoogleApis.connection.expects(:discover_api)
+                  assert_equal "< google-apis connection >", InstanceApi.new.instance_variable_get(:@connection)
+                end
+              end
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/test/unit/api/test_base.rb

@@ -0,0 +1,48 @@
+require_relative "../../test_helper"
+
+module Unit
+  module Api
+    class TestBigQuery < Minitest::Test
+
+      class BaseApi
+        extend GoogleApis::Api::Base
+        def self.metaclass
+          class << self; self; end
+        end
+      end
+
+      describe GoogleApis::Api::Base do
+        describe ".extended" do
+          it "extends base with GoogleApis::Api::Base::ClassMethods" do
+            assert_equal true, BaseApi.metaclass.included_modules.include?(GoogleApis::Api::Base::ClassMethods)
+          end
+          it "includes base with GoogleApis::Api::Base::InstanceMethods" do
+            assert_equal true, BaseApi.included_modules.include?(GoogleApis::Api::Base::InstanceMethods)
+          end
+          it "registers base in the Google namespace" do
+            assert_equal true, Google.constants.include?(:BaseApi)
+            assert_equal BaseApi, Google::BaseApi
+          end
+        end
+        describe ".name" do
+          it "returns its actual name demodulized within the Google namespace" do
+            assert_equal "Google::BaseApi", BaseApi.name
+          end
+        end
+        describe ".inspect" do
+          it "returns its name" do
+            BaseApi.expects(:name).returns("< inspect >")
+            assert_equal "< inspect >", BaseApi.inspect
+          end
+        end
+        describe ".to_s" do
+          it "returns its name" do
+            BaseApi.expects(:name).returns("< to_s >")
+            assert_equal "< to_s >", BaseApi.to_s
+          end
+        end
+      end
+
+    end
+  end
+end

data/test/unit/api/test_big_query.rb

@@ -0,0 +1,29 @@
+require_relative "../../test_helper"
+
+module Unit
+  module Api
+    class TestBigQuery < Minitest::Test
+
+      describe GoogleApis::Api::BigQuery do
+        describe ".api" do
+          it "returns the default API name" do
+            assert_equal "bigquery", GoogleApis::Api::BigQuery.api
+          end
+        end
+
+        describe ".version" do
+          it "returns the default API version" do
+            assert_equal 2, GoogleApis::Api::BigQuery.version
+          end
+        end
+
+        describe ".auth_scope" do
+          it "returns the default API authentication scope" do
+            assert_equal "https://www.googleapis.com/auth/bigquery", GoogleApis::Api::BigQuery.auth_scope
+          end
+        end
+      end
+
+    end
+  end
+end

data/test/unit/core_ext/test_hash.rb

@@ -0,0 +1,34 @@
+require_relative "../../test_helper"
+
+module Unit
+  module CoreExt
+    class TestHash < Minitest::Test
+
+      describe Hash do
+        describe "#symbolize_keys" do
+          before do
+            @hash = {"a" => 1, "b" => 2, "c" => 3}
+            @result = @hash.symbolize_keys
+          end
+          it "returns new hash" do
+            assert_equal true, @result.is_a?(Hash)
+            assert_equal true, @hash.object_id != @result.object_id
+          end
+          it "returns a hash with symbols as keys" do
+            assert_equal [:a, :b, :c], @result.keys
+          end
+        end
+        describe "#reverse_merge!" do
+          before do
+            @hash = {"a" => 1, "b" => 2, "c" => 3}
+            @hash.reverse_merge!("a" => 0, "d" => 4)
+          end
+          it "reverse merges another destructively" do
+            assert_equal({"a" => 1, "b" => 2, "c" => 3, "d" => 4}, @hash)
+          end
+        end
+      end
+
+    end
+  end
+end

data/test/unit/core_ext/test_kernel.rb

@@ -0,0 +1,18 @@
+require_relative "../../test_helper"
+
+module Unit
+  module CoreExt
+    class TestKernel < Minitest::Test
+
+      describe Kernel do
+        describe "#object_hexid" do
+          it "returns the hexadecimal representation of its object_id" do
+            object = Struct.new(:object_id).new(70232270636660)
+            assert_equal "0x007fc073160ce8", object.object_hexid
+          end
+        end
+      end
+
+    end
+  end
+end

data/test/unit/test_connection.rb

@@ -0,0 +1,30 @@
+require_relative "../test_helper"
+
+module Unit
+  class TestConnection < Minitest::Test
+
+    describe GoogleApis::Connection do
+      describe "#initialize" do
+        it "instantiates a Google::APIClient and Google::APIClient::JWTAsserter" do
+          Google::APIClient.expects(:new).with({
+            :application_name => "rubygem:google-apis",
+            :application_version => GoogleApis::VERSION
+          }).returns("< client >")
+
+          File.expects(:open).with("< private_key >", "rb").returns("< file >")
+          Google::APIClient::PKCS12.expects(:load_key).with("< file >", "notasecret").returns("< key >")
+          Google::APIClient::JWTAsserter.expects(:new).with("< email_address >", nil, "< key >").returns("< asserter >")
+
+          connection = GoogleApis::Connection.new(
+            :email_address => "< email_address >",
+            :private_key => "< private_key >"
+          )
+
+          assert_equal "< client >", connection.instance_variable_get(:@client)
+          assert_equal "< asserter >", connection.instance_variable_get(:@asserter)
+        end
+      end
+    end
+
+  end
+end

data/test/unit/test_google_apis.rb

@@ -0,0 +1,43 @@
+require_relative "../test_helper"
+
+module Unit
+  class TestGoogleApis < MiniTest::Test
+
+    describe GoogleApis do
+      it "has the current version" do
+        version = File.read(project_file("VERSION")).strip
+        assert_equal version, GoogleApis::VERSION
+        assert File.read(project_file("CHANGELOG.rdoc")).include?("Version #{version} ")
+      end
+
+      describe ".connect" do
+        before do
+          @options = {
+            :email_address => "< email_address >",
+            :private_key => "< private_key >"
+          }
+        end
+
+        it "instantiates a connection" do
+          GoogleApis::Connection.expects(:new).with(@options).returns(true)
+          assert_equal true, GoogleApis.connect(@options)
+        end
+
+        it "memoizes the connection" do
+          connection = "< connection >"
+          GoogleApis::Connection.expects(:new).with(@options).returns(connection)
+          GoogleApis.connect(@options)
+          assert_equal connection, GoogleApis.instance_variable_get(:@connection)
+        end
+      end
+
+      describe ".connection" do
+        it "returns instance variable @connection" do
+          GoogleApis.instance_variable_set :@connection, "< connection >"
+          assert_equal "< connection >", GoogleApis.connection
+        end
+      end
+    end
+
+  end
+end

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: google-apis
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Paul Engel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-02-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: google-api-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A thin layer on top of Google::APIClient (google-api-client) for a more
+  intuitive way of working (e.g. with BigQuery)
+email: pm_engel@icloud.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- CHANGELOG.rdoc
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- VERSION
+- google-apis.gemspec
+- lib/google-apis.rb
+- lib/google_apis.rb
+- lib/google_apis/api.rb
+- lib/google_apis/api/base.rb
+- lib/google_apis/api/base/class_methods.rb
+- lib/google_apis/api/base/instance_methods.rb
+- lib/google_apis/api/base/resource.rb
+- lib/google_apis/api/big_query.rb
+- lib/google_apis/api/drive.rb
+- lib/google_apis/api/plus.rb
+- lib/google_apis/connection.rb
+- lib/google_apis/core_ext.rb
+- lib/google_apis/core_ext/hash.rb
+- lib/google_apis/core_ext/kernel.rb
+- lib/google_apis/version.rb
+- script/console
+- test/test_helper.rb
+- test/test_helper/coverage.rb
+- test/unit/api/base/test_class_methods.rb
+- test/unit/api/base/test_instance_methods.rb
+- test/unit/api/test_base.rb
+- test/unit/api/test_big_query.rb
+- test/unit/core_ext/test_hash.rb
+- test/unit/core_ext/test_kernel.rb
+- test/unit/test_connection.rb
+- test/unit/test_google_apis.rb
+homepage: https://github.com/archan937/google-apis
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A thin layer on top of Google::APIClient (google-api-client) for a more intuitive
+  way of working (e.g. with BigQuery)
+test_files:
+- test/test_helper.rb
+- test/test_helper/coverage.rb
+- test/unit/api/base/test_class_methods.rb
+- test/unit/api/base/test_instance_methods.rb
+- test/unit/api/test_base.rb
+- test/unit/api/test_big_query.rb
+- test/unit/core_ext/test_hash.rb
+- test/unit/core_ext/test_kernel.rb
+- test/unit/test_connection.rb
+- test/unit/test_google_apis.rb
+has_rdoc: