airrecord 1.0.1 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 534c1f26e6248221487da3863fd700cb426b937cf26ece866a56c453f2bb70e9
-  data.tar.gz: dcfd2eaae567f63143fb2e2a4148faad1fd142bad54a16e3c9791b225c350b08
+  metadata.gz: 53739239320854267f0a3fa6a03b81b5ea733bcca061728f0a0b2337d5d32c8d
+  data.tar.gz: 4c7d23923d1fc45ff48c3644f83f42598b77878756ef2f41cabd229fb122e61f
 SHA512:
-  metadata.gz: ef4e7f2a364a4a489c6eed6f7750855e118afcab19f1511bda87217a252b7d1f0a8bce1669aaf3ced875c4ea76c0629052ea2fbfec2dcf3e10e0320e789ff9d0
-  data.tar.gz: 2845f143db4a202f050c5382a4b2596296ef725a40004ddc779e35e74d78ba025914c3294411043ddfcbd8351d045368c0dcfdc1bfc87c87dcefe7d6d76bc7ed
+  metadata.gz: f474a334e15a3feeedaa18dcbb5ddc9cc8a3b6ad2707377de076dc821ff4453e2400a39750e03b7cfb73a69d20aea5627c4e9c9aa1474e325a5e625bf6941d1b
+  data.tar.gz: eb8c7b5d6e66677059ab1fed2d25826280e6f9736d7e775422b8d103ad9dd53982708642782e7cbef3797c58cf95c0cfd712b4f370538b8436e10e1204cc5406

data/.travis.yml

@@ -1,4 +1,5 @@
 sudo: false
 language: ruby
 rvm:
-  - 2.3.3
+  - 2.7.2
+  - 3.0.0

data/CHANGELOG.md

@@ -1,4 +1,31 @@
+# 1.0.6
+
+* Ruby 3 compatibility
+
+# 1.0.5
+
+* Allow Faraday 1.0 (#70)
+
+# 1.0.4
+
+* Correctly set `created_at` on `#find` (#68)
+
+# 1.0.3
+
+* Allow passing optional parameters, e.g. `typecast: true`. (#67)
+
+# 1.0.2
+
+* When a `has_one` or `belongs_to` association is empty, return `nil` instead of
+  a blank record (#51)
+
+* When a `has_many` association is empty, do not make a network call to the
+  associated table
+
+* Relax dependency on `net-http-persistent` to allow latest (#57)
+
 # 1.0.1
+
 * Support JRuby 9.0 and CRuby 2.2 (#47)
 * Fix $stderr warnings in CRurby > 2.3 (#46)
 

data/README.md

@@ -222,6 +222,22 @@ tea.save
 Note that column names need to match the exact column names in Airtable,
 otherwise Airrecord will throw an error that no column matches it.
 
+
+If you need to include optional request parameters, such as the `typecast` parameter, these can be passed to either `Table.create` or `#save`.
+This is also supported when updating existing records with the `#save` method.
+
+```ruby
+tea = Tea.create(
+  {"Name" => "Feng Gang", "Type" => "Green", "Country" => "China"},
+  {"typecast" => true},
+)
+
+# Or with the #save method:
+tea = Tea.new({"Name" => "Feng Gang", "Type" => "Green"})
+tea["Name"] = "Feng Gang"
+tea.save("typecast" => true)
+```
+
 _Earlier versions of airrecord provided methods for snake-cased column names
 and symbols, however this proved error-prone without a proper schema API from
 Airtable which has still not been released._

data/airrecord.gemspec

@@ -20,10 +20,10 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
   spec.required_ruby_version = '>= 2.2'
 
-  spec.add_dependency 'faraday', '~> 0.10'
-  spec.add_dependency "net-http-persistent", '~> 2.9'
+  spec.add_dependency 'faraday', ['>= 0.10', '< 2.0']
+  spec.add_dependency "net-http-persistent", '>= 2.9'
 
-  spec.add_development_dependency "bundler", "~> 1.12"
+  spec.add_development_dependency "bundler", "~> 2"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "minitest", "~> 5.0"
   spec.add_development_dependency "byebug"

data/bin/production-test.rb

@@ -0,0 +1,9 @@
+require 'airrecord'
+
+Tea = Airrecord.table(
+  ENV["AIRTABLE_TOKEN"],
+  "appZJC9q8TBYPDF7j",
+  "Teas"
+)
+
+p Tea.all

data/lib/airrecord/table.rb

@@ -1,3 +1,5 @@
+require 'rubygems' # For Gem::Version
+
 module Airrecord
   class Table
     class << self
@@ -19,7 +21,9 @@ module Airrecord
           # sort associations in opposite directions. We want to match the UI.
           ids = (self[options.fetch(:column)] || []).reverse
           table = Kernel.const_get(options.fetch(:class))
-          options[:single] ? table.find(ids.first) : table.find_many(ids)
+          return table.find_many(ids) unless options[:single]
+
+          (id = ids.first) ? table.find(id) : nil
         end
 
         define_method("#{method_name}=".to_sym) do |value|
@@ -38,20 +42,22 @@ module Airrecord
         parsed_response = client.parse(response.body)
 
         if response.success?
-          self.new(parsed_response["fields"], id: id)
+          self.new(parsed_response["fields"], id: id, created_at: parsed_response["createdTime"])
         else
           client.handle_error(response.status, parsed_response)
         end
       end
 
       def find_many(ids)
+        return [] if ids.empty?
+
         or_args = ids.map { |id| "RECORD_ID() = '#{id}'"}.join(',')
         formula = "OR(#{or_args})"
         records(filter: formula).sort_by { |record| or_args.index(record.id) }
       end
 
-      def create(fields)
-        new(fields).tap { |record| record.save }
+      def create(fields, options={})
+        new(fields).tap { |record| record.save(options) }
       end
 
       def records(filter: nil, sort: nil, view: nil, offset: nil, paginate: true, fields: nil, max_records: nil, page_size: nil)
@@ -103,10 +109,20 @@ module Airrecord
 
     attr_reader :fields, :id, :created_at, :updated_keys
 
-    def initialize(fields, id: nil, created_at: nil)
-      @id = id
-      self.created_at = created_at
-      self.fields = fields
+    # This is an awkward definition for Ruby 3 to remain backwards compatible.
+    # It's easier to read by reading the 2.x definition below.
+    if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("3.0.0")
+      def initialize(*one, **two)
+        @id = one.first && two.delete(:id)
+        self.created_at = one.first && two.delete(:created_at)
+        self.fields = one.first || two
+      end
+    else
+      def initialize(fields, id: nil, created_at: nil)
+        @id = id
+        self.created_at = created_at
+        self.fields = fields
+      end
     end
 
     def new_record?
@@ -125,10 +141,14 @@ module Airrecord
       fields[key] = value
     end
 
-    def create
+    def create(options={})
       raise Error, "Record already exists (record has an id)" unless new_record?
 
-      body = { fields: serializable_fields }.to_json
+      body = {
+        fields: serializable_fields,
+        **options,
+      }.to_json
+
       response = client.connection.post("/v0/#{self.class.base_key}/#{client.escape(self.class.table_name)}", body, { 'Content-Type' => 'application/json' })
       parsed_response = client.parse(response.body)
 
@@ -141,8 +161,8 @@ module Airrecord
       end
     end
 
-    def save
-      return create if new_record?
+    def save(options={})
+      return create(options) if new_record?
 
       return true if @updated_keys.empty?
 
@@ -150,7 +170,8 @@ module Airrecord
       body = {
         fields: Hash[@updated_keys.map { |key|
           [key, fields[key]]
-        }]
+        }],
+        **options,
       }.to_json
 
       response = client.connection.patch("/v0/#{self.class.base_key}/#{client.escape(self.class.table_name)}/#{self.id}", body, { 'Content-Type' => 'application/json' })

data/lib/airrecord/version.rb

@@ -1,3 +1,3 @@
 module Airrecord
-  VERSION = "1.0.1"
+  VERSION = "1.0.6"
 end

metadata

@@ -1,41 +1,47 @@
 --- !ruby/object:Gem::Specification
 name: airrecord
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.6
 platform: ruby
 authors:
 - Simon Eskildsen
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2018-11-28 00:00:00.000000000 Z
+date: 2021-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0.10'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: net-http-persistent
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.9'
 - !ruby/object:Gem::Dependency
@@ -44,14 +50,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.12'
+        version: '2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.12'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -110,6 +116,7 @@ files:
 - Rakefile
 - airrecord.gemspec
 - bin/console
+- bin/production-test.rb
 - bin/setup
 - lib/airrecord.rb
 - lib/airrecord/client.rb
@@ -121,7 +128,7 @@ homepage: https://github.com/sirupsen/airrecord
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -136,9 +143,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: Airtable client
 test_files: []