Getting Started

The chapter illustrates how to define entities and set up an entity manager.

Define an Entity

First, we define the entity (document) class.

from tori.db.entity import entity

# Alternatively, @entity('name_of_collection') is to set the name of the collection.
@entity
class Character(object):
    def __init__(self, name, team=None):
        self.name = name
        self.team = None

@entity
class Team(Object):
    def __init__(self, name):
        self.name = name

where an entity of class Character automatically has a readable and writable property id which can be set only once.

Warning

It is not recommended to the ID manually. Leave setting the ID to the backend database.

Define the Entity Manager

Then, define the entity manager.

from tori.db.manager import ManagerFactory

manager_factory = ManagerFactory()
manager_factory.set('ff_game', 'mongodb://db_host/db_name')

entity_manager = manager_factory.get('ff_game')