google-apis 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 73ecd62e8a070f3007d0a70e89fba19c10fc5add
-  data.tar.gz: 07cdd1042f1446a7f7420269ac6b285d3188b7e3
+  metadata.gz: a7e91a00208cd6eccdb174d912834823f8e1238e
+  data.tar.gz: dd9df318acff7c25053e606bc1d0cf89e6084b4c
 SHA512:
-  metadata.gz: 2fdd5bc568744355390ba7fa05aa1045aae105a8d05d6c2283234a6f73d471338654e7e3da8bd95eb55555d1fff085ac56e29e78fdf67bbd4d873c692fb68d63
-  data.tar.gz: ddb5c0ac76e8232a72cfbc10113e8355995115516ba613c1c6c711778bac20229ef5b987f0a18edbd135713b6659d42eac8dc8f4c3bc8deb78e453b78d624e95
+  metadata.gz: 3938e0f06f08f049b874abebc73008781e56c33611260141517e8fc22bd81e507d0777528006218003834146dde2259a92b8f5d77b8a50feb63fbf1177e0ab2d
+  data.tar.gz: 028c5b6c2d45ec3de407a206462fd54320b0edae9a31667877d852a2bbb7117d3464c74f1ea62c7b8f6fb7979224c024d218f178f79cbde31e11f62340e69f4c

data/CHANGELOG.rdoc

@@ -1,5 +1,12 @@
 = Google APIs CHANGELOG
 
+== Version 0.1.1 (February 10, 2015)
+
+* Fixed bug: made options optional when invoking `.connect`
+* Overridden GoogleApis::Connection.inspect for better info
+* Fixed switching APIs using one global connection
+* Being able to delegate resource invocation on API class to its connection
+
 == Version 0.1.0 (February 10, 2015)
 
 * Initial release

data/README.md

@@ -18,11 +18,13 @@ The easiest setup is to define an application-wide Google API connection followe
 
 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).
 
+Enable the API at your Console API page (https://console.developers.google.com/project/your_project_id/apiui/api).
+
 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
+=> #<GoogleApis::Connection:0x007fa5a4743668 [lorem@developer.gserviceaccount.com]>
 [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
@@ -65,7 +67,9 @@ GoogleApis quickly displays the resources and methods a certain API provides.
  "scopes"=>["https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform"]}
 ```
 
-#### Application-wide API connections (e.g. Google::BigQuery.connection)
+#### Application-wide API connections
+
+##### 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`:
 
@@ -82,15 +86,53 @@ You can also configure an application-wide API connection. Let's say you also st
 => 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
+[3] pry(main)> Google::BigQuery.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"
+[4] pry(main)> Google::BigQuery.select_rows "SELECT * FROM [your_dataset_id.awesome_table_19820801] LIMIT 4"
 => [["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]]
 ```
 
+Please note that `Google::BigQuery.connection` is provided with several methods resembling ActiveRecord: `#select_rows`, `#select_values` and `#select_value`.
+
+##### Google::Drive.connection
+
+Please make sure that you also have created a "Public API access" server key and added your IP to the allowed IPs at the [API credentials page](https://console.developers.google.com/project/your_project_id/apiui/credential).
+
+```ruby
+[1] pry(main)> Google::Drive.connect :email_address => "lorem@developer.gserviceaccount.com", :private_key => "/path/to/private/key.p12"
+=> #<Google::Drive:0x007f83ee39fcc8 v2:[about,apps,changes,channels,children,comments,files,parents,permissions,properties,realtime,replies,revisions] {}>
+[2] pry(main)> Google::Drive.files.list
+=> {"kind"=>"drive#fileList",
+ "etag"=>"\"4GaIn/LoR3M-1pSuM-D0loR-s1T-AM3t\"",
+ "selfLink"=>"https://www.googleapis.com/drive/v2/files",
+ "items"=>
+  [{"kind"=>"drive#file",
+    "id"=>"12-On3Tw0w4ntO0-0neTh0",
+...
+```
+
+#### One Google API connection to rule them all
+
+If it isn't already clear, you can specify a global Google API connection and use different APIs:
+
+```ruby
+[1] pry(main)> GoogleApis.connect :email_address => "lorem@developer.gserviceaccount.com", :private_key => "/path/to/private/key.p12"
+=> #<GoogleApis::Connection:0x007ffe0aa95d70 [lorem@developer.gserviceaccount.com]>
+[2] pry(main)> Google::Drive.connect
+=> #<Google::Drive:0x007fcfec1265b0 v2:[about,apps,changes,channels,children,comments,files,parents,permissions,properties,realtime,replies,revisions] {}>
+[3] pry(main)> Google::Drive.files.list
+=> {"kind"=>"drive#fileList",
+...
+[4] pry(main)> Google::BigQuery.connect :projectId => "your_project_id", :datasetId => "your_dataset_id"
+=> #<Google::BigQuery:0x007ffe0b1fb240 v2:[datasets,jobs,projects,tabledata,tables] {projectId:"your_project_id",datasetId:"your_dataset_id"}>
+[5] pry(main)> Google::BigQuery.tables.list
+=> {"kind"=>"bigquery#tableList",
+...
+```
+
 ### Using the console
 
 The GoogleApis repo is provided with `script/console` which you can use for development / testing purposes.
@@ -100,8 +142,8 @@ 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
+[1] pry(main)> GoogleApis.connect :email_address => "", :private_key => "/path/to/private/key.p12"
+=> #<GoogleApis::Connection:0x007ff3d356cbf0 [lorem@developer.gserviceaccount.com]>
 [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"}>
 ```

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.1.1

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

@@ -27,7 +27,7 @@ module GoogleApis
           end
         end
 
-        def connect(options)
+        def connect(options = {})
           @connection = new(options)
         end
 
@@ -47,6 +47,14 @@ module GoogleApis
           name
         end
 
+        def method_missing(name, *args)
+          if connection && (connection.class.instance_methods(false).include?(name) || connection.send(:find, name))
+            connection.send(name, *args)
+          else
+            super
+          end
+        end
+
       end
     end
   end

data/lib/google_apis/connection.rb

@@ -16,7 +16,7 @@ module GoogleApis
 
       @asserter = Google::APIClient::JWTAsserter.new(
         options[:email_address],
-        nil,
+        "",
         key
       )
     end
@@ -43,11 +43,15 @@ module GoogleApis
       parse! @client.execute(options)
     end
 
+    def inspect
+      "#<#{self.class}:#{object_hexid} [#{@asserter.issuer}]>"
+    end
+
   private
 
     def authenticate!(api)
-      if !@client.authorization.access_token || @client.authorization.expired?
-        @asserter.scope = api.auth_scope
+      if !@asserter.scope.include?(api.auth_scope) || @client.authorization.expired?
+        @asserter.scope = (@asserter.scope.split(" ") << api.auth_scope).uniq
         @client.authorization = @asserter.authorize
       end
     end

data/lib/google_apis/version.rb

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

data/test/unit/test_connection.rb

@@ -13,7 +13,7 @@ module Unit
 
           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 >")
+          Google::APIClient::JWTAsserter.expects(:new).with("< email_address >", "", "< key >").returns("< asserter >")
 
           connection = GoogleApis::Connection.new(
             :email_address => "< email_address >",

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Paul Engel