---
type: testing
title: Unit tests
description: Overview of the in-module unit test suites in src/*.rs, what each one covers and how to run them.
tags: [testing, cargo, unit-tests]
sources:
  - id: openwiki-source-651d1fb6c9e49916a916ab51
    resource: repo://Cargo.toml
  - id: openwiki-source-1b05507d7085e8e99a9b64f1
    resource: repo://src/ai.rs
  - id: openwiki-source-9fec9d1af408501c9c455161
    resource: repo://src/app.rs
  - id: openwiki-source-043e6252badc57a1ee6bfb48
    resource: repo://src/autoreply.rs
  - id: openwiki-source-2a737474d86fc75cc9d9694f
    resource: repo://src/config.rs
  - id: openwiki-source-ce0c4ea8cd3b15431fa691ce
    resource: repo://src/history.rs
  - id: openwiki-source-6bddea306b9b87f180f1fc02
    resource: repo://src/ui.rs
  - id: openwiki-source-7ea5eac45e5030178a6ea05b
    resource: repo://src/whatsapp.rs
generated: { by: "claude-code", at: "2026-10-19T19:53:56.480Z" }
verified:
  - by: openwiki/0.7.2
    at: 2026-10-19T19:53:56.480Z
---

# Unit tests

All tests are plain Rust unit tests in `#[cfg(test)] mod tests` blocks at the
bottom of each source file. There are no integration tests, no
`[dev-dependencies]` (`Cargo.toml` only has `[dependencies]`) and no test
touches the network or a real WhatsApp session.

## Running

```sh
cargo test                      # whole suite
cargo test autoreply::          # one module
cargo test should_reply_false   # by name filter
```

## Suites

| Module | Tests | Location | Covers |
|---|---|---|---|
| `autoreply` | 77 | `src/autoreply.rs:528+` | private/group/self-chat detection, `supports_autoreply` (groups yes, broadcasts and newsletters no), every `ReplyGate::should_reply` rule (disabled, own messages, backlog, blank/placeholder text, per-chat cooldown, group cooldown vs. addressed messages via `is_addressed`), `deferral_due` / `take_pending` / `record_reply` pending logic, `catch_up_due` rules, custom and zero cooldowns, `context_start`, `build_turns` roles, role notes, group sender prefixes, context truncation, voice-note and image instructions |
| `config` | 26 | `src/config.rs:288+` | defaults, trimming, multiline prompt, base URL normalisation, `Debug` masking, DB and AI log paths, `ai_log`, cooldown and catch-up defaults/custom values/negative rejection, BOM/CRLF, non-leaking parse errors, missing/invalid/unreadable files |
| `ai` | 21 | `src/ai.rs:452+` | request and vision body shapes, image validation limits, `Debug` redaction, reply parsing, endpoint construction, AI log records (no key, images redacted), logging only when enabled, append-only log writes, truncation |
| `whatsapp` | 26 | `src/whatsapp.rs:990+` | `addressed_jids` (mentions, quoted participant, media context info), message rendering and placeholders, captions, image references, silent messages, JID device suffix, push-name filtering |
| `history` | 14 | `src/history.rs:418+` | dedupe by message id, ordering and limits, `messages_since` (boundary, limit keeps most recent, ascending order), chat name fallbacks, autoreply flags, contacts, on-disk open |
| `ui` | 11 | `src/ui.rs:508+` | sender labels, clock time, QR text, wrapping, visible lines, input tail, title, selection clamp |
| `app` | 11 | `src/app.rs:909+` | autoreply enable rules (private, self-chat LID, groups; broadcasts, newsletters and missing AI refused), vision applicability, error combining, selection and toggle helpers, AltGr handling |

Total: 186 `#[test]` functions.

## Test isolation

- History tests use `History::open_in_memory()` (only compiled for tests,
  `src/history.rs:74-80`); the on-disk test writes under
  `std::env::temp_dir()` in a per-process directory (`src/history.rs:648-662`).
- AI tests check request bodies, parsing and log records without sending
  requests; the append test writes a per-process file under
  `std::env::temp_dir()` and removes it (`src/ai.rs:720-731`).

Pages with module details: [AI autoreply](../workflows/ai-autoreply.md),
[Configuration](../operations/configuration-and-data.md),
[AI client](../integrations/ai-client.md),
[WhatsApp client](../integrations/whatsapp-client.md),
[History store](../concepts/history-store.md),
[Terminal UI](../architecture/terminal-ui.md),
[Application state](../architecture/app-state.md).