Metadata-Version: 2.1
Name: chess-board
Version: 0.3.1
Summary: A python chessboard library for representing game positions.
Home-page: https://github.com/ahira-justice/chess-board
Author: Ahira Adefokun
Author-email: justiceahira@gmail.com
License: GPLv3
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
License-File: LICENSE


# chess-board

## What is chess-board?

chess-board is a Python chessboard package with a flexible "just a board" API for graphically representing game positions.

## What chess-board is **not**

- A chess engine
- A legal move validator
- A PGN parser

While chess-board is designed to work well with any of these, the idea behind chess-board is that the logic that controls the board should be independent of those other problems.

## Entry Points
```sh

from chessboard import display

valid_fen = 'rnbqkbnr/pp1ppppp/8/2p5/4P3/5N2/PPPP1PPP/RNBQKB1R b KQkq - 1 2'

# Initialization
game_board = display.start()

# Position change/update
display.update(valid_fen, game_board)

# Checking GUI window for QUIT event. (Esc or GUI CANCEL)
display.check_for_quit()

# Close window
display.terminate()

```

## Usage
**test.py** - _example_
```sh

from chessboard import display

valid_fen = 'rnbqkbnr/pp1ppppp/8/2p5/4P3/5N2/PPPP1PPP/RNBQKB1R b KQkq - 1 2'

game_board = display.start()

while True:
    display.check_for_quit()
    display.update(valid_fen, game_board)

display.terminate()

```

## Installation
Download and install the latest release:
```sh

# install into virtualenv
source env/bin/activate
pip install chess-board

or 

# install with pipenv
pipenv install chess-board

or

# install system-wide
pip install chess-board

```

Alternatively, you could **git clone** this repo and add the directory to your package.

```sh

git clone https://github.com/ahira-justice/chess-board.git

```

## Dependencies
```sh

pygame==2.1.2

```
**chess-board** installation automatically installs latest **pygame** version.

## License

[GNU GENERAL PUBLIC LICENSE](LICENSE)


