Browse Source

updated README

master
Vašek Šraier 6 years ago
parent
commit
798681c47c
  1. 16
      README.md

16
README.md

@ -5,9 +5,10 @@ Určeno pro registraci organizátorů seminářů na MFF UK.
## Build ## Build
Build má následující závislosti: Build má následující závislosti:
* pipenv * [Pipenv](https://pipenv.readthedocs.io/en/latest/)
Spouští se prostým zavoláním `pipenv sync` Po každém `git pull` je potřeba zavolat `pipenv sync`. Tím se sesynchronizují závislosti a všude se pak používají
správné verze.
## Spouštění ## Spouštění
@ -17,8 +18,10 @@ Vyžaduje Python 3.5 a novější.
pipenv run python register.py --help pipenv run python register.py --help
``` ```
Zbytek by měl být samovysvětlující. Stačí vyměnit argumenty dle nápovědy z `--help`. ## Použití
Snaha je, aby se co nejvíce dokumentace nacházelo v kódu. Vysvětlení proto získáte zavoláním programu s argumentem
`--help`. Žádné další informace by k tomu neměly být potřeba.
## Dokumentace API Gitei ## Dokumentace API Gitei
@ -26,3 +29,10 @@ Gitea má specifikaci API popsanou dle specifikace OpenAPI 2.0 (dříve nazývá
jinak, je tato specifikace vystavena na každé běžící instanci a to na cestě `/api/swagger`. Přesněji, na této cestě je jinak, je tato specifikace vystavena na každé běžící instanci a to na cestě `/api/swagger`. Přesněji, na této cestě je
standardní vygenerovaný webový interface ke specifikaci. Specifikace samotná se nachází (alespoň v době psaní) na cestě standardní vygenerovaný webový interface ke specifikaci. Specifikace samotná se nachází (alespoň v době psaní) na cestě
`/swagger.v1.json`. `/swagger.v1.json`.
K tomuto API je vygenerován klient aktuálně se nacházející
[zde](https://gitea-gimli.kam.mff.cuni.cz/vasek/gitea-swagger-client). Kód je v podstatě čistě vygenerovaný nástrojem
`swagger-codegen` (link v repozitáři s klientem). Obsahuje akorát dva drobné patche, protože bez nich vůbec nejde
naimportovat.
`Pipenv` si z tohoto repozitáře stáhne kód a používá ho jako knihovnu.
Loading…
Cancel
Save