Merge branch 'master' into master

Author: baylesj

.clang-tidy

@@ -2,7 +2,6 @@
 Checks:          'google-readability-casting,modernize-deprecated-headers,modernize-loop-convert,modernize-use-auto,modernize-use-default-member-init,modernize-use-using,readability-else-after-return,readability-redundant-member-init,readability-redundant-string-cstr'
 WarningsAsErrors: ''
 HeaderFilterRegex: ''
-AnalyzeTemporaryDtors: false
 FormatStyle:     none
 CheckOptions:
   - key:             modernize-use-using.IgnoreMacros

BUILD.bazel

@@ -1,7 +1,29 @@
 licenses(["unencumbered"])  # Public Domain or MIT
 
+load("@bazel_skylib//rules:common_settings.bzl", "bool_flag")
+
 exports_files(["LICENSE"])
 
+bool_flag(
+    name = "use_exception",
+    build_setting_default = False,
+)
+
+config_setting(
+    name = "use_exception_cfg",
+    flag_values = {":use_exception": "true"},
+)
+
+bool_flag(
+    name = "has_int64",
+    build_setting_default = True,
+)
+
+config_setting(
+    name = "has_int64_cfg",
+    flag_values = {":has_int64": "true"},
+)
+
 cc_library(
     name = "jsoncpp",
     srcs = [
@@ -22,10 +44,13 @@ cc_library(
         "include/json/version.h",
         "include/json/writer.h",
     ],
-    copts = [
-        "-DJSON_USE_EXCEPTION=0",
-        "-DJSON_HAS_INT64",
-    ],
+    defines = select({
+        ":use_exception_cfg": ["JSON_USE_EXCEPTION=1"],
+        "//conditions:default": ["JSON_USE_EXCEPTION=0"],
+    }) + select({
+        ":has_int64_cfg": ["JSON_HAS_INT64"],
+        "//conditions:default": [],
+    }),
     includes = ["include"],
     visibility = ["//visibility:public"],
     deps = [":private"],

MODULE.bazel

@@ -12,3 +12,8 @@ module(
     version = "1.9.7",
     compatibility_level = 1,
 )
+
+bazel_dep(
+    name = "bazel_skylib",
+    version = "1.7.1",
+)

README.md

@@ -1,11 +1,10 @@
 # JsonCpp
 
-[![badge](https://img.shields.io/badge/conan.io-jsoncpp%2F1.8.0-green.svg?logo=data:image/png;base64%2CiVBORw0KGgoAAAANSUhEUgAAAA4AAAAOCAMAAAAolt3jAAAA1VBMVEUAAABhlctjlstkl8tlmMtlmMxlmcxmmcxnmsxpnMxpnM1qnc1sn85voM91oM11oc1xotB2oc56pNF6pNJ2ptJ8ptJ8ptN9ptN8p9N5qNJ9p9N9p9R8qtOBqdSAqtOAqtR%2BrNSCrNJ/rdWDrNWCsNWCsNaJs9eLs9iRvNuVvdyVv9yXwd2Zwt6axN6dxt%2Bfx%2BChyeGiyuGjyuCjyuGly%2BGlzOKmzOGozuKoz%2BKqz%2BOq0OOv1OWw1OWw1eWx1eWy1uay1%2Baz1%2Baz1%2Bez2Oe02Oe12ee22ujUGwH3AAAAAXRSTlMAQObYZgAAAAFiS0dEAIgFHUgAAAAJcEhZcwAACxMAAAsTAQCanBgAAAAHdElNRQfgBQkREyOxFIh/AAAAiklEQVQI12NgAAMbOwY4sLZ2NtQ1coVKWNvoc/Eq8XDr2wB5Ig62ekza9vaOqpK2TpoMzOxaFtwqZua2Bm4makIM7OzMAjoaCqYuxooSUqJALjs7o4yVpbowvzSUy87KqSwmxQfnsrPISyFzWeWAXCkpMaBVIC4bmCsOdgiUKwh3JojLgAQ4ZCE0AMm2D29tZwe6AAAAAElFTkSuQmCC)](https://bintray.com/theirix/conan-repo/jsoncpp%3Atheirix)
+[![Conan Center](https://img.shields.io/conan/v/jsoncpp)](https://conan.io/center/recipes/jsoncpp)
 [![badge](https://img.shields.io/badge/license-MIT-blue)](https://github.com/open-source-parsers/jsoncpp/blob/master/LICENSE)
 [![badge](https://img.shields.io/badge/document-doxygen-brightgreen)](http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html)
 [![Coverage Status](https://coveralls.io/repos/github/open-source-parsers/jsoncpp/badge.svg?branch=master)](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.
@@ -14,18 +13,16 @@ pairs.
 
 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 unserialization/serialization steps, making it a convenient
+existing comment in deserialization/serialization steps, making it a convenient
 format to store user input files.
 
-
 ## Documentation
 
 [JsonCpp documentation][JsonCpp-documentation] is generated using [Doxygen][].
 
 [JsonCpp-documentation]: http://open-source-parsers.github.io/jsoncpp-docs/doxygen/index.html
 [Doxygen]: http://www.doxygen.org
 
-
 ## A note on backward-compatibility
 
 * `1.y.z` is built with C++11.
@@ -34,34 +31,106 @@ format to store user input files.
 * Major versions maintain binary-compatibility.
 
 ### Special note
-The branch `00.11.z`is a new branch, its major version number `00` is to show that it is
-different from `0.y.z` and `1.y.z`, the main purpose of this branch is to make a balance
-between the other two branches. Thus, users can use some new features in this new branch
-that introduced in 1.y.z, but can hardly applied into 0.y.z.
+
+The branch `00.11.z`is a new branch, its major version number `00` is to show
+that it is different from `0.y.z` and `1.y.z`, the main purpose of this branch
+is to make a balance between the other two branches. Thus, users can use some
+new features in this new branch that introduced in 1.y.z, but can hardly applied
+into 0.y.z.
 
 ## Using JsonCpp in your project
 
 ### The vcpkg dependency manager
-You can download and install JsonCpp using the [vcpkg](https://github.com/Microsoft/vcpkg/) dependency manager:
 
+You can download and install JsonCpp using the [vcpkg](https://github.com/Microsoft/vcpkg/)
+dependency manager, which has installation instruction dependent on your
+build system. For example, if you are in a CMake project, the
+[CMake install tutorial](https://learn.microsoft.com/en-us/vcpkg/get_started/get-started?pivots=shell-powershell)
+suggests the follow installation method.
+
+First, clone and set up `vcpkg`.
+
+```sh
     git clone https://github.com/Microsoft/vcpkg.git
     cd vcpkg
     ./bootstrap-vcpkg.sh
-    ./vcpkg integrate install
-    ./vcpkg install jsoncpp
+```
+
+Then, create a [vcpkg.json manifest](https://learn.microsoft.com/en-us/vcpkg/reference/vcpkg-json),
+enabling manifest mode and adding JsonCpp to the manifest's dependencies list.
+
+```sh
+    vcpkg new --application
+    vcpkg add port jsoncpp
+```
+
+> [!NOTE]: you can use vcpkg in either classic mode or manifest mode (recommended).
+
+#### Classic mode
+
+If your project does not have a `vcpkg.json`,
+your project is in [Classic mode](https://learn.microsoft.com/en-us/vcpkg/concepts/classic-mode)
+you can install JsonCpp by directly invoking the `install` command:
+
+```sh
+    vcpkg install jsoncpp
+```
 
-The JsonCpp port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
+### Manifest mode
+
+If your project *does* have a vcpkg.json manifest, your project is in [Manifest mode](https://learn.microsoft.com/en-us/vcpkg/concepts/manifest-mode)
+and you need to add JsonCpp to your package manifest dependencies, then invoke
+install with no arguments.
+
+```sh
+    vcpkg add port jsoncpp
+    vcpkg install
+```
+
+Example manifest:
+
+```sh
+{
+    "name": "best-app-ever",
+    "dependencies": [ "jsoncpp" ],
+}
+```
+
+> [!NOTE] The JsonCpp port in vcpkg is kept up to date by Microsoft team members and community contributors.
+> If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg)
+> on the vcpkg repository.
+
+### Conan package manager
+
+You can download and install JsonCpp using the [Conan](https://conan.io/)
+package manager:
+
+```sh
+    conan install -r conancenter --requires="jsoncpp/[*]" --build=missing
+```
+
+The JsonCpp package in Conan Center is kept up to date by [ConanCenterIndex](https://github.com/conan-io/conan-center-index)
+contributors. If the version is out of date, please create an issue or pull request on the
+Conan Center Index repository.
 
 ### Amalgamated source
-https://github.com/open-source-parsers/jsoncpp/wiki/Amalgamated-(Possibly-outdated)
+
+See the [Wiki entry on Amalgamated Source](https://github.com/open-source-parsers/jsoncpp/wiki/Amalgamated-(Possibly-outdated)).
 
 ### The Meson Build System
-If you are using the [Meson Build System](http://mesonbuild.com), then you can get a wrap file by downloading it from [Meson WrapDB](https://wrapdb.mesonbuild.com/jsoncpp), or simply use `meson wrap install jsoncpp`.
+
+If you are using the [Meson Build System](http://mesonbuild.com), then you can
+get a wrap file by downloading it from [Meson WrapDB](https://mesonbuild.com/Wrapdb-projects.html),
+or simply use `meson wrap install jsoncpp`.
 
 ### Other ways
-If you have trouble, see the [Wiki](https://github.com/open-source-parsers/jsoncpp/wiki), or post a question as an Issue.
+
+If you have trouble, see the
+[Wiki](https://github.com/open-source-parsers/jsoncpp/wiki), or post a question
+as an Issue.
 
 ## License
 
-See the `LICENSE` file for details. In summary, JsonCpp is licensed under the
-MIT license, or public domain if desired and recognized in your jurisdiction.
+See the [LICENSE](./LICENSE) file for details. In summary, JsonCpp is licensed
+under the MIT license, or public domain if desired and recognized in your
+jurisdiction.

gcovr.cfg

@@ -0,0 +1,22 @@
+# Newer versions of gcovr have strict function merging by default, which
+# can cause issues with header-only functions or macros (like in jsontest.h).
+# 'separate' mode keeps them distinct, fixing the GcovrMergeAssertionError.
+merge-mode-functions = separate
+
+# --- Filtering ---
+# Only include the library sources in the coverage report.
+# This ensures coverage stats reflect the library quality and ignores test code.
+filter = src/lib_json/
+filter = include/json/
+
+# Exclude the build directory to avoid processing generated files
+exclude-directories = build
+
+# --- Noise Reduction ---
+# Ignore branches that are generated by the compiler (e.g., exception handling)
+# This drastically reduces "false positives" for missing branch coverage.
+exclude-throw-branches = yes
+
+# --- CI Visibility ---
+# Print a small summary table to the console logs.
+print-summary = yes

src/jsontestrunner/BUILD.bazel

@@ -0,0 +1,6 @@
+cc_binary(
+    name = "jsontestrunner",
+    srcs = ["main.cpp"],
+    deps = ["//:jsoncpp"],
+    visibility = ["//test:__pkg__"],
+)

src/lib_json/json_reader.cpp

@@ -16,6 +16,7 @@
 #include <cstring>
 #include <iostream>
 #include <istream>
+#include <iterator>
 #include <limits>
 #include <memory>
 #include <set>
@@ -143,7 +144,12 @@ bool Reader::readValue() {
   // after calling readValue(). parse() executes one nodes_.push(), so > instead
   // of >=.
   if (nodes_.size() > stackLimit_g)
+#if JSON_USE_EXCEPTION
     throwRuntimeError("Exceeded stackLimit in readValue().");
+#else
+    // throwRuntimeError aborts. Don't abort here.
+    return false;
+#endif
 
   Token token;
   readTokenSkippingComments(token);

src/test_lib_json/BUILD.bazel

@@ -0,0 +1,11 @@
+cc_test(
+    name = "jsoncpp_test",
+    srcs = [
+        "jsontest.cpp",
+        "jsontest.h",
+        "main.cpp",
+        "fuzz.h",
+        "fuzz.cpp",
+        ],
+    deps = ["//:jsoncpp"],
+)

src/test_lib_json/fuzz.cpp

@@ -11,10 +11,6 @@
 #include <memory>
 #include <string>
 
-namespace Json {
-class Exception;
-}
-
 extern "C" int LLVMFuzzerTestOneInput(const uint8_t* data, size_t size) {
   Json::CharReaderBuilder builder;
 
@@ -45,10 +41,14 @@ extern "C" int LLVMFuzzerTestOneInput(const uint8_t* data, size_t size) {
 
   Json::Value root;
   const auto data_str = reinterpret_cast<const char*>(data);
+#if JSON_USE_EXCEPTION
   try {
+#endif // JSON_USE_EXCEPTION
     reader->parse(data_str, data_str + size, &root, nullptr);
+#if JSON_USE_EXCEPTION
   } catch (Json::Exception const&) {
   }
+#endif // JSON_USE_EXCEPTION
   // Whether it succeeded or not doesn't matter.
   return 0;
 }

src/test_lib_json/jsontest.h

@@ -228,6 +228,8 @@ TestResult& checkStringEqual(TestResult& result, const Json::String& expected,
                              JsonTest::ToJsonString(actual), __FILE__,         \
                              __LINE__, #expected " == " #actual)
 
+#if JSON_USE_EXCEPTION
+
 /// \brief Asserts that a given expression throws an exception
 #define JSONTEST_ASSERT_THROWS(expr)                                           \
   do {                                                                         \
@@ -242,6 +244,8 @@ TestResult& checkStringEqual(TestResult& result, const Json::String& expected,
                           "expected exception thrown: " #expr);                \
   } while (0)
 
+#endif // JSON_USE_EXCEPTION
+
 /// \brief Begin a fixture test case.
 #define JSONTEST_FIXTURE(FixtureType, name)                                    \
   class Test##FixtureType##name : public FixtureType {                         \