Crate gtk_test

Crate to test UI interactions with gtk-rs crates.

Small example:

extern crate gtk;
#[macro_use]
extern crate gtk_test;

use gtk::{prelude::ButtonExt, prelude::ContainerExt, prelude::GtkWindowExt, prelude::LabelExt, prelude::WidgetExt};

gtk::init().expect("GTK init failed");

let win = gtk::Window::new(gtk::WindowType::Toplevel);
let but = gtk::Button::new();

but.set_label(""); // Otherwise, assert_label! call will fail.
but.connect_clicked(|b| {
    b.set_label("clicked!");
});

win.add(&but);
win.show_all();
win.activate_focus(); // Very important, otherwise tests will fail on OSX!

assert_label!(but, "");
gtk_test::click(&but);
gtk_test::wait(1000); // To be sure that GTK has updated the label's text.
assert_label!(but, "clicked!");

Re-exports

pub use gtk;

pub use gtk::gdk;

Macros

assert_label

To check if the widget’s label matches the given string.

assert_name

To check if the widget’s name matches the given string.

assert_text

To check if the widget’s text matches the given string.

assert_title

To check if the widget’s title matches the given string.

observer_new

Create a new observer for signals.

Structs

Observer

Used to wait for a widget’s signal.

Functions

click

Simulate a click on a widget.

double_click

Simulate a double-click on a widget.

enter_key

Send a key event to the given widget.

enter_keys

Send keys event to the given widget.

find_child_by_name

Returns the child element which has the given name.

find_widget_by_name

Returns the child widget which has the given name.

focus

Focus on the given widget.

key_press

Send a key press event to the given widget.

key_release

Send a key release event to the given widget.

mouse_move

Move the mouse relative to the widget position.

mouse_press

Send a mouse press event to the given widget.

mouse_release

Send a mouse release event to the given widget.

run_loop

Process all pending events and then return.

wait

Wait for events the specified amount the milliseconds.

wait_for_draw

Wait for a widget to be drawn.

wait_until_done

Wait until the given condition returns true.