Skip to content

Commit 09e0852

Browse files
committed
Update CLAUDE.md
1 parent 7a733bd commit 09e0852

File tree

1 file changed

+25
-2
lines changed

1 file changed

+25
-2
lines changed

CLAUDE.md

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -428,8 +428,8 @@ Large 2D symbols have different runtime bottlenecks, for example:
428428

429429
## Testing
430430

431-
- `tests/run_tests` - Top-level test orchestrator
432-
- `tests/<variant>/run` - Script to run the tests for each build variant
431+
- `tests/run_tests` - Top-level test orchestrator to run tests for all build variants
432+
- `tests/<variant>/run` - Script to run the tests for a single build variant
433433
- `tests/ps_tests/test_utils.ps` - PostScript test utility functions
434434
- `tests/ps_tests/*.ps.test` - Individual resource tests (run from either `build/resource/Resource` or `build/packaged_resource/Resource`); require that test_utils.ps utility is loaded
435435
- `tests/ps_tests/test.ps` - PostScript test entrypoint: Loads utility functions then runs all resource tests
@@ -449,6 +449,29 @@ Encoders may have one or more of the following debug options:
449449
- `debugecc` - Return error correction data
450450
- `debughexagons` - Return hexagon positions (MaxiCode)
451451

452+
### Examples of one off testing and debugging
453+
454+
Run tests for just one of the encoders:
455+
456+
```postscript
457+
gs -q -dNOSAFER -dNOPAUSE -dBATCH -sDEVICE=nullpage -I build/resource/Resource \
458+
-f tests/ps_tests/test_utils.ps -f tests/ps_tests/qrcode.ps.test
459+
```
460+
461+
Debug an encoder's high-level encoding codeword generation:
462+
463+
```postscript
464+
gs -q -dNOSAFER -dNOPAUSE -dBATCH -sDEVICE=nullpage -I build/resource/Resource \
465+
-c '10 10 moveto (TEST) (debugcws) /qrcode /uk.co.terryburton.bwipp findresource exec =='
466+
```
467+
468+
Debug an encoder's ECC codeword generation:
469+
470+
```postscript
471+
gs -q -dNOSAFER -dNOPAUSE -dBATCH -sDEVICE=nullpage -I build/resource/Resource \
472+
-c '10 10 moveto (TEST) (debugecc) /datamatrix /uk.co.terryburton.bwipp findresource exec =='
473+
```
474+
452475

453476
### Test Patterns
454477

0 commit comments

Comments
 (0)