Use Polish diacritics in docs
This commit is contained in:
+137
-137
@@ -1,8 +1,8 @@
|
||||
# RVCTL CLI
|
||||
|
||||
Plik opisuje przelaczniki i liste komend skryptu `rvctl`.
|
||||
Plik opisuje przełączniki i listę komend skryptu `rvctl`.
|
||||
|
||||
## Model katalogow
|
||||
## Model katalogów
|
||||
|
||||
Repo oryginalne trzymamy poza workspace:
|
||||
|
||||
@@ -10,13 +10,13 @@ Repo oryginalne trzymamy poza workspace:
|
||||
~/dev/edu/repos/rv
|
||||
```
|
||||
|
||||
Workspace sluzy do klonow roboczych i cwiczen:
|
||||
Workspace służy do klonów roboczych i ćwiczeń:
|
||||
|
||||
```bash
|
||||
~/dev/workspace/rv
|
||||
```
|
||||
|
||||
Typowy uklad:
|
||||
Typowy układ:
|
||||
|
||||
```text
|
||||
~/dev/edu/repos/rv/rv-launcher
|
||||
@@ -29,16 +29,16 @@ Typowy uklad:
|
||||
|
||||
`rvctl` czyta karty z `series_root` w workspace. Tool repo
|
||||
`rv32i-hazard3-env` wybiera najpierw z workspace, a potem z fallbacku
|
||||
`~/dev/edu/repos/rv`, jesli taki klon roboczy jeszcze nie istnieje.
|
||||
`~/dev/edu/repos/rv`, jeśli taki klon roboczy jeszcze nie istnieje.
|
||||
|
||||
Karty pracy tez sa rozdzielone:
|
||||
Karty pracy też są rozdzielone:
|
||||
|
||||
- `original_series_root` wskazuje repo zrodlowe kart, na przyklad `~/dev/edu/repos/rv/series`
|
||||
- `series_root` wskazuje klony testowe w workspace, na przyklad `~/dev/workspace/rv/series`
|
||||
- `original_series_root` wskazuje repo źródłowe kart, na przykład `~/dev/edu/repos/rv/series`
|
||||
- `series_root` wskazuje klony testowe w workspace, na przykład `~/dev/workspace/rv/series`
|
||||
|
||||
Komendy launchera pracuja na `series_root`, czyli na klonach testowych.
|
||||
Komendy launchera pracują na `series_root`, czyli na klonach testowych.
|
||||
|
||||
## Pobranie repo i przelaczenie galezi
|
||||
## Pobranie repo i przełączenie gałęzi
|
||||
|
||||
Repo treningowe launchera trzymaj pod:
|
||||
|
||||
@@ -46,7 +46,7 @@ Repo treningowe launchera trzymaj pod:
|
||||
~/dev/workspace/rv/tools/rv-launcher
|
||||
```
|
||||
|
||||
Podstawowy bootstrap wyglada tak:
|
||||
Podstawowy bootstrap wygląda tak:
|
||||
|
||||
```bash
|
||||
mkdir -p ~/dev/workspace/rv/tools
|
||||
@@ -55,17 +55,17 @@ git clone http://77.90.8.171:3001/edu-tools/rv-launcher.git
|
||||
cd rv-launcher
|
||||
```
|
||||
|
||||
Glowne pliki CLI:
|
||||
Główne pliki CLI:
|
||||
|
||||
```bash
|
||||
./rvctl
|
||||
rvctl.py
|
||||
```
|
||||
|
||||
`rvctl` jest jedynym publicznym entrypointem. `rvctl.py` jest implementacja
|
||||
uruchamiana przez wrapper i nie wymaga osobnego wywolywania przez ucznia.
|
||||
`rvctl` jest jedynym publicznym entrypointem. `rvctl.py` jest implementacją
|
||||
uruchamianą przez wrapper i nie wymaga osobnego wywoływania przez ucznia.
|
||||
|
||||
Uruchomienie bez argumentow pokazuje tabelaryczny skrot komend:
|
||||
Uruchomienie bez argumentów pokazuje tabelaryczny skrót komend:
|
||||
|
||||
```bash
|
||||
./rvctl
|
||||
@@ -79,11 +79,11 @@ Masz dwie drogi.
|
||||
|
||||
#### Droga 1: remote `r1` z tokenem w URL
|
||||
|
||||
To jest wariant dydaktyczny, jesli uczen ma cwiczyc reczne dodawanie remota z
|
||||
tokenem do zdalnego endpointu. Jesli launcher zobaczy URL w formacie
|
||||
To jest wariant dydaktyczny, jeśli uczeń ma ćwiczyć ręczne dodawanie remota z
|
||||
tokenem do zdalnego endpointu. Jeśli launcher zobaczy URL w formacie
|
||||
`http://LOGIN:TOKEN@...`, zapisze ten token lokalnie do `tokens/tokens.json`.
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
git remote add r1 http://u1:TOKEN@77.90.8.171:3001/edu-tools/rv-launcher.git
|
||||
@@ -93,7 +93,7 @@ git switch --track -c main r1/main
|
||||
|
||||
#### Droga 2: lokalny `tokens/tokens.json`
|
||||
|
||||
Przed operacjami wymagajacymi autoryzacji dodaj lokalny token do:
|
||||
Przed operacjami wymagającymi autoryzacji dodaj lokalny token do:
|
||||
|
||||
```bash
|
||||
~/dev/workspace/rv/tokens/tokens.json
|
||||
@@ -123,9 +123,9 @@ Minimalny format pliku:
|
||||
}
|
||||
```
|
||||
|
||||
Ten plik powinien byc lokalny, niewersjonowany i miec prawa `600`.
|
||||
Ten plik powinien być lokalny, niewersjonowany i mieć prawa `600`.
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
mkdir -p ~/dev/workspace/rv/tokens
|
||||
@@ -134,13 +134,13 @@ chmod 600 ~/dev/workspace/rv/tokens/tokens.json
|
||||
```
|
||||
|
||||
Wariant z `tokens/tokens.json` jest wygodniejszy wtedy, gdy launcher ma
|
||||
sam wykonywac `clone`, `fetch` i `push`, albo gdy uzytkownik po zajeciach chce
|
||||
pracowac z wieloma repo na swoim koncie bez wpisywania tokena do kazdego
|
||||
sam wykonywać `clone`, `fetch` i `push`, albo gdy użytkownik po zajęciach chce
|
||||
pracować z wieloma repo na swoim koncie bez wpisywania tokena do każdego
|
||||
remota.
|
||||
|
||||
### Fetch i switch
|
||||
|
||||
Domyslna galaz launchera to `main`.
|
||||
Domyślna gałąź launchera to `main`.
|
||||
|
||||
Po sklonowaniu:
|
||||
|
||||
@@ -158,7 +158,7 @@ git switch --track -c main r1/main
|
||||
git pull --ff-only r1 main
|
||||
```
|
||||
|
||||
Jesli chcesz wejsc na inna galaz, na przyklad `feat/x`, uzyj:
|
||||
Jeśli chcesz wejść na inną gałąź, na przykład `feat/x`, użyj:
|
||||
|
||||
```bash
|
||||
git fetch origin feat/x
|
||||
@@ -172,16 +172,16 @@ git fetch r1 feat/x
|
||||
git switch --track -c feat/x r1/feat/x
|
||||
```
|
||||
|
||||
## Wywolanie glowne
|
||||
## Wywołanie główne
|
||||
|
||||
```bash
|
||||
./rvctl [--config PATH] <komenda> [opcje]
|
||||
```
|
||||
|
||||
Globalne przelaczniki:
|
||||
Globalne przełączniki:
|
||||
|
||||
- `--config PATH`
|
||||
Uzywa innego pliku `workspace.json`.
|
||||
Używa innego pliku `workspace.json`.
|
||||
|
||||
Pomoc tabelaryczna:
|
||||
|
||||
@@ -192,7 +192,7 @@ Pomoc tabelaryczna:
|
||||
./rvctl help tokens
|
||||
```
|
||||
|
||||
Szczegolowy help parsera:
|
||||
Szczegółowy help parsera:
|
||||
|
||||
```bash
|
||||
./rvctl --help
|
||||
@@ -216,7 +216,7 @@ Komendy:
|
||||
|
||||
## `show-config`
|
||||
|
||||
Wypisuje rozwiazane sciezki z konfiguracji.
|
||||
Wypisuje rozwiązane ścieżki z konfiguracji.
|
||||
|
||||
Typowy format:
|
||||
|
||||
@@ -240,7 +240,7 @@ tools_root_candidates
|
||||
...
|
||||
```
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl show-config
|
||||
@@ -250,13 +250,13 @@ Przyklad:
|
||||
|
||||
Listuje katalogi serii znalezione w `series_root`.
|
||||
|
||||
Kazda linia ma format:
|
||||
Każda linia ma format:
|
||||
|
||||
```text
|
||||
<series_id><TAB><liczba_kart><TAB><pelna_sciezka>
|
||||
<series_id><TAB><liczba_kart><TAB><pełna_ścieżka>
|
||||
```
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl list-series
|
||||
@@ -269,22 +269,22 @@ Listuje karty z wybranej serii.
|
||||
Argumenty:
|
||||
|
||||
- `series`
|
||||
Opcjonalne id serii, na przyklad `inf`.
|
||||
Jesli go brak, brana jest domyslna seria z `workspace.json`.
|
||||
Opcjonalne id serii, na przykład `inf`.
|
||||
Jeśli go brak, brana jest domyślna seria z `workspace.json`.
|
||||
|
||||
Format wyjscia:
|
||||
Format wyjścia:
|
||||
|
||||
```text
|
||||
<card_no><TAB><tytul_z_README><TAB><pelna_sciezka>
|
||||
<card_no><TAB><tytuł_z_README><TAB><pełna_ścieżka>
|
||||
```
|
||||
|
||||
Jesli `README.md` nie ma naglowka `#`, skrypt wypisuje:
|
||||
Jeśli `README.md` nie ma nagłówka `#`, skrypt wypisuje:
|
||||
|
||||
```text
|
||||
<card_no><TAB><pelna_sciezka>
|
||||
<card_no><TAB><pełna_ścieżka>
|
||||
```
|
||||
|
||||
Przyklady:
|
||||
Przykłady:
|
||||
|
||||
```bash
|
||||
./rvctl list-cards
|
||||
@@ -293,14 +293,14 @@ Przyklady:
|
||||
|
||||
## `tokens scan`
|
||||
|
||||
Czyta remote URL-e w repo i pokazuje diagnostyczna tabele git remotes:
|
||||
`auth`, `plain` i `unsupported`. Nie porownuje ich z `tokens.json`. Komenda
|
||||
Czyta remote URL-e w repo i pokazuje diagnostyczną tabelę git remotes:
|
||||
`auth`, `plain` i `unsupported`. Nie porównuje ich z `tokens.json`. Komenda
|
||||
jest read-only.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Sciezka wewnatrz docelowego repo. Domyslnie repo zawierajace `rvctl`.
|
||||
Ścieżka wewnątrz docelowego repo. Domyślnie repo zawierające `rvctl`.
|
||||
- `--server ENDPOINT`
|
||||
Pokazuje tylko wpisy z danego endpointu.
|
||||
|
||||
@@ -313,7 +313,7 @@ item remote kind server proto host org repo
|
||||
1 r1 auth gitea http 77.90.8.171:3001 edu-tools rv-launcher u1 e59cc...13be found http://77.90.8.171:3001/edu-tools/...
|
||||
```
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens scan
|
||||
@@ -322,14 +322,14 @@ Przyklad:
|
||||
|
||||
## `tokens compare`
|
||||
|
||||
Czyta remote URL-e w repo oraz lokalny `tokens.json`, laczy wpisy w pary po
|
||||
endpoincie, nazwie remota, token id, wartosci tokena, org i repo, a potem
|
||||
Czyta remote URL-e w repo oraz lokalny `tokens.json`, łączy wpisy w pary po
|
||||
endpoincie, nazwie remota, token id, wartości tokena, org i repo, a potem
|
||||
pokazuje jeden logiczny wiersz na token. Komenda jest read-only.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Sciezka wewnatrz docelowego repo. Domyslnie repo zawierajace `rvctl`.
|
||||
Ścieżka wewnątrz docelowego repo. Domyślnie repo zawierające `rvctl`.
|
||||
|
||||
Typowy wynik:
|
||||
|
||||
@@ -340,21 +340,21 @@ item server proto host org repo user remote t
|
||||
1 gitea http 77.90.8.171:3001 edu-tools rv-launcher u1 r1 r1 * e59cc...13be forever wwwwwwwww +++++ ++++
|
||||
```
|
||||
|
||||
`token_ref` jest komorka stalej szerokosci: nazwa tokena jest po lewej, a marker
|
||||
`token_ref` jest komórką stałej szerokości: nazwa tokena jest po lewej, a marker
|
||||
po prawej. Nazwa tokena jest taka sama jak nazwa git remote, np. `r1`. Marker
|
||||
`*` oznacza, ze remote i `tokens.json` sa zgodne. Marker `R` oznacza token tylko
|
||||
`*` oznacza, że remote i `tokens.json` są zgodne. Marker `R` oznacza token tylko
|
||||
w remote, a `S` token tylko w `tokens.json`.
|
||||
|
||||
Maski uprawnien:
|
||||
Maski uprawnień:
|
||||
|
||||
- `scope` ma pozycje `aAimnopru`: activitypub, admin, issue, misc, notification, organization, package, repository, user
|
||||
- w `scope`: `w` oznacza read/write, `r` read, `-` brak dostepu
|
||||
- w `scope`: `w` oznacza read/write, `r` read, `-` brak dostępu
|
||||
- `org` ma pozycje `oawrc`: owner, admin, write, read, create repo
|
||||
- `repo` ma pozycje `oawr`: owner, admin, write, read
|
||||
- `+` oznacza wlaczone, `-` wylaczone, `?` nie wczytano, `!` blad wczytania
|
||||
- `+` oznacza włączone, `-` wyłączone, `?` nie wczytano, `!` błąd wczytania
|
||||
- `valid` pokazuje `forever`, lokalne `expires_at`, `invalid`, `?` albo `!`
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens compare
|
||||
@@ -363,14 +363,14 @@ Przyklad:
|
||||
|
||||
## `tokens list store|remote|both`
|
||||
|
||||
Wypisuje jedno zrodlo bez porownywania go z drugim. `list` jest read-only:
|
||||
pokazuje co jest w `tokens.json`, co jest w git remote albo oba zrodla jako
|
||||
osobne wiersze. `compare` sluzy do porownania zgodnosci.
|
||||
Wypisuje jedno źródło bez porównywania go z drugim. `list` jest read-only:
|
||||
pokazuje co jest w `tokens.json`, co jest w git remote albo oba źródła jako
|
||||
osobne wiersze. `compare` służy do porównania zgodności.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Repo, z ktorego listowane sa git remotes. Domyslnie repo zawierajace `rvctl`.
|
||||
Repo, z którego listowane są git remotes. Domyślnie repo zawierające `rvctl`.
|
||||
- `--server ENDPOINT`
|
||||
Ogranicza wynik do jednego endpointu.
|
||||
|
||||
@@ -384,7 +384,7 @@ item source kind server proto host org repo
|
||||
2 remote auth gitea http 77.90.8.171:3001 edu-tools rv-launcher u1 r1 e59cc...13be
|
||||
```
|
||||
|
||||
Przyklady:
|
||||
Przykłady:
|
||||
|
||||
```bash
|
||||
./rvctl tokens list store
|
||||
@@ -394,20 +394,20 @@ Przyklady:
|
||||
|
||||
## `tokens add REMOTE_ID`
|
||||
|
||||
Dodaje pusty szkielet tokena do `tokens.json`. `REMOTE_ID` musi byc taki sam
|
||||
jak nazwa git remote, np. `r1`. Pole `value` jest puste i trzeba je uzupelnic
|
||||
recznie przed uzyciem tokena.
|
||||
Dodaje pusty szkielet tokena do `tokens.json`. `REMOTE_ID` musi być taki sam
|
||||
jak nazwa git remote, np. `r1`. Pole `value` jest puste i trzeba je uzupełnić
|
||||
ręcznie przed użyciem tokena.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--server ENDPOINT`
|
||||
Endpoint serwera. Domyslnie `git.base_url` z `workspace.json`.
|
||||
Endpoint serwera. Domyślnie `git.base_url` z `workspace.json`.
|
||||
- `--value TOKEN`
|
||||
Opcjonalna wartosc tokena. Domyslnie pusta.
|
||||
Opcjonalna wartość tokena. Domyślnie pusta.
|
||||
- `--user NAME`
|
||||
Login uzywany w URL-u auth, np. `u1`.
|
||||
Login używany w URL-u auth, np. `u1`.
|
||||
- `--remote NAME`
|
||||
Alias zgodnosci. Jesli podany, musi byc taki sam jak `REMOTE_ID`.
|
||||
Alias zgodności. Jeśli podany, musi być taki sam jak `REMOTE_ID`.
|
||||
- `--org NAME`
|
||||
Opcjonalna organizacja dla remota.
|
||||
- `--repo NAME`
|
||||
@@ -415,7 +415,7 @@ Przelaczniki:
|
||||
- `--dry-run`
|
||||
Pokazuje plan bez zapisu.
|
||||
|
||||
Przyklady:
|
||||
Przykłady:
|
||||
|
||||
```bash
|
||||
./rvctl tokens add r1
|
||||
@@ -427,14 +427,14 @@ Przyklady:
|
||||
Czyta dane auth z git remote `REMOTE_ID` i zapisuje je do `tokens.json`. Nie
|
||||
pobiera metadanych z API.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Sciezka wewnatrz docelowego repo. Domyslnie repo zawierajace `rvctl`.
|
||||
Ścieżka wewnątrz docelowego repo. Domyślnie repo zawierające `rvctl`.
|
||||
- `--dry-run`
|
||||
Pokazuje plan bez zapisu.
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens sync remote r1
|
||||
@@ -444,23 +444,23 @@ Przyklad:
|
||||
## `tokens sync store REMOTE_ID`
|
||||
|
||||
Zapisuje dane auth z rekordu `REMOTE_ID` w `tokens.json` do git remote o tej
|
||||
samej nazwie. Jesli remote jeszcze nie istnieje, URL jest budowany z pol
|
||||
samej nazwie. Jeśli remote jeszcze nie istnieje, URL jest budowany z pól
|
||||
`server.endpoint`, `org` i `repo` w `tokens.json`.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Sciezka wewnatrz docelowego repo. Domyslnie biezacy katalog.
|
||||
Ścieżka wewnątrz docelowego repo. Domyślnie bieżący katalog.
|
||||
- `--url URL`
|
||||
Opcjonalny URL remota. Nadpisuje URL zbudowany z `tokens.json`.
|
||||
- `--server ENDPOINT`
|
||||
Endpoint serwera z `tokens.json`.
|
||||
- `--replace`
|
||||
Nadpisuje inne dane auth juz wpisane w remote URL.
|
||||
Nadpisuje inne dane auth już wpisane w remote URL.
|
||||
- `--dry-run`
|
||||
Pokazuje plan bez zapisu.
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens sync store r1 --repo ~/dev/workspace/rv/series/inf/03
|
||||
@@ -469,20 +469,20 @@ Przyklad:
|
||||
## `tokens remove store|remote|both REMOTE_ID`
|
||||
|
||||
Usuwa rekord z `tokens.json`, git remote albo oba miejsca.
|
||||
Domyslnym repo dla `remote` i `both` jest repo, w ktorym lezy `rvctl`. Inne
|
||||
repo mozna wskazac przez `--repo PATH`.
|
||||
Domyślnym repo dla `remote` i `both` jest repo, w którym leży `rvctl`. Inne
|
||||
repo można wskazać przez `--repo PATH`.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Repo, z ktorego ma byc usuniety git remote. Domyslnie repo zawierajace
|
||||
Repo, z którego ma być usunięty git remote. Domyślnie repo zawierające
|
||||
`rvctl`.
|
||||
- `--server ENDPOINT`
|
||||
Endpoint serwera, jesli `tokens.json` ma kilka rekordow o tym samym `id`.
|
||||
Endpoint serwera, jeśli `tokens.json` ma kilka rekordów o tym samym `id`.
|
||||
- `--dry-run`
|
||||
Pokazuje plan bez usuwania.
|
||||
|
||||
Przyklady:
|
||||
Przykłady:
|
||||
|
||||
```bash
|
||||
./rvctl tokens remove store r1
|
||||
@@ -493,14 +493,14 @@ Przyklady:
|
||||
|
||||
## `tokens read`
|
||||
|
||||
Pokazuje zawartosc `tokens/tokens.json` w podziale na endpointy serwerow.
|
||||
Pokazuje zawartość `tokens/tokens.json` w podziale na endpointy serwerów.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--server ENDPOINT`
|
||||
Ogranicza wynik do jednego endpointu.
|
||||
- `--show-secrets`
|
||||
Pokazuje pelne wartosci tokenow zamiast maskowania.
|
||||
Pokazuje pełne wartości tokenów zamiast maskowania.
|
||||
|
||||
Typowy wynik:
|
||||
|
||||
@@ -516,7 +516,7 @@ id<TAB>r1<TAB>SE****23
|
||||
user<TAB>r1<TAB>u1
|
||||
```
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens read
|
||||
@@ -525,13 +525,13 @@ Przyklad:
|
||||
|
||||
## `tokens stats`
|
||||
|
||||
Pokazuje statystyki endpointow z repo i `tokens.json`, a takze ich zgodnosc
|
||||
wzgledem siebie.
|
||||
Pokazuje statystyki endpointów z repo i `tokens.json`, a także ich zgodność
|
||||
względem siebie.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Sciezka wewnatrz repo, z ktorego maja byc odczytane remote URL-e.
|
||||
Ścieżka wewnątrz repo, z którego mają być odczytane remote URL-e.
|
||||
- `--server ENDPOINT`
|
||||
Ogranicza wynik do jednego endpointu.
|
||||
|
||||
@@ -553,7 +553,7 @@ item<TAB>value
|
||||
in_sync<TAB>1
|
||||
```
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens stats --repo ~/dev/workspace/rv/series/inf/03
|
||||
@@ -563,10 +563,10 @@ Przyklad:
|
||||
|
||||
Wpisuje dane z `tokens/tokens.json` do wybranego remota repo.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--repo PATH`
|
||||
Sciezka wewnatrz docelowego repo. Domyslnie biezacy katalog.
|
||||
Ścieżka wewnątrz docelowego repo. Domyślnie bieżący katalog.
|
||||
- `--remote NAME`
|
||||
Nazwa remota do aktualizacji lub utworzenia.
|
||||
- `--url URL`
|
||||
@@ -574,15 +574,15 @@ Przelaczniki:
|
||||
- `--server ENDPOINT`
|
||||
Endpoint serwera z `tokens.json`.
|
||||
- `--user NAME`
|
||||
Uzytkownik z wybranego endpointu.
|
||||
Użytkownik z wybranego endpointu.
|
||||
- `--token-name NAME`
|
||||
Remote id w `tokens.json`, na przyklad `r1`. Domyslnie wartosc `--remote`.
|
||||
Remote id w `tokens.json`, na przykład `r1`. Domyślnie wartość `--remote`.
|
||||
- `--replace`
|
||||
Nadpisuje inne dane auth juz wpisane w remote URL.
|
||||
Nadpisuje inne dane auth już wpisane w remote URL.
|
||||
- `--dry-run`
|
||||
Pokazuje plan bez zapisu.
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens write --repo ~/dev/workspace/rv/series/inf/03 --remote r1 --server http://77.90.8.171:3001
|
||||
@@ -593,14 +593,14 @@ Przyklad:
|
||||
Pobiera z API metadane dla rekordu `REMOTE_ID` zapisanego w `tokens.json`.
|
||||
Nie synchronizuje sekretu z git remote.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--server ENDPOINT`
|
||||
Opcjonalny wybor endpointu, jesli ten sam `REMOTE_ID` istnieje dla wielu serwerow.
|
||||
Opcjonalny wybór endpointu, jeśli ten sam `REMOTE_ID` istnieje dla wielu serwerów.
|
||||
- `--dry-run`
|
||||
Pokazuje plan bez zapisu.
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```bash
|
||||
./rvctl tokens update r1
|
||||
@@ -608,32 +608,32 @@ Przyklad:
|
||||
|
||||
## `tokens update --from ...`
|
||||
|
||||
Komendy zgodnosci dla starego modelu kierunkowego.
|
||||
Komendy zgodności dla starego modelu kierunkowego.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--from remotes`
|
||||
Skanuje remote URL-e i zapisuje wynik do `tokens.json`.
|
||||
- `--from store`
|
||||
Bierze dane z `tokens.json` i wpisuje je do remota repo.
|
||||
- `--repo PATH`
|
||||
Sciezka wewnatrz repo.
|
||||
Ścieżka wewnątrz repo.
|
||||
- `--remote NAME`
|
||||
Wymagane dla `--from store`.
|
||||
- `--url URL`
|
||||
Opcjonalny URL dla `--from store`.
|
||||
- `--server ENDPOINT`
|
||||
Opcjonalny wybor endpointu dla `--from store`.
|
||||
Opcjonalny wybór endpointu dla `--from store`.
|
||||
- `--user NAME`
|
||||
Opcjonalny wybor usera dla `--from store`.
|
||||
Opcjonalny wybór usera dla `--from store`.
|
||||
- `--token-name NAME`
|
||||
Opcjonalny wybor remote id dla `--from store`.
|
||||
Opcjonalny wybór remote id dla `--from store`.
|
||||
- `--replace`
|
||||
Nadpisuje inne auth przy `--from store`.
|
||||
- `--dry-run`
|
||||
Pokazuje plan bez zapisu.
|
||||
|
||||
Przyklady:
|
||||
Przykłady:
|
||||
|
||||
```bash
|
||||
./rvctl tokens update --from remotes --repo ~/dev/workspace/rv/series/inf/03
|
||||
@@ -642,20 +642,20 @@ Przyklady:
|
||||
|
||||
## `submission [series] [card]`
|
||||
|
||||
Wylicza flow oddawania rozwiazan:
|
||||
Wylicza przepływ oddawania rozwiązań:
|
||||
|
||||
- `r1` jako repo z materialem z `edu-inf`
|
||||
- `r1` jako repo z materiałem z `edu-inf`
|
||||
- `a1` jako repo odpowiedzi w `zsl-inf`
|
||||
- branch ucznia na podstawie jego nicku
|
||||
|
||||
Nazwa repo odpowiedzi jest budowana z nazwy repo zrodlowego z `edu-inf`, klasy
|
||||
Nazwa repo odpowiedzi jest budowana z nazwy repo źródłowego z `edu-inf`, klasy
|
||||
i daty:
|
||||
|
||||
```text
|
||||
<repo_z_edu-inf>-<klasa>-<data>
|
||||
```
|
||||
|
||||
Przyklad:
|
||||
Przykład:
|
||||
|
||||
```text
|
||||
lab-rv32i-strlen-bss-data-stack-4i-2026-04-26
|
||||
@@ -664,26 +664,26 @@ lab-rv32i-strlen-bss-data-stack-4i-2026-04-26
|
||||
Argumenty pozycyjne:
|
||||
|
||||
- `series`
|
||||
Id serii albo pelny selector, na przyklad `inf` albo `inf/03`.
|
||||
Id serii albo pełny selector, na przykład `inf` albo `inf/03`.
|
||||
- `card`
|
||||
Numer karty, na przyklad `03`.
|
||||
Numer karty, na przykład `03`.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--class NAME`
|
||||
Id klasy, na przyklad `4i`.
|
||||
Id klasy, na przykład `4i`.
|
||||
- `--nick NAME`
|
||||
Nick ucznia. Domyslnie z niego powstaje nazwa brancha.
|
||||
Nick ucznia. Domyślnie z niego powstaje nazwa brancha.
|
||||
- `--branch NAME`
|
||||
Nadpisuje domyslna nazwe brancha.
|
||||
Nadpisuje domyślną nazwę brancha.
|
||||
- `--date YYYY-MM-DD`
|
||||
Data zajec uzywana w nazwie repo odpowiedzi. Domyslnie dzisiejsza.
|
||||
Data zajęć używana w nazwie repo odpowiedzi. Domyślnie dzisiejsza.
|
||||
- `--source-url URL`
|
||||
Nadpisuje URL repo zrodlowego. Bez tego launcher czyta `origin` z repo karty.
|
||||
Nadpisuje URL repo źródłowego. Bez tego launcher czyta `origin` z repo karty.
|
||||
- `--apply`
|
||||
Dodaje albo aktualizuje remote `r1` i `a1` w repo karty.
|
||||
|
||||
Typowy format wyjscia:
|
||||
Typowy format wyjścia:
|
||||
|
||||
```text
|
||||
selector<TAB>inf/03
|
||||
@@ -698,7 +698,7 @@ answer_url<TAB>http://77.90.8.171:3001/zsl-inf/lab-rv32i-strlen-bss-data-stack-4
|
||||
student_branch<TAB>u1
|
||||
```
|
||||
|
||||
Przyklady:
|
||||
Przykłady:
|
||||
|
||||
```bash
|
||||
./rvctl submission inf 03 --class 4i --nick u1
|
||||
@@ -708,37 +708,37 @@ Przyklady:
|
||||
|
||||
## `tmux-container [series] [card]`
|
||||
|
||||
Tworzy nowa sesje `tmux` i uruchamia kontener w `pane 0`.
|
||||
Tworzy nową sesję `tmux` i uruchamia kontener w `pane 0`.
|
||||
|
||||
Argumenty pozycyjne:
|
||||
|
||||
- `series`
|
||||
Id serii albo pelny selector, na przyklad `inf` albo `inf/03`.
|
||||
Id serii albo pełny selector, na przykład `inf` albo `inf/03`.
|
||||
- `card`
|
||||
Numer karty, na przyklad `03`.
|
||||
Numer karty, na przykład `03`.
|
||||
|
||||
Przelaczniki:
|
||||
Przełączniki:
|
||||
|
||||
- `--session NAME`
|
||||
Nadpisuje nazwe sesji `tmux`.
|
||||
Nadpisuje nazwę sesji `tmux`.
|
||||
- `--window NAME`
|
||||
Nadpisuje nazwe okna `tmux`.
|
||||
Nadpisuje nazwę okna `tmux`.
|
||||
- `--instance NAME`
|
||||
Ustawia `RV_INSTANCE` dla wrappera `rv`.
|
||||
- `--attach`
|
||||
Po utworzeniu sesji robi `tmux attach`.
|
||||
- `--dry-run`
|
||||
Nie uruchamia `tmux`; wypisuje selector, sciezki i koncowa komende.
|
||||
Nie uruchamia `tmux`; wypisuje selector, ścieżki i końcową komendę.
|
||||
|
||||
Reguly wyboru karty:
|
||||
Reguły wyboru karty:
|
||||
|
||||
- `tmux-container inf 03` -> seria `inf`, karta `03`
|
||||
- `tmux-container inf/03` -> pelny selector
|
||||
- `tmux-container 03` -> domyslna seria + karta `03`
|
||||
- `tmux-container inf` -> seria `inf` + domyslna karta
|
||||
- bez argumentow -> domyslna seria i domyslna karta
|
||||
- `tmux-container inf/03` -> pełny selector
|
||||
- `tmux-container 03` -> domyślna seria + karta `03`
|
||||
- `tmux-container inf` -> seria `inf` + domyślna karta
|
||||
- bez argumentów -> domyślna seria i domyślna karta
|
||||
|
||||
Przyklady:
|
||||
Przykłady:
|
||||
|
||||
```bash
|
||||
./rvctl tmux-container 03 --dry-run
|
||||
|
||||
Reference in New Issue
Block a user