🐳 Ocean DB BigchainDB driver (Python).
Project description
|banner|
.. raw:: html
<h1 align="center">
oceandb-bigchaindb-driver
.. raw:: html
</h1>
..
🐳 Ocean DB `BigchainDB <https://www.bigchaindb.com/>`_ driver (Python).
.. |banner| image:: doc/img/repo-banner@2x.png
:target: https://oceanprotocol.com
.. image:: https://img.shields.io/pypi/v/oceandb-bigchaindb-driver.svg
:target: https://pypi.python.org/pypi/oceandb-bigchaindb-driver
.. image:: https://travis-ci.com/oceanprotocol/oceandb-bigchaindb-driver.svg?token=pA8zcB6SCxKW5MHpqs6L&branch=master
:target: https://travis-ci.com/oceanprotocol/oceandb-bigchaindb-driver
.. image:: https://readthedocs.org/projects/oceandb-plugin-system/badge/?version=latest
:target: https://oceandb-plugin-system.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
BigchainDB driver to connect implementing OceanDB.
* Free software: Apache Software License 2.0
* Documentation: https://oceandb-plugin-system.readthedocs.io.
How to use it
-------------
First of all we have to specify where is allocated our config.
To do that we have to pass the following argument:
.. code-block:: python
--config=/path/of/my/config
..
If you do not provide a configuration path, by default the config is expected in the config folder.
In the configuration we are going to specify the following parameters to
.. code-block:: python
[oceandb]
enabled=true # In order to enable or not the plugin
module=bigchaindb # You can use one the plugins already created. Currently we have mongodb and bigchaindb.
module.path= # You can specify the location of your custom plugin.
db.hostname=localhost # Address of your bigchaindb nodes.
db.port=9985 # Port of your bigchaindb database.
# Bigchaindb specific config:
secret= # A secret that serves as a seed.
db.namespace=namespace # Namespace that you are going to use in bigchaindb
db.app_id= # App id of your bigchaindb application.
db.app_key= # App key of your bigchaindb application.
..
Once you have defined this the only thing that you have to do it is use it:
.. code-block:: python
oceandb = OceanDb(confPath)
tx_id = oceandb.write({"value": "test"}) #Write a new transaction in bdb.
oceandb.read(tx_id) #Read the content of this transaction
oceandb.update({"value": "update"},tx_id) #Update value of the transaction.
oceandb.delete(tx_id) #Delete transaction
..
About BigchainDB plugin implementation
--------------------------------------
CRAB is the CRUD model in databases applied to blockchains:
+--------------+----------------+
| Database | Blockchain |
+==============+================+
| **C**\ reate | **C**\ reate |
+--------------+----------------+
| **R**\ ead | **R**\ etrieve |
+--------------+----------------+
| **U**\ pdate | **A**\ ppend |
+--------------+----------------+
| **D**\ elete | **B**\ urn |
+--------------+----------------+
You can find `here <https://blog.bigchaindb.com/crab-create-retrieve-append-burn-b9f6d111f460>`_ a link talking about the CRAB model.
=======
History
=======
0.1.0 (2018-05-31)
------------------
* First release on PyPI.
.. raw:: html
<h1 align="center">
oceandb-bigchaindb-driver
.. raw:: html
</h1>
..
🐳 Ocean DB `BigchainDB <https://www.bigchaindb.com/>`_ driver (Python).
.. |banner| image:: doc/img/repo-banner@2x.png
:target: https://oceanprotocol.com
.. image:: https://img.shields.io/pypi/v/oceandb-bigchaindb-driver.svg
:target: https://pypi.python.org/pypi/oceandb-bigchaindb-driver
.. image:: https://travis-ci.com/oceanprotocol/oceandb-bigchaindb-driver.svg?token=pA8zcB6SCxKW5MHpqs6L&branch=master
:target: https://travis-ci.com/oceanprotocol/oceandb-bigchaindb-driver
.. image:: https://readthedocs.org/projects/oceandb-plugin-system/badge/?version=latest
:target: https://oceandb-plugin-system.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
BigchainDB driver to connect implementing OceanDB.
* Free software: Apache Software License 2.0
* Documentation: https://oceandb-plugin-system.readthedocs.io.
How to use it
-------------
First of all we have to specify where is allocated our config.
To do that we have to pass the following argument:
.. code-block:: python
--config=/path/of/my/config
..
If you do not provide a configuration path, by default the config is expected in the config folder.
In the configuration we are going to specify the following parameters to
.. code-block:: python
[oceandb]
enabled=true # In order to enable or not the plugin
module=bigchaindb # You can use one the plugins already created. Currently we have mongodb and bigchaindb.
module.path= # You can specify the location of your custom plugin.
db.hostname=localhost # Address of your bigchaindb nodes.
db.port=9985 # Port of your bigchaindb database.
# Bigchaindb specific config:
secret= # A secret that serves as a seed.
db.namespace=namespace # Namespace that you are going to use in bigchaindb
db.app_id= # App id of your bigchaindb application.
db.app_key= # App key of your bigchaindb application.
..
Once you have defined this the only thing that you have to do it is use it:
.. code-block:: python
oceandb = OceanDb(confPath)
tx_id = oceandb.write({"value": "test"}) #Write a new transaction in bdb.
oceandb.read(tx_id) #Read the content of this transaction
oceandb.update({"value": "update"},tx_id) #Update value of the transaction.
oceandb.delete(tx_id) #Delete transaction
..
About BigchainDB plugin implementation
--------------------------------------
CRAB is the CRUD model in databases applied to blockchains:
+--------------+----------------+
| Database | Blockchain |
+==============+================+
| **C**\ reate | **C**\ reate |
+--------------+----------------+
| **R**\ ead | **R**\ etrieve |
+--------------+----------------+
| **U**\ pdate | **A**\ ppend |
+--------------+----------------+
| **D**\ elete | **B**\ urn |
+--------------+----------------+
You can find `here <https://blog.bigchaindb.com/crab-create-retrieve-append-burn-b9f6d111f460>`_ a link talking about the CRAB model.
=======
History
=======
0.1.0 (2018-05-31)
------------------
* First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for oceandb_bigchaindb_driver-0.0.2.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6b6b056e4e91bc8e8185ee4df59ca094bfa64eb9c6c73beca119ebdd8702b4b6 |
|
MD5 | ab764c9bca7c110f096ccda2fac86095 |
|
BLAKE2b-256 | 4868eca47ee003b0f12dd488e4d86269ea9e4d8910c625baea34623e860afe0a |
Close
Hashes for oceandb_bigchaindb_driver-0.0.2.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a8ed44c1b73814c12197886177be8332842e2ea49f092300926bc58e2309b9f2 |
|
MD5 | ad377a2e83a85e3934e686834f5ece44 |
|
BLAKE2b-256 | 0ed740c40d2ff909a5ae4d10bf7f7d9025d4c5bc68d4760424af5cd35ec07f92 |