Skip to content

Implement ReerJSONEncoder using yyjson for high-performance JSON encoding #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vnixx merged 7 commits into from
Apr 14, 2026
Merged

Implement ReerJSONEncoder using yyjson for high-performance JSON encoding #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
fb27580
Implement ReerJSONEncoder using yyjson for high-performance JSON enco…
vnixx Apr 13, 2026
6fa058a
Optimize: replace post-processing with in-place sort, adopt yyjson na…
vnixx Apr 13, 2026
535eb37
Update README: add ReerJSONEncoder usage and Encoder diff table
vnixx Apr 13, 2026
fa322f7
Optimize encoder performance: T.self== dispatch, bulk yyjson array AP…
vnixx Apr 13, 2026
92562ee
perf: reuse encoder in wrapGenericEncodable, eliminate array copy + o…
vnixx Apr 13, 2026
c33de89
perf: optimize YYJSONKeyedEncodingContainer encoder performance
vnixx Apr 14, 2026
285dc33
refactor: remove nested double array fast paths
vnixx Apr 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# ReerJSON
## A faster version of JSONDecoder based on [yyjson](https://github.com/ibireme/yyjson)
## A faster version of JSONDecoder & JSONEncoder based on [yyjson](https://github.com/ibireme/yyjson)

![Coverage: 88%](https://img.shields.io/static/v1?label=coverage&message=88%&color=brightgreen)
[![SwiftPM compatible](https://img.shields.io/badge/SwiftPM-compatible%20%28iOS%29-brightgreen)](https://swift.org/package-manager/)
Expand Down Expand Up @@ -47,17 +47,19 @@ Depend on `ReerJSON` in your target.
```

# Usage
`ReerJSONDecoder` is API-compatible replacements for Foundation's JSONDecoder.
`ReerJSONDecoder` and `ReerJSONEncoder` are API-compatible replacements for Foundation's JSONDecoder and JSONEncoder.
Simply swap the type and add the import, no other code changes required:

```
import ReerJSON

// Before
let decoder = JSONDecoder()
let encoder = JSONEncoder()

// After
let decoder = ReerJSONDecoder()
let encoder = ReerJSONEncoder()
```

All public interfaces, behaviors, error types, and coding strategies are identical to the Foundation counterparts. The ReerJSON test suite includes exhaustive test cases covering every feature, ensuring full compatibility.
Expand All @@ -67,17 +69,26 @@ All public interfaces, behaviors, error types, and coding strategies are identic

Except for the items listed below, ReerJSON behaves exactly the same as Foundation—every capability, every thrown error, and every edge case is covered by a comprehensive test suite.

## Decoder

| Decoder Diff | Foundation |ReerJSON |
|---------------------------|------------|---------------------------|
| JSON5 | ✅ | ✅ |
| assumesTopLevelDictionary | ✅ | ❌ |
| Infinity and NaN | ±Infinity, ±NaN | ±Infinity, ±NaN, ±Inf and case-insensitive. See [details](https://github.com/reers/ReerJSON/blob/main/Tests/ReerJSONTests/JSONEncoderTests.swift#L1975) |

## Encoder

| Encoder Diff | Foundation | ReerJSON |
|-----------------------|-------------------------|---------------------------------------|
| Unicode escape casing | `\u001f` (lowercase) | `\u001F` (uppercase). Both are valid JSON per RFC 8259 |
| Pretty-print colon | `"key" : value` (space before and after colon) | `"key": value` (space after colon only) |

# TODO
* [x] Add GitHub workflow for CI.
* [x] Support `CodableWithConfiguration`.
* [x] Support JSON5 decoding.
* [ ] Implement ReerJSONEncoder.
* [x] Implement ReerJSONEncoder.

# License
This project is licensed under the MIT License.
Expand Down
Loading