1# JSON Parsing Test Suite 2A comprehensive test suite for RFC 8259 compliant JSON parsers 3 4This repository was created as an appendix to the article [Parsing JSON is a Minefield ��](http://seriot.ch/parsing_json.php). 5 6**/parsers/** 7 8This directory contains several parsers and tiny wrappers to turn the parsers into JSON validators, by returning a specific value. 9 10- `0` the parser did accept the content 11- `1` the parser did reject the content 12- `>1` the process did crash 13- `timeout` happens after 5 seconds 14 15**/test\_parsing/** 16 17The name of these files tell if their contents should be accepted or rejected. 18 19- `y_` content must be accepted by parsers 20- `n_` content must be rejected by parsers 21- `i_` parsers are free to accept or reject content 22 23**/test\_transform/** 24 25These files contain weird structures and characters that parsers may understand differently, eg: 26 27- huge numbers 28- dictionaries with similar keys 29- NULL characters 30- escaped invalid strings 31 32These files were used to produce `results/transform.html`. 33 34**/run_tests.py** 35 36Run all parsers with all files: 37 38 $ python3 run_tests.py 39 40Run all parsers with a specific file: 41 42 $ python3 run_tests.py file.json 43 44Run specific parsers with all files: 45 46 $ echo '["Python 2.7.10", "Python 3.5.2"]' > python_only.json 47 $ python3 run_tests.py --filter=python_only.json 48 49The script writes logs in `results/logs.txt`. 50 51The script then reads `logs.txt` and generates `results/parsing.html`. 52 53**/results/** 54 55<img src="results/pruned_results.png" alt="JSON Parsing Tests" /> 56
