mirror of
https://github.com/TheRealOwenRees/chess-endgame-trainer.git
synced 2026-11-18 03:32:06 +00:00
Rename the endgame-label concept from Tag to Theme to match the glossary: the context becomes Chesstrainer.Themes, the schema Chesstrainer.Themes.Theme, and the Endgame association is :themes. The category enum (endgame/opening/tactic) is preserved. Rewrite the original migrations in place so themes / endgames_themes (with theme_id) are created directly, instead of adding a transition migration. Closes #12
127 lines
2.5 KiB
Elixir
127 lines
2.5 KiB
Elixir
defmodule Chesstrainer.Endgames do
|
|
@moduledoc """
|
|
The Endgames context.
|
|
"""
|
|
|
|
import Ecto.Query, warn: false
|
|
alias Chesstrainer.Repo
|
|
|
|
alias Chesstrainer.Endgames.Endgame
|
|
|
|
@doc """
|
|
Returns the list of endgames.
|
|
|
|
## Examples
|
|
|
|
iex> list_endgames()
|
|
[%Endgame{}, ...]
|
|
|
|
"""
|
|
def list_endgames do
|
|
Repo.all(Endgame)
|
|
end
|
|
|
|
@doc """
|
|
Gets a single endgame.
|
|
|
|
Raises `Ecto.NoResultsError` if the Endgame does not exist.
|
|
|
|
## Examples
|
|
|
|
iex> get_endgame!(123)
|
|
%Endgame{}
|
|
|
|
iex> get_endgame!(456)
|
|
** (Ecto.NoResultsError)
|
|
|
|
"""
|
|
def get_endgame!(id), do: Repo.get!(Endgame, id)
|
|
|
|
@doc """
|
|
Creates a endgame.
|
|
|
|
## Examples
|
|
|
|
iex> create_endgame(%{field: value})
|
|
{:ok, %Endgame{}}
|
|
|
|
iex> create_endgame(%{field: bad_value})
|
|
{:error, %Ecto.Changeset{}}
|
|
|
|
"""
|
|
def create_endgame(attrs, themes \\ []) do
|
|
%Endgame{}
|
|
|> Endgame.changeset(attrs)
|
|
|> Ecto.Changeset.put_assoc(:themes, themes)
|
|
|> Repo.insert()
|
|
end
|
|
|
|
@doc """
|
|
Updates a endgame.
|
|
|
|
## Examples
|
|
|
|
iex> update_endgame(endgame, %{field: new_value})
|
|
{:ok, %Endgame{}}
|
|
|
|
iex> update_endgame(endgame, %{field: bad_value})
|
|
{:error, %Ecto.Changeset{}}
|
|
|
|
"""
|
|
def update_endgame(%Endgame{} = endgame, attrs, themes \\ []) do
|
|
# ignore fen on update
|
|
attrs = Map.delete(attrs, "fen")
|
|
|
|
endgame
|
|
|> Repo.preload(:themes)
|
|
|> Endgame.changeset(attrs)
|
|
|> Ecto.Changeset.put_assoc(:themes, themes)
|
|
|> Repo.update()
|
|
end
|
|
|
|
@doc """
|
|
Deletes a endgame.
|
|
|
|
## Examples
|
|
|
|
iex> delete_endgame(endgame)
|
|
{:ok, %Endgame{}}
|
|
|
|
iex> delete_endgame(endgame)
|
|
{:error, %Ecto.Changeset{}}
|
|
|
|
"""
|
|
def delete_endgame(%Endgame{} = endgame) do
|
|
Repo.delete(endgame)
|
|
end
|
|
|
|
@doc """
|
|
Returns an `%Ecto.Changeset{}` for tracking endgame changes.
|
|
|
|
## Examples
|
|
|
|
iex> change_endgame(endgame)
|
|
%Ecto.Changeset{data: %Endgame{}}
|
|
|
|
"""
|
|
def change_endgame(%Endgame{} = endgame, attrs \\ %{}) do
|
|
Endgame.changeset(endgame, attrs)
|
|
end
|
|
|
|
@doc """
|
|
Records the start of an attempt, incrementing `times_attempted`.
|
|
"""
|
|
def record_attempt(%Endgame{id: id}), do: increment(id, times_attempted: 1)
|
|
|
|
@doc """
|
|
Records a solved attempt, incrementing `times_solved`.
|
|
"""
|
|
def record_solve(%Endgame{id: id}), do: increment(id, times_solved: 1)
|
|
|
|
defp increment(id, increments) do
|
|
Repo.update_all(from(e in Endgame, where: e.id == ^id), inc: increments)
|
|
|
|
{:ok, Repo.get!(Endgame, id)}
|
|
end
|
|
end
|