History

Rodolphe Marques c91eff70e5 Feat/960/test mongodb queries (#1030 ) * Created tests to mongodb queries Small fix to queries * cleanup pytest markers		2017-01-10 16:49:30 +01:00
..
mongodb	Feat/960/test mongodb queries (#1030 )	2017-01-10 16:49:30 +01:00
rethinkdb	Rename any util.py to utils.py (#991 )	2016-12-22 17:39:39 +01:00
README.md	Abstract db layer cherrypick docs (#932 )	2016-12-12 18:28:43 +01:00
__init__.py	Initial implementation of the changefeed abstraction	2016-12-13 11:14:25 +01:00
changefeed.py	fixed typo	2016-12-14 13:28:37 +01:00
connection.py	config changes	2016-12-16 12:18:41 +01:00
query.py	Tx ID as Asset ID (#926 )	2016-12-20 17:28:15 +01:00
schema.py	Add a bit of logging	2016-12-13 11:59:57 +01:00
utils.py	Generalize naming of module dispatch decorator factory	2016-12-12 15:48:48 +01:00

README.md

Backend Interfaces

Structure

changefeed.py: Changefeed-related interfaces
connection.py: Database connection-related interfaces
query.py: Database query-related interfaces, dispatched through single-dispatch
schema.py: Database setup and schema-related interfaces, dispatched through single-dispatch

Built-in implementations (e.g. RethinkDB's) are provided in sub-directories and have their connection type's location exposed as BACKENDS in connection.py.

Single-Dispatched Interfaces

The architecture of this module is based heavily upon Python's newly-introduced single-dispatch generic functions. Single-dispatch is convenient, because it allows Python, rather than something we design ourselves, to manage the dispatching of generic functions based on certain conditions being met (e.g. the database backend to use).

To see what this looks like in BigchainDB, first note that our backend interfaces have been configured to dispatch based on a backend's connection type.

Call bigchaindb.backend.connect() to create an instance of a Connection:

from bigchaindb.backend import connect
connection = connect()  # By default, uses the current configuration for backend, host, port, etc.

Then, we can call a backend function by directly calling its interface:

from bigchaindb.backend import query
query.write_transaction(connection, ...)

Notice that we don't need to care about which backend implementation to use or how to access it. Code can simply call the base interface function with a Connection instance, and single-dispatch will handle routing the call to the actual implementation.

BigchainDB will load and register the configured backend's implementation automatically (see bigchaindb.backend.connect()), so you should always just be able to call an interface function if you have a Connection instance. A few helper utilities (see backend/utils.py) are also provided to make registering new backend implementations easier.