Struct Engine 

pub struct Engine { /* private fields */ }

This represents the controller of an GTP Engine.

You establish a connection like this:

use std::time::Duration;
use gtp::Command;
use gtp::controller::Engine;

let mut ctrl = Engine::new("/usr/bin/gnugo", &["--mode", "gtp"]);
assert!(ctrl.start().is_ok());

ctrl.send(Command::cmd("name", |e| e));
let resp = ctrl.wait_response(Duration::from_millis(500)).unwrap();
let ev = resp.entities(|ep| ep.s().s()).unwrap();
assert_eq!(ev[0].to_string(), "GNU");
assert_eq!(ev[1].to_string(), "Go");
assert_eq!(resp.text(), "GNU Go");

Implementations

impl Engine

pub fn new(cmd: &str, args: &[&str]) -> Engine

Creates a new Engine instance with the path to the engine binary and the arguments to pass to the engine.

pub fn start(&mut self) -> Result<(), Error>

Starts the engine in the background.

pub fn send(&mut self, cmd: Command) -> u32

Sends a command to the engine. Returns the ID of the command.

pub fn stderr(&self) -> String

Returns the currently captured stderr output of the engine.

pub fn clear_stderr(&mut self)

Clears the up to now returned output of the engine.

pub fn wait_response(&mut self, timeout: Duration) -> Result<Response, Error>

This method waits for a maximum amount of time for a response from the GTP engine.

If no response was received in the given time Error::PollAgain is returned.

pub fn poll_response(&mut self) -> Result<Response, Error>

This method polls once for a response from the GTP engine.

If no response was found Error::PollAgain is returned.