motorodm

An ODM for motor.


Keywords
motor, odm, mongo
License
Apache-2.0
Install
pip install motorodm==0.0.9

Documentation

motorodm

A python object document mapper for MongoDB using the asyncio motor package

Installation

Install directly from git with:

pip install git+git://github.com/rob-blackbourn/motorodm

or

pip install https+git://github.com/rob-blackbourn/motorodm

Testing

The project uses pytest, so the usual pytest commands work:

(venv) ~/motorodm$ pip install -r requirements_dev.txt
(venv) ~/motorodm$ pytest

Some markers have been setup

  • unit
  • integration
  • regression

So to run all unit test the following would work:

(venv) ~/motorodm$ pytest -v -m unit

The test framework has been integrated with setup.py, so the following also works

(venv) ~/motorodm$ python setup.py test
(venv) ~/motorodm$ python setup.py test --addopts '-v -m unit'

There is a docker compose file which will create an environment suitable for integration tests.
This assumes mongo is not already running locally (as it uses the default port) and requires docker and docker-compose.

Uploading
---------
First change the version number in `mototodm/__init__.py`.

Make sure you have a current version of pip, wheel, setuptools, and twine:

```bash
(venv) ~/motorodm$ pip install --upgrade pip wheel setuptools twine

To upload to pypi; make the distribution, then upload. You may need to remove any previous distributions.

(venv) ~/motorodm$ rm -rf dist
(venv) ~/motorodm$ python setup.py sdist bdist_wheel
(venv) ~/motorodm$ twine upload dist/*