A fork of sqlalchemy-mixins for starlette, especially fastapi.

Features added by scil

• refactor sqlalchemy_mixins API by adding db argument, e.g. def first(cls, db) instead of def first(cls)
• API for fastapi
  • create_from_schema. save a new line from schema.
  • init_from_schema only create a new object from schema, not saved into db yet.
• paginate. Powered by exhuma/sqlalchemy-paginator@integration. I am considerring djrobstep/sqlakeyset which is updated recently.

Example

# base_class.py

from sqlalchemy_mixins import AllFeaturesMixin as SimpleBase  # noqa

class Base(SimpleBase):
    __abstract__ = True

    # Default auto incrementing primary key field
    # overwrite as needed
    id = sa.Column(sa.Integer, primary_key=True)

    @declared_attr
    def __tablename__(cls) -> str:
        return cls.__name__.lower()

    def __str__(self):
        return self.__repr__()

# app/models/item.py

from app.db import Base

class Item(Base):
    title = Column(sa.String, index=True)
    description = Column(sa.String, index=True)
    owner_id = Column(sa.Integer, ForeignKey("user.id"))
    owner = relationship("User", back_populates="items")

# app/models/user.py
class User(Base):
    ...

use

# app/api/api_v1/endpoints/items.py

@router.post("/", response_model=schemas.ItemResponse)
def create_item(
        *,
        db: Session = Depends(deps.get_db),
        item_in: schemas.ItemCreate,
        current_user: models.User = Depends(deps.get_current_active_user),
) -> Any:
    """
    Create new item.
    """
    return models.Item.create_from_schema(db, item_in, {'owner_id':current_user.id})


# app/api/deps.py

def get_current_user(
    db: Session = Depends(deps.get_db),
    token: str = Depends(reusable_oauth2)
) -> models.User:
    token_data = ...

    # old-style: user = crud.user.get(db, user_id=token_data.user_id)
    user = models.User.find(db, token_data.sub)
    ...

About accent-starlette/starlette-core

Old version v2 based on accent-starlette/starlette-core

Main unique feature: no need to pass argument db, as it uses customize session instead of session provided by fastapi:

user = User()
user.save() # use starlette_core session
user.db(my_db)
user.save() # use my_db
user.db(None)
user.save() # use starlette_core session

User.create_from_schema(user_in, my_db) # use my_db

SQLAlchemy mixins

see full docs in origian absent1706/sqlalchemy-mixins