Files
chess-endgame-trainer/lib/chesstrainer/endgames/tablebase/router.ex
T
owenrees 515196857f Route tablebase lookups through a piece-count backend seam (#27)
Add a Backend behaviour, a Lichess implementation, and a Router that picks a backend by piece count: five or fewer to the local slot, six or seven to the remote slot, and eight or more short-circuited as not covered with no network call. Both slots point at Lichess for now; the local Syzygy backend replaces the local slot when it lands.

Map :not_covered to the existing 'not covered by the tablebase' message.
2026-11-03 12:51:08 +01:00

43 lines
1.4 KiB
Elixir

defmodule Chesstrainer.Endgames.Tablebase.Router do
@moduledoc """
Chooses a tablebase backend by piece count.
Positions with five or fewer pieces go to the local slot; six or seven go to
the remote slot. The local slot currently points at Lichess until the local
Syzygy backend lands, so this ships without changing today's behaviour.
Positions with eight or more pieces are beyond every tablebase and are
rejected without a network call.
"""
alias Chesstrainer.Endgames.Tablebase
alias Chesstrainer.Endgames.Tablebase.Backend.Lichess
alias Chesstrainer.FEN
@max_local_pieces 5
@max_pieces 7
# The local Syzygy backend will replace Lichess here once it exists.
@local_backend Lichess
@remote_backend Lichess
@spec backend(String.t()) :: {:ok, module()} | {:error, :not_covered | :invalid_endgame}
def backend(fen) do
case FEN.piece_count(fen) do
count when is_integer(count) and count <= @max_local_pieces -> {:ok, @local_backend}
count when is_integer(count) and count <= @max_pieces -> {:ok, @remote_backend}
count when is_integer(count) -> {:error, :not_covered}
_ -> {:error, :invalid_endgame}
end
end
@spec probe(String.t()) ::
{:ok, Tablebase.t()} | {:cooldown, non_neg_integer()} | {:error, term()}
def probe(fen) do
case backend(fen) do
{:ok, backend} -> backend.probe(fen)
{:error, reason} -> {:error, reason}
end
end
end