Add network diagnostic reports
This commit is contained in:
1 parent
a23fc775e3
commit
43518d51cc
4 files changed
+756
-3
No files matched your search
@@ -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`.
|
||||
|
||||
Reference in new issue
Block a user