The APL binding

GNU APL runs one persistent process for a match, with generated Cy* functions calling the Python binding's shared core through a synchronous pipe. Protocol parsing, tracking, geometry and act serialization stay in the core. The adapter does not spawn a process per turn.

Install with make install SDK=/opt/clunkyard/sdk. Put a tactic beside this launcher, and run it with PYTHONPATH containing both bindings/python and bindings/apl from that SDK:

import clunkyard_apl
clunkyard_apl.run("tactic.apl")

The tactic defines niladic OnTurn and optional OnStart. Every API entry has a generated monadic function, such as CyGunLead or CyMatchIs3d. Pass no arguments as ⍬, text arguments enclosed (⊂'text'), and records flattened in their generated field order. Records have generated accessors, such as CyContactRange; record lists begin with the count. Optional absence returns ⍬ and sets CyPresent to zero, so absent text differs from present empty text. Numeric values travel as binary GNU APL Common Data Representation, preserving floating-point bits rather than formatted decimal text. Controls also have named convenience functions such as CyDriveThrottle and CyGunFirePower.

APL errors and core errors are logged by the Python run loop, which sends the controls already set. CySessionForfeit takes enclosed code and message strings. clunkyard_apl.play(tactic,lines) plays a memory session.

A tiny robot

∇OnTurn;T;POWER;A;H;P;S
 T←CySensorsNearest ⍬ ⋄ →(0≠⍴T)/TRACK
 CyDriveThrottle 0.75 ⋄ CyDriveTurn 0.25
 CyScannerHeading CyMeHeading ⍬ ⋄ CyScannerArc 40
 CyStatusText 'SEARCH' ⋄ CyStatusValue CyScanArc CyScannerLast ⍬ ⋄ →0
 TRACK: POWER←CyGunPowerForFlightTime (CyContactRange T),1
 A←CyGunLead T,POWER ⋄ H←CyContactBearing T ⋄ P←CyContactElevation T
 →(0=⍴A)/AIM ⋄ H←CySolutionHeading A ⋄ P←CySolutionPitch A
 AIM: CyGunAimHeading H ⋄ CyGunAimPitch P
 →(~CyGunCanFire POWER 10)/DRIVE ⋄ CyGunFirePower POWER
 DRIVE: CyDriveThrottle 0.5
 CyDriveTurn CyAnglesClamp (CyAnglesAngleDiff (CyContactBearing T),CyMeHeading ⍬),¯1 1
 CyScannerHeading CyContactBearing T ⋄ CyScannerArc 10
 CyStatusText 'TRACK' ⋄ CyStatusValue CyContactRange T
∇

Save that tactic as tiny.apl beside this launcher:

import clunkyard_apl
clunkyard_apl.run("tiny.apl")

make test SDK=... traverses the generated APL functions for every API vector and compares their actual APL values with the core transcript.

Names

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

Download this page as Markdown