The Elixir binding

The generated Elixir facade shares the Erlang binding's in-process NIF. Facts are functions of the robot handle, records are maps, controls take a map of fields, and an absent result is :undefined. on_start/1 returns memory; on_turn/2 returns its next value. The core owns every helper and the tracker.

Install after the Erlang binding with make install SDK=/opt/clunkyard/sdk. Run with elixir -pa /opt/clunkyard/sdk/bindings/erlang -pa /opt/clunkyard/sdk/bindings/elixir bot.exs.

A tiny robot

defmodule Tiny do
  alias Clunkyard, as: C
  def on_turn(r, state) do
    target = C.sensors_nearest(r)
    if target == :undefined do
      C.drive_set(r, %{throttle: 0.75, turn: 0.25})
      C.scanner_set(r, %{heading: C.me_heading(r), arc: 40})
      C.status_set(r, %{text: "SEARCH", value: C.scanner_last(r).arc})
    else
      power = C.gun_power_for_flight_time(r, target.range, 1)
      aim = C.gun_lead(r, target, power)
      C.gun_aim(r, if(aim == :undefined, do: %{heading: target.bearing, pitch: target.elevation}, else: %{heading: aim.heading, pitch: aim.pitch}))
      if C.gun_can_fire(r, power, 10), do: C.gun_fire(r, %{power: power})
      C.drive_set(r, %{throttle: 0.5, turn: C.angles_clamp(C.angles_angle_diff(target.bearing, C.me_heading(r)), -1, 1)})
      C.scanner_set(r, %{heading: target.bearing, arc: 10})
      C.status_set(r, %{text: "TRACK", value: target.range})
    end
    state
  end
end
Clunkyard.run(Tiny)

make test SDK=... checks the actual generated API against every core vector, including exact floating-point results and act lines. Core errors raise a language error carrying their status. A core fault during input sends its empty act and continues with the next state. User exceptions are logged and send the controls already set. Use the binding’s forfeit helper to give up a match; play runs protocol lines in memory for tests.

Names

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

Download this page as Markdown