stem-launcher/doc/series.md

Series

Ten dokument opisuje docelowy model komend rvctl do pracy z seriami, kartami pracy i zadaniami w kartach.

Zasada

Komendy kart pracy dzielimy na trzy poziomy:

• series - operacje na serii jako calosci
• series cards - operacje na kartach w ramach serii
• series cards tasks - operacje na zadaniach w ramach karty

Uzywamy pluralnych namespace'ow cards i tasks, bo opisuja kolekcje zasobow i sa spojne z pluralnym tokens.

Szybki Flow

Typowy przeplyw pracy:

./rvctl tokens compare
./rvctl series list
./rvctl series show inf
./rvctl series fetch inf
./rvctl series cards list inf
./rvctl series cards show inf 03
./rvctl series cards tasks list inf 03
./rvctl series cards tasks show inf 03 task1
./rvctl series cards fetch inf 03
./rvctl series cards submission inf 03 --class 4i --nick u1

Serie

series list

Listuje dostepne serie w workspace.

./rvctl series list

Przykladowy wynik:

series  cards  workspace
------  -----  -------------------------------
inf     12     ~/dev/workspace/rv/series/inf

series show SERIES

Pokazuje informacje o serii jako calosci.

./rvctl series show inf

Typowe pola:

series          inf
workspace_path  ~/dev/workspace/rv/series/inf
source_path     ~/dev/edu/repos/rv/series/inf
cards_count     12
cards           01 02 03 ...

series fetch SERIES

Pobiera albo aktualizuje cala serie w workspace.

./rvctl series fetch inf

Ta komenda pracuje na wszystkich kartach w serii. Do pobrania jednej karty sluzy series cards fetch.

Karty

series cards list SERIES

Listuje karty w wybranej serii.

./rvctl series cards list inf

Przykladowy wynik:

series  card  repo
------  ----  ------------------------------------
inf     03    lab-rv32i-strlen-bss-data-stack

series cards show SERIES CARD

Pokazuje informacje o konkretnej karcie.

./rvctl series cards show inf 03

Typowe pola:

series          inf
card            03
workspace_path  ~/dev/workspace/rv/series/inf/03
source_path     ~/dev/edu/repos/rv/series/inf/03
source_repo     edu-inf/lab-rv32i-strlen-bss-data-stack
source_remote   r1
answer_remote   a1
tasks           task1 task2 ...

series cards fetch SERIES CARD

Pobiera albo aktualizuje jedna karte w workspace.

./rvctl series cards fetch inf 03

series cards submission SERIES CARD

Pokazuje albo stosuje konfiguracje repo odpowiedzi dla karty.

./rvctl series cards submission inf 03 --class 4i --nick u1
./rvctl series cards submission inf 03 --class 4i --nick u1 --apply

Bez --apply komenda tylko pokazuje plan. Z --apply ustawia remotes potrzebne do pracy z repo odpowiedzi.

Zadania W Karcie

Zadania sa czescia karty, dlatego trzymamy je pod series cards tasks.

series cards tasks list SERIES CARD

Listuje zadania dostepne w konkretnej karcie.

./rvctl series cards tasks list inf 03

Przykladowy wynik:

series  card  task   path
------  ----  -----  --------------------------------------
inf     03    task1  ~/dev/workspace/rv/series/inf/03/task1
inf     03    task2  ~/dev/workspace/rv/series/inf/03/task2

series cards tasks show SERIES CARD TASK

Pokazuje informacje o konkretnym zadaniu w karcie.

./rvctl series cards tasks show inf 03 task1

Typowe pola:

series          inf
card            03
task            task1
workspace_path  ~/dev/workspace/rv/series/inf/03/task1
card_path       ~/dev/workspace/rv/series/inf/03

Na tym poziomie nie wprowadzamy osobnego fetch: zadania sa pobierane razem z karta przez series cards fetch albo razem z cala seria przez series fetch.

Aliasowanie Starych Komend

Stare komendy mozna zostawic jako aliasy kompatybilnosci:

list-series                         -> series list
list-cards inf                      -> series cards list inf
submission inf 03 --class K --nick N -> series cards submission inf 03 --class K --nick N

Komendy series cards tasks ... nie maja starego odpowiednika i powinny byc wprowadzane tylko w nowym namespace.

Dokumentacja i nowe przyklady powinny promowac namespace series.