🐳 Mongo DB BigchainDB driver (Python).
Project description
[![banner](https://raw.githubusercontent.com/oceanprotocol/art/master/github/repo-banner%402x.png)](https://oceanprotocol.com)
# oceandb-mongodb-driver
> 🐳 [Mongo DB](https://www.mongodb.com/) driver for OceanDB (Python).
> [oceanprotocol.com](https://oceanprotocol.com)
[![Travis (.com)](https://img.shields.io/travis/com/oceanprotocol/oceandb-mongodb-driver.svg)](https://travis-ci.com/oceanprotocol/oceandb-mongodb-driver)
[![Codacy coverage](https://img.shields.io/codacy/coverage/6b8d544ca5064cfeb00e679b265f5ac9.svg)](https://app.codacy.com/project/ocean-protocol/oceandb-mongodb-driver/dashboard)
[![PyPI](https://img.shields.io/pypi/v/oceandb-mongodb-driver.svg)](https://pypi.org/project/oceandb-mongodb-driver/)
[![GitHub contributors](https://img.shields.io/github/contributors/oceanprotocol/oceandb-mongodb-driver.svg)](https://github.com/oceanprotocol/oceandb-mongodb-driver/graphs/contributors)
---
## Table of Contents
- [Features](#features)
- [Prerequisites](#prerequisites)
- [Quickstart](#quickstart)
- [Code style](#code-style)
- [Testing](#testing)
- [License](#license)
---
## Features
MongoDB driver to connect implementing OceanDB.
## Prerequisites
You should have running a mongo instance.
## Quickstart
First of all we have to specify where is allocated our config.
To do that we have to pass the following argument:
```
--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
```yaml
[oceandb]
enabled=true # In order to enable or not the plugin
module=mongodb # 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 MongoDB.
db.port=27017 # Port of your Mongodb.
db.username=user # If you are using authentication, mongodb username.
db.password=password # If you are using authentication, mongodb password.
db.name=test # Mongodb database name
db.collection=col # Mongodb collection name
```
Once you have defined this the only thing that you have to do it is use it:
```python
oceandb = OceanDb(conf)
oceandb.write({"value": "test"}, id)
```
## Code style
The information about code style in python is documented in this two links [python-developer-guide](https://github.com/oceanprotocol/dev-ocean/blob/master/doc/development/python-developer-guide.md)
and [python-style-guide](https://github.com/oceanprotocol/dev-ocean/blob/master/doc/development/python-style-guide.md).
## Testing
Automatic tests are setup via Travis, executing `tox`.
Our test use pytest framework.
## License
```
Copyright 2018 Ocean Protocol Foundation Ltd.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
# oceandb-mongodb-driver
> 🐳 [Mongo DB](https://www.mongodb.com/) driver for OceanDB (Python).
> [oceanprotocol.com](https://oceanprotocol.com)
[![Travis (.com)](https://img.shields.io/travis/com/oceanprotocol/oceandb-mongodb-driver.svg)](https://travis-ci.com/oceanprotocol/oceandb-mongodb-driver)
[![Codacy coverage](https://img.shields.io/codacy/coverage/6b8d544ca5064cfeb00e679b265f5ac9.svg)](https://app.codacy.com/project/ocean-protocol/oceandb-mongodb-driver/dashboard)
[![PyPI](https://img.shields.io/pypi/v/oceandb-mongodb-driver.svg)](https://pypi.org/project/oceandb-mongodb-driver/)
[![GitHub contributors](https://img.shields.io/github/contributors/oceanprotocol/oceandb-mongodb-driver.svg)](https://github.com/oceanprotocol/oceandb-mongodb-driver/graphs/contributors)
---
## Table of Contents
- [Features](#features)
- [Prerequisites](#prerequisites)
- [Quickstart](#quickstart)
- [Code style](#code-style)
- [Testing](#testing)
- [License](#license)
---
## Features
MongoDB driver to connect implementing OceanDB.
## Prerequisites
You should have running a mongo instance.
## Quickstart
First of all we have to specify where is allocated our config.
To do that we have to pass the following argument:
```
--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
```yaml
[oceandb]
enabled=true # In order to enable or not the plugin
module=mongodb # 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 MongoDB.
db.port=27017 # Port of your Mongodb.
db.username=user # If you are using authentication, mongodb username.
db.password=password # If you are using authentication, mongodb password.
db.name=test # Mongodb database name
db.collection=col # Mongodb collection name
```
Once you have defined this the only thing that you have to do it is use it:
```python
oceandb = OceanDb(conf)
oceandb.write({"value": "test"}, id)
```
## Code style
The information about code style in python is documented in this two links [python-developer-guide](https://github.com/oceanprotocol/dev-ocean/blob/master/doc/development/python-developer-guide.md)
and [python-style-guide](https://github.com/oceanprotocol/dev-ocean/blob/master/doc/development/python-style-guide.md).
## Testing
Automatic tests are setup via Travis, executing `tox`.
Our test use pytest framework.
## License
```
Copyright 2018 Ocean Protocol Foundation Ltd.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
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-mongodb-driver-0.1.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b5b1d7bc69f5fdd7237a5d725356cae5b73119382fc519197c7986d8df2afddb |
|
MD5 | 136080b26d58de9b60ccd8ab2e6c9861 |
|
BLAKE2b-256 | 970d5a01b213eb8530e881322d17a0a3bf708d1994dc26518047858871c0fd2a |
Close
Hashes for oceandb_mongodb_driver-0.1.1-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8752467ee23535dac5e2b339dff84bb48f1f89209f4743493b360313a3143abe |
|
MD5 | 0968a76f3bf002fe3b26fbde68d37a82 |
|
BLAKE2b-256 | a23c2a5a364356176a5d5ab02d2533a7364e5a4f1719f0841a2c6e42362705e0 |