sheets_db 0.13.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a6eb0913dc274c00619b8de23c709d73676e64e233294469c00c2eb549afcfbb
-  data.tar.gz: ffeaa1616416edd4fa9529c982fce59f39594ec27b6d43eb7da16c5c086824cb
+  metadata.gz: 6656b055b485e05c1ff2d593bb7083c76bdac97302dd77e3667767ff5d4d34ff
+  data.tar.gz: 3d93d3d2fe190a1f8b34ce47ee2bdd83a117ee3abd96c1725a33fda48d1bc051
 SHA512:
-  metadata.gz: 06d3c6c10ed9009cfd370de72fd9afc8b4393b77512149fa6043a04c787086822b9c5fd165f21666c3c6612417a77c279ea6fa2023046b6a565dfe7532264f30
-  data.tar.gz: 73b8d7c1d5a7b79061af23414984597a66d1e2accf9e7a59c84a8e58e7e53726e66869dc258f60a74b036993156f14c889583be95cf8eb2f8e18176705113edf
+  metadata.gz: 7414fba3a498bc109b5bce7d53beb5c9e119c1bf781ee642fac68485730b2d152a2beedc107c0b1d7860d4f72e7d2d27259d7c331782febc51592809a4f81ed7
+  data.tar.gz: 61b136a641a01378b44205ff06d273f3f5cba3cee35521046eba09778f40ad9e7b979e1dd51e819e5fd419abba51dadba0f0bb7799e29c8fdef4d26e71e6e01f

data/lib/sheets_db/resource.rb

@@ -16,10 +16,26 @@ module SheetsDB
         @resource_type = resource_type
       end
 
+      def find(id_or_url, session: SheetsDB::Session.default)
+        find_by_url(id_or_url, session: session)
+      rescue SheetsDB::Session::InvalidGoogleDriveUrlError
+        find_by_id(id_or_url, session: session)
+      end
+
+      def find_by_url(url, session: SheetsDB::Session.default)
+        wrap_google_drive_resource(session.raw_file_by_url(url))
+      end
+
       def find_by_id(id, session: SheetsDB::Session.default)
-        google_drive_resource = session.raw_file_by_id(id)
+        wrap_google_drive_resource(session.raw_file_by_id(id))
+      end
+
+      def wrap_google_drive_resource(google_drive_resource)
         if resource_type && !google_drive_resource.is_a?(resource_type)
-          fail(ResourceTypeMismatchError, "The file with id #{id} is not a #{resource_type}")
+          fail(
+            ResourceTypeMismatchError,
+            "The file #{google_drive_resource.human_url} is not a #{resource_type}"
+          )
         end
         new(google_drive_resource)
       end

data/lib/sheets_db/session.rb

@@ -4,6 +4,7 @@ module SheetsDB
   class Session
     class IllegalDefaultError < StandardError; end
     class NoDefaultSetError < StandardError; end
+    class InvalidGoogleDriveUrlError < ArgumentError; end
 
     def self.default=(default)
       unless default.is_a?(self)
@@ -30,5 +31,12 @@ module SheetsDB
     def raw_file_by_id(id)
       @google_drive_session.file_by_id(id)
     end
+
+    def raw_file_by_url(url)
+      @google_drive_session.file_by_url(url)
+    rescue GoogleDrive::Error => e
+      (raise InvalidGoogleDriveUrlError, url) if e.message.match(/not a known Google Drive URL/)
+      raise
+    end
   end
-end
+end

data/lib/sheets_db/spreadsheet.rb

@@ -4,6 +4,9 @@ module SheetsDB
     class WorksheetNotFoundError < Resource::ChildResourceNotFoundError; end
     class LastWorksheetCannotBeDeletedError < StandardError; end
 
+    SHEET_URL_REGEX = /spreadsheets\/d\/(?<sheet_id>[^\/]+)/.freeze
+    DEFAULT_WORKSHEET_TITLE = "Sheet1".freeze
+
     set_resource_type GoogleDrive::Spreadsheet
 
     class << self
@@ -28,6 +31,19 @@ module SheetsDB
           worksheet_association(resource, **kwargs)
         end
       end
+
+      def extract_id_from_string(id_string)
+        (matches = SHEET_URL_REGEX.match(id_string)) ? matches[:sheet_id] : id_string.gsub("/", "")
+      end
+    end
+
+    def write_raw_data_to_worksheet!(data, worksheet_title: nil, rewrite: false)
+      find_or_create_worksheet!(title: worksheet_title || DEFAULT_WORKSHEET_TITLE).
+        write_raw_data!(data, rewrite: rewrite)
+    end
+
+    def existing_raw_data_from_worksheet(worksheet_title: nil)
+      find_worksheet!(title: worksheet_title || DEFAULT_WORKSHEET_TITLE).existing_raw_data
     end
 
     def find_association_by_id(association_name, id)
@@ -93,7 +109,7 @@ module SheetsDB
     end
 
     def clean_up_default_worksheet!(force: false)
-      default_sheet = google_drive_resource.worksheet_by_title("Sheet1")
+      default_sheet = google_drive_resource.worksheet_by_title(DEFAULT_WORKSHEET_TITLE)
       return unless default_sheet
 
       raise LastWorksheetCannotBeDeletedError if google_drive_resource.worksheets.count == 1

data/lib/sheets_db/version.rb

@@ -1,3 +1,3 @@
 module SheetsDB
-  VERSION = "0.13.0"
+  VERSION = "0.15.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sheets_db
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Ravi Gadad
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-05-21 00:00:00.000000000 Z
+date: 2025-04-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google_drive