1
1
Fork 0
mirror of https://github.com/NixOS/nix.git synced 2025-11-09 03:56:01 +01:00

Merge pull request #14278 from obsidiansystems/adl-serializer-xp

Cleanup and JSON serializer and XP feature interations
This commit is contained in:
John Ericson 2025-10-20 18:22:21 +00:00 committed by GitHub
commit f05d240222
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
11 changed files with 166 additions and 164 deletions

View file

@ -14,7 +14,7 @@
namespace nix { namespace nix {
using nlohmann::json; using namespace nlohmann;
class DerivationAdvancedAttrsTest : public CharacterizationTest, public LibStoreTest class DerivationAdvancedAttrsTest : public CharacterizationTest, public LibStoreTest
{ {
@ -59,7 +59,7 @@ TYPED_TEST_SUITE(DerivationAdvancedAttrsBothTest, BothFixtures);
/* Use DRV file instead of C++ literal as source of truth. */ \ /* Use DRV file instead of C++ literal as source of truth. */ \
auto aterm = readFile(this->goldenMaster(NAME ".drv")); \ auto aterm = readFile(this->goldenMaster(NAME ".drv")); \
auto expected = parseDerivation(*this->store, std::move(aterm), NAME, this->mockXpSettings); \ auto expected = parseDerivation(*this->store, std::move(aterm), NAME, this->mockXpSettings); \
Derivation got = Derivation::fromJSON(encoded, this->mockXpSettings); \ Derivation got = adl_serializer<Derivation>::from_json(encoded, this->mockXpSettings); \
EXPECT_EQ(got, expected); \ EXPECT_EQ(got, expected); \
}); \ }); \
} \ } \
@ -71,7 +71,7 @@ TYPED_TEST_SUITE(DerivationAdvancedAttrsBothTest, BothFixtures);
[&]() -> json { \ [&]() -> json { \
/* Use DRV file instead of C++ literal as source of truth. */ \ /* Use DRV file instead of C++ literal as source of truth. */ \
auto aterm = readFile(this->goldenMaster(NAME ".drv")); \ auto aterm = readFile(this->goldenMaster(NAME ".drv")); \
return parseDerivation(*this->store, std::move(aterm), NAME, this->mockXpSettings).toJSON(); \ return parseDerivation(*this->store, std::move(aterm), NAME, this->mockXpSettings); \
}, \ }, \
[](const auto & file) { return json::parse(readFile(file)); }, \ [](const auto & file) { return json::parse(readFile(file)); }, \
[](const auto & file, const auto & got) { return writeFile(file, got.dump(2) + "\n"); }); \ [](const auto & file, const auto & got) { return writeFile(file, got.dump(2) + "\n"); }); \
@ -81,10 +81,10 @@ TYPED_TEST_SUITE(DerivationAdvancedAttrsBothTest, BothFixtures);
{ \ { \
this->readTest(NAME ".drv", [&](auto encoded) { \ this->readTest(NAME ".drv", [&](auto encoded) { \
/* Use JSON file instead of C++ literal as source of truth. */ \ /* Use JSON file instead of C++ literal as source of truth. */ \
auto json = json::parse(readFile(this->goldenMaster(NAME ".json"))); \ auto j = json::parse(readFile(this->goldenMaster(NAME ".json"))); \
auto expected = Derivation::fromJSON(json, this->mockXpSettings); \ auto expected = adl_serializer<Derivation>::from_json(j, this->mockXpSettings); \
auto got = parseDerivation(*this->store, std::move(encoded), NAME, this->mockXpSettings); \ auto got = parseDerivation(*this->store, std::move(encoded), NAME, this->mockXpSettings); \
EXPECT_EQ(got.toJSON(), expected.toJSON()); \ EXPECT_EQ(static_cast<json>(got), static_cast<json>(expected)); \
EXPECT_EQ(got, expected); \ EXPECT_EQ(got, expected); \
}); \ }); \
} \ } \

View file

@ -70,13 +70,7 @@ TEST_F(DynDerivationTest, BadATerm_oldVersionDynDeps)
TEST_P(FIXTURE, from_json) \ TEST_P(FIXTURE, from_json) \
{ \ { \
const auto & [name, expected] = GetParam(); \ const auto & [name, expected] = GetParam(); \
/* Don't use readJsonTest because we want to check experimental \ readJsonTest(Path{"output-"} + name, expected, mockXpSettings); \
features. */ \
readTest(Path{"output-"} + name + ".json", [&](const auto & encoded_) { \
json j = json::parse(encoded_); \
DerivationOutput got = DerivationOutput::fromJSON(j, mockXpSettings); \
ASSERT_EQ(got, expected); \
}); \
} \ } \
\ \
TEST_P(FIXTURE, to_json) \ TEST_P(FIXTURE, to_json) \
@ -193,13 +187,7 @@ INSTANTIATE_TEST_SUITE_P(
TEST_P(FIXTURE, from_json) \ TEST_P(FIXTURE, from_json) \
{ \ { \
const auto & drv = GetParam(); \ const auto & drv = GetParam(); \
/* Don't use readJsonTest because we want to check experimental \ readJsonTest(drv.name, drv, mockXpSettings); \
features. */ \
readTest(drv.name + ".json", [&](const auto & encoded_) { \
auto encoded = json::parse(encoded_); \
Derivation got = Derivation::fromJSON(encoded, mockXpSettings); \
ASSERT_EQ(got, drv); \
}); \
} \ } \
\ \
TEST_P(FIXTURE, to_json) \ TEST_P(FIXTURE, to_json) \
@ -213,7 +201,8 @@ INSTANTIATE_TEST_SUITE_P(
const auto & drv = GetParam(); \ const auto & drv = GetParam(); \
readTest(drv.name + ".drv", [&](auto encoded) { \ readTest(drv.name + ".drv", [&](auto encoded) { \
auto got = parseDerivation(*store, std::move(encoded), drv.name, mockXpSettings); \ auto got = parseDerivation(*store, std::move(encoded), drv.name, mockXpSettings); \
ASSERT_EQ(got.toJSON(), drv.toJSON()); \ using nlohmann::json; \
ASSERT_EQ(static_cast<json>(got), static_cast<json>(drv)); \
ASSERT_EQ(got, drv); \ ASSERT_EQ(got, drv); \
}); \ }); \
} \ } \

View file

@ -3,13 +3,13 @@
#include <gtest/gtest.h> #include <gtest/gtest.h>
#include <rapidcheck/gtest.h> #include <rapidcheck/gtest.h>
#include "nix/util/tests/characterization.hh" #include "nix/util/tests/json-characterization.hh"
#include "nix/store/tests/derived-path.hh" #include "nix/store/tests/derived-path.hh"
#include "nix/store/tests/libstore.hh" #include "nix/store/tests/libstore.hh"
namespace nix { namespace nix {
class DerivedPathTest : public CharacterizationTest, public LibStoreTest class DerivedPathTest : public virtual CharacterizationTest, public LibStoreTest
{ {
std::filesystem::path unitTestData = getUnitTestData() / "derived-path"; std::filesystem::path unitTestData = getUnitTestData() / "derived-path";
@ -123,25 +123,51 @@ RC_GTEST_FIXTURE_PROP(DerivedPathTest, prop_round_rip, (const DerivedPath & o))
using nlohmann::json; using nlohmann::json;
struct SingleDerivedPathJsonTest : DerivedPathTest,
JsonCharacterizationTest<SingleDerivedPath>,
::testing::WithParamInterface<SingleDerivedPath>
{};
struct DerivedPathJsonTest : DerivedPathTest,
JsonCharacterizationTest<DerivedPath>,
::testing::WithParamInterface<DerivedPath>
{};
#define TEST_JSON(TYPE, NAME, VAL) \ #define TEST_JSON(TYPE, NAME, VAL) \
static const TYPE NAME = VAL; \ static const TYPE NAME = VAL; \
\ \
TEST_F(DerivedPathTest, NAME##_from_json) \ TEST_F(TYPE##JsonTest, NAME##_from_json) \
{ \ { \
readTest(#NAME ".json", [&](const auto & encoded_) { \ readJsonTest(#NAME, NAME); \
auto encoded = json::parse(encoded_); \
TYPE got = static_cast<TYPE>(encoded); \
ASSERT_EQ(got, NAME); \
}); \
} \ } \
\ \
TEST_F(DerivedPathTest, NAME##_to_json) \ TEST_F(TYPE##JsonTest, NAME##_to_json) \
{ \ { \
writeTest( \ writeJsonTest(#NAME, NAME); \
#NAME ".json", \ }
[&]() -> json { return static_cast<json>(NAME); }, \
[](const auto & file) { return json::parse(readFile(file)); }, \ #define TEST_JSON_XP_DYN(TYPE, NAME, VAL) \
[](const auto & file, const auto & got) { return writeFile(file, got.dump(2) + "\n"); }); \ static const TYPE NAME = VAL; \
\
TEST_F(TYPE##JsonTest, NAME##_from_json_throws_without_xp) \
{ \
std::optional<json> ret; \
readTest(#NAME ".json", [&](const auto & encoded_) { ret = json::parse(encoded_); }); \
if (ret) { \
EXPECT_THROW(nlohmann::adl_serializer<TYPE>::from_json(*ret), MissingExperimentalFeature); \
} \
} \
\
TEST_F(TYPE##JsonTest, NAME##_from_json) \
{ \
ExperimentalFeatureSettings xpSettings; \
xpSettings.set("experimental-features", "dynamic-derivations"); \
readJsonTest(#NAME, NAME, xpSettings); \
} \
\
TEST_F(TYPE##JsonTest, NAME##_to_json) \
{ \
writeJsonTest(#NAME, NAME); \
} }
TEST_JSON( TEST_JSON(
@ -156,7 +182,7 @@ TEST_JSON(
.output = "bar", .output = "bar",
})); }));
TEST_JSON( TEST_JSON_XP_DYN(
SingleDerivedPath, SingleDerivedPath,
single_built_built, single_built_built,
(SingleDerivedPath::Built{ (SingleDerivedPath::Built{
@ -179,7 +205,7 @@ TEST_JSON(
.outputs = OutputsSpec::Names{"bar", "baz"}, .outputs = OutputsSpec::Names{"bar", "baz"},
})); }));
TEST_JSON( TEST_JSON_XP_DYN(
DerivedPath, DerivedPath,
multi_built_built, multi_built_built,
(DerivedPath::Built{ (DerivedPath::Built{
@ -191,7 +217,7 @@ TEST_JSON(
.outputs = OutputsSpec::Names{"baz", "quux"}, .outputs = OutputsSpec::Names{"baz", "quux"},
})); }));
TEST_JSON( TEST_JSON_XP_DYN(
DerivedPath, DerivedPath,
multi_built_built_wildcard, multi_built_built_wildcard,
(DerivedPath::Built{ (DerivedPath::Built{

View file

@ -1261,9 +1261,15 @@ void Derivation::checkInvariants(Store & store, const StorePath & drvPath) const
const Hash impureOutputHash = hashString(HashAlgorithm::SHA256, "impure"); const Hash impureOutputHash = hashString(HashAlgorithm::SHA256, "impure");
nlohmann::json DerivationOutput::toJSON() const } // namespace nix
namespace nlohmann {
using namespace nix;
void adl_serializer<DerivationOutput>::to_json(json & res, const DerivationOutput & o)
{ {
nlohmann::json res = nlohmann::json::object(); res = nlohmann::json::object();
std::visit( std::visit(
overloaded{ overloaded{
[&](const DerivationOutput::InputAddressed & doi) { res["path"] = doi.path; }, [&](const DerivationOutput::InputAddressed & doi) { res["path"] = doi.path; },
@ -1289,12 +1295,11 @@ nlohmann::json DerivationOutput::toJSON() const
res["impure"] = true; res["impure"] = true;
}, },
}, },
raw); o.raw);
return res;
} }
DerivationOutput DerivationOutput
DerivationOutput::fromJSON(const nlohmann::json & _json, const ExperimentalFeatureSettings & xpSettings) adl_serializer<DerivationOutput>::from_json(const json & _json, const ExperimentalFeatureSettings & xpSettings)
{ {
std::set<std::string_view> keys; std::set<std::string_view> keys;
auto & json = getObject(_json); auto & json = getObject(_json);
@ -1362,18 +1367,18 @@ DerivationOutput::fromJSON(const nlohmann::json & _json, const ExperimentalFeatu
} }
} }
nlohmann::json Derivation::toJSON() const void adl_serializer<Derivation>::to_json(json & res, const Derivation & d)
{ {
nlohmann::json res = nlohmann::json::object(); res = nlohmann::json::object();
res["name"] = name; res["name"] = d.name;
res["version"] = 3; res["version"] = 3;
{ {
nlohmann::json & outputsObj = res["outputs"]; nlohmann::json & outputsObj = res["outputs"];
outputsObj = nlohmann::json::object(); outputsObj = nlohmann::json::object();
for (auto & [outputName, output] : outputs) { for (auto & [outputName, output] : d.outputs) {
outputsObj[outputName] = output; outputsObj[outputName] = output;
} }
} }
@ -1381,7 +1386,7 @@ nlohmann::json Derivation::toJSON() const
{ {
auto & inputsList = res["inputSrcs"]; auto & inputsList = res["inputSrcs"];
inputsList = nlohmann::json ::array(); inputsList = nlohmann::json ::array();
for (auto & input : inputSrcs) for (auto & input : d.inputSrcs)
inputsList.emplace_back(input); inputsList.emplace_back(input);
} }
@ -1401,24 +1406,22 @@ nlohmann::json Derivation::toJSON() const
{ {
auto & inputDrvsObj = res["inputDrvs"]; auto & inputDrvsObj = res["inputDrvs"];
inputDrvsObj = nlohmann::json::object(); inputDrvsObj = nlohmann::json::object();
for (auto & [inputDrv, inputNode] : inputDrvs.map) { for (auto & [inputDrv, inputNode] : d.inputDrvs.map) {
inputDrvsObj[inputDrv.to_string()] = doInput(inputNode); inputDrvsObj[inputDrv.to_string()] = doInput(inputNode);
} }
} }
} }
res["system"] = platform; res["system"] = d.platform;
res["builder"] = builder; res["builder"] = d.builder;
res["args"] = args; res["args"] = d.args;
res["env"] = env; res["env"] = d.env;
if (structuredAttrs) if (d.structuredAttrs)
res["structuredAttrs"] = structuredAttrs->structuredAttrs; res["structuredAttrs"] = d.structuredAttrs->structuredAttrs;
return res;
} }
Derivation Derivation::fromJSON(const nlohmann::json & _json, const ExperimentalFeatureSettings & xpSettings) Derivation adl_serializer<Derivation>::from_json(const json & _json, const ExperimentalFeatureSettings & xpSettings)
{ {
using nlohmann::detail::value_t; using nlohmann::detail::value_t;
@ -1434,7 +1437,7 @@ Derivation Derivation::fromJSON(const nlohmann::json & _json, const Experimental
try { try {
auto outputs = getObject(valueAt(json, "outputs")); auto outputs = getObject(valueAt(json, "outputs"));
for (auto & [outputName, output] : outputs) { for (auto & [outputName, output] : outputs) {
res.outputs.insert_or_assign(outputName, DerivationOutput::fromJSON(output, xpSettings)); res.outputs.insert_or_assign(outputName, adl_serializer<DerivationOutput>::from_json(output, xpSettings));
} }
} catch (Error & e) { } catch (Error & e) {
e.addTrace({}, "while reading key 'outputs'"); e.addTrace({}, "while reading key 'outputs'");
@ -1490,30 +1493,4 @@ Derivation Derivation::fromJSON(const nlohmann::json & _json, const Experimental
return res; return res;
} }
} // namespace nix
namespace nlohmann {
using namespace nix;
DerivationOutput adl_serializer<DerivationOutput>::from_json(const json & json)
{
return DerivationOutput::fromJSON(json);
}
void adl_serializer<DerivationOutput>::to_json(json & json, const DerivationOutput & c)
{
json = c.toJSON();
}
Derivation adl_serializer<Derivation>::from_json(const json & json)
{
return Derivation::fromJSON(json);
}
void adl_serializer<Derivation>::to_json(json & json, const Derivation & c)
{
json = c.toJSON();
}
} // namespace nlohmann } // namespace nlohmann

View file

@ -252,20 +252,26 @@ void adl_serializer<DerivedPath::Built>::to_json(json & json, const DerivedPath:
}; };
} }
SingleDerivedPath::Built adl_serializer<SingleDerivedPath::Built>::from_json(const json & json0) SingleDerivedPath::Built
adl_serializer<SingleDerivedPath::Built>::from_json(const json & json0, const ExperimentalFeatureSettings & xpSettings)
{ {
auto & json = getObject(json0); auto & json = getObject(json0);
auto drvPath = make_ref<SingleDerivedPath>(static_cast<SingleDerivedPath>(valueAt(json, "drvPath")));
drvRequireExperiment(*drvPath, xpSettings);
return { return {
.drvPath = make_ref<SingleDerivedPath>(static_cast<SingleDerivedPath>(valueAt(json, "drvPath"))), .drvPath = std::move(drvPath),
.output = getString(valueAt(json, "output")), .output = getString(valueAt(json, "output")),
}; };
} }
DerivedPath::Built adl_serializer<DerivedPath::Built>::from_json(const json & json0) DerivedPath::Built
adl_serializer<DerivedPath::Built>::from_json(const json & json0, const ExperimentalFeatureSettings & xpSettings)
{ {
auto & json = getObject(json0); auto & json = getObject(json0);
auto drvPath = make_ref<SingleDerivedPath>(static_cast<SingleDerivedPath>(valueAt(json, "drvPath")));
drvRequireExperiment(*drvPath, xpSettings);
return { return {
.drvPath = make_ref<SingleDerivedPath>(static_cast<SingleDerivedPath>(valueAt(json, "drvPath"))), .drvPath = std::move(drvPath),
.outputs = adl_serializer<OutputsSpec>::from_json(valueAt(json, "outputs")), .outputs = adl_serializer<OutputsSpec>::from_json(valueAt(json, "outputs")),
}; };
} }
@ -280,20 +286,21 @@ void adl_serializer<DerivedPath>::to_json(json & json, const DerivedPath & sdp)
std::visit([&](const auto & buildable) { json = buildable; }, sdp.raw()); std::visit([&](const auto & buildable) { json = buildable; }, sdp.raw());
} }
SingleDerivedPath adl_serializer<SingleDerivedPath>::from_json(const json & json) SingleDerivedPath
adl_serializer<SingleDerivedPath>::from_json(const json & json, const ExperimentalFeatureSettings & xpSettings)
{ {
if (json.is_string()) if (json.is_string())
return static_cast<SingleDerivedPath::Opaque>(json); return static_cast<SingleDerivedPath::Opaque>(json);
else else
return static_cast<SingleDerivedPath::Built>(json); return adl_serializer<SingleDerivedPath::Built>::from_json(json, xpSettings);
} }
DerivedPath adl_serializer<DerivedPath>::from_json(const json & json) DerivedPath adl_serializer<DerivedPath>::from_json(const json & json, const ExperimentalFeatureSettings & xpSettings)
{ {
if (json.is_string()) if (json.is_string())
return static_cast<DerivedPath::Opaque>(json); return static_cast<DerivedPath::Opaque>(json);
else else
return static_cast<DerivedPath::Built>(json); return adl_serializer<DerivedPath::Built>::from_json(json, xpSettings);
} }
} // namespace nlohmann } // namespace nlohmann

View file

@ -134,13 +134,6 @@ struct DerivationOutput
*/ */
std::optional<StorePath> std::optional<StorePath>
path(const StoreDirConfig & store, std::string_view drvName, OutputNameView outputName) const; path(const StoreDirConfig & store, std::string_view drvName, OutputNameView outputName) const;
nlohmann::json toJSON() const;
/**
* @param xpSettings Stop-gap to avoid globals during unit tests.
*/
static DerivationOutput
fromJSON(const nlohmann::json & json, const ExperimentalFeatureSettings & xpSettings = experimentalFeatureSettings);
}; };
typedef std::map<std::string, DerivationOutput> DerivationOutputs; typedef std::map<std::string, DerivationOutput> DerivationOutputs;
@ -390,10 +383,6 @@ struct Derivation : BasicDerivation
{ {
} }
nlohmann::json toJSON() const;
static Derivation
fromJSON(const nlohmann::json & json, const ExperimentalFeatureSettings & xpSettings = experimentalFeatureSettings);
bool operator==(const Derivation &) const = default; bool operator==(const Derivation &) const = default;
// TODO libc++ 16 (used by darwin) missing `std::map::operator <=>`, can't do yet. // TODO libc++ 16 (used by darwin) missing `std::map::operator <=>`, can't do yet.
// auto operator <=> (const Derivation &) const = default; // auto operator <=> (const Derivation &) const = default;
@ -537,5 +526,5 @@ std::string hashPlaceholder(const OutputNameView outputName);
} // namespace nix } // namespace nix
JSON_IMPL(nix::DerivationOutput) JSON_IMPL_WITH_XP_FEATURES(nix::DerivationOutput)
JSON_IMPL(nix::Derivation) JSON_IMPL_WITH_XP_FEATURES(nix::Derivation)

View file

@ -299,7 +299,7 @@ void drvRequireExperiment(
} // namespace nix } // namespace nix
JSON_IMPL(nix::SingleDerivedPath::Opaque) JSON_IMPL(nix::SingleDerivedPath::Opaque)
JSON_IMPL(nix::SingleDerivedPath::Built) JSON_IMPL_WITH_XP_FEATURES(nix::SingleDerivedPath::Built)
JSON_IMPL(nix::SingleDerivedPath) JSON_IMPL_WITH_XP_FEATURES(nix::SingleDerivedPath)
JSON_IMPL(nix::DerivedPath::Built) JSON_IMPL_WITH_XP_FEATURES(nix::DerivedPath::Built)
JSON_IMPL(nix::DerivedPath) JSON_IMPL_WITH_XP_FEATURES(nix::DerivedPath)

View file

@ -24,12 +24,12 @@ struct JsonCharacterizationTest : virtual CharacterizationTest
* @param test hook that takes the contents of the file and does the * @param test hook that takes the contents of the file and does the
* actual work * actual work
*/ */
void readJsonTest(PathView testStem, const T & expected) void readJsonTest(PathView testStem, const T & expected, auto... args)
{ {
using namespace nlohmann; using namespace nlohmann;
readTest(Path{testStem} + ".json", [&](const auto & encodedRaw) { readTest(Path{testStem} + ".json", [&](const auto & encodedRaw) {
auto encoded = json::parse(encodedRaw); auto encoded = json::parse(encodedRaw);
T decoded = adl_serializer<T>::from_json(encoded); T decoded = adl_serializer<T>::from_json(encoded, args...);
ASSERT_EQ(decoded, expected); ASSERT_EQ(decoded, expected);
}); });
} }

View file

@ -3,6 +3,8 @@
#include <nlohmann/json_fwd.hpp> #include <nlohmann/json_fwd.hpp>
#include "nix/util/experimental-features.hh"
// Following https://github.com/nlohmann/json#how-can-i-use-get-for-non-default-constructiblenon-copyable-types // Following https://github.com/nlohmann/json#how-can-i-use-get-for-non-default-constructiblenon-copyable-types
#define JSON_IMPL(TYPE) \ #define JSON_IMPL(TYPE) \
namespace nlohmann { \ namespace nlohmann { \
@ -14,3 +16,15 @@
static void to_json(json & json, const TYPE & t); \ static void to_json(json & json, const TYPE & t); \
}; \ }; \
} }
#define JSON_IMPL_WITH_XP_FEATURES(TYPE) \
namespace nlohmann { \
using namespace nix; \
template<> \
struct adl_serializer<TYPE> \
{ \
static TYPE \
from_json(const json & json, const ExperimentalFeatureSettings & xpSettings = experimentalFeatureSettings); \
static void to_json(json & json, const TYPE & t); \
}; \
}

View file

@ -33,7 +33,7 @@ struct CmdAddDerivation : MixDryRun, StoreCommand
{ {
auto json = nlohmann::json::parse(drainFD(STDIN_FILENO)); auto json = nlohmann::json::parse(drainFD(STDIN_FILENO));
auto drv = Derivation::fromJSON(json); auto drv = static_cast<Derivation>(json);
auto drvPath = writeDerivation(*store, drv, NoRepair, /* read only */ dryRun); auto drvPath = writeDerivation(*store, drv, NoRepair, /* read only */ dryRun);

View file

@ -58,7 +58,7 @@ struct CmdShowDerivation : InstallablesCommand, MixPrintJSON
if (!drvPath.isDerivation()) if (!drvPath.isDerivation())
continue; continue;
jsonRoot[drvPath.to_string()] = store->readDerivation(drvPath).toJSON(); jsonRoot[drvPath.to_string()] = store->readDerivation(drvPath);
} }
printJSON(jsonRoot); printJSON(jsonRoot);
} }