60 lines
1.9 KiB
Markdown
60 lines
1.9 KiB
Markdown
# Timesheet
|
|
|
|
CLI nástroj pro vypsání timesheetu z GitLabu jako ASCII tabulky.
|
|
|
|
## Použití
|
|
|
|
```bash
|
|
GITLAB_TOKEN=glpat-... \
|
|
GITLAB_USERNAME=foo.bar \
|
|
HOURLY_RATE=100 \
|
|
go run . --month 2026-04
|
|
```
|
|
|
|
Volitelně lze zadat vlastní GitLab instanci:
|
|
|
|
```bash
|
|
GITLAB_URL=https://gitlab.example.com \
|
|
GITLAB_TOKEN=glpat-... \
|
|
GITLAB_USERNAME=foo.bar \
|
|
HOURLY_RATE=100 \
|
|
go run . --month 2026-04
|
|
```
|
|
|
|
Filtrovat lze také podle issue nebo merge request IID:
|
|
|
|
```bash
|
|
GITLAB_TOKEN=glpat-... \
|
|
GITLAB_USERNAME=foo.bar \
|
|
HOURLY_RATE=100 \
|
|
go run . --month 2026-04 --id 123
|
|
```
|
|
|
|
## Example Output
|
|
|
|
```text
|
|
GitLab Timesheet — Duben 2026
|
|
Hodinová sazba: 100 Kč/h | Norma: 8 h/den
|
|
|
|
+---------------------------------------------------------------+
|
|
| Datum | Den | Odpracováno | Rozdíl | Částka |
|
|
+---------------------------------------------------------------+
|
|
| 2026-04-01 | St | 8.00 h | +0.00 h | 800 Kč |
|
|
| 2026-04-02 | Čt | 6.50 h | -1.50 h | 650 Kč |
|
|
| 2026-04-03 | Pá | 8.00 h | +0.00 h | 800 Kč |
|
|
+---------------------------------------------------------------+
|
|
| Souhrn týdne | 22.50 h | -1.50 h | 2250 Kč |
|
|
+---------------------------------------------------------------+
|
|
|
|
+===============================================================+
|
|
| SOUHRN MĚSÍCE | 160.00 h | +0.00 h | 16000 Kč |
|
|
+===============================================================+
|
|
```
|
|
|
|
## Význam proměnných
|
|
|
|
- `GITLAB_TOKEN` - GitLab Personal Access Token se scope `read_api`. Povinná proměnná.
|
|
- `GITLAB_USERNAME` - GitLab username uživatele, pro kterého se timesheet načítá. Povinná proměnná.
|
|
- `GITLAB_URL` - základní URL GitLabu. Volitelná proměnná, výchozí hodnota je `https://gitlab.com`.
|
|
- `HOURLY_RATE` - hodinová sazba v Kč za hodinu, ze které se počítá výsledná cena. Povinná proměnná.
|