Skip to main content

simple active record for redis

Project description

Simple active record for redis. Drop-in replacement for CQLEngine

Why

I needed an active record that worked almost as a drop-in replacement for CQLEngine.

Long-story-short I had a project where I originally wrote the db layer usign cassandra, through CQLEngine. It became an overkill and I decided to use redis instead.

There is a pretty good documentation available and more importantly I commited to 100% of unit and functional test coverage. This code is battle ready for production, if you find any bugs in it you can fix within minutes.

That also means that collaboration is easy, just don’t break anything, don’t delete tests and add as test coverage to you collaboration: when fixing a bug, write at least one test to reproduce the problem in an automated way.

If you want a new feature, please feel free to open a ticket and request, someone might make your dreams come true. Better yet, submit a pull request; just please remember to write tests and documentation for your contributions.

Quick Usage

$ pip install repocket

Declare your models

>>> from repocket import attributes
>>> from repocket import ActiveRecord
>>>
>>>
>>> class User(ActiveRecord):
...     name = attributes.Unicode()
...     house_name = attributes.Unicode()
...     email = attributes.Bytes()
...     password = attributes.Bytes()
...     metadata = attributes.JSON()

Persist in redis

>>> import bcrypt

>>> harry = User(
...     id='970773fa-4de1-11e5-86f4-6c4008a70392',
...     name='Harry Potter',
...     email='harry@hogwards.uk',
...     house_name='Gryffindor',
...     password=bcrypt.hashpw(b'hermione42', bcrypt.gensalt(10)),
...     metadata={
...         'known_tricks': [
...             "Protego",
...             "Expelliarmus",
...             "Wingardium Leviosa",
...             "Expecto Patronum"
...         ]
...     }
... )
>>> redis_keys_for_harry = harry.save()
>>>
>>> ron = User.create(
...     id='40997aa4-71fc-4ad3-b0d7-04c0fac6d6d8',
...     name='Ron Weasley',
...     house_name='Gryffindor',
...     email='ron@hogwards.uk',
...     password=bcrypt.hashpw(b'hermione42', bcrypt.gensalt(10)),
...     metadata={
...         'known_tricks': [
...             "Protego",
...             "Expelliarmus",
...         ]
...     }
... )

Query

>>> harry = User.objects.get(id='970773fa-4de1-11e5-86f4-6c4008a70392')
>>> harry.metadata

>>> results = User.objects.filter(house_name='Griffindor')
>>> len(results)
>>> results[0] == harry
True

>>> results[1] == ron
True

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

repocket-0.1.20.tar.gz (8.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page