libpoker

= libpoker

Libpoker is a Ruby-based poker simulation library.

== Networking

My goal is that libpoker should be able to work over a network, with a libpoker server serving to various poker clients, and for players to be able to connect to a game remotely, and play as if the remote end exposed the libpoker interface.

It should also be threadable, so a game can be running in one thread, and clients can connect remotely or locally to the game while it is running.

== Usage

=== Standard

include Poker

game = Game.new :table => Table.new(6), :ruleset => :hold_em, :limit => :no_limit, :blinds => [25, 50]

game.play # forks the game into the background

game.seat Player::Human.new('Player 1', 1000) game.seat Player::Human.new('Player 2', 1000)

game.stop # stops the game at the end of the current hand

=== Poker Server

include Poker

game = Game.new :table => Table.new(6), :ruleset => :hold_em, :limit => :no_limit, :blinds => [25, 50], :host => '127.0.0.1', :port => 4210

game.play

=== Poker Client

include Poker

game = Game.remote :host => '127.0.0.1', :port => 4210

game.seat Player::Human.new('Player 1', 1000)

=== Player API

One concern is that players should not be allowed to see too much information about their opponents' hands. Somehow, the game object needs to proxy or sanitize Hand objects before handing them off to the player.

A player must simply respond to the +act+ method, accepting the +game+ as a parameter, and return either :fold, :call (which suffices as a check, when no bets have been made), or the amount to bet.