Function get_or_create_practice_session

backend/src/flashcards/services.py:250–279

(
    session: Session, collection_id: uuid.UUID, user_id: uuid.UUID
)

def get_or_create_practice_session(
    session: Session, collection_id: uuid.UUID, user_id: uuid.UUID
) -> PracticeSession:
    existing_session = _get_uncompleted_session(session, collection_id, user_id)
    if existing_session:
        if existing_session.cards_practiced == 0:
            session.delete(existing_session)
            session.commit()
        else:
            return existing_session

    cards = _get_collection_cards(session, collection_id)
    if not cards:
        raise EmptyCollectionError(
            "Cannot create practice session for empty collection"
        )

    practice_session = PracticeSession(
        collection_id=collection_id,
        user_id=user_id,
        total_cards=len(cards),
    )
    session.add(practice_session)
    session.flush()

    _create_practice_cards(session, practice_session, cards)

    session.commit()
    session.refresh(practice_session)
    return practice_session


def get_practice_cards(