The Hew binding

import hew.clunkyard; exposes typed records, subsystem methods, Option for absent values and Vec for lists. Methods use fails CoreError and ?. Controls take optional fields: robot.drive.set(throttle: .Some(0.5))? changes the throttle while retaining any turn already set this tick. match_info names the match subsystem because match is a Hew keyword.

Install with make install SDK=/opt/clunkyard/sdk. Build a robot with hew build --release --pkg-path /opt/clunkyard/sdk/bindings/hew/packages --link-lib /opt/clunkyard/sdk/bindings/hew/libclunkyard_hew.a --link-lib /opt/clunkyard/sdk/lib/libclunkyard.a bot.hew -o bot. The executable links both the core and Hew runtime statically. The generated C shim copies native fields through Hew's scalar and bytes FFI; parsing, tracking, geometry and control decisions stay in the core.

Implement Strategy.on_turn(var self, robot) and optionally on_start. clunkyard.run(strategy) owns the protocol loop; clunkyard.play(strategy, lines) returns replies from a memory session. Returned strategy errors are logged and controls already set are sent. Return error clunkyard.forfeit( code, message) for an explicit forfeit. A core fault sends the empty reply and resumes on the next state. Hew panics terminate the process; use returned errors for recoverable strategy failures. Keep the robot handle within its session and let run or play close it.

A tiny robot

import hew.clunkyard;
import hew.clunkyard.{Robot, Strategy, CoreError, Direction};
type Tiny {}
impl Strategy for Tiny {
    fn on_turn(var self, robot: Robot) fails CoreError {
        let target = match robot.sensors.nearest()? {
            .Some(target) => target,
            .None => {
                robot.drive.set(.Some(0.75), .Some(0.25))?;
                robot.scanner.set(.Some(robot.me.heading()?), .Some(40.0))?;
                robot.status.set(.Some("SEARCH"), .Some((robot.scanner.last()?).arc))?;
                return;
            }
        };
        let power = robot.gun.power_for_flight_time(target.range, 1.0)?;
        let aim = match robot.gun.lead(target, power)? {
            .Some(aim) => Direction { heading: aim.heading, pitch: aim.pitch },
            .None => Direction { heading: target.bearing, pitch: target.elevation },
        };
        robot.gun.aim(.Some(aim.heading), .Some(aim.pitch))?;
        if robot.gun.can_fire(power, 10.0)? { robot.gun.fire(.Some(power))?; }
        robot.drive.set(.Some(0.5), .Some(robot.angles.clamp(robot.angles.angle_diff(target.bearing, robot.me.heading()?)?)?))?;
        robot.scanner.set(.Some(target.bearing), .Some(10.0))?;
        robot.status.set(.Some("TRACK"), .Some(target.range))?;
    }
}
fn main() { let _ = clunkyard.run(Tiny {}); }

make test checks every generated Hew method against the core's full vectors, including typed arguments, records, optional values, lists, text, exact floating-point results and serialized acts.

Names

Every entry of the robot API 2.0.0 in Hew. names.md has every language side by side.

Download this page as Markdown