Tirsvad
8dbaaa3059
Review record RC-027 (Go, autonomous mode, not independent). Task: MIL-005#1 Task: MIL-005#2 Task: MIL-005#3 Task: MIL-005#4 Task: MIL-005#5
34 lines
1.3 KiB
Python
34 lines
1.3 KiB
Python
"""Start a study session.
|
|
|
|
@file open_study_session.py
|
|
@brief The open_study_session use case.
|
|
"""
|
|
|
|
from collections.abc import Callable, Sequence
|
|
|
|
from flash_card.application.use_cases.study_session import StudySession
|
|
from flash_card.domain.entities.card import Card
|
|
from flash_card.domain.entities.deck import Deck
|
|
from flash_card.domain.repositories.progress_repository import ProgressRepository
|
|
from flash_card.domain.repositories.vocabulary_repository import VocabularyRepository
|
|
|
|
|
|
def open_study_session(
|
|
vocabulary_repository: VocabularyRepository,
|
|
progress_repository: ProgressRepository,
|
|
choose: Callable[[Sequence[Card]], Card],
|
|
) -> StudySession:
|
|
"""Build a session over the saved words to learn, else the whole word list.
|
|
|
|
@param vocabulary_repository Source of the delivered word list.
|
|
@param progress_repository Store of the words still to learn.
|
|
@param choose Picks one card from a non-empty sequence.
|
|
@return The new session.
|
|
@throws VocabularyError When the saved progress, or the word list when no
|
|
progress exists, cannot be loaded.
|
|
"""
|
|
deck = progress_repository.load()
|
|
if deck is None:
|
|
deck = Deck.from_vocabulary(vocabulary_repository.load())
|
|
return StudySession(deck, choose, progress_repository)
|