pydraughts 0.5.6

A draughts library for Python with move generation, PDN reading and writing, engine communication and balloted openings

pydraughts

pydraughts is a draughts library for Python with move generation, PDN reading and writing, engine communication and balloted openings. It is based on ImparaAI/checkers.

Installing

Download and install the latest release:

pip install pydraughts

Features

Note: White always starts. Black always has the squares starting from 1 (e.g. 1-20 in international draughts).

Variants:

• Standard (International)
• Frisian
• frysk!
• Antidraughts
• Breakthrough
• Russian
• Brazilian
• English/American
• Italian
• Turkish

Engine protocols:

• Hub
• DXP
• CheckerBoard

PDN Reading and Writing

• Import pydraughts

from draughts import Game, Move, WHITE, BLACK

• Create a game

game = Game(variant="standard", fen="startpos")

• Make a move

game.push([34, 30])

# Multi-capture
game2 = Game(fen="W:WK40:B19,29")
game2.push([[40, 23], [23, 14]])

• Get legal moves

moves, captures = game.legal_moves()

• Detect wins and draws

has_white_won = game.has_player_won(WHITE)
is_draw = game.is_draw()
winnner = game.get_winner()
is_game_over = game.game_over()

• Convert move to other types

move = Move(game, board_move=moves[0]).pdn_move

• Get fen

fen = game.get_li_fen()

• Communicate with engines

from draughts.engine import HubEngine, Limit
engine = HubEngine(["scan.exe", "hub"])
engine.init()
limit = Limit(time=10)
engine_move = engine.play(game, limit, ponder=False)

• Read PDN games

from draughts.PDN import PDNReader
games = PDNReader(filename=filepath)
game = games.games[0]
moves = game.moves

• Write PDN games

from draughts.PDN import PDNWriter
games = PDNWriter(filename=filepath, board=game)

• Get a ballot

from draughts.ballots import Ballots
ballots = Ballots('english')
ballot1 = ballots.get_ballot()
ballot2 = ballots.get_ballot()

Acknowledgements

Thanks to fishnet which was modified to add support for Hub engines. Thanks to akalverboer for their DXC100_draughts_client which was modified to add support for DXP engines.

License

pydraughts is licensed under The MIT License. Check out LICENSE for the full text. The licenses of the other projects that pydraughts uses are in the other_licenses folder.