[Teachers-GitLab] Novinky ve verzi 0.3.0

[Vojtech Horky]

Dobrý den, ahoj,

posílám stručný souhrn novinek v teachers-gitlabu za poslední cca rok.

TL;DR

- Instalace pomocí pip install teachers-gitlab.
- Dokumentace na https://teachers-gitlab.rtfd.io/
- Nový příkaz create-group
- Nové testy a vylepšení v kódu
- Hlášení chyb přes issues


Největší novinkou je, že teachers-gitlab je nově dostupný na PyPI [1], 
což by mělo (doufám) všem zjednodušit instalaci. Nově by mělo stačit 
spustit jen následující příkaz pro instalaci poslední verze.

pip install teachers-gitlab

Doporučuji i nadále instalovat uvnitř virtual environmentu (kvůli 
izolaci vůči zbytku systému), ale není již nutné klonovat hlavní 
repozitář. Po instalaci je k dispozici příkaz teachers-gitlab.

[1] https://pypi.org/project/teachers-gitlab/


Dokumentace je sice i nadále slabším místem programu, ale nově je teď 
alespoň na webu read-the-docs a je tak i trochu jednodušší ji upravovat 
a doplňovat. Nově jsou v ní tři krátké návody [3]: pro získání API 
tokenu, jak strukturujeme repozitáře pro jednotlivé předměty a jak 
získat rozumné (tj. platné) CSV se seznamem zapsaných studentů ze SISu.

[2] https://teachers-gitlab.readthedocs.io/how-to/


GitLab nově umí vytvořit i skupinu příkazem create-group [3], což se 
může hodit těm, kdo potřebují podskupiny pro jednotlivé cvičící (název i 
cestu skupiny lze poskládat ze sloupečků v CSV).

[3] https://teachers-gitlab.readthedocs.io/commands/#create-group


Co se týče vnitřností, tak jsme přidali přes léto automatické testy 
(nejsem s nimi zatím úplně 100% spokojený, ale alespoň něco máme), 
opravili pár drobností v kódu a dost činností zautomatizovali.


Pokud narazíte na něco nefunkčního, prosím, ozvěte se. Stejně tak pokud 
byste chtěli nějakou novou funkci. Neslibuji řešení do druhého dne, ale 
zkusím se na to podívat co nejdřív. Klidně rovnou vytvořte issue na MFF 
GitLabu [4] nebo na GitHub [5] nebo mi napište e-mail.

[4] https://gitlab.mff.cuni.cz/teaching/utils/teachers-gitlab
[5] https://github.com/d-iii-s/teachers-gitlab


Děkuji, s přáním veselého forkování,
- Vojtěch Horký