PowerShell on the .NET binding

PowerShell uses the same generated net8.0 assembly as C# and F#. The SDK launcher loads it before parsing a robot's class declarations: pwsh -NoProfile -File /opt/clunkyard/sdk/bindings/powershell/run.ps1 bot.ps1. There is no copied module or separate protocol, tracking or geometry implementation. The assembly loads libclunkyard.so.2, or the file named by CLUNKYARD_LIB.

Subsystems and facts are properties; methods use PascalCase. Absent values are $null. Pass $null for a control field to keep its earlier value in the turn. Drive.Get('throttle') reads the pending value. Throw [Clunkyard.Forfeit]::new(code, message) to forfeit. Other exceptions are logged and send the controls already set. The .NET Clunkyard.Play method plays lines in memory for tests.

A tiny robot

using namespace Clunkyard

class Tiny : Clunkyard.Robot {
    [void] OnTurn(){
        $target=$this.Sensors.Nearest
        if($null -eq $target){
            $this.Drive.Set(0.75,0.25,$null)
            $this.Scanner.Set($this.Me.Heading,40,$null)
            $this.Status.Set('SEARCH',$this.Scanner.Last.Arc)
            return
        }
        $power=$this.Gun.PowerForFlightTime($target.Range,1)
        $aim=$this.Gun.Lead($target,$power)
        $heading=if($null -eq $aim){$target.Bearing}else{$aim.Heading}
        $pitch=if($null -eq $aim){$target.Elevation}else{$aim.Pitch}
        $this.Gun.Aim($heading,$pitch)
        if($this.Gun.CanFire($power,10)){$this.Gun.Fire($power)}
        $this.Drive.Set(0.5,$this.Angles.Clamp($this.Angles.AngleDiff($target.Bearing,$this.Me.Heading)),$null)
        $this.Scanner.Set($target.Bearing,10,$null)
        $this.Status.Set('TRACK',$target.Range)
    }
}

[Clunkyard.Clunkyard]::Run([Tiny]::new())

make test SDK=... runs the shared assembly's complete conformance transcript through PowerShell. The README example also participates in the cross-language act identity check.

Names

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

Download this page as Markdown