New performance guarantee for multiple records

.editorconfig

@@ -0,0 +1,21 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+# 4 space indentation
+[*.py]
+indent_style = space
+indent_size = 4
+charset = utf-8
+trim_trailing_whitespace = true
+
+# Matches the exact files either package.json or .travis.yml
+[*.yml]
+indent_style = space
+indent_size = 2

.envrc

@@ -0,0 +1,7 @@
+# Adds the bin directory to the environment
+PATH_add bin
+
+# Source the necessary environment for all users
+set -o allexport
+source .env
+set +o allexport

.gitignore

@@ -1,3 +1,7 @@
+build/
+dist/
+docs/build
+
 .DS_store
 .eggs
 .tox
@@ -6,7 +10,13 @@
 *.pyc
 .pytest_cache
 .mypy_cache\
-.env
 .cache
-*.todo
-mypy.ini
+coverage.xml
+.coverage
+
+.env
+.vscode
+.venv
+.python-version
+
+test.py

.travis.yml

@@ -0,0 +1,19 @@
+dist: bionic
+language: python
+git:
+  depth: 2
+python:
+  - "3.7"
+  - "3.8"
+matrix:
+  include:
+    python: "3.7"
+    env: TOXENV=lint
+install:
+  - pip install .
+  - pip install tox tox-travis
+script: tox
+after_success:
+  - pip install pytest pytest-asyncio aiohttp coveralls
+  - coverage run --source=airbase setup.py test
+  - coveralls

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 Luis Felipe Paris
+Copyright (c) 2022 Luis Felipe Paris
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

MANIFEST.in

@@ -0,0 +1,2 @@
+include LICENSE
+include README.md

Makefile

@@ -0,0 +1,32 @@
+# Colours
+NC=\033[0m\n
+HIGHLIGHT=\033[91m
+
+## usage: print useful commands
+usage:
+	@echo "$(HIGHLIGHT)Choose a command: $(PWD) $(NC)"
+	@bash -c "sed -ne 's/^##//p' ./Makefile | column -t -s ':' |  sed -e 's/^/ /'"
+
+## release: Release new version
+release:
+	python setup.py sdist bdist_wheel --universal
+	twine upload ./dist/*
+	make clean
+
+## test: Run tests
+test:
+	tox
+	make clean
+
+## lint: Lint and format
+lint:
+	flake8 .
+	black --line-length 79 --check .
+
+## clean: delete python artifacts
+clean:
+	python -c "import pathlib; [p.unlink() for p in pathlib.Path('.').rglob('*.py[co]')]"
+	python -c "import pathlib; [p.rmdir() for p in pathlib.Path('.').rglob('pytest_cache')]"
+	rm -rdf ./dist
+	rm -rdf ./build
+	rm -rdf  airbase.egg-info

README.md

@@ -1,10 +1,26 @@
-# Airtable Python Wrapper
+# Asynchronous Airtable Python Wrapper
+[![Python 3.7](https://img.shields.io/badge/python-3.7-blue.svg)](https://www.python.org/downloads/release/python-370)
+[![Python 3.8](https://img.shields.io/badge/python-3.8-blue.svg)](https://www.python.org/downloads/release/python-380)
+
+[![PyPI version](https://badge.fury.io/py/airtable-async.svg)](https://badge.fury.io/py/airtable-async)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/airtable-async.svg?label=pypi%20downloads)](https://pypi.org/project/airtable-async/)
+[![Build Status](https://travis-ci.org/lfparis/airbase.svg?branch=master)](https://travis-ci.org/lfparis/airbase)
+[![Coverage Status](https://coveralls.io/repos/github/lfparis/airbase/badge.svg?branch=master)](https://coveralls.io/github/lfparis/airbase?branch=master)
+
+## Installing
+```bash
+pip install airtable-async
+```
+Requirements: Python 3.7+
+
+## Documentation
+*coming soon*
+
+## Example
 
-### Asynchronous
-Requires CPython 3.8
 ```python
 import asyncio
-from airbase import AirtableAsync as Airtable
+from airbase import Airtable
 
 api_key = "your Airtable API key found at https://airtable.com/account"
 base_key = "name or id of a base"
@@ -13,6 +29,7 @@ table_key = "name or id of a table in that base"
 
 async def main() -> None:
     async with Airtable(api_key=api_key) as at:
+        at: Airtable
 
         # Get all bases for a user
         await at.get_bases()
@@ -83,7 +100,7 @@ async def main() -> None:
             "id": "record id",
             "fields": {"field1": "value1", "field2": "value2"},
         }
-        await table.update_record()
+        await table.update_record(record)
         # Update several records in that table
         records = [
             {
@@ -99,142 +116,26 @@ async def main() -> None:
                 "fields": {"field1": "value1", "field2": "value2"},
             },
         ]
-        await table.update_records()
+        await table.update_records(records)
 
         # Delete a record in that table
         record = {
             "id": "record id",
         }
-        await table.delete_record()
+        await table.delete_record(record)
         # Delete several records in that table
         records = [
             {"id": "record id"},
             {"id": "record id"},
             {"id": "record id"},
         ]
-        await table.delete_records()
+        await table.delete_records(records)
 
 
 if __name__ == "__main__":
     asyncio.run(main())
 ```
 
-### Synchronous
-Works in ironpython and cpython 2.7 and beyond
-```python
-from airbase import Airtable
-
-api_key = "your Airtable API key found at https://airtable.com/account"
-base_key = "id of a base"
-table_key = "name of a table in that base"
-
-
-def main() -> None:
-    # NOT IMPLEMENTED - with Airtable(api_key=api_key) as at: 
-    at = Airtable(api_key=api_key)
-
-    # Get all bases for a user
-    at.get_bases()
-
-    # NOT IMPLEMENTED - Get one base by name
-    # base = at.get_base(base_key, key="name")
-    # Get one base by id
-    base = at.get_base(base_key)
-    # NOT IMPLEMENTED - Get one base by either id or name
-    # base = at.get_base(base_key)
-
-    # Base Attributes
-    print(base.id)
-    print(base.name)
-    print(base.permission_level)
-
-    # Set base logging level (debug, info, warning, error, etc)
-    # Default is "info"
-    base.log = "debug"
-
-    # Get all tables for a base
-    base.get_tables()
-
-    # Get one table by name
-    table = base.get_table(table_key)
-    # NOT IMPLEMENTED - Get one table by id
-    # table = at.get_table(table_key, key="id")
-    # NOT IMPLEMENTED - Get one table by either id or name
-    # table = at.get_table(table_key)
-
-    # Base Attributes
-    print(table.base)
-    print(table.name)
-    print(table.id)
-    print(table.primary_field_id)
-    # print(table.primary_field_name)
-    print(table.fields)
-    print(table.views)
-
-    # Get a record in that table
-    table_record = table.get_record("record_id")
-    # Get all records in that table
-    table_records = table.get_records()
-    # NOT IMPLEMENTED - Get all records in a view in that table
-    # view_records = table.get_records(view="view id or name")
-    # Get only certain fields for all records in that table
-    reduced_fields_records = table.get_records(
-        filter_by_fields=["field1, field2"]
-    )
-    # Get all records in that table that pass a formula
-    filtered_records = table.get_records(
-        filter_by_formula="Airtable Formula"
-    )
-
-    # Post a record in that table
-    record = {"fields": {"field1": "value1", "field2": "value2"}}
-    table.post_record(record)
-    # Post several records in that table
-    records = [
-        {"fields": {"field1": "value1", "field2": "value2"}},
-        {"fields": {"field1": "value1", "field2": "value2"}},
-        {"fields": {"field1": "value1", "field2": "value2"}},
-    ]
-    table.post_records(records)
-
-    # Update a record in that table
-    record = {
-        "id": "record id",
-        "fields": {"field1": "value1", "field2": "value2"},
-    }
-    table.update_record()
-    # Update several records in that table
-    records = [
-        {
-            "id": "record id",
-            "fields": {"field1": "value1", "field2": "value2"},
-        },
-        {
-            "id": "record id",
-            "fields": {"field1": "value1", "field2": "value2"},
-        },
-        {
-            "id": "record id",
-            "fields": {"field1": "value1", "field2": "value2"},
-        },
-    ]
-    table.update_records()
-
-    # Delete a record in that table
-    record = {
-        "id": "record id",
-    }
-    table.delete_record()
-    # NOT IMPLEMENTED - Delete several records in that table
-    # records = [
-    #     {"id": "record id"},
-    #     {"id": "record id"},
-    #     {"id": "record id"},
-    # ]
-    # table.delete_records()
-
-
-if __name__ == "__main__":
-    main()
+## License
 
-```
+[MIT](https://opensource.org/licenses/MIT)

airbase/__init__.py

@@ -1,3 +1,2 @@
 from __future__ import absolute_import
 from .airtable import Airtable  # noqa: F401
-from .airtable_async import Airtable as AirtableAsync  # noqa: F401