SAN Kit was made public in 1993 by Stephen Edwards, the inventor of PGN Chess notation. The original code is in C, and with few comments quite cryptic. In addition, the original author's style was quite quixotic, making it even more difficult to read.
This code is now reformatted to modern standards, adds support for NAG codes and comments, and has a "non-CLI" mode for inclusion in chess playing programs.
The code has gone through extensive analysis using the llvm/clang compiler and reports no issues at this time. To use the code as a "framework" you would undefined "CLI".
In addition, a small C++ program is included that takes as input a file of one or more PGN records, and outputs pure pristine PGN records as output. In addition to flagging errors at the move level, the program provides three boards around the move.
NOTE: plan on budgeting a fair amount of time to read, re-read, and experiment with the documentation and cryptic uncommented code. You are on your own
Features
- Read sloppily written PGN text, output perfect "export" quality PGN
- Replay games in PGN format
- Play games (using CLI) against the original authors automated player
License
BSD LicenseFollow SANKit
User Reviews
-
I incorporated this code in an iPhone app, ChessNotePad. In addition to having this code create PGN for me, I was able to load games move by move, and verify whether or not a proposed move was legal or not (this took some effort). I no longer support ChessNotePad and frankly don't recall how I used the library, but I did add two features to the original: import and export of both NAG codes and comments. If you want to use this code, it offers a lot, but demands a lot. There are no comments, the functions all have similar looking names, and the original documentation leaves a lot to be desired. The only want to really learn it is play around with it, add print statements, etc. I found that the vast majority of PGN files on the web, on the well known web sites, are faulty (I actually tracked down the apparent discrepancy to verify that they were in fact violations).