Skip to content
Persistence API for attr-based Python classes
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Python Entity Framework

Persistence for attr-based Python classes.

WARNING A lot of things here is not yet working, there is some mess. The project is stil in the prototyping phase.


from entity_framework import Entity, Identity, Repository
from entity_framework.storages.sqlalchemy import SqlAlchemyRepo

# Write your business entities in almost-plain Python
class Customer(Entity):
    id: Identity[int]
    full_name: str

# Get abstract base class for repo
CustomerRepo = Repository[Customer, int]  # first argument - entity class, second - Identity field type

# Setup your persistence as usual
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

# Setup registry and get concrete class
from entity_framework.storages.sqlalchemy import SqlAlchemyRepo
from entity_framework.storages.sqlalchemy.registry import SaRegistry

Registry = SaRegistry()

class SaCustomerRepo(SqlAlchemyRepo, CustomerRepo):
    base = Base
    registry = Registry

Voilà. Python Entity Framework will generate SQLAlchemy's model for you. They are properly detected by alembic (yay!) Additionally, SaCustomerRepo will have two methods - save & get to respectively persist and fetch your entity.


Everything is subjected to change, including name of the library and address of this repository. Code inside may be inconsistent and is undergoing significant refactorings all the time.


To get rid of necessity of manual writing code for persisting attr-based business entities AKA aggregates.


  • Support SQLAlchemy with possibilities of overriding implementation partially (e.g. single column definitions) or entirely
  • Use SQLAlchemy's Session as UnitOfWork
  • Optimize code for populating models/entities
  • Support MongoDB with the same set of functionalities as SQLAlchemy storage
You can’t perform that action at this time.