Added new dump for mock testing

Airtable.ipynb

@@ -2,16 +2,14 @@
  "cells": [
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 1,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "<Airtable table:TABLE READ>\n",
-      "The autoreload extension is already loaded. To reload it, use:\n",
-      "  %reload_ext autoreload\n"
+      "<Airtable table:TABLE READ>\n"
      ]
     }
    ],
@@ -35,7 +33,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": 2,
    "metadata": {},
    "outputs": [
     {
@@ -90,15 +88,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 5,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Found!\n",
-      "[{'id': 'rec5eR7IzKSAOBHCz', 'fields': {'COLUMN_STR': 'DUPLICATE', 'COLUMN_ID': '3'}, 'createdTime': '2017-08-05T21:47:52.000Z'}]\n"
+      "[{'fields': {'COLUMN_ID': 3, 'COLUMN_STR': 'DUPLICATE'}, 'id': 'rec5eR7IzKSAOBHCz', 'createdTime': '2017-08-05T21:47:52.000Z'}]\n"
      ]
     }
    ],

HISTORY.md

@@ -1,7 +1,8 @@
 # 0.8.0
 * Docs: New Documentation on Parameter filters Docs
 * Docs: More documentation and examples.
-
+* Feature: Search now uses filterByFormula
+* Added Formula Generator
 
 # 0.7.3
 * Removed Unencoded Debug Msg due to IronPython Bug #242

airtable/airtable.py

@@ -152,8 +152,29 @@ def record_url(self, record_id):
 
     def _request(self, method, url, params=None, json_data=None):
         response = self.session.request(method, url, params=params, json=json_data)
+        # self._dump_request_data(response)
         return self._process_response(response)
 
+    # def _dump_request_data(self, response):
+    #     """ For Debugging """
+    #     timestamp = str(time.time()).split('.')[-1]
+    #     url = response.request.url
+    #     method = response.request.method
+    #     response_json = response.json()
+    #     status = response.status_code
+    #     filepath = os.path.join('tests', 'dump', '{}-{}_{}.json'.format(
+    #                                                                 method,
+    #                                                                 status,
+    #                                                                 timestamp))
+    #     dump = {
+    #             'url': url,
+    #             'method': method,
+    #             'response_json': response_json,
+    #             }
+    #     with open(filepath, 'w') as fp:
+    #         json.dump(dump, fp, indent=4)
+
+
     def _get(self, url, **params):
         processed_params = self._process_params(params)
         return self._request('get', url, params=processed_params)
@@ -282,8 +303,7 @@ def match(self, field_name, field_value, **options):
         Returns:
             record (``dict``): First record to match the field_value provided
         """
-        formula = "{{{name}}}={value}".format(name=field_name,
-                                              value=field_value)
+        formula = self.formula_from_name_and_value(field_name, field_value)
         options['formula'] = formula
         for record in self.get_all(**options):
             return record
@@ -316,13 +336,9 @@ def search(self, field_name, field_value, record=None, **options):
 
         """
         records = []
-        formula = "{{{name}}}={value}".format(name=field_name,
-                                              value=field_value)
+        formula = self.formula_from_name_and_value(field_name, field_value)
         options['formula'] = formula
-
-        for record in self.get_all(**options):
-            if record.get('fields', {}).get(field_name) == field_value:
-                records.append(record)
+        records = self.get_all(**options)
         return records
 
     def insert(self, fields):
@@ -551,5 +567,15 @@ def mirror(self, records, **options):
         new_records = self.batch_insert(records)
         return (new_records, deleted_records)
 
+    @staticmethod
+    def formula_from_name_and_value(field_name, field_value):
+        """ Creates a formula to match cells from from field_name and value """
+        if isinstance(field_value, str):
+            field_value = "'{}'".format(field_value)
+
+        formula = "{{{name}}}={value}".format(name=field_name,
+                                              value=field_value)
+        return formula
+
     def __repr__(self):
         return '<Airtable table:{}>'.format(self.table_name)

tests/dump/DELETE-200_215193.json

@@ -0,0 +1,8 @@
+{
+    "url": "https://api.airtable.com/v0/appJMY16gZDQrMWpA/TABLE%20WRITE/reclIoucZv0XVI56B",
+    "method": "DELETE",
+    "response_json": {
+        "deleted": true,
+        "id": "reclIoucZv0XVI56B"
+    }
+}

tests/dump/GET-200_0081942.json

@@ -0,0 +1,17 @@
+{
+    "url": "https://api.airtable.com/v0/appJMY16gZDQrMWpA/TABLE%20READ?view=ViewAll&maxRecords=1",
+    "method": "GET",
+    "response_json": {
+        "records": [
+            {
+                "createdTime": "2017-03-14T22:04:31.000Z",
+                "fields": {
+                    "COLUMN_ID": "1",
+                    "COLUMN_STR": "UNIQUE",
+                    "COLUMN_UPDATE": "A"
+                },
+                "id": "recwPQIfs4wKPyc9D"
+            }
+        ]
+    }
+}

tests/dump/GET-200_0262082.json

@@ -0,0 +1,15 @@
+{
+    "url": "https://api.airtable.com/v0/appJMY16gZDQrMWpA/TABLE%20READ?fields%5B%5D=COLUMN_UPDATE&view=ViewAll&maxRecords=1",
+    "method": "GET",
+    "response_json": {
+        "records": [
+            {
+                "createdTime": "2017-03-14T22:04:31.000Z",
+                "fields": {
+                    "COLUMN_UPDATE": "A"
+                },
+                "id": "recwPQIfs4wKPyc9D"
+            }
+        ]
+    }
+}

tests/dump/GET-200_0466983.json

@@ -0,0 +1,17 @@
+{
+    "url": "https://api.airtable.com/v0/appJMY16gZDQrMWpA/TABLE%20READ?view=ViewAll&maxRecords=1",
+    "method": "GET",
+    "response_json": {
+        "records": [
+            {
+                "createdTime": "2017-03-14T22:04:31.000Z",
+                "fields": {
+                    "COLUMN_ID": "1",
+                    "COLUMN_STR": "UNIQUE",
+                    "COLUMN_UPDATE": "B"
+                },
+                "id": "recwPQIfs4wKPyc9D"
+            }
+        ]
+    }
+}