# tests/

Contains all functional and integration tests for the iron_cli crate.

## Purpose

This directory validates the functionality of iron_cli.

## Organization Principles

- **Domain-based organization**: Tests organized by functionality (what is tested), not methodology
- **Flat structure**: Minimal nesting for simplicity and discoverability
- **Descriptive naming**: Test files named to reflect the functionality they validate

## Test Files

- `smoke_test.rs` - Basic smoke tests ensuring core functionality works
- `tests.rs` - Main test suite
- `inc/` - Test utilities, helper modules, and shared test infrastructure
  - `inc/mod.rs` - Test module declarations
  - `inc/basic_test.rs` - Common test utilities and fixtures

## Running Tests

**Default (all tests):**
```bash
cd iron_cli
cargo test
```

**With all features:**
```bash
cargo test --all-features
```

**Specific test:**
```bash
cargo test test_name
```

## Test Strategy

All tests use real implementations (no mocking) and fail loudly with clear error messages.
