mirror of
https://github.com/TheRealOwenRees/chess-endgame-trainer.git
synced 2026-11-18 03:32:06 +00:00
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.
69 lines
2.0 KiB
Elixir
69 lines
2.0 KiB
Elixir
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
|