Package Exports
- @akaoio/battle
Readme
@akaoio/battle
Real PTY testing with StarCraft-style replay capabilities
Universal terminal application testing framework with real PTY emulation
Why Battle?
Features
Installation
Quick Start
Basic Usage
Advanced Usage with Replay
CLI Usage
Testing Patterns
Interactive Applications
Error Handling
Long-Running Processes
Architecture
Battle follows the @akaoio principle of "Class = Directory + Method-per-file":
Performance vs Accuracy Trade-off
| Operation | Pipe Testing | PTY Testing | Overhead | Worth It? |
|---|
Philosophy: Accept 3-10× performance overhead for 99% bug detection accuracy.
Self-Testing Validation
Battle tests itself recursively to ensure framework reliability:
- Level 1: Battle tests a command
- Level 2: Battle tests Battle testing a command
- Level 3: Battle tests Battle testing Battle (maximum confidence)
Documentation
All documentation is generated with @akaoio/composer from atomic YAML files.
npm run docs:build
npm run docs:watchBuilt With @akaoio Tools
- @akaoio/builder: Universal TypeScript build system
- @akaoio/composer: Atomic documentation generation
- @akaoio/battle: Self-testing (this framework tests itself!)
License
MIT © AKAO Team
Built with @akaoio/battle v1.1.0 Documentation generated with @akaoio/composer