---
type: testing
title: Unit tests
description: Overview of the in-module unit test suites in src/*.rs (including the web panel), 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-7b75006986d8b0337adc6ca0
    resource: repo://src/web.rs
  - id: openwiki-source-7ea5eac45e5030178a6ea05b
    resource: repo://src/whatsapp.rs
generated: { by: "claude-code", at: "2026-10-20T20:27:06.515Z" }
verified:
  - by: openwiki/0.7.2
    at: 2026-10-20T20:27:06.515Z
---

# 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, binds a port or uses 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` | 32 | `src/config.rs:323+` | defaults, trimming, multiline prompt, base URL normalisation, `Debug` masking, DB and AI log paths, `ai_log`, cooldown, catch-up and `ai_retries` defaults/custom values/negative rejection, `web_port` (unset, valid, `0` and out of range rejected), BOM/CRLF, non-leaking parse errors, missing/invalid/unreadable files |
| `whatsapp` | 27 | `src/whatsapp.rs:1005+` | fatal-only app state sync reporting, `addressed_jids` (mentions, quoted participant, media context info), message rendering and placeholders, captions, image references, silent messages, JID device suffix, push-name filtering |
| `ai` | 25 | `src/ai.rs:526+` | 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, retry policy (`is_retryable`, `StatusError` message, linear `retry_delay`), truncation |
| `history` | 16 | `src/history.rs:481+` | dedupe by message id, ordering and limits, `messages_since` (boundary, limit keeps most recent, ascending order), chat name fallbacks, per-chat and global autoreply flags, `delete_chat`, contacts, on-disk open |
| `ui` | 14 | `src/ui.rs:558+` | footer key help (F4 highlight), sender labels, clock time, QR text, wrapping, visible lines, input tail, messages title, list title (global marker, filter), selection clamp |
| `app` | 14 | `src/app.rs:1167+` | autoreply enable rules (private, self-chat LID, groups; broadcasts, newsletters and missing AI refused), `web_chats` filtering and order, vision applicability, error combining, list filter matching, selection and toggle helpers, AltGr handling, fixed function-key codes |
| `web` | 9 | `src/web.rs:366+` | query stripping, route resolution, `X-Wh-Request` header check (any case, missing/wrong value), which routes require it, request body trimming, empty/invalid UTF-8 rejection and the 1024-byte limit |

Total: 214 `#[test]` functions.

## Test isolation

- History tests use `History::open_in_memory()` (only compiled for tests,
  `src/history.rs:76-86`); the on-disk test writes under
  `std::env::temp_dir()` in a per-process directory (`src/history.rs:749-763`).
- AI tests check request bodies, parsing, log records and the retry policy
  without sending requests; the append test writes a per-process file under
  `std::env::temp_dir()` and removes it (`src/ai.rs:802-813`).
- Web tests exercise the pure routing and parsing helpers; the HTTP server
  itself is never started.

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),
[Web control panel](../integrations/web-control-panel.md),
[History store](../concepts/history-store.md),
[Terminal UI](../architecture/terminal-ui.md),
[Application state](../architecture/app-state.md).