p-json 0.1.0

Petr Sabanov's JSON implementation
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# `p-json` — Petr Sabanov's JSON Parser

[![crates.io version](https://img.shields.io/crates/v/p-json?style=for-the-badge&logo=rust)](https://crates.io/crates/p-json)
[![docs.rs documentation](https://img.shields.io/docsrs/p-json/latest?style=for-the-badge&logo=docs.rs&color=2DA44E)](https://docs.rs/p-json/latest/p-json)
[![GitLab latest release](https://img.shields.io/gitlab/v/release/pasabanov%2Fmy-json?style=for-the-badge&logo=gitlab)](https://gitlab.com/pasabanov/p-json/-/releases/permalink/latest)

Written out of pure interest.

### Features

- No `unsafe`.
- Fully self-contained.
- Clear and minimal API.
- Doesn't require `serde`.

### Disadvantages

- Doesn't accept [UTF-16 surrogate characters](https://en.wikipedia.org/wiki/UTF-16#U+D800_to_U+DFFF_(surrogates)).
- Doesn't work with `serde`.

### Usage

To use `p-json` in your project, simply add it to your `Cargo.toml`:

```toml
p-json = "x.y.z"
```

## Examples

### Parsing

```rust
use p_json::{JsonValue, parse};
use indexmap::{IndexMap, indexmap};

fn main() {
	let text = r#"{"id":123,"name":"Alice","active":true}"#;
	let json = parse(text).unwrap();

	assert_eq!(json, JsonValue::Object(indexmap!{
		"id".to_string() => JsonValue::Number(123.0),
		"name".to_string() => JsonValue::String("Alice".to_string()),
		"active".to_string() => JsonValue::Bool(true),
	}));
}
```

### Stringification

```rust
use p_json::{JsonValue, stringify};
use indexmap::{IndexMap, indexmap};

fn main() {
	let mut json = JsonValue::Object(indexmap!{
		"id".to_string() => JsonValue::Number(123.0),
		"name".to_string() => JsonValue::String("Alice".to_string()),
		"active".to_string() => JsonValue::Bool(true),
	});

	let text = stringify(&json);
	assert_eq!(text, r#"{"id":123,"name":"Alice","active":true}"#);
}
```

### Validation

```rust
fn main() {
	let valid = r#"{"key": "value"}"#;
	let invalid = r#"{"key": "value""#;

	assert!(p_json::parse(valid).is_ok());
	assert!(p_json::parse(invalid).is_err());
}
```

## License

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

## Copyright

© 2025 Petr Aleksandrovich Sabanov

## Metrics

![crate size](https://img.shields.io/crates/size/p-json?label=crate%20size&color=orange)