Native implementation map¶
The native build produces itch_replay and the itch_market shared library used by
Python. Interfaces live under include/itch/.
| Folder | Responsibility |
|---|---|
| app | CLI parsing and output/checkpoint coordination |
| book | Visible orders, price levels and state checks |
| feed | File framing, ITCH decoding and network transport |
| replay | Ordered file playback and checkpoint recovery |
| output | CSV and staged file publication |
| common | Shared binary, digest and path primitives |
| bridge | Native market/preparation handles exposed to Python |
File flow: BinaryFILE reader -> ITCH decoder -> Book -> CSV or Python bridge. Network flow: MoldUDP64 receiver -> sequence/recovery checks -> the same decoder and Book. The App coordinates final output publication.
Run make test from the repository root. Networking tests require local UDP sockets.
New or moved C++ files must be listed in both Makefile and CMakeLists.txt; neither build
silently includes every source file. Keep single-file helpers private. See the
coding rules and test guide.
Maintained source: src/README.md