poka.sh

Docs

SGF

Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.

SGF Game Preview.

At a glance

Purpose A Smart Game Format file: game records (mostly Go) as trees of nodes with properties.
Extensions .sgf
Poka parser poka-sgf
Viewer poka-table-viewer
Depth tier Parser with a shared viewer (see Depth tiers)
Breadth tier B4 Summary (see Breadth tiers)

How much Poka reads

B4 Summary. The container and metadata are read and summarised (counts, properties, structure), but the main content is not rendered.

Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-sgf/src/main.rs (296 lines) and plugin.json. No unit tests or tests/samples.rs, and the corpus has no .sgf sample. Covers .sgf. The table gives one row per top-level game tree with date, event, game type, board size, players with ranks, result and a move count, read from the root properties (GM, SZ, PB, PW, BR, WR, RE, DT, EV, KM, HA). Judgement: B4: the games are listed but the moves are not shown.

What Poka does not read

  • The moves are not shown and no board is drawn
  • Variations are not shown, and their moves are added into the move count
  • Komi and handicap are read but not shown
  • Comments, setup stones and markup are not read
  • Only the first 1,000 games are listed

Libraries

Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.

  • sgf-parse (candidate; MIT; Rust; https://github.com/julianandrews/sgf-parse) — Parses SGF FF[4] into typed Rust values, keeps non-standard properties; latest seen 4.2.8 on docs.rs.
  • sgf-parser (candidate; MIT; Rust; https://docs.rs/sgf-parser/) — pest-based SGF parser supporting all properties and branching; version 2.6.0. Repo github.com/mipli/sgf-parser (Cargo.toml says MIT).
  • sgf-render (candidate; MIT; Rust; https://github.com/julianandrews/sgf-render/) — CLI to generate diagrams of Go games from SGF game records; v3.3.1, updated 2025-09-20; matched on lib.rs, not tested

Sources

  • parsers/poka-sgf/src/main.rs
  • parsers/poka-sgf/plugin.json