airtable2 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f8968193253823a000c9f38c14185208b89a4dfd77d9ff6ab0a5b5f8b3f595e
-  data.tar.gz: 06c31cfbcc19f156ab7e498e7e6b6f9f0ca4b749aecb523124f85df7d8a452c2
+  metadata.gz: 32bae2cc155c84b948c193c8ea5677288ea7123aeded90f6e6121ba196d0a4c7
+  data.tar.gz: 8efc8479bf004389e25aee1bdc8b88b60dfbc395078dfa4935f4a65afa93bbe4
 SHA512:
-  metadata.gz: 6bbbc8e341a9a16969df15e605d0e379138915066968abd3581b635d6bf66349526ae7f88d483384a5248f6f72c97f1f85d32e2a4a7e3e49c223f339d07cedc0
-  data.tar.gz: f8f0c2a7f3400519a07082a7c1640ae80947c7d4c4143d6b0d82e50068c01176d0f3aaeeeee392d9926647574f65185fc69382a147fa68b0bad4c2603dc2f59d
+  metadata.gz: 9f0993c56aa18abf1fc80089ebf8b08d377ff70476c04b4df619dd6637a4439bf034a0af2b8f90660244464ceeefc137fd836cd99493b00415ea7108cead000b
+  data.tar.gz: b1b30151a67ff2ce1f2eb479327ef1a959fa4ca9d671ecd33553d3a75c746f1193010e5d3e1ab457cfbd3ca9e25d385a2c85cc5d850e1a3b2766ddfd65160647

data/README.md

@@ -41,12 +41,15 @@ and its tables
 @tables = @base.tables
 ```
 
-and a table's records, so you can navigate the has_many chain the way God intended:
+and a table's records, so you can navigate the belongs_to/has_many relationships the way God intended:
 
 ```ruby
-@client.bases.first.tables.first.records.first
+@record = @client.bases.first.tables.first.records.first
+@base = @record.table.base
 ```
 
+Note that objects' child records are memoized to avoid unnecessary API calls. If sensitive to stale data, be sure to use the objects instantiated most recently.
+
 ### Manipulating Tables
 
 Create a new table with:
@@ -71,10 +74,10 @@ Once you have access to a table from above, we can query a set of records in the
 
 ### Inserting Records
 
-A single record or an array of records can be inserted using the `add_records` method on a table (max 10 at a time):
+A single record or an array of records can be inserted using the `create_records` method on a table (max 10 at a time):
 
 ```ruby
-@table.add_records({ 'Name': 'name value', 'Age': 35 })
+@table.create_records({ 'Name': 'name value', 'Age': 35 })
 ```
 
 ### Deleting Records

data/airtable.gemspec

@@ -30,5 +30,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rubocop-performance'
   spec.add_development_dependency 'rubocop-rake'
   spec.add_development_dependency 'webmock'
+
   spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.metadata['github_repo'] = 'ssh://github.com/aseroff/airtable-ruby'
 end

data/lib/airtable/base.rb

@@ -2,14 +2,15 @@
 
 # Object corresponding to an Airtable Base
 class Airtable::Base < Airtable::Resource
-  def initialize(token, id)
+  def initialize(token, id, tables = nil)
     super(token)
     @id = id
+    @tables = tables
   end
 
-  # Expects {name:,description:,fields:[]}
-  # @see https://airtable.com/developers/web/api/create-table
+  # @param table_data [Hash] Payload for table creation. Expects {name:,description:,fields:[]}
   # @return [Airtable::Table]
+  # @see https://airtable.com/developers/web/api/create-table
   def create_table(table_data)
     response = self.class.post("#{base_url}/tables",
                                body: table_data.to_json).parsed_response
@@ -19,17 +20,20 @@ class Airtable::Base < Airtable::Resource
     Airtable::Table.new @token, @id, response
   end
 
+  # @return [Array<Airtable::Table>]
   # @see https://airtable.com/developers/web/api/get-base-schema
-  # @return [Array]<Airtable::Table>
   def tables
-    response = self.class.get("#{base_url}/tables")
+    @tables ||= begin
+      response = self.class.get("#{base_url}/tables")
 
-    check_and_raise_error(response)
+      check_and_raise_error(response)
 
-    response['tables'].map { Airtable::Table.new(@token, @id, _1) }
+      response['tables'].map { Airtable::Table.new(@token, @id, _1['id'], _1) }
+    end
   end
 
   # Instantiate table in base
+  # @param table_id [String] ID of table
   # @return [Airtable::Table]
   def table(table_id)
     Airtable::Table.new(@token, @id, table_id)

data/lib/airtable/client.rb

@@ -2,8 +2,8 @@
 
 # Client carrying authorization token
 class Airtable::Client < Airtable::Resource
+  # @return [Array<Airtable::Base>]
   # @see https://airtable.com/developers/web/api/list-bases
-  # @return [Array]<Airtable::Base>
   def bases
     response = self.class.get('/v0/meta/bases').parsed_response
 
@@ -12,22 +12,22 @@ class Airtable::Client < Airtable::Resource
     response['bases'].map { Airtable::Base.new(@token, _1['id']) }
   end
 
-  # @see https://airtable.com/developers/web/api/create-base
-  # def create_base(base_data)
-  #   response = self.class.post('/v0/meta/bases'
-  #                              body: base_data.to_json).parsed_response
-  #   check_and_raise_error(response)
-  #   Airtable::Base.new @token, response
-  # end
+  # Instantiate workspace
+  # @param workspace_id [String] ID of workspace
+  # @return [Airtable::Workspace]
+  def workspace(workspace_id)
+    Airtable::Workspace.new(@token, workspace_id)
+  end
 
   # Instantiate base
+  # @param base_id [String] ID of base
   # @return [Airtable::Base]
   def base(base_id)
     Airtable::Base.new(@token, base_id)
   end
 
+  # @return [Hash] User's data based on token
   # @see https://airtable.com/developers/web/api/get-user-id-scopes
-  # @return [Hash]
   def whoami
     response = self.class.get('/v0/meta/whoami').parsed_response
 

data/lib/airtable/record.rb

@@ -2,14 +2,44 @@
 
 # Object corresponding to an Airtable Record
 class Airtable::Record < Airtable::Resource
-  attr_reader :fields
-
-  def initialize(token, base_id, table_id, api_response)
+  def initialize(token, base_id, table_id, id, data = nil)
     super(token)
     @base_id = base_id
     @table_id = table_id
-    api_response.deep_symbolize_keys.each do |key, value|
-      instance_variable_set(:"@#{key}", value)
+    @id = id
+    @data = data
+  end
+
+  # Return record data, retrieve if not present
+  # @return [Hash]
+  # @see https://airtable.com/developers/web/api/get-record
+  def data
+    @data ||= begin
+      response = self.class.get(record_url).parsed_response
+
+      check_and_raise_error(response)
+
+      response
     end
   end
+
+  # Instantiate record's table
+  # @return [Airtable::Table]
+  def table = Airtable::Table.new(token, @base_id, @table_id)
+
+  # @return [Airtable::Record]
+  # @see https://airtable.com/developers/web/api/update-record
+  def update(record_data)
+    response = self.class.patch(record_url,
+                                body: { fields: record_data }.to_json).parsed_response
+
+    check_and_raise_error(response)
+
+    Airtable::Record.new @token, @base_id, @table_id, response['id'], response
+  end
+
+  protected
+
+  # Endpoint for records
+  def record_url = "/v0/#{@base_id}/#{@table_id}/#{@id}"
 end

data/lib/airtable/table.rb

@@ -4,45 +4,55 @@
 class Airtable::Table < Airtable::Resource
   attr_reader :name
 
-  def initialize(token, base_id, api_response)
+  def initialize(token, base_id, id, data = nil)
     super(token)
     @base_id = base_id
-    api_response.deep_symbolize_keys.each do |key, value|
-      instance_variable_set(:"@#{key}", value)
-    end
+    @id = id
+    @data = data
   end
 
-  # @see https://airtable.com/developers/web/api/list-records
+  # Return table model, retrieve if not present
+  # @return [Hash]
+  # @see https://airtable.com/developers/web/api/get-base-schema
+  def data = @data ||= base.tables.find { _1.id == @id }.data
+
+  # Instantiate table's base
+  # @return [Airtable::Base]
+  def base = Airtable::Base.new(token, @base_id)
+
   # @return [Array<Airtable::Record>]
+  # @see https://airtable.com/developers/web/api/list-records
   def records
-    response = self.class.get(table_url)
+    @records ||= begin
+      response = self.class.get(table_url)
 
-    check_and_raise_error(response)
+      check_and_raise_error(response)
 
-    response['records'].map { Airtable::Record.new(@token, @base_id, @table_id, _1) }
+      response['records'].map { Airtable::Record.new(@token, @base_id, @id, _1['id'], _1) }
+    end
   end
 
   # Instantiate record in table
-  # @return [Airtable::Table]
-  def record(record_id)
-    Airtable::Table.new(@token, @base_id, @id, record_id)
-  end
+  # @param record_id [String] ID of record
+  # @return [Airtable::Record]
+  def record(record_id) = Airtable::Record.new(@token, @base_id, @id, record_id)
 
-  # @see https://airtable.com/developers/web/api/update-table
   # @return [Airtable::Table]
+  # @see https://airtable.com/developers/web/api/update-table
   def update(table_data)
     response = self.class.patch("/v0/meta/bases/#{@base_id}/tables/#{@id}",
                                 body: table_data.to_json).parsed_response
 
     check_and_raise_error(response)
 
-    Airtable::Table.new @token, @base_id, response
+    Airtable::Table.new @token, @base_id, response['id'], response
   end
 
-  # @note API maximum of 10 records at a time
-  # @see https://airtable.com/developers/web/api/create-records
+  # @param [Array] Record objects to create
   # @return [Array<Airtable::Record>]
-  def add_records(records)
+  # @see https://airtable.com/developers/web/api/create-records
+  # @note API maximum of 10 records at a time
+  def create_records(records)
     response = self.class.post(table_url,
                                body: { records: Array(records).map { |fields| { fields: } } }.to_json).parsed_response
 
@@ -51,9 +61,10 @@ class Airtable::Table < Airtable::Resource
     response['records'].map { Airtable::Record.new(@token, @base_id, @id, _1) }
   end
 
-  # @note API maximum of 10 records at a time
-  # @see https://airtable.com/developers/web/api/delete-multiple-records
+  # @param [Array] IDs of records to delete
   # @return [Array] Deleted record ids
+  # @see https://airtable.com/developers/web/api/delete-multiple-records
+  # @note API maximum of 10 records at a time
   def delete_records(record_ids)
     params = Array(record_ids).compact.map { "records[]=#{_1}" }.join('&')
     response = self.class.delete("#{table_url}?#{params}").parsed_response

data/lib/airtable/version.rb

@@ -2,5 +2,5 @@
 
 # Version
 module Airtable
-  VERSION = '0.2.2'
+  VERSION = '0.2.3'
 end

data/lib/airtable/workspace.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Object corresponding to an Airtable Workspace
+class Airtable::Workspace < Airtable::Resource
+  def initialize(token, id)
+    super(token)
+    @id = id
+  end
+
+  # @param base_data [Hash] Payload for base
+  # @see https://airtable.com/developers/web/api/create-base
+  def create_base(base_data)
+    response = self.class.post('/v0/meta/bases',
+                               body: base_data.merge({ workspaceId: @id }).to_json).parsed_response
+
+    check_and_raise_error(response)
+
+    Airtable::Base.new @token, response
+  end
+end

data/lib/airtable.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 require 'httparty'
-require 'delegate'
-require 'active_support/core_ext/hash'
 require 'json'
 
 require 'airtable/version'
@@ -10,5 +8,6 @@ require 'airtable/resource'
 require 'airtable/record'
 require 'airtable/table'
 require 'airtable/base'
+require 'airtable/workspace'
 require 'airtable/client'
 require 'airtable/error'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: airtable2
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Andrew Seroff
@@ -175,11 +175,13 @@ files:
 - lib/airtable/resource.rb
 - lib/airtable/table.rb
 - lib/airtable/version.rb
+- lib/airtable/workspace.rb
 homepage: https://github.com/aseroff/airtable-ruby
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
+  github_repo: ssh://github.com/aseroff/airtable-ruby
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -195,7 +197,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.21
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: For when Airrecord is just too much.