Add network diagnostic reports

This commit is contained in:
dido committed 2026-09-29 11:25:33 +03:00
1 parent a23fc775e3
commit 43518d51cc
4 files changed
+756 -3

No files matched your search

+11 -2
View File
@@ -37,11 +37,20 @@
relative link към `.md` файла на скрипта. Пълното описание живее само
в скрипт-специфичния `.md`, README не го дублира.
5. **Скриптът минава `shellcheck` без warnings** (виж `.shellcheckrc` в
5. **В началото се проверяват всички задължителни команди и програми.**
След `common::show_help_if_requested "$@"` и преди основната работа
извикай `common::require_cmd` за всяка външна команда, без която скриптът
не може да изпълни предназначението си. При липсваща команда helper-ът
извежда разбираемо съобщение и прекратява изпълнението. Незадължителните
команди се проверяват условно и трябва да имат fallback или описано
ограничено поведение; липсата им не бива да спира скрипта без причина.
Изброй задължителните и незадължителните зависимости в съответния `.md`.
6. **Скриптът минава `shellcheck` без warnings** (виж `.shellcheckrc` в
корена). Ако warning-ът е false positive, добави `# shellcheck disable=SCxxxx`
с коментар защо точно на реда, не глобално в файла.
6. **`set -euo pipefail`** в началото на всеки скрипт, веднага след shebang
7. **`set -euo pipefail`** в началото на всеки скрипт, веднага след shebang
реда и коментарния блок. Без изключения — ако скрипт умишлено трябва да
продължи след грешка в конкретна команда, обгради само тази команда с
`|| true` или явна проверка, не маха global `set -e`.