Add a Fathom Syzygy probe NIF (#29)

Vendor the MIT-licensed Fathom C source and compile it into a Rustler NIF (native/fathom_nif). The NIF exposes init/1 (point Fathom at a tablebase directory) and probe/1 (raw WDL/DTZ/move results for a FEN); probes are serialised because Fathom's root probe is not thread safe, and run as dirty NIFs.

Add KRvK/KQvK 3-piece WDL+DTZ fixtures and an integration test proving a known KRvK probe returns Win, DTZ 23 and 15 moves.
This commit is contained in:
2026-11-03 13:41:54 +01:00
parent 3fadd4397c
commit e60c161a3a
20 changed files with 5247 additions and 0 deletions
@@ -0,0 +1,29 @@
defmodule Chesstrainer.Endgames.Tablebase.FathomTest do
# Not async: Fathom keeps global state, and `init/1` points it at one directory.
use ExUnit.Case, async: false
alias Chesstrainer.Endgames.Tablebase.Fathom
@fixture_path Path.expand("../../../fixtures/tablebase", __DIR__)
# KRvK, white to move. Fathom CLI reports WDL Win, DTZ 23, 15 legal moves.
@krk "4k3/8/8/8/8/8/8/R3K3 w - - 0 1"
setup_all do
assert {:ok, largest} = Fathom.init(@fixture_path)
assert largest == 3
:ok
end
test "probes a known KRvK position" do
assert {:ok, {root, moves}} = Fathom.probe(@krk)
assert {:win, _from, _to, _promotes, _ep, 23} = root
assert length(moves) == 15
assert Enum.all?(moves, fn {wdl, _from, _to, _promotes, _ep, _dtz} -> wdl == :win end)
end
test "rejects a malformed FEN" do
assert {:error, _reason} = Fathom.probe("not a fen")
end
end