Smart Objects
Project description
SmartObject
SmartObject is a library to easily manipulate object attributes with the API commands, store and synchronize object data.
Mapped object attributes (called properties) can be automatically validated, saved, loaded, serialized and synchronized with the external services.
SmartObject looks like ORM, but it's different from ORM: object properties can be stored in storages of different type and combined together into a single data object.
SmartObject has built-in storage engines for files (JSON, YAML, MessagePack and CBOR) and databases: RDBMS via SQLAlchemy (can store objects) and Redis (can handle external properties only).
Property values are automatically processed, validated and synchronized with external services if required.
Note: all SmartObject methods are thread-safe (at least they should be :)
Example:
You have a team of people with heart-rate sensors. Data for each person is stored into local JSON files, heartbeat is stored in Redis database. How to implement this with SmartObject? Just a few lines of code:
import smartobject
class Person(smartobject.SmartObject):
def __init__(self, name):
self.name = name
self.load_property_map('person.yml')
self.apply_property_map()
smartobject.config.storage_dir = 'data'
smartobject.define_storage(smartobject.JSONStorage())
smartobject.define_storage(smartobject.RedisStorage(), 'r1')
people = smartobject.SmartObjectFactory(Person)
# create objects with factory
people.create(name='John')
people.create(name='Jane')
# create object manually
jack = Person('Jack')
# you can set a single prop
people.set_prop('John', 'sex', 'male')
people.set_prop('Jane', 'sex', 'female')
from pprint import pprint
pprint(people.serialize('Jane'))
# or multiple props with dict
jack.set_prop({ 'sex': 'male' })
people.save()
jack.save()
# clear Jack's sex
jack.set_prop('sex', None)
# load it back
jack.load()
# add Jack to factory
people.create(obj=jack)
# set Jack's heartbeat
jack.heartbeat = 100
# but consider heartbeat is collected to Redis via external service
print('Heartbeat of Jack is: {}'.format(people.get('Jack').heartbeat))
The file person.yml is a property map for the Person object. It can be loaded from the external YAML file or specified directly, as Python dict.
The map for the above example looks like:
name:
pk: true
sex:
type: str
choices:
- null
- male
- female
store: true
heartbeat:
type: float
external: true
store: r1
Pretty simple, isn't it? You define a map, SmartObject does the job!
Install
pip3 install smartobject
Documentation
Full documentation is available at https://smartobject.readthedocs.io/
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.