Add local tablebase path config, fetch and check tasks (#31)

Read the local Syzygy directory from TABLEBASE_PATH so a dev machine and a VPS can point at their own copies. Add mix tablebase.fetch (downloads the 3/4/5 WDL+DTZ set, resumable) and mix tablebase.check (verifies it loads), plus a boot log reporting whether local tablebases are ready and the largest piece count.

Covers the codeable part of #31; installing on the VPS and setting TABLEBASE_PATH there remains a manual step.
This commit is contained in:
2026-11-03 14:26:30 +01:00
parent cb35351f8c
commit f37242ed29
7 changed files with 230 additions and 10 deletions
@@ -15,13 +15,13 @@ defmodule Chesstrainer.Endgames.Tablebase.Backend.Fathom do
alias Chesstrainer.Endgames.Tablebase
alias Chesstrainer.Endgames.Tablebase.Backend.Lichess
alias Chesstrainer.Endgames.Tablebase.Fathom, as: Nif
alias Chesstrainer.Endgames.Tablebase.Local
alias Chesstrainer.Endgames.Tablebase.Move
alias Chesstrainer.Endgames.Tablebase.San
@impl true
def probe(fen) do
with {:ok, path} <- tablebase_path(),
{:ok, _largest} <- Nif.init(path),
with {:ok, _largest} <- Local.check(),
{:ok, {root, moves}} <- Nif.probe(fen) do
case root do
:failed -> fallback(fen)
@@ -32,13 +32,6 @@ defmodule Chesstrainer.Endgames.Tablebase.Backend.Fathom do
end
end
defp tablebase_path do
case Application.get_env(:chesstrainer, :tablebase_path) do
path when is_binary(path) and path != "" -> {:ok, path}
_ -> :error
end
end
defp fallback(fen) do
(Application.get_env(:chesstrainer, :tablebase_fallback) || Lichess).probe(fen)
end
@@ -0,0 +1,68 @@
defmodule Chesstrainer.Endgames.Tablebase.Local do
@moduledoc """
Local Syzygy tablebase configuration and verification.
The directory is read from `TABLEBASE_PATH` (see `config/runtime.exs`), so the
same release can point at a different location on a dev machine and on a VPS
without a rebuild. When it is unset the local backend stays disabled and
lookups fall back to Lichess.
On boot this logs whether the local tablebases loaded and how many pieces they
cover, so a misconfigured path is visible in the logs.
"""
use GenServer
require Logger
alias Chesstrainer.Endgames.Tablebase.Fathom
@spec path() :: String.t() | nil
def path do
case Application.get_env(:chesstrainer, :tablebase_path) do
path when is_binary(path) and path != "" -> path
_ -> nil
end
end
@doc """
Initialises Fathom against the configured directory.
Returns `{:ok, largest}` where `largest` is the biggest piece count available
(`0` when the directory has no tablebase files), or `{:error, :not_configured}`
when `TABLEBASE_PATH` is unset.
"""
@spec check() :: {:ok, non_neg_integer()} | {:error, term()}
def check do
with path when is_binary(path) <- path(),
{:ok, largest} <- Fathom.init(path) do
{:ok, largest}
else
nil -> {:error, :not_configured}
{:error, _reason} = error -> error
end
end
def start_link(_opts), do: GenServer.start_link(__MODULE__, :ok, name: __MODULE__)
@impl true
def init(:ok) do
log_status()
{:ok, %{}}
end
defp log_status do
case check() do
{:ok, 0} ->
Logger.warning("local Syzygy tablebases at #{path()} contain no files")
{:ok, largest} ->
Logger.info("local Syzygy tablebases ready at #{path()} (largest=#{largest})")
{:error, :not_configured} ->
Logger.info("local Syzygy tablebases disabled (TABLEBASE_PATH unset)")
{:error, reason} ->
Logger.warning("local Syzygy tablebases failed: #{inspect(reason)}")
end
end
end