kittest 0.2.0

Automated GUI testing using AccessKit
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

# 💻🐈 kittest: UI Testing Library for Rust Powered by AccessKit

**kittest** is a GUI testing library for Rust, inspired by [Testing Library](https://testing-library.com/). 
It leverages [AccessKit](https://github.com/AccessKit/accesskit/) to provide a framework-agnostic solution 
for testing user interfaces, with a focus on accessibility.

This library is designed to be flexible and works with any GUI framework that supports AccessKit.
Creating new **kittest** integrations is simple and straightforward. To get started, check out our 
[basic integration example](https://github.com/rerun-io/kittest/blob/main/examples/basic_integration.rs).

## Available Integrations
- [egui_kittest](https://github.com/emilk/egui/tree/master/crates/egui_kittest): Official integration for 
  [egui](https://github.com/emilk/egui).

If you create a new integration, please open a PR to add it to this list!

## Example usage with [egui_kittest](https://github.com/emilk/egui/tree/master/crates/egui_kittest)

```rust ignore
use egui::accesskit::Toggled;
use egui_kittest::{Harness, kittest::Queryable};

fn main() {
    let mut checked = false;
    let app = |ui: &mut egui::Ui| {
        ui.checkbox(&mut checked, "Check me!");
    };

    let mut harness = Harness::new_ui(app);
    
    let checkbox = harness.get_by_label("Check me!");
    assert_eq!(checkbox.toggled(), Some(Toggled::False));
    checkbox.click();
    
    harness.run();

    let checkbox = harness.get_by_label("Check me!");
    assert_eq!(checkbox.toggled(), Some(Toggled::True));
}
```

Also see the [querying example](https://github.com/rerun-io/kittest/blob/4b3ecd2043bc6cd4b0460958f0ca0d8d81331841/examples/querying.rs).