README.md

# Pokex

**A poker engine**

Implementing a library to play a [Five Hand Draw](https://en.wikipedia.org/wiki/Draw_poker#Standard_five-card_draw) poker variant.

## Installation

The package can be installed
by adding `pokex` to your list of dependencies in `mix.exs`

* as a hex dependency:

```elixir
def deps do
  [
    {:pokex, "~> 0.2.0"}
  ]
end
```

* or as a git dependency:

```elixir
def deps do
  [
    {:pokex, git: "https://bitbucket.org/vmanoli/pokex", tag: "v0.2.0"}
  ]
end
```

## Play

You can open file `play.exs` for a short script that plays a single simple game.

The script can be played -after cloning the repo- by running:

```console
mix run play.exs
```

or -after getting the dependency- by running:

```console
mix run deps/pokex/play.exs
```

The file `gameplay.exs` also has playing commands using the _Pokex API_.
They are not all implemented yet.

## Documentation

Documentation can be found [here](http://hexdocs.pm/pokex).

_Docs also served with :heart: and [Felix](http://fenixwebserver.com/)_

---

## Roadmap

Steps to be taken later on as time allows.

* Betting and Pot implementation
* Better AI for computer player
* Game server with multiple sessions
* Better testing
* Better docs