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.