slievr/Roshambo

Rochambo

A GenServer that can play Rock, Paper, Scissors.

Once the application starts the Rochambo.Server is brought up

Requirements

local:

• elixir 1.10.4
• erlang > 21

Alternativly docker can be used.

API

The server exposes the following functions:

• status/0 return the current state of the game one of [:need_players, :waiting_for_gambits]
• join/1 enters the game and binds process to player slot
• play/1 plays the move and waits for round to resolve
• scores/0 returns the score for the game
• players/0 returns the player names

USAGE

Sample usage:

alias Rochambo.Server

def go() do
  Server.status()
  # get game status :need_players signifies a slot

  Server.join(name)
  # ... :joined
  # {:error, reason} when unable

  Server.play(:rock)
  # ... "You won!"

  Server.scores()
  # ... %{"bob" => 1, "michael" => 0}

  Server.players()
  # ... ["bob", "michael"]
end

Docker

A multi stage dockerfile is used for building various images, the images available are as follows

• Test docker build --target test -t rocham .
• Interactive shell docker build --target iex -t rocham .
• Porduction release docker build --target prod -t rocham .

The image can then be run with docker run -it rocham