@spec add_game(name :: atom(), stones :: pos_integer()) :: atom() | tuple()

Functions that adds another game A game is an ETS table and a genserver under supervision

Returns a specification to start this module under a supervisor.

See Supervisor.

@spec count_games() :: non_neg_integer()

Functions that returns how many games are currently running

@spec delete_game(pid :: pid()) :: :ok | {:error, :not_found}

Function that terminates a session. Called by Session Purger for games where no move has been made for a while

@spec get_board_state(name :: atom()) :: Hanoi.Board.t()

Function returning the current state of the hanoi board

@spec get_board_state_as_text(name :: atom()) :: String.t()

Debug function returning current state of hanoi board in a textual representation.

@spec get_moves_to_win(name :: atom()) :: list() | :error

Function that for a board with all stones on left pile will move them in a legal way (no big stone on small stone) to the right hand pile

@spec get_number_moves(name :: atom()) :: non_neg_integer()

Function returning the number of moves that have been played.

@spec get_number_stones(name :: atom()) :: non_neg_integer()

Function that returns the number of stones on the board.

@spec is_complete(name :: atom()) :: boolean() | :error

Funtion returns true if game is complete That is all stones in correct order on right hand pile

@spec move_stone(name :: atom(), from :: atom(), to :: atom()) :: :ok | :error

Funtion that moves a stone between piles. Will error if the stone is bigger than the one at the top of the pile. Increments moves taken.

@spec reset_game(name :: atom(), new_stones :: pos_integer()) :: :ok

Restarts a game with a new number of stones on the board. Resets move count

@spec show_games_state() :: Keyword.t()

Functions that returns information on the games currently running

[
  [class: Hanoi.TowerState, name: :Hanoi_91924B39, pid: #PID<0.486.0>, stones: 7, moves: 0, age: 152],
  [class: Hanoi.TowerState, name: :Hanoi_31148637, pid: #PID<0.515.0>, stones: 6, moves: 32, age: 83]
]

@spec start_link(opts :: list()) :: {:error, any()} | {:ok, pid()}

Call this function to start up the module. Name and Stones must be provided.