norairrecord 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e43689c499a7d1d54963791d0dacd275d2cc9c8b0c2dc27b636884b51596bbee
-  data.tar.gz: '01970ece2dddb567110ebaaec5f855df7240d329f1403c33aad49e3632aa978e'
+  metadata.gz: 910e4c4f488a1f1fb996144d7bc2bd023eca3d386681937af92c337d8f8e2b26
+  data.tar.gz: 55979229a04ec5ad233f49d2858b1179af6c47dc0eaf3c7f260cc808f55083d9
 SHA512:
-  metadata.gz: '097efbecab4facd4d22299b7b5629b015c032c93808342f88cb6cdb652d572b72e7d1a5c48d165827ea5d35e9be41c0d6d37aafb82a411474d302e14e911fb8b'
-  data.tar.gz: f166ce6e3be2bdd525c78168df6c9f0e7dc10bd95c779abe55b742a710fb904f8694bd2604c42d93264ff607a2df962fb07dc88d7d9610c7dc269f8ef2ea5e64
+  metadata.gz: 80beee3c36c56253974af2053e669df452f0d4af0ff5ad88b05eabf2afc7673706848563d57b298a7565a88fa831700d77325b46300e48351a0607e7753d87a0
+  data.tar.gz: 66f75e0a29877db15f9463ae95f65a3b2521f623c0ffa45bf3ddbfb261ff5f67b049d5df68d1f58fcaa21e14988918ecefe4d53d9fab0fcae4c3371a556ab690

data/README.md

@@ -29,4 +29,22 @@ stuff not in the OG:
 * custom UA
   * `Norairrecord.user_agent = "i'm the reason why you're getting 429s!"`
 * `Table#airtable_url`
-  * what it says on the tin!
+  * what it says on the tin!
+* `Table.has_subtypes`
+  * hokay so: 
+  * ```ruby
+    class Friend < Norairrecord::Table
+      # base_key/table_name, etc...
+      has_subtypes "type", { # based on 'type' column...
+        "person" => "Person", # when 'person' instantiate record as Person 
+        "shark" => "Shark"
+      }, strict: true # if strict, unmapped types will raise UnknownTypeError
+      # otherwise they will be instantiated as the base class
+    end
+
+    class Person < Friend; end
+    class Shark < Friend; end
+    
+    Friend.all
+    => [<Person>, <Person>, <Shark>]
+    ```

data/lib/norairrecord/table.rb

@@ -37,12 +37,18 @@ module Norairrecord
 
       alias has_one belongs_to
 
+      def has_subtypes(column, mapping, strict: false)
+        @subtype_column = column
+        @subtype_mapping = mapping
+        @subtype_strict = strict
+      end
+
       def find(id)
         response = client.connection.get("v0/#{base_key}/#{client.escape(table_name)}/#{id}")
         parsed_response = client.parse(response.body)
 
         if response.success?
-          self.new(parsed_response["fields"], id: id, created_at: parsed_response["createdTime"])
+          self.new_with_subtype(parsed_response["fields"], id: id, created_at: parsed_response["createdTime"])
         else
           client.handle_error(response.status, parsed_response)
         end
@@ -78,6 +84,18 @@ module Norairrecord
         new(fields).tap { |record| record.save(options) }
       end
 
+      def new_with_subtype(fields, id:, created_at:)
+        if @subtype_column
+          clazz = self
+          st = @subtype_mapping[fields[@subtype_column]]
+          raise Norairrecord::UnknownTypeError, "#{fields[@subtype_column]}?????" if @subtype_strict && st.nil?
+          clazz =  Kernel.const_get(st) if st
+          clazz.new(fields, id:, created_at:)
+        else
+          self.new(fields, id: id, created_at: created_at)
+        end
+      end
+
       def records(filter: nil, sort: nil, view: nil, offset: nil, paginate: true, fields: nil, max_records: nil, page_size: nil)
         options = {}
         options[:filterByFormula] = filter if filter
@@ -100,8 +118,8 @@ module Norairrecord
 
         if response.success?
           records = parsed_response["records"]
-          records = records.map { |record|
-            self.new(record["fields"], id: record["id"], created_at: record["createdTime"])
+          records.map! { |record|
+            self.new_with_subtype(record["fields"], id: record["id"], created_at: record["createdTime"])
           }
 
           if paginate && parsed_response["offset"]
@@ -193,8 +211,7 @@ module Norairrecord
       update_hash = Hash[@updated_keys.map { |key|
         [key, fields[key]]
       }]
-
-      self.patch(update_hash, options)
+      self.fields = self.class.update(self.id, update_hash, options)
     end
 
     def destroy

data/lib/norairrecord/version.rb

@@ -1,3 +1,3 @@
 module Norairrecord
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/norairrecord.rb

@@ -11,6 +11,7 @@ module Norairrecord
   attr_accessor :api_key, :throttle, :base_url, :user_agent
 
   Error = Class.new(StandardError)
+  UnknownTypeError = Class.new(StandardError)
 
   def throttle?
     return true if @throttle.nil?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: norairrecord
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - nora
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-12-03 00:00:00.000000000 Z
+date: 2024-12-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday