google_drive 0.3.11 → 1.0.0.pre1

data/lib/google_drive_v1/list.rb

@@ -0,0 +1,119 @@
+# Author: Hiroshi Ichikawa <http://gimite.net/>
+# The license of this source is "New BSD Licence"
+
+require "google_drive_v1/util"
+require "google_drive_v1/error"
+require "google_drive_v1/list_row"
+
+
+module GoogleDriveV1
+
+    # Provides access to cells using column names.
+    # Use GoogleDriveV1::Worksheet#list to get GoogleDriveV1::List object.
+    #--
+    # This is implemented as wrapper of GoogleDriveV1::Worksheet i.e. using cells
+    # feed, not list feed. In this way, we can easily provide consistent API as
+    # GoogleDriveV1::Worksheet using save()/reload().
+    class List
+        
+        include(Enumerable)
+        
+        def initialize(worksheet) #:nodoc:
+          @worksheet = worksheet
+        end
+        
+        # Number of non-empty rows in the worksheet excluding the first row.
+        def size
+          return @worksheet.num_rows - 1
+        end
+        
+        # Returns Hash-like object (GoogleDriveV1::ListRow) for the row with the
+        # index. Keys of the object are colum names (the first row).
+        # The second row has index 0.
+        #
+        # Note that updates to the returned object are not sent to the server until
+        # you call GoogleDriveV1::Worksheet#save().
+        def [](index)
+          return ListRow.new(self, index)
+        end
+        
+        # Updates the row with the index with the given Hash object.
+        # Keys of +hash+ are colum names (the first row).
+        # The second row has index 0.
+        #
+        # Note that update is not sent to the server until
+        # you call GoogleDriveV1::Worksheet#save().
+        def []=(index, hash)
+          self[index].replace(hash)
+        end
+        
+        # Iterates over Hash-like object (GoogleDriveV1::ListRow) for each row
+        # (except for the first row).
+        # Keys of the object are colum names (the first row).
+        def each(&block)
+          for i in 0...self.size
+            yield(self[i])
+          end
+        end
+        
+        # Column names i.e. the contents of the first row.
+        # Duplicates are removed.
+        def keys
+          return (1..@worksheet.num_cols).map(){ |i| @worksheet[1, i] }.uniq()
+        end
+        
+        # Updates column names i.e. the contents of the first row.
+        #
+        # Note that update is not sent to the server until
+        # you call GoogleDriveV1::Worksheet#save().
+        def keys=(ary)
+          for i in 1..ary.size
+            @worksheet[1, i] = ary[i - 1]
+          end
+          for i in (ary.size + 1)..@worksheet.num_cols
+            @worksheet[1, i] = ""
+          end
+        end
+        
+        # Adds a new row to the bottom.
+        # Keys of +hash+ are colum names (the first row).
+        # Returns GoogleDriveV1::ListRow for the new row.
+        #
+        # Note that update is not sent to the server until
+        # you call GoogleDriveV1::Worksheet#save().
+        def push(hash)
+          row = self[self.size]
+          row.update(hash)
+          return row
+        end
+        
+        # Returns all rows (except for the first row) as Array of Hash.
+        # Keys of Hash objects are colum names (the first row).
+        def to_hash_array()
+          return self.map(){ |r| r.to_hash() }
+        end
+        
+        def get(index, key) #:nodoc:
+          return @worksheet[index + 2, key_to_col(key)]
+        end
+        
+        def numeric_value(index, key) #:nodoc:
+          return @worksheet.numeric_value(index + 2, key_to_col(key))
+        end
+        
+        def set(index, key, value) #:nodoc:
+          @worksheet[index + 2, key_to_col(key)] = value
+        end
+        
+      private
+        
+        def key_to_col(key)
+          key = key.to_s()
+          col = (1..@worksheet.num_cols).find(){ |c| @worksheet[1, c] == key }
+          raise(GoogleDriveV1::Error, "Column doesn't exist: %p" % key) if !col
+          return col
+        end
+        
+    end
+    
+end

data/lib/google_drive_v1/list_row.rb

@@ -0,0 +1,88 @@
+# Author: Hiroshi Ichikawa <http://gimite.net/>
+# The license of this source is "New BSD Licence"
+
+require "forwardable"
+
+require "google_drive_v1/util"
+require "google_drive_v1/error"
+
+
+module GoogleDriveV1
+
+    # Hash-like object returned by GoogleDriveV1::List#[].
+    class ListRow
+        
+        include(Enumerable)
+        extend(Forwardable)
+        
+        def_delegators(:to_hash,
+            :keys, :values, :each_key, :each_value, :each, :each_pair, :hash,
+            :assoc, :fetch, :flatten, :key, :invert, :size, :length, :rassoc,
+            :merge, :reject, :select, :sort, :to_a, :values_at)
+        
+        def initialize(list, index) #:nodoc:
+          @list = list
+          @index = index
+        end
+        
+        def [](key)
+          return @list.get(@index, key)
+        end
+        
+        def numeric_value(key)
+          return @list.numeric_value(@index, key)
+        end
+        
+        def []=(key, value)
+          @list.set(@index, key, value)
+        end
+        
+        def has_key?(key)
+          return @list.keys.include?(key)
+        end
+        
+        alias include? has_key?
+        alias key? has_key?
+        alias member? has_key?
+        
+        def update(hash)
+          for k, v in hash
+            self[k] = v
+          end
+        end
+        
+        alias merge! update
+        
+        def replace(hash)
+          clear()
+          update(hash)
+        end
+        
+        def clear()
+          for key in @list.keys
+            self[key] = ""
+          end
+        end
+        
+        def to_hash()
+          result = {}
+          for key in @list.keys
+            result[key] = self[key]
+          end
+          return result
+        end
+        
+        def ==(other)
+          return self.class == other.class && self.to_hash() == other.to_hash()
+        end
+        
+        alias === ==
+        alias eql? ==
+        
+        def inspect
+          return "\#<%p %p>" % [self.class, to_hash()]
+        end
+        
+    end
+    
+end

data/lib/{google_drive → google_drive_v1}/oauth1_fetcher.rb

@@ -5,7 +5,7 @@ require "rubygems"
 require "oauth"
 
 
-module GoogleDrive
+module GoogleDriveV1
 
     class OAuth1Fetcher #:nodoc:
         

data/lib/{google_drive → google_drive_v1}/oauth2_fetcher.rb

@@ -1,10 +1,10 @@
 # Author: Hiroshi Ichikawa <http://gimite.net/>
 # The license of this source is "New BSD Licence"
 
-require "google_drive/basic_fetcher"
+require "google_drive_v1/basic_fetcher"
 
 
-module GoogleDrive
+module GoogleDriveV1
 
     class OAuth2Fetcher < BasicFetcher #:nodoc:
         

data/lib/google_drive_v1/record.rb

@@ -0,0 +1,31 @@
+# Author: Hiroshi Ichikawa <http://gimite.net/>
+# The license of this source is "New BSD Licence"
+
+require "google_drive_v1/util"
+require "google_drive_v1/error"
+
+
+module GoogleDriveV1
+
+    # DEPRECATED: Table and Record feeds are deprecated and they will not be available after
+    # March 2012.
+    #
+    # Use GoogleDriveV1::Table#records to get GoogleDriveV1::Record objects.
+    class Record < Hash
+        include(Util)
+
+        def initialize(session, entry) #:nodoc:
+          @session = session
+          entry.css("gs|field").each() do |field|
+            self[field["name"]] = field.inner_text
+          end
+        end
+
+        def inspect #:nodoc:
+          content = self.map(){ |k, v| "%p => %p" % [k, v] }.join(", ")
+          return "\#<%p:{%s}>" % [self.class, content]
+        end
+
+    end
+
+end