Eremey Valetov
e7f35c21ff
Binary SAVE/LOAD: SAVE now writes tokenized binary by default (0xFF header format), matching original GW-BASIC behavior. SAVE "file",A for ASCII. LOAD auto-detects binary vs ASCII from the first byte. Command-line file loading also auto-detects, so binary .BAS files just work. INKEY$ extended keys: arrow keys, Home/End/PgUp/PgDn, Insert/Delete, and F1-F10 now return the correct CHR$(0) + scan_code two-byte sequences per the IBM PC convention. Refactored event trap key parsing to use tui_read_key() instead of duplicating escape sequence parsing. Golden-file regression tests: generated .expected output files for 55 of 58 test programs (3 timing-dependent tests excluded). The test runner now reports compat match status alongside pass/fail. Classic programs: added Hamurabi, Lunar Lander, Gunner, and Diamond from David Ahl's BASIC Computer Games (1978) in tests/classic/ for manual compatibility testing. Docs updated with compiler roadmap item and hardware I/O simulator plan.
52 lines
2.0 KiB
Markdown
52 lines
2.0 KiB
Markdown
# Development
|
|
|
|
## Development History
|
|
|
|
| Version | Commit | Description |
|
|
|---------|--------|-------------|
|
|
| 0.1.0 | `d8e8375` | Expression calculator with direct mode |
|
|
| 0.2.0 | `6162595` | Variables, arrays, program storage, control flow |
|
|
| 0.3.0 | `c2d73e9` | File I/O, PRINT USING, SAVE/LOAD, MID$ assignment, graphics stubs |
|
|
| 0.4.0 | `df5c308` | CHAIN, RUN "file", random-access I/O (FIELD/PUT/GET), CVI/CVS/CVD/MKI$/MKS$/MKD$ |
|
|
| 0.5.0 | `ad21350` | Full-screen TUI editor, KEY statement, Ctrl+Break, Sixel graphics, SOUND/BEEP/PLAY, DOSBox-X compat testing, project rename |
|
|
| 0.6.0 | `ece018d` | DATE$/TIME$/TIMER, FILES, SHELL, CHDIR, MKDIR, RMDIR |
|
|
| 0.7.0 | `da6b513` | AUTO, RENUM (with GOTO/GOSUB patching), DELETE, COMMON, LIST range fix |
|
|
| 0.8.0 | `c68167c` | Dynamic TUI screen buffer, `--full` flag, LPRINT/LLIST with `--lpt` |
|
|
| 0.9.0 | `2a8f98b` | EDIT statement, ON TIMER/ON KEY event trapping, F-key escape parser fixes |
|
|
| 0.10.0 | | Binary tokenized SAVE/LOAD, INKEY$ extended key sequences, golden-file regression tests, classic BASIC programs |
|
|
|
|
## Tests
|
|
|
|
58 test programs in `tests/programs/`, plus 4 classic interactive programs in
|
|
`tests/classic/` (Hamurabi, Lunar Lander, Gunner, Diamond from David Ahl's
|
|
*BASIC Computer Games*).
|
|
|
|
Run the full automated suite:
|
|
|
|
```bash
|
|
bash tests/run_tests.sh
|
|
```
|
|
|
|
Each test has a 5-second timeout. 55 tests have `.expected` golden files
|
|
for output regression detection. Three timing-dependent tests (datetime,
|
|
on_timer, timer_stop) run without golden comparison.
|
|
|
|
### Compatibility Testing
|
|
|
|
Compare output against real GWBASIC.EXE running under DOSBox-X:
|
|
|
|
```bash
|
|
# Generate .expected files from GWBASIC.EXE (requires DOSBox-X Flatpak)
|
|
bash tests/run_compat.sh --generate
|
|
|
|
# Compare gwbasic output against .expected
|
|
bash tests/run_compat.sh
|
|
```
|
|
|
|
## CI
|
|
|
|
GitHub Actions runs on every push to `main` and on pull requests. The workflow
|
|
builds the project with PulseAudio support and runs all 58 test programs.
|
|
|
|
See [`.github/workflows/ci.yml`](https://github.com/evvaletov/gw-basic-2026/blob/main/.github/workflows/ci.yml).
|