/* This file is part of solidity. solidity is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. solidity 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 General Public License for more details. You should have received a copy of the GNU General Public License along with solidity. If not, see . */ // SPDX-License-Identifier: GPL-3.0 /** @file JSON.h * @date 2016 * * JSON related helpers */ #pragma once #include #include namespace solidity::util { /// Removes members with null value recursively from (@a _json). Json::Value removeNullMembers(Json::Value _json); /// JSON printing format. struct JsonFormat { enum Format { Compact, // No unnecessary whitespace (including new lines and indentation) Pretty, // Nicely indented, with new lines }; static constexpr uint32_t defaultIndent = 2; bool operator==(JsonFormat const& _other) const noexcept { return (format == _other.format) && (indent == _other.indent); } bool operator!=(JsonFormat const& _other) const noexcept { return !(*this == _other); } Format format = Compact; uint32_t indent = defaultIndent; }; /// Serialise the JSON object (@a _input) with indentation std::string jsonPrettyPrint(Json::Value const& _input); /// Serialise the JSON object (@a _input) without indentation std::string jsonCompactPrint(Json::Value const& _input); /// Serialise the JSON object (@a _input) using specified format (@a _format) std::string jsonPrint(Json::Value const& _input, JsonFormat const& _format); /// Parse a JSON string (@a _input) with enabled strict-mode and writes resulting JSON object to (@a _json) /// \param _input JSON input string /// \param _json [out] resulting JSON object /// \param _errs [out] Formatted error messages /// \return \c true if the document was successfully parsed, \c false if an error occurred. bool jsonParseStrict(std::string const& _input, Json::Value& _json, std::string* _errs = nullptr); }