airmodel 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fb5eeb6e340c2b3236d9cb8c193d5761498d8d90
-  data.tar.gz: 75325168af92642cab483442ac1f22ab46290e7a
+  metadata.gz: 0993017b73e85cdf5feea7202fe15bc08b7337db
+  data.tar.gz: 96efc042d20d434f44e31485f2f585a18aa26522
 SHA512:
-  metadata.gz: f1c9c3bedfe7b4ea7796845b0d063df8828d425c315314c7ff179dd794624edc63f1207fe024a8062c976007dde65c74a5f237758e746944a1d701666690f999
-  data.tar.gz: cf7b16dcaa42d6f4ad4145c24939b21fd4179431bb917aec1951cf690fa6ccd2c5409237e0c841da3c3364c90a9a14bc8520bff192d6f0d66765cd2d5f7a7220
+  metadata.gz: b6198d0499f0b32b0d7d6df2dd16ea5405cdf8fd9125ac87118416082587080e1c775319aef2359825f8c458455483fc88883dc5b5c4c2fc6b84866c15cb078e
+  data.tar.gz: 574e06e6344caee7da1ed5e904bbe6fabaf58f313e8714fe5305de108a1c7dfb109c6b6cfd33b411f2ad1200a3ef86ac6ebae91b3e13a112a1a10741181cb454

data/README.md

@@ -8,7 +8,7 @@ Installation
 
 Add this line to your Gemfile:
 
-		gem install 'airmodel', git: 'https://github.com/chrisfrank/airmodel.git'
+		gem install 'airmodel'
 
 Configuration
 ----------------
@@ -69,6 +69,10 @@ Now you can write code like
 
 		Song.where("Artist Name": "The Beatles", "Composer": "Harrison")
 
+		Song.find("recXYZ")
+
+		Song.find(["recXYZ", "recABC", "recJKL"])
+
 See lib/airmodel/model.rb for all available methods.
 
 

data/lib/airmodel.rb

@@ -17,7 +17,7 @@ module Airmodel
     @@api_client
   end
 
-  def self.bases(path_to_config_file="#{Airmodel.root}/config/bases.yml")
+  def self.bases(path_to_config_file="#{Dir.pwd}/config/bases.yml")
     @@bases ||= YAML.load_file(path_to_config_file)
     @@bases
   end

data/lib/airmodel/model.rb

@@ -29,6 +29,24 @@ module Airmodel
       )
     end
 
+    # find a record by ID.
+    # IF you've (1) defined an 'id' Field in Airtable, (2) made it a formula,
+    # and (3) set the formula to RECORD_ID(),
+    # THEN you can pass self.find([an,array,of,ids]) and it will return
+    # each record in that order. This is mostly only useful for looking up
+    # records linked to a particular record.
+    def self.find(id, shard=nil)
+      if id.is_a? String
+        results = self.classify tables(shard: shard).map{|tbl| tbl.find(id) }
+        results.count == 0 ? nil : results.first
+      else
+        formula = "OR(" + id.map{|x| "id='#{x}'" }.join(',') + ")"
+        some(shard: shard, filterByFormula: formula).sort_by do |x|
+          id.index(x.id)
+        end
+      end
+    end
+
     # find a record by specified attributes, return it
     def self.find_by(filters)
       shard = filters.delete(:shard)

data/lib/airmodel/utils.rb

@@ -9,13 +9,13 @@ module Airmodel
     # each backed by a base defined in DB YAML file
     def tables(args={})
       db = Airmodel.bases[table_name] || raise(NoSuchBase.new("Could not find base '#{table_name}' in config file"))
-      bases = normalized_base_config(db[:bases])
+      bases_list = normalized_base_config(db[:bases])
       # return just one Airtable::Table if a particular shard was requested
       if args[:shard]
-        [Airmodel.client.table(bases[args.delete(:shard)], db[:table_name])]
+        [Airmodel.client.table(bases_list[args.delete(:shard)], db[:table_name])]
       # otherwise return each one
       else
-        bases.map{|key, val| Airmodel.client.table val, db[:table_name] }
+        bases_list.map{|key, val| Airmodel.client.table val, db[:table_name] }
       end
     end
 

data/lib/airmodel/version.rb

@@ -1,3 +1,3 @@
 module Airmodel
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

data/spec/models_spec.rb

@@ -71,6 +71,19 @@ describe TestModel do
       end
     end
 
+    describe "find" do
+      it "should call airtable-ruby's 'find' method when passed just one record ID" do
+        stub_airtable_response! "https://api.airtable.com/v0/appXYZ/example_table/recABC", { "id":"recABC", fields: {"name": "example record"} }
+        record = TestModel.find("recABC")
+        expect(record.name).to eq "example record"
+      end
+      it "should return an ordered list of records when passed an array of record IDs" do
+        records = TestModel.find(["recABC", "recXYZ"])
+        expect(records.class).to eq Array
+        expect(records.first.id).to eq "recABC"
+      end
+    end
+
     describe "find_by" do
       it "should return one record that matches the supplied filters", skip_before: true do
         stub_airtable_response!(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: airmodel
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - chrisfrankdotfm
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-18 00:00:00.000000000 Z
+date: 2016-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler