129 lines
2.3 KiB
Markdown
129 lines
2.3 KiB
Markdown
# Uzycie CLI
|
|
|
|
Plik opisuje przelaczniki i liste komend skryptu `workspace.py`.
|
|
|
|
## Wywolanie glowne
|
|
|
|
```bash
|
|
python3 workspace.py [--config PATH] <komenda> [opcje]
|
|
```
|
|
|
|
Globalne przelaczniki:
|
|
|
|
- `--config PATH`
|
|
Uzywa innego pliku `workspace.json`.
|
|
|
|
Komendy:
|
|
|
|
- `show-config`
|
|
- `list-series`
|
|
- `list-cards [series]`
|
|
- `tmux-container [series] [card]`
|
|
|
|
## `show-config`
|
|
|
|
Wypisuje rozwiazane sciezki z konfiguracji.
|
|
|
|
Typowy format:
|
|
|
|
```text
|
|
config_path<TAB>...
|
|
workspace_root<TAB>...
|
|
series_root<TAB>...
|
|
socket_root<TAB>...
|
|
tools_root<TAB>...
|
|
tools_root_candidates
|
|
...
|
|
```
|
|
|
|
Przyklad:
|
|
|
|
```bash
|
|
python3 workspace.py show-config
|
|
```
|
|
|
|
## `list-series`
|
|
|
|
Listuje katalogi serii znalezione w `series_root`.
|
|
|
|
Kazda linia ma format:
|
|
|
|
```text
|
|
<series_id><TAB><liczba_kart><TAB><pelna_sciezka>
|
|
```
|
|
|
|
Przyklad:
|
|
|
|
```bash
|
|
python3 workspace.py list-series
|
|
```
|
|
|
|
## `list-cards [series]`
|
|
|
|
Listuje karty z wybranej serii.
|
|
|
|
Argumenty:
|
|
|
|
- `series`
|
|
Opcjonalne id serii, na przyklad `inf`.
|
|
Jesli go brak, brana jest domyslna seria z `workspace.json`.
|
|
|
|
Format wyjscia:
|
|
|
|
```text
|
|
<card_no><TAB><tytul_z_README><TAB><pelna_sciezka>
|
|
```
|
|
|
|
Jesli `README.md` nie ma naglowka `#`, skrypt wypisuje:
|
|
|
|
```text
|
|
<card_no><TAB><pelna_sciezka>
|
|
```
|
|
|
|
Przyklady:
|
|
|
|
```bash
|
|
python3 workspace.py list-cards
|
|
python3 workspace.py list-cards inf
|
|
```
|
|
|
|
## `tmux-container [series] [card]`
|
|
|
|
Tworzy nowa sesje `tmux` i uruchamia kontener w `pane 0`.
|
|
|
|
Argumenty pozycyjne:
|
|
|
|
- `series`
|
|
Id serii albo pelny selector, na przyklad `inf` albo `inf/03`.
|
|
- `card`
|
|
Numer karty, na przyklad `03`.
|
|
|
|
Przelaczniki:
|
|
|
|
- `--session NAME`
|
|
Nadpisuje nazwe sesji `tmux`.
|
|
- `--window NAME`
|
|
Nadpisuje nazwe 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.
|
|
|
|
Reguly 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
|
|
|
|
Przyklady:
|
|
|
|
```bash
|
|
python3 workspace.py tmux-container 03 --dry-run
|
|
python3 workspace.py tmux-container inf 03 --session rv-inf03
|
|
python3 workspace.py tmux-container inf/03 --attach
|
|
```
|