Package: sente
Sente (from the Japanese せんて/先手) is a general-purpose open-source python library for the ancient chinese board game Go/Badok/Weiqi.
It allows for python code to simulate and play a game of Go and also read, edit and create SGF files.
Sente is designed to be a Python 3 replacement for thegomilllibrary.
In addition to supporting Python 3, Sente is written in C++ which allows AIs that use Sente to take advantage of C++'s superior performance.Installation & RequirementsSente runs on any operating system with python 3.8+ and can be installed via pip.$pipinstallsente-- or --$python3-mpipinstallsenteGetting StartedThe Basic element in Sente is thesente.Gameobject which represents a Simple Game.>>>importsente>>>game=sente.Game()By default, sente creates a 19x19 game with Chinese Rules.
9x9 and 13x13 board sizes and Japanese rules can be specified if desired.note: japanese rules are not reccomended as sente does not currently include automatic dead stone removal.>>>game=sente.Game(13)>>>game=sente.Game(19,sente.rules.JAPANESE)moves can be played on the game using theplay()method, and the board can be printed using the pythonprint()function.>>>game.play(4,4)>>>game.play(4,16)>>>game.play(17,4)>>>print(game)1  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 2  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 3  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 4  .  .  .  ⚫ .  .  .  .  .  *  .  .  .  .  .  *  ⚫ .  .
 5  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 6  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 7  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 8  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
 9  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
10  .  .  .  *  .  .  .  .  .  *  .  .  .  .  .  *  .  .  .
11  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
12  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
13  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
14  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
15  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
16  .  .  .  ⚪ .  .  .  .  .  *  .  .  .  .  .  *  .  .  .
17  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
18  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
19  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .
    A  B  C  D  E  F  G  H  J  K  L  M  N  O  P  Q  R  S  TThe text created by printing a Sente board is designed to be similar to thegomill ascii boards output.
Unlike Gomill however, Sente uses unicode characters to represent black and white stones to make complex board positions more visible and also plots star points.Finally, Sente also provides utilities for reading and saving SGF files using thesente.SGFmodule>>>fromsenteimportsgf>>>game=sgf.load("Lee Sedol ladder game.sgf")>>>move_sequence=game.get_default_sequence()[:95]>>>game.play_sequence(move_sequence)>>>print(game)1...................2.⚪⚫⚪...............3..⚪⚫⚫........⚫.....4...⚪.⚫...*.....⚫...5..⚪⚪...............6..⚪⚫⚫..............7..⚫⚪⚪⚫.............8...⚫⚪⚪⚫............9....⚫⚪⚪⚫...........10...*.⚫⚪⚪⚫*.....*.⚫.11......⚫⚪⚪⚫....⚫.⚫⚪.12.......⚫⚪⚪⚫.⚪⚫.⚫.⚪⚪13........⚫⚪⚪⚫⚪⚫⚫⚪⚪⚪.14.........⚫⚪⚫⚪⚪⚪⚫⚫⚫⚪15..⚪........⚫⚫⚫⚫⚪⚪⚫⚪16...*.....*..⚪..⚪⚪⚫.17...⚪....⚫....⚫⚫⚫⚪⚫⚫18................⚪⚪⚫19.................⚪.ABCDEFGHJKLMNOPQRSTFurther ReadingGame TreesSFG file readerNumPy conversionGTP (Go Text Protocol)Automatic Dead Stone removal(Coming Soon!)Building & ContributingSente usesCMake,gitand C++17. In order to
build the library, you will need CMake, and a
C++ compiler that supports C++17. You can install these
using a software package installer like homebrew or apt.OSx$brewinstallgit
$brewinstallcmake
$xcode-select--install# installs Apple clang++Debian/Ubuntu$sudoapt-getinstallgit
$sudoapt-getinstallcmake
$sudoapt-getinstallg++A sente binary can be built by running the setup script.$python3setup.pydevelopTo import the resulting .so file, simply import sente in a local python interpreter$python3setup.pydevelop
$python3Python 3.8.10 (v3.8.10:3d8993a744, May  3 2021, 09:09:08) 
[Clang 12.0.5 (clang-1205.0.22.9)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import sente
>>>Building documentationin order to build the documentation, you will need to havesphinxinstalled and build a development version of sente.$pipinstall-rrequirements.txt# install sphinx$pythonsetup.pydevelop# build a development version of sente$cddocs
$makehtml# make the html