Metadata-Version: 2.1
Name: relationaldb
Version: 0.1.0
Summary: Python library to create databases
Home-page: https://github.com/nazime/relationaldb
Author: Nazime LAKEHAL
Author-email: nazime.lkh@gmail.com
Maintainer: Nazime LAKEHAL
Maintainer-email: nazime.lkh@gmail.com
License: MIT
Project-URL: Documentation, https://relationaldb.readthedocs.org/
Project-URL: Bug Tracker, https://github.com/nazime/relationaldb/issues
Project-URL: Source Code, https://github.com/nazime/relationaldb
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: codeg
Requires-Dist: attrs
Requires-Dist: pymongo
Requires-Dist: jinja2
Provides-Extra: dev
Requires-Dist: coverage ; extra == 'dev'
Requires-Dist: hypothesis ; extra == 'dev'
Requires-Dist: pytest (>=4.3.0) ; extra == 'dev'
Requires-Dist: coloring ; extra == 'dev'
Requires-Dist: sphinx ; extra == 'dev'
Requires-Dist: sphinx-rtd-theme ; extra == 'dev'
Requires-Dist: sphinxcontrib.napoleon ; extra == 'dev'
Requires-Dist: pre-commit ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
Requires-Dist: sphinxcontrib.napoleon ; extra == 'docs'
Provides-Extra: tests
Requires-Dist: coverage ; extra == 'tests'
Requires-Dist: hypothesis ; extra == 'tests'
Requires-Dist: pytest (>=4.3.0) ; extra == 'tests'
Requires-Dist: coloring ; extra == 'tests'
Provides-Extra: travis
Requires-Dist: coverage ; extra == 'travis'
Requires-Dist: hypothesis ; extra == 'travis'
Requires-Dist: pytest (>=4.3.0) ; extra == 'travis'
Requires-Dist: coloring ; extra == 'travis'
Requires-Dist: sphinx ; extra == 'travis'
Requires-Dist: sphinx-rtd-theme ; extra == 'travis'
Requires-Dist: sphinxcontrib.napoleon ; extra == 'travis'
Requires-Dist: pre-commit ; extra == 'travis'
Requires-Dist: tox ; extra == 'travis'
Requires-Dist: codecov ; extra == 'travis'

[![Pypi version](https://img.shields.io/pypi/v/relationaldb.svg)](https://pypi.org/project/relationaldb/) [![Python versions](https://img.shields.io/pypi/pyversions/relationaldb.svg)](https://pypi.org/project/relationaldb/) [![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

-----------------

# relationaldb

RelationalDB is a python ODM library for MongoDB that allows you to design collections like you do it for your normal dataclasses objects.

**DISCLAMER**

This library is in alpha-release, it's a work in progress for the moment, excellent libraries for MongoDB ODM in python exist:

- https://github.com/roman-right/beanie/

There are a lot of none implemented main features (I implement them when I have time or when I need it for my project).

# Quickstart

relationaldb wraps `attrs` to create classes boilerplate and add few parameters.

## One to Many relation

Let's say you want a simple one to many relations, with two entities: Animal and Person.

- Each animal can have one owner (Person)
- Each person can have 0 to many animals

```python
from relationaldb import conception

# Object to design the architecture of the database
c = conception()


# Add collection woth 'define' like with attrs
@c.define
class Person:
    # add new attribute with 'field' method
    # in_filter_query parameter allows to use the 'db.Person.feed' method to upsert new documents
    name: str = c.field(in_filter_query=True)

    # all attrs.fields parameters are available
    money: int = c.field(kw_only=True, default=0)
    birth_year: int = c.field(kw_only=True, default=None)


@c.define
class Animal:
    # We can reference
    name: Person = c.field(in_filter_query=True)

    owner: Person = c.field(kw_only=True, default=None)
    birth_year: int = c.field(kw_only=True, default=None)


# Create a new mongodb named "mydb"
db = c.mongodb("relationaldb_mydb_01")

# Create second DB with same architecture
db2 = c.mongodb("relationaldb_mydb_02")

# Create a new person
db.Person.insert_one("John")

# Get the person
person = db.Person.first()
assert isinstance(person, Person)
assert person.name == "John"

for person in db.Person:
    print(person)

# Upsert (create or update) person named 'Smith' if it does not exists (based on in_filter_query)
db.Person.feed("Smith")  # will create the person
db.Person.feed("Smith")  # will do nothing, person already exist
db.Person.feed("Smith", money=1000)  # will update the person 'Smith'
```


