Documentation
¶
Overview ¶
Command gengp writes testdata/fixture_riff.gp: the canonical 4-bar fixture riff (see docs/TEXTFORMAT.md) as a Guitar Pro 7/8-style .gp file — a plain ZIP archive holding Content/score.gpif, the id-referential GPIF XML document. It is the .gp member of the cross-format fixture corpus (ROADMAP Phase 0/3); internal/gpimport is tested against its exact tick content.
The archive holds only the gpif entry. Real Guitar Pro 8 exports also carry sidecar entries (a VERSION marker, binary stylesheets, layout and part configuration) that we cannot reproduce faithfully, so they are omitted rather than faked; the importer ignores non-gpif entries either way, and its tests cover archives with extra entries.
Honesty note: this fixture is self-authored from the publicly documented structure of the format (clean-room, docs/DECISIONS.md D3), so the generator and the importer share one understanding of the format. Files exported by Guitar Pro itself remain the untested gap — see testdata/README-gp.txt.
Bar 4 is authored as two tied half notes, exactly as the .gtab source writes it; score.Events() merging them into one whole-note event is the round-trip invariant the corpus pins down.
Source Files