feat(run): improve run-all handling, clarify exit codes, and enhance documentation

- Expanded `Falyx.run()` docstring into a detailed Google‑style docstring:
- Refined exit code semantics:
- `QuitSignal` now exits with code 130 (Ctrl+C style)
- `BackSignal` and `CancelSignal` exit with code 1 instead of 0 for script correctness
- Reworked `run-all` execution flow:
- Uses `asyncio.gather()` to run tagged commands concurrently
- Aggregates exceptions and signals for clearer reporting
- Tracks `had_errors` flag and exits with code 1 if any commands fail
- Bumped version to **0.1.79**

These changes make `run-all` safer for automation, standardize exit codes, and provide richer documentation for developers using the CLI.
This commit is contained in:
2025-07-30 23:41:25 -04:00
parent 3b2c33d28f
commit 8e306b9eaf
3 changed files with 84 additions and 21 deletions

View File

@ -1,6 +1,6 @@
[tool.poetry]
name = "falyx"
version = "0.1.78"
version = "0.1.79"
description = "Reliable and introspectable async CLI action framework."
authors = ["Roland Thomas Jr <roland@rtj.dev>"]
license = "MIT"