reobject

KO | EN

gitlite — search

#hacktoberfest #ai #llm #golang #rust #deep-learning #docker #java #awesome #awesome-list #pytorch #security #mcp #openai

(★ 80)

Python without ifs and buts - an ORM layer for Python objects, inspired by Django

reobject Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# reobject

[![Build Status](https://travis-ci.org/onyb/reobject.svg?branch=master)](https://travis-ci.org/onyb/reobject)
[![PyPI version](https://badge.fury.io/py/reobject.svg)](https://badge.fury.io/py/reobject)
[![PyPI](https://img.shields.io/pypi/pyversions/reobject.svg)](https://pypi.python.org/pypi/reobject)
[![codecov](https://codecov.io/gh/onyb/reobject/branch/master/graph/badge.svg)](https://codecov.io/gh/onyb/reobject)

*reobject* is an ORM layer for your objects. It allows you to track and query
objects at runtime using a familiar query langauge inspired by Django ORM.

**Note:** *reobject* is **NOT** a database ORM. It keeps track of regular objects in the memory.

**This is highly experimental code, and not safe for production.**

### Installation

*reobject* supports Python 3 only.

```sh
pip install reobject
```

### Example usage

```py3
from reobject.models import Model, Field

class Book(Model):
    title = Field()
    authors = Field()
    price = Field()

>>> # Create a bunch of objects
>>> Book(title='The C Programming Language', authors=['Kernighan', 'Ritchie'], price=52)
>>> Book(title='The Go Programming Language', authors=['Donovan', 'Kernighan'], price=30)

>>> Book.objects.all()  # All books
[Book(title='The C Programming Language', authors=['Kernighan', 'Ritchie'], price=52),
 Book(title='The Go Programming Language', authors=['Donovan', 'Kernighan'], price=30)]

>>> Book.objects.filter(price__lt=50).values('title')  # Titles of books priced under $50
[{'title': 'The Go Programming Language'}, {'title': 'The C Programming Language'}]

>>> # Titles of books co-authored by Brian Kernighan
>>> Book.objects.filter(authors__contains='Kernighan').values_list('title', flat=True)
['The Go Programming Language', 'The C Programming Language']
```

### Features

* Elegant data-model syntax inspired by Django ORM.
* Class-level model fields, out of the box object protocols, pretty reprs; powered by [attrs](http://attrs.org).
* Advanced query language and chainable querysets. Read the [QuerySet API docs](https://anirudha.co/reobject).
* Transactions. See [example](tests/unit/test_transaction.py#L7-L13).
* Many-to-one model relationships. See [example](tests/unit/test_manager.py#L61-L108)
* [TBA] Attribute indexes for fast lookups.

### Crunching Design Patterns

Note: Some of the examples above may be inaccurate. The idea is to demonstrate what reobject is capable of. Pull requests are most welcome.

### Contributing

Want to help? You can contribute to the project by:

* Using reobject in your projects, finding bugs, and proposing new features.
* Sending pull requests with recipes built using reobject.
* Trying your hand at some [good first bugs](https://github.com/onyb/reobject/issues?q=is%3Aissue+is%3Aopen+label%3Abitesize).
* Improving test coverage, and writing documentation.

reobject

reobject Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

reobject

reobject Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README