Write documentation for `iced_test`

3 files changed, 35 insertions, 2 deletions

diff --git a/examples/counter/Cargo.toml b/examples/counter/Cargo.toml
index e916a1a1..02eac329 100644
--- a/examples/counter/Cargo.toml
+++ b/examples/counter/Cargo.toml
@@ -11,3 +11,6 @@ iced.workspace = true
 [target.'cfg(target_arch = "wasm32")'.dependencies]
 iced.workspace = true
 iced.features = ["webgl", "fira-sans"]
+
+[dev-dependencies]
+iced_test.workspace = true
diff --git a/examples/counter/src/main.rs b/examples/counter/src/main.rs
index 81684c1c..35d6f0e5 100644
--- a/examples/counter/src/main.rs
+++ b/examples/counter/src/main.rs
@@ -38,3 +38,32 @@ impl Counter {
         .align_x(Center)
     }
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use iced_test::selector::text;
+    use iced_test::{simulator, Error};
+
+    #[test]
+    fn it_counts() -> Result<(), Error> {
+        let mut counter = Counter { value: 0 };
+        let mut ui = simulator(counter.view());
+
+        let _ = ui.click(text("Increment"));
+        let _ = ui.click(text("Increment"));
+        let _ = ui.click(text("Decrement"));
+
+        for message in ui.into_messages() {
+            counter.update(message);
+        }
+
+        assert_eq!(counter.value, 1);
+
+        let mut ui = simulator(counter.view());
+
+        assert!(ui.find(text("1")).is_ok(), "Counter should display 1!");
+
+        Ok(())
+    }
+}
diff --git a/examples/todos/src/main.rs b/examples/todos/src/main.rs
index 45034d6c..a5bca235 100644
--- a/examples/todos/src/main.rs
+++ b/examples/todos/src/main.rs
@@ -591,7 +591,8 @@ mod tests {
     use super::*;
 
     use iced::{Settings, Theme};
-    use iced_test::{selector, Error, Simulator};
+    use iced_test::selector::text;
+    use iced_test::{Error, Simulator};
 
     fn simulator(todos: &Todos) -> Simulator<Message> {
         Simulator::with_settings(
@@ -619,7 +620,7 @@ mod tests {
         }
 
         let mut ui = simulator(&todos);
-        let _ = ui.find(selector::text("Create the universe"))?;
+        let _ = ui.find(text("Create the universe"))?;
 
         let snapshot = ui.snapshot(&Theme::Dark)?;
         assert!(