probador

probador (Spanish: "tester") is the CLI tool for Probar - a Playwright-compatible testing framework for WASM games and applications.

Note: The library is published separately as jugar-probar.

Installation

cargo install probador

Quick Start

# Validate a playbook state machine
probador playbook login.yaml --validate

# Run with mutation testing (M1-M5 falsification)
probador playbook login.yaml --mutate

# Export state diagram
probador playbook login.yaml --export svg -o diagram.svg

# Run tests
probador test

# Run tests with coverage
probador coverage --html

# Watch mode for development
probador watch tests/

# Start dev server for WASM
probador serve --port 8080

Commands

Playbook Testing

probador supports YAML-driven state machine testing with mutation testing:

# login.yaml
version: "1.0"
name: "Login Flow"
machine:
  id: "login"
  initial: "logged_out"
  states:
    logged_out:
      id: "logged_out"
    logging_in:
      id: "logging_in"
    logged_in:
      id: "logged_in"
      final_state: true
  transitions:
    - id: "start_login"
      from: "logged_out"
      to: "logging_in"
      event: "submit"
    - id: "complete_login"
      from: "logging_in"
      to: "logged_in"
      event: "success"

# Validate
probador playbook login.yaml --validate

# Export as SVG diagram
probador playbook login.yaml --export svg -o login.svg

# Mutation testing (M1-M5 classes)
probador playbook login.yaml --mutate

Mutation Classes

Library Usage

For programmatic usage in Rust tests, add the library crate:

cargo add jugar-probar --dev

use jugar_probar::prelude::*;

#[test]
fn test_game() {
    let mut gui = gui_coverage! {
        buttons: ["start", "quit"],
        screens: ["menu", "game"]
    };

    gui.click("start");
    gui.visit("game");

    assert!(gui.meets(50.0));
}

Documentation

• Book - Comprehensive guide
• API Docs - Library documentation
• CLI Reference - Full command reference

License

MIT OR Apache-2.0