google-spreadsheet-ruby 0.1.3 → 0.1.4

data/lib/google_spreadsheet.rb

@@ -370,20 +370,41 @@ module GoogleSpreadsheet
         # URL of worksheet-based feed of the spreadsheet.
         attr_reader(:worksheets_feed_url)
 
-        # Title of the spreadsheet. So far only available if you get this object by
-        # GoogleSpreadsheet::Session#spreadsheets.
-        attr_reader(:title)
+        # Title of the spreadsheet.
+        #
+        # Set params[:reload] to true to force reloading the title.
+        def title(params = {})
+          if !@title || params[:reload]
+            @title = spreadsheet_feed_entry(params).css("title").text
+          end
+          return @title
+        end
 
         # Key of the spreadsheet.
         def key
           if !(@worksheets_feed_url =~
-              %r{^https?://spreadsheets.google.com/feeds/worksheets/(.*)/private/full$})
+              %r{^https?://spreadsheets.google.com/feeds/worksheets/(.*)/private/.*$})
             raise(GoogleSpreadsheet::Error,
               "worksheets feed URL is in unknown format: #{@worksheets_feed_url}")
           end
           return $1
         end
+        
+        # Spreadsheet feed URL of the spreadsheet.
+        def spreadsheet_feed_url
+          return "https://spreadsheets.google.com/feeds/spreadsheets/private/full/#{self.key}"
+        end
+        
+        # URL which you can open the spreadsheet in a Web browser with.
+        #
+        # e.g. "http://spreadsheets.google.com/ccc?key=pz7XtlQC-PYx-jrVMJErTcg"
+        def human_url
+          return self.spreadsheet_feed_entry.css("link[@rel='alternate']").first["href"]
+        end
 
+        # DEPRECATED: Table and Record feeds are deprecated and they will not be available after
+        # March 2012.
+        #
         # Tables feed URL of the spreadsheet.
         def tables_feed_url
           return "https://spreadsheets.google.com/feeds/#{self.key}/tables"
@@ -394,6 +415,16 @@ module GoogleSpreadsheet
           return "https://docs.google.com/feeds/documents/private/full/spreadsheet%3A#{self.key}"
         end
 
+        # <entry> element of spreadsheet feed as Nokogiri::XML::Element.
+        #
+        # Set params[:reload] to true to force reloading the feed.
+        def spreadsheet_feed_entry(params = {})
+          if !@spreadsheet_feed_entry || params[:reload]
+            @spreadsheet_feed_entry = @session.request(:get, self.spreadsheet_feed_url).css("entry").first
+          end
+          return @spreadsheet_feed_entry
+        end
+        
         # Creates copy of this spreadsheet with the given name.
         def duplicate(new_name = nil)
           new_name ||= (@title ? "Copy of " + @title : "Untitled")
@@ -407,7 +438,7 @@ module GoogleSpreadsheet
           }
           doc = @session.request(:post, url, :data => ods, :auth => :writely, :header => header)
           ss_url = doc.css(
-            "link[@rel='http://schemas.google.com/spreadsheets/2006#worksheetsfeed']").first['href']
+            "link[@rel='http://schemas.google.com/spreadsheets/2006#worksheetsfeed']").first["href"]
           return Spreadsheet.new(@session, ss_url, title)
         end
 
@@ -422,7 +453,7 @@ module GoogleSpreadsheet
         # Renames title of the spreadsheet.
         def rename(title)
           doc = @session.request(:get, self.document_feed_url)
-          edit_url = doc.css("link[@rel='edit']").first['href']
+          edit_url = doc.css("link[@rel='edit']").first["href"]
           xml = <<-"EOS"
             <atom:entry
                 xmlns:atom="http://www.w3.org/2005/Atom"
@@ -466,6 +497,9 @@ module GoogleSpreadsheet
           return Worksheet.new(@session, self, url, title)
         end
 
+        # DEPRECATED: Table and Record feeds are deprecated and they will not be available after
+        # March 2012.
+        #
         # Returns list of tables in the spreadsheet.
         def tables
           doc = @session.request(:get, self.tables_feed_url)
@@ -474,6 +508,9 @@ module GoogleSpreadsheet
 
     end
 
+    # DEPRECATED: Table and Record feeds are deprecated and they will not be available after
+    # March 2012.
+    #
     # Use GoogleSpreadsheet::Worksheet#add_table to create table.
     # Use GoogleSpreadsheet::Worksheet#tables to get GoogleSpreadsheet::Table objects.
     class Table
@@ -520,6 +557,9 @@ module GoogleSpreadsheet
 
     end
 
+    # DEPRECATED: Table and Record feeds are deprecated and they will not be available after
+    # March 2012.
+    #
     # Use GoogleSpreadsheet::Table#records to get GoogleSpreadsheet::Record objects.
     class Record < Hash
         include(Util)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: google-spreadsheet-ruby
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 19
   prerelease: false
   segments: 
   - 0
   - 1
-  - 3
-  version: 0.1.3
+  - 4
+  version: 0.1.4
 platform: ruby
 authors: 
 - Hiroshi Ichikawa
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-06 00:00:00 +09:00
+date: 2011-05-12 00:00:00 +09:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency