google-apis 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a7e91a00208cd6eccdb174d912834823f8e1238e
-  data.tar.gz: dd9df318acff7c25053e606bc1d0cf89e6084b4c
+  metadata.gz: b8d1add3229c971662ab77620ca8b6a11021803e
+  data.tar.gz: ba08f0e27722cc5055ab23c6142777e7edbc2b60
 SHA512:
-  metadata.gz: 3938e0f06f08f049b874abebc73008781e56c33611260141517e8fc22bd81e507d0777528006218003834146dde2259a92b8f5d77b8a50feb63fbf1177e0ab2d
-  data.tar.gz: 028c5b6c2d45ec3de407a206462fd54320b0edae9a31667877d852a2bbb7117d3464c74f1ea62c7b8f6fb7979224c024d218f178f79cbde31e11f62340e69f4c
+  metadata.gz: 13de4d3734a4c18d8534c69478c2ce988648be0deb0475a3743343c6fd1e9f02bcdd13b9b96617a9f7de156dda5aed9683d1fbe6537c6b03a659e6d30187c70c
+  data.tar.gz: 83788437def396e77c72749567e75a54f570c14db8a1c0f2b2cced2bba0b9c7d5da98d94fda08b7cb785dfab780aa028761568565887128b2098a754d5004f15

data/CHANGELOG.rdoc

@@ -1,5 +1,10 @@
 = Google APIs CHANGELOG
 
+== Version 0.1.2 (April 17, 2015)
+
+* Added Google Storage API definition
+* Being able to download files from Google Storage ^^
+
 == Version 0.1.1 (February 10, 2015)
 
 * Fixed bug: made options optional when invoking `.connect`

data/README.md

@@ -97,6 +97,41 @@ You can also configure an application-wide API connection. Let's say you also st
 
 Please note that `Google::BigQuery.connection` is provided with several methods resembling ActiveRecord: `#select_rows`, `#select_values` and `#select_value`.
 
+##### Google::Storage.connection
+
+The following example demonstrates how to download a file from Google Storage:
+
+```ruby
+[1] pry(main)> Google::Storage.connect :email_address => "lorem@developer.gserviceaccount.com", :private_key => "/path/to/private/key.p12"
+=> #<Google::Storage:0x007fe522024f68 v1:[bucketAccessControls,buckets,channels,defaultObjectAccessControls,objectAccessControls,objects] {}>
+[2] pry(main)> metadata = Google::Storage.objects.list :bucket => "your-bucket", :prefix => "path/to/your/file/awesome.tsv"
+=> {"kind"=>"storage#objects",
+ "items"=>
+  [{"kind"=>"storage#object",
+    "id"=>"your-bucket/path/to/your/file/awesome.tsv/1425499569141000",
+    "selfLink"=>"https://www.googleapis.com/storage/v1/b/your-bucket/o/path%2Fto%2Fyour%2Ffile%2Fawesome.tsv",
+    "name"=>"path/to/your/file/awesome.tsv",
+    "bucket"=>"your-bucket",
+    "generation"=>"1425499569141000",
+    "metageneration"=>"1",
+    "contentType"=>"text/tab-separated-values",
+    "updated"=>"2015-03-04T20:06:09.141Z",
+    "storageClass"=>"STANDARD",
+    "size"=>"5592792",
+    "md5Hash"=>"od4vAFihlDLs1k9kgo+U4CXhQ==",
+    "mediaLink"=>"https://www.googleapis.com/download/storage/v1/b/your-bucket/o/path%2Fto%2Fyour%2Ffile%2Fawesome.tsv?generation=1425499569141000&alt=media",
+    "owner"=>{"entity"=>"user-00b4903a97b10389ce680ca45ba5999e068c4d0c8ccbbfbb7094238bc85a567", "entityId"=>"00b4903a97b20004ce680ca5f5aeebe068c4d0c8ccbbfbb7094266d1b9787457"},
+    "crc32c"=>"P4UlsJQ==",
+    "etag"=>"EN93lyNu/j8QCEAE="}]}
+[3] pry(main)> Google::Storage.download metadata["items"][0]["mediaLink"]
+=> 5592792
+[4] pry(main)> puts `ls -l | grep awesome`
+-rw-rw-r--  1 paulengel  paulengel  5592792 Apr 17 16:38 awesome.tsv
+=> nil
+```
+
+Easy, huh? :)
+
 ##### 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).

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/google-apis.gemspec

@@ -14,6 +14,7 @@ Gem::Specification.new do |gem|
   gem.name          = "google-apis"
   gem.require_paths = ["lib"]
   gem.version       = GoogleApis::VERSION
+  gem.licenses      = ["MIT"]
 
   gem.add_dependency "google-api-client", "~> 0.8.2"
 

data/lib/google_apis/api.rb

@@ -2,3 +2,4 @@ require "google_apis/api/base"
 require "google_apis/api/big_query"
 require "google_apis/api/drive"
 require "google_apis/api/plus"
+require "google_apis/api/storage"

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

@@ -28,11 +28,15 @@ module GoogleApis
         end
 
         def connect(options = {})
-          @connection = new(options)
+          @instance = new(options)
+        end
+
+        def instance
+          @instance
         end
 
         def connection
-          @connection
+          instance
         end
 
         def name
@@ -48,8 +52,8 @@ module GoogleApis
         end
 
         def method_missing(name, *args)
-          if connection && (connection.class.instance_methods(false).include?(name) || connection.send(:find, name))
-            connection.send(name, *args)
+          if instance && (instance.respond_to?(name) || instance.send(:find, name))
+            instance.send(name, *args)
           else
             super
           end

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

@@ -22,6 +22,10 @@ module GoogleApis
           connection.execute self.class, api_method, *params
         end
 
+        def download(uri, to = nil)
+          connection.download self.class, uri, to
+        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

data/lib/google_apis/api/storage.rb

@@ -0,0 +1,12 @@
+module GoogleApis
+  class Api
+    class Storage
+      extend Base
+
+      api "storage"
+      version 1
+      auth_scope "https://www.googleapis.com/auth/devstorage.read_write"
+
+    end
+  end
+end

data/lib/google_apis/connection.rb

@@ -1,3 +1,5 @@
+require "uri"
+
 module GoogleApis
   class Connection
 
@@ -43,6 +45,17 @@ module GoogleApis
       parse! @client.execute(options)
     end
 
+    def download(api, uri, to = nil)
+      authenticate!(api)
+
+      response = @client.execute Google::APIClient::Request.new(:uri => uri)
+      to ||= File.basename CGI.unescape(URI.parse(uri).path)
+
+      File.open(to, "wb") do |file|
+        file.write response.body
+      end
+    end
+
     def inspect
       "#<#{self.class}:#{object_hexid} [#{@asserter.issuer}]>"
     end

data/lib/google_apis/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Paul Engel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-02-10 00:00:00.000000000 Z
+date: 2015-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-api-client
@@ -133,6 +133,7 @@ files:
 - lib/google_apis/api/big_query.rb
 - lib/google_apis/api/drive.rb
 - lib/google_apis/api/plus.rb
+- lib/google_apis/api/storage.rb
 - lib/google_apis/connection.rb
 - lib/google_apis/core_ext.rb
 - lib/google_apis/core_ext/hash.rb
@@ -150,7 +151,8 @@ files:
 - test/unit/test_connection.rb
 - test/unit/test_google_apis.rb
 homepage: https://github.com/archan937/google-apis
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -168,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.3
 signing_key: 
 specification_version: 4
 summary: A thin layer on top of Google::APIClient (google-api-client) for a more intuitive