https://github.com/grondilu/chess
Chess-related stuff in raku
https://github.com/grondilu/chess
chess raku
Last synced: 2 months ago
JSON representation
Chess-related stuff in raku
- Host: GitHub
- URL: https://github.com/grondilu/chess
- Owner: grondilu
- License: artistic-2.0
- Created: 2014-07-03T13:17:52.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2025-05-07T12:25:10.000Z (2 months ago)
- Last Synced: 2025-05-07T13:32:43.489Z (2 months ago)
- Topics: chess, raku
- Language: Raku
- Homepage:
- Size: 10.1 MB
- Stars: 6
- Watchers: 2
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Chess
Chess-related stuff in Raku
## SYNOPSIS
```
$ raku -MChess
> say startpos;
rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1
> say startpos * 'e4'; # position after 1.e4
rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1
> (startpos * 'd4').ascii; # see further for kitty terminal
+------------------------+
8 | r n b q k b n r |
7 | p p p p p p p p |
6 | . . . . . . . . |
5 | . . . . . . . . |
4 | . . . P . . . . |
3 | . . . . . . . . |
2 | P P P . P P P P |
1 | R N B Q K B N R |
+------------------------+
> say legal-moves startpos;
[d3 d4 e3 e4 c3 c4 f3 f4 Nf3 Nh3 h3 h4 a3 a4 g3 g4 Na3 Nc3 b3 b4]
```
## Description
### PGN Grammar
```raku
use Chess::PGN;
say Chess::PGN.parse: "1. f3 e5 2. g4?? Qh4#";
```
### FEN Grammar
```raku
use Chess::FEN;
say Chess::FEN.parse('rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1');
```
See [the wikipedia article about FEN](http://en.wikipedia.org/wiki/Forsyth%E2%80%93Edwards_Notation) for more information.
## General utilities
### Graphical display
In addition to the ASCII representation mentioned above,
there are two other possibilities to display a chess position:
- one is using unicode chess characters, along with escape code sequences to change the background and foreground colors of each square.
- the other is using [Kitty's graphics protocol](https://sw.kovidgoyal.net/kitty/graphics-protocol/). This second solution is a bit slow
at startup, it requires [ImageMagick](https://imagemagick.org/script/command-line-tools.php) to be installed on your system,
and it's not very robust to things like terminal zoom or scrolling. It looks very good though, using the same piece set as the default one
on lichess.
### Polyglot books
WIP
## TODO
- [x] implement rules of the game
- [ ] interface Stockfish
- [x] make Board image internally, not relying on lichess
- [ ] opening and tactics trainer
- [ ] game database management
- [ ] translate [Chess.js](https://github.com/jhlywa/chess.js/tree/master)
- [ ] read and write [Polyglot books](https://www.chessprogramming.org/PolyGlot)
- [ ] make the board square as tall as the cursor by default
- [ ] clean-up and update README