Ryan VanderMeulen
490aad98aa
Differential Revision: https://phabricator.services.mozilla.com/D288811
105 lines
3.5 KiB
Markdown
105 lines
3.5 KiB
Markdown
# JsonCpp
|
|
|
|
[](https://conan.io/center/recipes/jsoncpp)
|
|
[](https://github.com/open-source-parsers/jsoncpp/blob/master/LICENSE)
|
|
[](http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html)
|
|
[](https://coveralls.io/github/open-source-parsers/jsoncpp?branch=master)
|
|
|
|
[JSON][json-org] is a lightweight data-interchange format. It can represent
|
|
numbers, strings, ordered sequences of values, and collections of name/value
|
|
pairs.
|
|
|
|
[json-org]: http://json.org/
|
|
|
|
JsonCpp is a C++ library that allows manipulating JSON values, including
|
|
serialization and deserialization to and from strings. It can also preserve
|
|
existing comment in deserialization/serialization steps, making it a convenient
|
|
format to store user input files.
|
|
|
|
## Project Status
|
|
|
|
JsonCpp is a mature project in maintenance mode. Our priority is providing a stable,
|
|
reliable JSON library for the long tail of C++ development.
|
|
|
|
### Current Focus
|
|
|
|
* **Security:** Addressing vulnerabilities and fuzzing results.
|
|
* **Compatibility:** Ensuring the library builds without warnings on the latest versions of GCC,
|
|
Clang, and MSVC.
|
|
* **Reliability:** Fixing regressions and critical logical bugs.
|
|
|
|
### Out of Scope
|
|
|
|
* **Performance:** We are not competing with SIMD-accelerated or reflection-based parsers.
|
|
* **Features:** We are generally not accepting requests for new data formats or major API changes.
|
|
|
|
JsonCpp remains a primary choice for developers who require comment preservation and support for
|
|
legacy toolchains where modern C++ standards are unavailable. The library is intended to be a
|
|
reliable dependency that does not require frequent updates or major migration efforts.
|
|
|
|
## A note on backward-compatibility
|
|
|
|
* **`1.y.z` (master):** Actively maintained. Requires C++11.
|
|
|
|
* **`0.y.z`:** Legacy support for pre-C++11 compilers. Maintenance is limited to critical security fixes.
|
|
|
|
* **`00.11.z`:** Discontinued.
|
|
|
|
Major versions maintain binary compatibility. Critical security fixes are accepted for both the `master` and `0.y.z` branches.
|
|
|
|
## Integration
|
|
|
|
> [!NOTE]
|
|
> Package manager ports (vcpkg, Conan, etc.) are community-maintained. Please report outdated versions or missing generators to their respective repositories.
|
|
|
|
### vcpkg
|
|
Add `jsoncpp` to your `vcpkg.json` manifest:
|
|
|
|
```json
|
|
{
|
|
"dependencies": ["jsoncpp"]
|
|
}
|
|
```
|
|
|
|
Or install via classic mode: `vcpkg install jsoncpp`.
|
|
|
|
### Conan
|
|
|
|
```sh
|
|
conan install --requires="jsoncpp/[*]" --build=missing
|
|
```
|
|
|
|
If you are using a `conanfile.txt` in a Conan 2 project, ensure you use the appropriate generators:
|
|
|
|
```ini
|
|
[requires]
|
|
jsoncpp/[*]
|
|
|
|
[generators]
|
|
CMakeToolchain
|
|
CMakeDeps
|
|
```
|
|
|
|
### Meson
|
|
|
|
```sh
|
|
meson wrap install jsoncpp
|
|
```
|
|
|
|
### Amalgamated source
|
|
|
|
> [!NOTE]
|
|
> This approach may be outdated.
|
|
|
|
For projects requiring a single-header approach, see the [Wiki entry](https://github.com/open-source-parsers/jsoncpp/wiki/Amalgamated-(Possibly-outdated)).
|
|
|
|
## Documentation
|
|
|
|
Documentation is generated via [Doxygen](http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html).
|
|
Additional information is available on the [Project Wiki](https://github.com/open-source-parsers/jsoncpp/wiki).
|
|
|
|
## License
|
|
|
|
JsonCpp is licensed under the MIT license, or public domain where recognized.
|
|
See [LICENSE](./LICENSE) for details.
|