picojson 0.2.3

A resource-constrained JSON parser for embedded systems.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# Test Data Sources

This directory contains downloaded JSON conformance test suites used for comprehensive testing of the picojson parser.

## Test Suites

### JSONTestSuite
- **Source**: https://github.com/nst/JSONTestSuite
- **Location**: `tests/data/JSONTestSuite/`
- **Description**: A comprehensive test suite for JSON parsers containing hundreds of test cases
- **Test Categories**:
  - `y_*.json` - Tests that should parse successfully
  - `n_*.json` - Tests that should fail to parse
  - `i_*.json` - Implementation-dependent tests (behavior may vary)
- **Feature Flag**: `remote-tests`

### JSON_checker
- **Source**: http://www.json.org/JSON_checker/
- **Location**: `tests/data/json_checker/`
- **Description**: The original JSON validation test suite from json.org
- **Test Categories**:
  - `pass*.json` - Tests that should parse successfully
  - `fail*.json` - Tests that should fail to parse
- **Feature Flag**: `json-checker-tests`

## Usage

To run tests with both suites:
```bash
cargo test --features="remote-tests,json-checker-tests"
```

To run only JSONTestSuite tests:
```bash
cargo test --features="remote-tests"
```

To run only JSON_checker tests:
```bash
cargo test --features="json-checker-tests"
```

## Automatic Download

Test suites are automatically downloaded during build when the corresponding feature flags are enabled. Downloaded files are cached and won't be re-downloaded unless the directories are removed.

## Generated Tests

The build script (`build.rs`) automatically generates Rust test functions from the JSON files in these directories. Generated tests are written to `tests/conformance_generated.rs`.