Building a macOS Dev Workstation Toolkit in Bash

说明与用途

一套 Bash 工具集，用于管理 macOS 工作站，配备测试、CI 和可验证的备份。

问题

Workstation scripts rot because they lack tests, documentation, and consistent configuration, leading to duplicated logic, scattered settings, and silent regressions.

结果

The toolkit provides a single, test‑driven, documented, and verifiable workflow for macOS workstation setup, reducing script rot and ensuring reliable backups.

工作流

• Clone the repo
• Run ./scripts/install.sh to install utilities
• Use ./scripts/doctor.sh to report environment status
• Run make all before committing to ensure tests, lint, and CI pass
• Use backup.sh and restore.sh with manifest verification for reliable backups

证据

Workstation scripts rot for the same reason any codebase without tests rots.

来源

v2.2.0 ships 187 passing Bats tests covering backup, restore, install, update, uninstall, doctor, cleanup, config, shell quality, and repo sync.

来源

Backups are recorded and verified. Every backup.sh run writes a manifest_<timestamp>.json with the filename, source path, and a SHA-256 of the content.

来源

Every push and pull request runs Bash syntax validation, ShellCheck, shfmt verification, and the Bats suite — on both macos-latest and ubuntu-latest.

来源