Getting Started

Why CLI/test?

CLI/test makes it easy to write and maintain tests for command-line applications. Its syntax is designed to be concise, human-readable, and powerful, allowing you to express complex test scenarios without extra noise.

If you have not read it yet, see Overview for how the runner, .cli files, and integrations fit together.

Features

• Simple and readable test syntax. See Basic Usage.
• Support for pattern matching using grok patterns. See Grok Patterns.
• Flexible output matching with multi-line support. See Pattern Matching.
• Environment variable management. See Environment and Variables.
• Control structures for complex test scenarios. See Control Structures.
• Background process management. See Control Structures.
• Create temporary directories to use during test runs with automatic deletion. See Environment and Variables.
• Cleanup commands to run after the test. See Control Structures.
• Retry logic to re-run commands until they succeed or timeout. See Control Structures.