A pure Python 3 library to simplify parsing and manipulation of PGN (Portable Game Notation) format files, which are often used for serializing games such as chess.
Python version 3.x
>= 3.6
and PiP
Install or upgrade with PiP
$ pip install pypgn
You can also install from source:
git clone https://github.com/DaniruKun/pypgn.git
cd pypgn
python setup.py install
from pypgn.game import Game
# Importing game from file on disk
chess_game = Game('test.pgn')
# Import game from Lichess
chess_game.pgn('dGm3ND39')
print(chess_game.tag('Event'))
print(chess_game.result())
# Print opening ply for white
print(chess_game.ply(1, 'w'))
Output:
$ Rated Blitz game
$ 0-1
$ e4
Setup a virtual environment with virtualenv
$ virtualenv venv
$ source venv/bin/activate
Install requirements
$ make install
Run unit tests locally with pytest
$ make test
Run flake8
lint with
$ make lint
You can also build and run tests in a Docker container:
$ make docker-build
$ make docker-run
@DaniruKun aka Daniils Petrovs
Mozilla Public License 2.0 see LICENSE for more details.