From e27904081379328c48153f7dcf8cdc7f2a9084e5 Mon Sep 17 00:00:00 2001 From: Nikolai Kochetov Date: Fri, 9 Apr 2021 14:38:19 +0300 Subject: [PATCH 01/93] Update boost. --- contrib/boost | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contrib/boost b/contrib/boost index ee24fa55bc4..b97ed144799 160000 --- a/contrib/boost +++ b/contrib/boost @@ -1 +1 @@ -Subproject commit ee24fa55bc46e4d2ce7d0d052cc5a0d9b1be8c36 +Subproject commit b97ed14479927ac9fc378ed9610393114dfeb6b5 From 66b6d53a93f45a5eb8c62ad1f464f2de1deec7d4 Mon Sep 17 00:00:00 2001 From: Nikolai Kochetov Date: Fri, 9 Apr 2021 17:44:58 +0300 Subject: [PATCH 02/93] Add json=1 setting for explain actions --- src/Interpreters/InterpreterExplainQuery.cpp | 15 ++++- src/Processors/QueryPlan/IQueryPlanStep.h | 4 ++ src/Processors/QueryPlan/QueryPlan.cpp | 60 ++++++++++++++++++++ src/Processors/QueryPlan/QueryPlan.h | 2 + 4 files changed, 80 insertions(+), 1 deletion(-) diff --git a/src/Interpreters/InterpreterExplainQuery.cpp b/src/Interpreters/InterpreterExplainQuery.cpp index 4eff8b8456d..864bbbb5fe1 100644 --- a/src/Interpreters/InterpreterExplainQuery.cpp +++ b/src/Interpreters/InterpreterExplainQuery.cpp @@ -18,6 +18,9 @@ #include #include +#include +#include + namespace DB { @@ -121,6 +124,7 @@ struct QueryPlanSettings /// Apply query plan optimizations. bool optimize = true; + bool json = false; constexpr static char name[] = "PLAN"; @@ -130,6 +134,7 @@ struct QueryPlanSettings {"description", query_plan_options.description}, {"actions", query_plan_options.actions}, {"optimize", optimize}, + {"json", json} }; }; @@ -255,7 +260,15 @@ BlockInputStreamPtr InterpreterExplainQuery::executeImpl() if (settings.optimize) plan.optimize(QueryPlanOptimizationSettings::fromContext(context)); - plan.explainPlan(buf, settings.query_plan_options); + if (settings.json) + { + auto tree = plan.explainPlan(); + std::stringstream out; + boost::property_tree::json_parser::write_json(out, tree); + buf.str() = out.str(); + } + else + plan.explainPlan(buf, settings.query_plan_options); } else if (ast.getKind() == ASTExplainQuery::QueryPipeline) { diff --git a/src/Processors/QueryPlan/IQueryPlanStep.h b/src/Processors/QueryPlan/IQueryPlanStep.h index 8211b52a6c4..5b235833ad0 100644 --- a/src/Processors/QueryPlan/IQueryPlanStep.h +++ b/src/Processors/QueryPlan/IQueryPlanStep.h @@ -3,6 +3,8 @@ #include #include +#include + namespace DB { @@ -96,6 +98,8 @@ public: const bool write_header = false; }; + virtual void describeActions(boost::property_tree::ptree & /*tree*/) const {} + /// Get detailed description of step actions. This is shown in EXPLAIN query with options `actions = 1`. virtual void describeActions(FormatSettings & /*settings*/) const {} diff --git a/src/Processors/QueryPlan/QueryPlan.cpp b/src/Processors/QueryPlan/QueryPlan.cpp index 974da579d0c..bac4dc232ce 100644 --- a/src/Processors/QueryPlan/QueryPlan.cpp +++ b/src/Processors/QueryPlan/QueryPlan.cpp @@ -9,6 +9,7 @@ #include #include #include +#include namespace DB { @@ -200,6 +201,65 @@ void QueryPlan::addInterpreterContext(std::shared_ptr context) } +static boost::property_tree::ptree explainStep(const IQueryPlanStep & step) +{ + boost::property_tree::ptree tree; + tree.put("Node Type", step.getName()); + + const auto & description = step.getStepDescription(); + if (!description.empty()) + tree.put("Description", description); + + step.describeActions(tree); + + return tree; +} + +boost::property_tree::ptree QueryPlan::explainPlan() +{ + checkInitialized(); + + struct Frame + { + Node * node; + size_t next_child = 0; + boost::property_tree::ptree node_tree = {}; + boost::property_tree::ptree children_trees = {}; + }; + + std::stack stack; + stack.push(Frame{.node = root}); + + boost::property_tree::ptree tree; + + while (!stack.empty()) + { + auto & frame = stack.top(); + + if (frame.next_child == 0) + frame.node_tree = explainStep(*frame.node->step); + + if (frame.next_child < frame.node->children.size()) + { + stack.push(Frame{frame.node->children[frame.next_child]}); + ++frame.next_child; + } + else + { + if (!frame.children_trees.empty()) + frame.node_tree.add_child("Plans", frame.children_trees); + + tree.swap(frame.node_tree); + stack.pop(); + + if (!stack.empty()) + stack.top().children_trees.add_child("", tree); + } + } + + return tree; +} + static void explainStep( const IQueryPlanStep & step, IQueryPlanStep::FormatSettings & settings, diff --git a/src/Processors/QueryPlan/QueryPlan.h b/src/Processors/QueryPlan/QueryPlan.h index d5cc2e8f4e8..d68b57452cb 100644 --- a/src/Processors/QueryPlan/QueryPlan.h +++ b/src/Processors/QueryPlan/QueryPlan.h @@ -3,6 +3,7 @@ #include #include #include +#include #include @@ -73,6 +74,7 @@ public: bool header = false; }; + boost::property_tree::ptree explainPlan(); void explainPlan(WriteBuffer & buffer, const ExplainPlanOptions & options); void explainPipeline(WriteBuffer & buffer, const ExplainPipelineOptions & options); From 48bcd5b490c4321ac9d3df881a06467acac09860 Mon Sep 17 00:00:00 2001 From: Nikolai Kochetov Date: Fri, 9 Apr 2021 19:18:45 +0300 Subject: [PATCH 03/93] Add tree conversion for expression. --- src/Interpreters/ActionsDAG.cpp | 45 +++++++++++++ src/Interpreters/ActionsDAG.h | 6 ++ src/Interpreters/ExpressionActions.cpp | 74 +++++++++++++++++++++ src/Interpreters/ExpressionActions.h | 2 + src/Processors/QueryPlan/ExpressionStep.cpp | 8 +++ src/Processors/QueryPlan/ExpressionStep.h | 2 + 6 files changed, 137 insertions(+) diff --git a/src/Interpreters/ActionsDAG.cpp b/src/Interpreters/ActionsDAG.cpp index 4d2465b6e93..b091a2e7373 100644 --- a/src/Interpreters/ActionsDAG.cpp +++ b/src/Interpreters/ActionsDAG.cpp @@ -13,6 +13,7 @@ #include #include +#include namespace DB { @@ -27,6 +28,50 @@ namespace ErrorCodes extern const int ILLEGAL_COLUMN; } +const char * ActionsDAG::typeToString(ActionsDAG::ActionType type) +{ + switch (type) + { + case ActionType::INPUT: + return "Input"; + case ActionType::COLUMN: + return "Column"; + case ActionType::ALIAS: + return "Alias"; + case ActionType::ARRAY_JOIN: + return "ArrayJoin"; + case ActionType::FUNCTION: + return "Function"; + } + + __builtin_unreachable(); +} + +boost::property_tree::ptree ActionsDAG::Node::toTree() const +{ + boost::property_tree::ptree tree; + tree.add("NodeType", ActionsDAG::typeToString(type)); + + if (result_type) + tree.add("ResultType", result_type->getName()); + + if (!result_name.empty()) + tree.add("ResultType", ActionsDAG::typeToString(type)); + + if (column) + tree.add("Column", column->getName()); + + if (function_base) + tree.add("Function", function_base->getName()); + else if (function_builder) + tree.add("Function", function_base->getName()); + + if (type == ActionType::FUNCTION) + tree.add("Compiled", is_function_compiled); + + return tree; +} + ActionsDAG::ActionsDAG(const NamesAndTypesList & inputs_) { diff --git a/src/Interpreters/ActionsDAG.h b/src/Interpreters/ActionsDAG.h index 6fd9d1f8f3a..9edeb7d9ada 100644 --- a/src/Interpreters/ActionsDAG.h +++ b/src/Interpreters/ActionsDAG.h @@ -8,6 +8,8 @@ # include "config_core.h" #endif +#include + namespace DB { @@ -54,6 +56,8 @@ public: FUNCTION, }; + static const char * typeToString(ActionType type); + struct Node; using NodeRawPtrs = std::vector; using NodeRawConstPtrs = std::vector; @@ -80,6 +84,8 @@ public: /// Some functions like `ignore()` always return constant but can't be replaced by constant it. /// We calculate such constants in order to avoid unnecessary materialization, but prohibit it's folding. bool allow_constant_folding = true; + + boost::property_tree::ptree toTree() const; }; /// NOTE: std::list is an implementation detail. diff --git a/src/Interpreters/ExpressionActions.cpp b/src/Interpreters/ExpressionActions.cpp index e4d81dbbf94..7232297c315 100644 --- a/src/Interpreters/ExpressionActions.cpp +++ b/src/Interpreters/ExpressionActions.cpp @@ -15,6 +15,7 @@ #include #include #include +#include #if defined(MEMORY_SANITIZER) #include @@ -258,6 +259,31 @@ std::string ExpressionActions::Action::toString() const return out.str(); } +boost::property_tree::ptree ExpressionActions::Action::toTree() const +{ + boost::property_tree::ptree tree; + + if (node) + tree = node->toTree(); + + boost::property_tree::ptree args; + boost::property_tree::ptree dropped_args; + for (auto arg : arguments) + { + boost::property_tree::ptree arg_tree; + arg_tree.put("", arg.pos); + args.add_child("", arg_tree); + if (!arg.needed_later) + dropped_args.add_child("", arg_tree); + } + + tree.add_child("Arguments", args); + tree.add_child("RemovedArguments", dropped_args); + tree.put("Result", result_position); + + return tree; +} + void ExpressionActions::checkLimits(const ColumnsWithTypeAndName & columns) const { if (settings.max_temporary_non_const_columns) @@ -567,6 +593,54 @@ std::string ExpressionActions::dumpActions() const return ss.str(); } +boost::property_tree::ptree ExpressionActions::toTree() const +{ + boost::property_tree::ptree inputs_tree; + + for (const auto & input_column : required_columns) + { + boost::property_tree::ptree tree; + tree.add("Name", input_column.name); + if (input_column.type) + tree.add("Type", input_column.type->getName()); + + inputs_tree.add_child("", tree); + } + + boost::property_tree::ptree outputs_tree; + + for (const auto & output_column : sample_block) + { + boost::property_tree::ptree tree; + tree.add("Name", output_column.name); + if (output_column.type) + tree.add("Type", output_column.type->getName()); + + outputs_tree.add_child("", tree); + } + + boost::property_tree::ptree actions_tree; + for (const auto & action : actions) + actions_tree.add_child("", action.toTree()); + + boost::property_tree::ptree positions_tree; + for (auto pos : result_positions) + { + boost::property_tree::ptree pos_tree; + pos_tree.put("", pos); + positions_tree.add_child("", pos_tree); + } + + boost::property_tree::ptree tree; + tree.add_child("Inputs", inputs_tree); + tree.add_child("Actions", actions_tree); + tree.add_child("Outputs", outputs_tree); + tree.add_child("Positions", positions_tree); + tree.put("ProjectInput", actions_dag->isInputProjected()); + + return tree; +} + bool ExpressionActions::checkColumnIsAlwaysFalse(const String & column_name) const { /// Check has column in (empty set). diff --git a/src/Interpreters/ExpressionActions.h b/src/Interpreters/ExpressionActions.h index 5d48ed84b7c..2edd97abb5e 100644 --- a/src/Interpreters/ExpressionActions.h +++ b/src/Interpreters/ExpressionActions.h @@ -58,6 +58,7 @@ public: size_t result_position; std::string toString() const; + boost::property_tree::ptree toTree() const; }; using Actions = std::vector; @@ -108,6 +109,7 @@ public: const Block & getSampleBlock() const { return sample_block; } std::string dumpActions() const; + boost::property_tree::ptree toTree() const; static std::string getSmallestColumn(const NamesAndTypesList & columns); diff --git a/src/Processors/QueryPlan/ExpressionStep.cpp b/src/Processors/QueryPlan/ExpressionStep.cpp index c85092edf05..bdb2ce07f5a 100644 --- a/src/Processors/QueryPlan/ExpressionStep.cpp +++ b/src/Processors/QueryPlan/ExpressionStep.cpp @@ -7,6 +7,8 @@ #include #include +#include + namespace DB { @@ -110,6 +112,12 @@ void ExpressionStep::describeActions(FormatSettings & settings) const settings.out << '\n'; } +void ExpressionStep::describeActions(boost::property_tree::ptree & tree) const +{ + auto expression = std::make_shared(actions_dag, ExpressionActionsSettings{}); + tree.add_child("Expression", expression->toTree()); +} + JoinStep::JoinStep(const DataStream & input_stream_, JoinPtr join_, bool has_non_joined_rows_, size_t max_block_size_) : ITransformingStep( input_stream_, diff --git a/src/Processors/QueryPlan/ExpressionStep.h b/src/Processors/QueryPlan/ExpressionStep.h index bcc1b0ef7b6..fa03fd9441a 100644 --- a/src/Processors/QueryPlan/ExpressionStep.h +++ b/src/Processors/QueryPlan/ExpressionStep.h @@ -30,6 +30,8 @@ public: const ActionsDAGPtr & getExpression() const { return actions_dag; } + void describeActions(boost::property_tree::ptree & tree) const override; + private: ActionsDAGPtr actions_dag; }; From dff996bf7d084f05a5c14ab10a97ab93be094dfd Mon Sep 17 00:00:00 2001 From: lehasm Date: Sat, 10 Apr 2021 15:19:59 +0300 Subject: [PATCH 04/93] Added some file --- docs/tools/temp_file | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/tools/temp_file diff --git a/docs/tools/temp_file b/docs/tools/temp_file new file mode 100644 index 00000000000..b7f212221cd --- /dev/null +++ b/docs/tools/temp_file @@ -0,0 +1 @@ +temporary file \ No newline at end of file From 9bbd611d95bdecf499cd9310af483d2ae36757a4 Mon Sep 17 00:00:00 2001 From: lehasm Date: Sat, 10 Apr 2021 15:29:53 +0300 Subject: [PATCH 05/93] Revert "Added some file" This reverts commit dff996bf7d084f05a5c14ab10a97ab93be094dfd. --- docs/tools/temp_file | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/tools/temp_file diff --git a/docs/tools/temp_file b/docs/tools/temp_file deleted file mode 100644 index b7f212221cd..00000000000 --- a/docs/tools/temp_file +++ /dev/null @@ -1 +0,0 @@ -temporary file \ No newline at end of file From d1d2b89a512ceaa48ced66133bef2df7b56e1288 Mon Sep 17 00:00:00 2001 From: Nikolai Kochetov Date: Tue, 13 Apr 2021 10:51:55 +0300 Subject: [PATCH 06/93] Use setting for explain json --- src/Interpreters/InterpreterExplainQuery.cpp | 2 +- src/Processors/QueryPlan/QueryPlan.cpp | 35 ++++++++++++++++---- src/Processors/QueryPlan/QueryPlan.h | 2 +- 3 files changed, 30 insertions(+), 9 deletions(-) diff --git a/src/Interpreters/InterpreterExplainQuery.cpp b/src/Interpreters/InterpreterExplainQuery.cpp index 864bbbb5fe1..129be8bab9a 100644 --- a/src/Interpreters/InterpreterExplainQuery.cpp +++ b/src/Interpreters/InterpreterExplainQuery.cpp @@ -262,7 +262,7 @@ BlockInputStreamPtr InterpreterExplainQuery::executeImpl() if (settings.json) { - auto tree = plan.explainPlan(); + auto tree = plan.explainPlan(settings.query_plan_options); std::stringstream out; boost::property_tree::json_parser::write_json(out, tree); buf.str() = out.str(); diff --git a/src/Processors/QueryPlan/QueryPlan.cpp b/src/Processors/QueryPlan/QueryPlan.cpp index bac4dc232ce..e4002f5dba9 100644 --- a/src/Processors/QueryPlan/QueryPlan.cpp +++ b/src/Processors/QueryPlan/QueryPlan.cpp @@ -201,21 +201,42 @@ void QueryPlan::addInterpreterContext(std::shared_ptr context) } -static boost::property_tree::ptree explainStep(const IQueryPlanStep & step) +static boost::property_tree::ptree explainStep(const IQueryPlanStep & step, const QueryPlan::ExplainPlanOptions & options) { boost::property_tree::ptree tree; tree.put("Node Type", step.getName()); - const auto & description = step.getStepDescription(); - if (!description.empty()) - tree.put("Description", description); + if (options.description) + { + const auto & description = step.getStepDescription(); + if (!description.empty()) + tree.put("Description", description); + } - step.describeActions(tree); + if (options.header && step.hasOutputStream()) + { + boost::property_tree::ptree header_tree; + + for (const auto & output_column : step.getOutputStream().header) + { + boost::property_tree::ptree column_tree; + column_tree.add("Name", output_column.name); + if (output_column.type) + column_tree.add("Type", output_column.type->getName()); + + header_tree.add_child("", column_tree); + } + + tree.add_child("Header", header_tree); + } + + if (options.actions) + step.describeActions(tree); return tree; } -boost::property_tree::ptree QueryPlan::explainPlan() +boost::property_tree::ptree QueryPlan::explainPlan(const ExplainPlanOptions & options) { checkInitialized(); @@ -237,7 +258,7 @@ boost::property_tree::ptree QueryPlan::explainPlan() auto & frame = stack.top(); if (frame.next_child == 0) - frame.node_tree = explainStep(*frame.node->step); + frame.node_tree = explainStep(*frame.node->step, options); if (frame.next_child < frame.node->children.size()) { diff --git a/src/Processors/QueryPlan/QueryPlan.h b/src/Processors/QueryPlan/QueryPlan.h index d68b57452cb..4ca7d38f087 100644 --- a/src/Processors/QueryPlan/QueryPlan.h +++ b/src/Processors/QueryPlan/QueryPlan.h @@ -74,7 +74,7 @@ public: bool header = false; }; - boost::property_tree::ptree explainPlan(); + boost::property_tree::ptree explainPlan(const ExplainPlanOptions & options); void explainPlan(WriteBuffer & buffer, const ExplainPlanOptions & options); void explainPipeline(WriteBuffer & buffer, const ExplainPipelineOptions & options); From 8a41e63e2a2092a207bd15f9fc3476a8da5cf348 Mon Sep 17 00:00:00 2001 From: Nikolai Kochetov Date: Tue, 13 Apr 2021 18:12:12 +0300 Subject: [PATCH 07/93] Add JSON for Modern C++ --- contrib/nlohmann_json/.circleci/config.yml | 48 + contrib/nlohmann_json/.clang-format | 84 + contrib/nlohmann_json/.clang-tidy | 23 + contrib/nlohmann_json/.github/CODEOWNERS | 6 + contrib/nlohmann_json/.github/CONTRIBUTING.md | 71 + contrib/nlohmann_json/.github/FUNDING.yml | 2 + .../.github/ISSUE_TEMPLATE/Bug_report.md | 57 + .../.github/ISSUE_TEMPLATE/config.yml | 5 + .../.github/PULL_REQUEST_TEMPLATE.md | 19 + contrib/nlohmann_json/.github/SECURITY.md | 5 + contrib/nlohmann_json/.github/config.yml | 19 + contrib/nlohmann_json/.github/stale.yml | 17 + .../.github/workflows/codeql-analysis.yml | 54 + .../nlohmann_json/.github/workflows/macos.yml | 17 + .../.github/workflows/ubuntu.yml | 17 + .../.github/workflows/windows.yml | 68 + contrib/nlohmann_json/.gitignore | 35 + contrib/nlohmann_json/.travis.yml | 348 + contrib/nlohmann_json/CMakeLists.txt | 164 + contrib/nlohmann_json/CODE_OF_CONDUCT.md | 46 + contrib/nlohmann_json/ChangeLog.md | 2297 ++ contrib/nlohmann_json/LICENSE.MIT | 21 + contrib/nlohmann_json/README.md | 1630 + contrib/nlohmann_json/appveyor.yml | 147 + .../nlohmann_json/benchmarks/CMakeLists.txt | 25 + .../benchmarks/src/benchmarks.cpp | 110 + .../benchmarks/thirdparty/benchmark/AUTHORS | 46 + .../thirdparty/benchmark/BUILD.bazel | 42 + .../thirdparty/benchmark/CMakeLists.txt | 251 + .../thirdparty/benchmark/CONTRIBUTING.md | 58 + .../thirdparty/benchmark/CONTRIBUTORS | 65 + .../benchmarks/thirdparty/benchmark/LICENSE | 202 + .../benchmarks/thirdparty/benchmark/README.md | 950 + .../benchmarks/thirdparty/benchmark/WORKSPACE | 7 + .../thirdparty/benchmark/appveyor.yml | 56 + .../benchmark/cmake/AddCXXCompilerFlag.cmake | 74 + .../benchmark/cmake/CXXFeatureCheck.cmake | 64 + .../benchmark/cmake/Config.cmake.in | 1 + .../benchmark/cmake/GetGitVersion.cmake | 54 + .../benchmark/cmake/HandleGTest.cmake | 113 + .../benchmark/cmake/Modules/FindLLVMAr.cmake | 16 + .../benchmark/cmake/Modules/FindLLVMNm.cmake | 16 + .../cmake/Modules/FindLLVMRanLib.cmake | 15 + .../benchmark/cmake/benchmark.pc.in | 11 + .../benchmark/cmake/gnu_posix_regex.cpp | 12 + .../benchmark/cmake/llvm-toolchain.cmake | 8 + .../benchmark/cmake/posix_regex.cpp | 14 + .../benchmark/cmake/split_list.cmake | 3 + .../thirdparty/benchmark/cmake/std_regex.cpp | 10 + .../benchmark/cmake/steady_clock.cpp | 7 + .../cmake/thread_safety_attributes.cpp | 4 + .../benchmark/docs/AssemblyTests.md | 147 + .../thirdparty/benchmark/docs/tools.md | 242 + .../benchmark/include/benchmark/benchmark.h | 1456 + .../benchmarks/thirdparty/benchmark/mingw.py | 320 + .../thirdparty/benchmark/releasing.md | 16 + .../thirdparty/benchmark/src/CMakeLists.txt | 105 + .../thirdparty/benchmark/src/arraysize.h | 33 + .../thirdparty/benchmark/src/benchmark.cc | 630 + .../benchmark/src/benchmark_api_internal.h | 47 + .../benchmark/src/benchmark_main.cc | 17 + .../benchmark/src/benchmark_register.cc | 461 + .../benchmark/src/benchmark_register.h | 33 + .../thirdparty/benchmark/src/check.h | 79 + .../thirdparty/benchmark/src/colorprint.cc | 188 + .../thirdparty/benchmark/src/colorprint.h | 33 + .../benchmark/src/commandlineflags.cc | 218 + .../benchmark/src/commandlineflags.h | 79 + .../thirdparty/benchmark/src/complexity.cc | 220 + .../thirdparty/benchmark/src/complexity.h | 55 + .../benchmark/src/console_reporter.cc | 182 + .../thirdparty/benchmark/src/counter.cc | 68 + .../thirdparty/benchmark/src/counter.h | 26 + .../thirdparty/benchmark/src/csv_reporter.cc | 149 + .../thirdparty/benchmark/src/cycleclock.h | 177 + .../benchmark/src/internal_macros.h | 89 + .../thirdparty/benchmark/src/json_reporter.cc | 205 + .../benchmarks/thirdparty/benchmark/src/log.h | 73 + .../thirdparty/benchmark/src/mutex.h | 155 + .../benchmarks/thirdparty/benchmark/src/re.h | 152 + .../thirdparty/benchmark/src/reporter.cc | 87 + .../thirdparty/benchmark/src/sleep.cc | 51 + .../thirdparty/benchmark/src/sleep.h | 15 + .../thirdparty/benchmark/src/statistics.cc | 178 + .../thirdparty/benchmark/src/statistics.h | 37 + .../thirdparty/benchmark/src/string_util.cc | 172 + .../thirdparty/benchmark/src/string_util.h | 40 + .../thirdparty/benchmark/src/sysinfo.cc | 587 + .../thirdparty/benchmark/src/thread_manager.h | 66 + .../thirdparty/benchmark/src/thread_timer.h | 69 + .../thirdparty/benchmark/src/timers.cc | 217 + .../thirdparty/benchmark/src/timers.h | 48 + .../thirdparty/benchmark/tools/compare.py | 316 + .../benchmark/tools/compare_bench.py | 67 + .../tools/gbench/Inputs/test1_run1.json | 102 + .../tools/gbench/Inputs/test1_run2.json | 102 + .../tools/gbench/Inputs/test2_run.json | 81 + .../benchmark/tools/gbench/__init__.py | 8 + .../benchmark/tools/gbench/report.py | 208 + .../thirdparty/benchmark/tools/gbench/util.py | 159 + .../thirdparty/benchmark/tools/strip_asm.py | 151 + contrib/nlohmann_json/cmake/config.cmake.in | 15 + .../cmake/download_test_data.cmake | 56 + .../cmake/nlohmann_jsonConfigVersion.cmake.in | 20 + contrib/nlohmann_json/cmake/pkg-config.pc.in | 4 + contrib/nlohmann_json/doc/Doxyfile | 331 + contrib/nlohmann_json/doc/avatars.png | Bin 0 -> 1174355 bytes contrib/nlohmann_json/doc/css/mylayout.css | 26 + .../nlohmann_json/doc/css/mylayout_docset.css | 27 + contrib/nlohmann_json/doc/examples/README.cpp | 39 + .../nlohmann_json/doc/examples/README.link | 1 + .../nlohmann_json/doc/examples/README.output | 27 + .../doc/examples/accept__string.cpp | 26 + .../doc/examples/accept__string.link | 1 + .../doc/examples/accept__string.output | 1 + contrib/nlohmann_json/doc/examples/array.cpp | 19 + contrib/nlohmann_json/doc/examples/array.link | 1 + .../nlohmann_json/doc/examples/array.output | 4 + .../doc/examples/at__object_t_key_type.cpp | 48 + .../doc/examples/at__object_t_key_type.link | 1 + .../doc/examples/at__object_t_key_type.output | 4 + .../examples/at__object_t_key_type_const.cpp | 42 + .../examples/at__object_t_key_type_const.link | 1 + .../at__object_t_key_type_const.output | 3 + .../doc/examples/at__size_type.cpp | 43 + .../doc/examples/at__size_type.link | 1 + .../doc/examples/at__size_type.output | 4 + .../doc/examples/at__size_type_const.cpp | 37 + .../doc/examples/at__size_type_const.link | 1 + .../doc/examples/at__size_type_const.output | 3 + .../doc/examples/at_json_pointer.cpp | 103 + .../doc/examples/at_json_pointer.link | 1 + .../doc/examples/at_json_pointer.output | 12 + .../doc/examples/at_json_pointer_const.cpp | 79 + .../doc/examples/at_json_pointer_const.link | 1 + .../doc/examples/at_json_pointer_const.output | 9 + contrib/nlohmann_json/doc/examples/back.cpp | 38 + contrib/nlohmann_json/doc/examples/back.link | 1 + .../nlohmann_json/doc/examples/back.output | 7 + .../examples/basic_json__CompatibleType.cpp | 218 + .../examples/basic_json__CompatibleType.link | 1 + .../basic_json__CompatibleType.output | 39 + .../examples/basic_json__InputIt_InputIt.cpp | 32 + .../examples/basic_json__InputIt_InputIt.link | 1 + .../basic_json__InputIt_InputIt.output | 4 + .../doc/examples/basic_json__basic_json.cpp | 17 + .../doc/examples/basic_json__basic_json.link | 1 + .../examples/basic_json__basic_json.output | 2 + .../examples/basic_json__copyassignment.cpp | 18 + .../examples/basic_json__copyassignment.link | 1 + .../basic_json__copyassignment.output | 2 + .../doc/examples/basic_json__list_init_t.cpp | 21 + .../doc/examples/basic_json__list_init_t.link | 1 + .../examples/basic_json__list_init_t.output | 5 + .../examples/basic_json__moveconstructor.cpp | 17 + .../examples/basic_json__moveconstructor.link | 1 + .../basic_json__moveconstructor.output | 2 + .../doc/examples/basic_json__nullptr_t.cpp | 16 + .../doc/examples/basic_json__nullptr_t.link | 1 + .../doc/examples/basic_json__nullptr_t.output | 2 + .../basic_json__size_type_basic_json.cpp | 18 + .../basic_json__size_type_basic_json.link | 1 + .../basic_json__size_type_basic_json.output | 3 + .../doc/examples/basic_json__value.cpp | 30 + .../doc/examples/basic_json__value.link | 1 + .../doc/examples/basic_json__value.output | 1 + .../doc/examples/basic_json__value_ptr.cpp | 30 + .../doc/examples/basic_json__value_ptr.link | 1 + .../doc/examples/basic_json__value_ptr.output | 1 + .../doc/examples/basic_json__value_t.cpp | 25 + .../doc/examples/basic_json__value_t.link | 1 + .../doc/examples/basic_json__value_t.output | 7 + contrib/nlohmann_json/doc/examples/begin.cpp | 16 + contrib/nlohmann_json/doc/examples/begin.link | 1 + .../nlohmann_json/doc/examples/begin.output | 1 + contrib/nlohmann_json/doc/examples/cbegin.cpp | 16 + .../nlohmann_json/doc/examples/cbegin.link | 1 + .../nlohmann_json/doc/examples/cbegin.output | 1 + contrib/nlohmann_json/doc/examples/cend.cpp | 19 + contrib/nlohmann_json/doc/examples/cend.link | 1 + .../nlohmann_json/doc/examples/cend.output | 1 + contrib/nlohmann_json/doc/examples/clear.cpp | 34 + contrib/nlohmann_json/doc/examples/clear.link | 1 + .../nlohmann_json/doc/examples/clear.output | 7 + .../nlohmann_json/doc/examples/contains.cpp | 17 + .../nlohmann_json/doc/examples/contains.link | 1 + .../doc/examples/contains.output | 3 + .../doc/examples/contains_json_pointer.cpp | 42 + .../doc/examples/contains_json_pointer.link | 1 + .../doc/examples/contains_json_pointer.output | 7 + contrib/nlohmann_json/doc/examples/count.cpp | 18 + contrib/nlohmann_json/doc/examples/count.link | 1 + .../nlohmann_json/doc/examples/count.output | 2 + .../nlohmann_json/doc/examples/crbegin.cpp | 16 + .../nlohmann_json/doc/examples/crbegin.link | 1 + .../nlohmann_json/doc/examples/crbegin.output | 1 + contrib/nlohmann_json/doc/examples/crend.cpp | 19 + contrib/nlohmann_json/doc/examples/crend.link | 1 + .../nlohmann_json/doc/examples/crend.output | 1 + contrib/nlohmann_json/doc/examples/diff.cpp | 36 + contrib/nlohmann_json/doc/examples/diff.link | 1 + .../nlohmann_json/doc/examples/diff.output | 25 + contrib/nlohmann_json/doc/examples/dump.cpp | 48 + contrib/nlohmann_json/doc/examples/dump.link | 1 + .../nlohmann_json/doc/examples/dump.output | 55 + .../nlohmann_json/doc/examples/emplace.cpp | 31 + .../nlohmann_json/doc/examples/emplace.link | 1 + .../nlohmann_json/doc/examples/emplace.output | 6 + .../doc/examples/emplace_back.cpp | 24 + .../doc/examples/emplace_back.link | 1 + .../doc/examples/emplace_back.output | 4 + contrib/nlohmann_json/doc/examples/empty.cpp | 30 + contrib/nlohmann_json/doc/examples/empty.link | 1 + .../nlohmann_json/doc/examples/empty.output | 9 + contrib/nlohmann_json/doc/examples/end.cpp | 19 + contrib/nlohmann_json/doc/examples/end.link | 1 + contrib/nlohmann_json/doc/examples/end.output | 1 + .../doc/examples/erase__IteratorType.cpp | 31 + .../doc/examples/erase__IteratorType.link | 1 + .../doc/examples/erase__IteratorType.output | 6 + .../erase__IteratorType_IteratorType.cpp | 31 + .../erase__IteratorType_IteratorType.link | 1 + .../erase__IteratorType_IteratorType.output | 6 + .../doc/examples/erase__key_type.cpp | 18 + .../doc/examples/erase__key_type.link | 1 + .../doc/examples/erase__key_type.output | 2 + .../doc/examples/erase__size_type.cpp | 16 + .../doc/examples/erase__size_type.link | 1 + .../doc/examples/erase__size_type.output | 1 + .../nlohmann_json/doc/examples/exception.cpp | 20 + .../nlohmann_json/doc/examples/exception.link | 1 + .../doc/examples/exception.output | 2 + .../doc/examples/find__key_type.cpp | 20 + .../doc/examples/find__key_type.link | 1 + .../doc/examples/find__key_type.output | 3 + .../nlohmann_json/doc/examples/flatten.cpp | 32 + .../nlohmann_json/doc/examples/flatten.link | 1 + .../nlohmann_json/doc/examples/flatten.output | 12 + .../nlohmann_json/doc/examples/from_bson.cpp | 21 + .../nlohmann_json/doc/examples/from_bson.link | 1 + .../doc/examples/from_bson.output | 4 + .../nlohmann_json/doc/examples/from_cbor.cpp | 20 + .../nlohmann_json/doc/examples/from_cbor.link | 1 + .../doc/examples/from_cbor.output | 4 + .../doc/examples/from_msgpack.cpp | 20 + .../doc/examples/from_msgpack.link | 1 + .../doc/examples/from_msgpack.output | 4 + .../doc/examples/from_ubjson.cpp | 20 + .../doc/examples/from_ubjson.link | 1 + .../doc/examples/from_ubjson.output | 4 + contrib/nlohmann_json/doc/examples/front.cpp | 29 + contrib/nlohmann_json/doc/examples/front.link | 1 + .../nlohmann_json/doc/examples/front.output | 6 + .../doc/examples/get__PointerType.cpp | 21 + .../doc/examples/get__PointerType.link | 1 + .../doc/examples/get__PointerType.output | 2 + .../doc/examples/get__ValueType_const.cpp | 50 + .../doc/examples/get__ValueType_const.link | 1 + .../doc/examples/get__ValueType_const.output | 11 + .../nlohmann_json/doc/examples/get_ptr.cpp | 21 + .../nlohmann_json/doc/examples/get_ptr.link | 1 + .../nlohmann_json/doc/examples/get_ptr.output | 2 + .../nlohmann_json/doc/examples/get_ref.cpp | 27 + .../nlohmann_json/doc/examples/get_ref.link | 1 + .../nlohmann_json/doc/examples/get_ref.output | 2 + contrib/nlohmann_json/doc/examples/get_to.cpp | 60 + .../nlohmann_json/doc/examples/get_to.link | 1 + .../nlohmann_json/doc/examples/get_to.output | 11 + contrib/nlohmann_json/doc/examples/insert.cpp | 17 + .../nlohmann_json/doc/examples/insert.link | 1 + .../nlohmann_json/doc/examples/insert.output | 2 + .../doc/examples/insert__count.cpp | 17 + .../doc/examples/insert__count.link | 1 + .../doc/examples/insert__count.output | 2 + .../doc/examples/insert__ilist.cpp | 17 + .../doc/examples/insert__ilist.link | 1 + .../doc/examples/insert__ilist.output | 2 + .../doc/examples/insert__range.cpp | 20 + .../doc/examples/insert__range.link | 1 + .../doc/examples/insert__range.output | 2 + .../doc/examples/insert__range_object.cpp | 21 + .../doc/examples/insert__range_object.link | 1 + .../doc/examples/insert__range_object.output | 3 + .../doc/examples/invalid_iterator.cpp | 21 + .../doc/examples/invalid_iterator.link | 1 + .../doc/examples/invalid_iterator.output | 2 + .../nlohmann_json/doc/examples/is_array.cpp | 30 + .../nlohmann_json/doc/examples/is_array.link | 1 + .../doc/examples/is_array.output | 9 + .../nlohmann_json/doc/examples/is_binary.cpp | 30 + .../nlohmann_json/doc/examples/is_binary.link | 1 + .../doc/examples/is_binary.output | 9 + .../nlohmann_json/doc/examples/is_boolean.cpp | 30 + .../doc/examples/is_boolean.link | 1 + .../doc/examples/is_boolean.output | 9 + .../doc/examples/is_discarded.cpp | 30 + .../doc/examples/is_discarded.link | 1 + .../doc/examples/is_discarded.output | 9 + .../nlohmann_json/doc/examples/is_null.cpp | 30 + .../nlohmann_json/doc/examples/is_null.link | 1 + .../nlohmann_json/doc/examples/is_null.output | 9 + .../nlohmann_json/doc/examples/is_number.cpp | 30 + .../nlohmann_json/doc/examples/is_number.link | 1 + .../doc/examples/is_number.output | 9 + .../doc/examples/is_number_float.cpp | 30 + .../doc/examples/is_number_float.link | 1 + .../doc/examples/is_number_float.output | 9 + .../doc/examples/is_number_integer.cpp | 30 + .../doc/examples/is_number_integer.link | 1 + .../doc/examples/is_number_integer.output | 9 + .../doc/examples/is_number_unsigned.cpp | 30 + .../doc/examples/is_number_unsigned.link | 1 + .../doc/examples/is_number_unsigned.output | 9 + .../nlohmann_json/doc/examples/is_object.cpp | 30 + .../nlohmann_json/doc/examples/is_object.link | 1 + .../doc/examples/is_object.output | 9 + .../doc/examples/is_primitive.cpp | 30 + .../doc/examples/is_primitive.link | 1 + .../doc/examples/is_primitive.output | 9 + .../nlohmann_json/doc/examples/is_string.cpp | 30 + .../nlohmann_json/doc/examples/is_string.link | 1 + .../doc/examples/is_string.output | 9 + .../doc/examples/is_structured.cpp | 30 + .../doc/examples/is_structured.link | 1 + .../doc/examples/is_structured.output | 9 + contrib/nlohmann_json/doc/examples/items.cpp | 23 + contrib/nlohmann_json/doc/examples/items.link | 1 + .../nlohmann_json/doc/examples/items.output | 7 + .../doc/examples/iterator_wrapper.cpp | 23 + .../doc/examples/iterator_wrapper.link | 1 + .../doc/examples/iterator_wrapper.output | 7 + .../doc/examples/json_pointer.cpp | 47 + .../doc/examples/json_pointer.link | 1 + .../doc/examples/json_pointer.output | 3 + .../doc/examples/json_pointer__back.cpp | 15 + .../doc/examples/json_pointer__back.link | 1 + .../doc/examples/json_pointer__back.output | 2 + .../doc/examples/json_pointer__empty.cpp | 20 + .../doc/examples/json_pointer__empty.link | 1 + .../doc/examples/json_pointer__empty.output | 4 + .../examples/json_pointer__operator_add.cpp | 23 + .../examples/json_pointer__operator_add.link | 1 + .../json_pointer__operator_add.output | 4 + .../json_pointer__operator_add_binary.cpp | 19 + .../json_pointer__operator_add_binary.link | 1 + .../json_pointer__operator_add_binary.output | 3 + .../examples/json_pointer__parent_pointer.cpp | 18 + .../json_pointer__parent_pointer.link | 1 + .../json_pointer__parent_pointer.output | 3 + .../doc/examples/json_pointer__pop_back.cpp | 21 + .../doc/examples/json_pointer__pop_back.link | 1 + .../examples/json_pointer__pop_back.output | 4 + .../doc/examples/json_pointer__push_back.cpp | 21 + .../doc/examples/json_pointer__push_back.link | 1 + .../examples/json_pointer__push_back.output | 4 + .../doc/examples/json_pointer__to_string.cpp | 35 + .../doc/examples/json_pointer__to_string.link | 1 + .../examples/json_pointer__to_string.output | 12 + .../nlohmann_json/doc/examples/max_size.cpp | 25 + .../nlohmann_json/doc/examples/max_size.link | 1 + .../doc/examples/max_size.output | 7 + .../doc/examples/merge_patch.cpp | 40 + .../doc/examples/merge_patch.link | 1 + .../doc/examples/merge_patch.output | 11 + contrib/nlohmann_json/doc/examples/meta.cpp | 11 + contrib/nlohmann_json/doc/examples/meta.link | 1 + .../nlohmann_json/doc/examples/meta.output | 17 + contrib/nlohmann_json/doc/examples/object.cpp | 28 + .../nlohmann_json/doc/examples/object.link | 1 + .../nlohmann_json/doc/examples/object.output | 4 + .../doc/examples/operator__ValueType.cpp | 60 + .../doc/examples/operator__ValueType.link | 1 + .../doc/examples/operator__ValueType.output | 12 + .../doc/examples/operator__equal.cpp | 24 + .../doc/examples/operator__equal.link | 1 + .../doc/examples/operator__equal.output | 4 + .../examples/operator__equal__nullptr_t.cpp | 22 + .../examples/operator__equal__nullptr_t.link | 1 + .../operator__equal__nullptr_t.output | 5 + .../doc/examples/operator__greater.cpp | 24 + .../doc/examples/operator__greater.link | 1 + .../doc/examples/operator__greater.output | 4 + .../doc/examples/operator__greaterequal.cpp | 24 + .../doc/examples/operator__greaterequal.link | 1 + .../examples/operator__greaterequal.output | 4 + .../doc/examples/operator__less.cpp | 24 + .../doc/examples/operator__less.link | 1 + .../doc/examples/operator__less.output | 4 + .../doc/examples/operator__lessequal.cpp | 24 + .../doc/examples/operator__lessequal.link | 1 + .../doc/examples/operator__lessequal.output | 4 + .../doc/examples/operator__notequal.cpp | 24 + .../doc/examples/operator__notequal.link | 1 + .../doc/examples/operator__notequal.output | 4 + .../operator__notequal__nullptr_t.cpp | 22 + .../operator__notequal__nullptr_t.link | 1 + .../operator__notequal__nullptr_t.output | 5 + .../doc/examples/operator__value_t.cpp | 38 + .../doc/examples/operator__value_t.link | 1 + .../doc/examples/operator__value_t.output | 8 + .../doc/examples/operator_deserialize.cpp | 26 + .../doc/examples/operator_deserialize.link | 1 + .../doc/examples/operator_deserialize.output | 13 + .../doc/examples/operator_serialize.cpp | 21 + .../doc/examples/operator_serialize.link | 1 + .../doc/examples/operator_serialize.output | 22 + .../doc/examples/operatorarray__key_type.cpp | 32 + .../doc/examples/operatorarray__key_type.link | 1 + .../examples/operatorarray__key_type.output | 19 + .../operatorarray__key_type_const.cpp | 16 + .../operatorarray__key_type_const.link | 1 + .../operatorarray__key_type_const.output | 1 + .../doc/examples/operatorarray__size_type.cpp | 25 + .../examples/operatorarray__size_type.link | 1 + .../examples/operatorarray__size_type.output | 3 + .../operatorarray__size_type_const.cpp | 13 + .../operatorarray__size_type_const.link | 1 + .../operatorarray__size_type_const.output | 1 + .../doc/examples/operatorjson_pointer.cpp | 48 + .../doc/examples/operatorjson_pointer.link | 1 + .../doc/examples/operatorjson_pointer.output | 8 + .../examples/operatorjson_pointer_const.cpp | 24 + .../examples/operatorjson_pointer_const.link | 1 + .../operatorjson_pointer_const.output | 4 + .../doc/examples/other_error.cpp | 29 + .../doc/examples/other_error.link | 1 + .../doc/examples/other_error.output | 2 + .../doc/examples/out_of_range.cpp | 20 + .../doc/examples/out_of_range.link | 1 + .../doc/examples/out_of_range.output | 2 + .../parse__array__parser_callback_t.cpp | 30 + .../parse__array__parser_callback_t.link | 1 + .../parse__array__parser_callback_t.output | 20 + ...contiguouscontainer__parser_callback_t.cpp | 15 + ...ontiguouscontainer__parser_callback_t.link | 1 + ...tiguouscontainer__parser_callback_t.output | 6 + .../parse__istream__parser_callback_t.cpp | 58 + .../parse__istream__parser_callback_t.link | 1 + .../parse__istream__parser_callback_t.output | 34 + ...parse__iteratortype__parser_callback_t.cpp | 15 + ...arse__iteratortype__parser_callback_t.link | 1 + ...se__iteratortype__parser_callback_t.output | 6 + .../parse__string__parser_callback_t.cpp | 49 + .../parse__string__parser_callback_t.link | 1 + .../parse__string__parser_callback_t.output | 34 + .../doc/examples/parse_error.cpp | 20 + .../doc/examples/parse_error.link | 1 + .../doc/examples/parse_error.output | 3 + contrib/nlohmann_json/doc/examples/patch.cpp | 32 + contrib/nlohmann_json/doc/examples/patch.link | 1 + .../nlohmann_json/doc/examples/patch.output | 11 + .../nlohmann_json/doc/examples/push_back.cpp | 25 + .../nlohmann_json/doc/examples/push_back.link | 1 + .../doc/examples/push_back.output | 4 + .../examples/push_back__initializer_list.cpp | 27 + .../examples/push_back__initializer_list.link | 1 + .../push_back__initializer_list.output | 4 + .../examples/push_back__object_t__value.cpp | 25 + .../examples/push_back__object_t__value.link | 1 + .../push_back__object_t__value.output | 4 + contrib/nlohmann_json/doc/examples/rbegin.cpp | 16 + .../nlohmann_json/doc/examples/rbegin.link | 1 + .../nlohmann_json/doc/examples/rbegin.output | 1 + contrib/nlohmann_json/doc/examples/rend.cpp | 19 + contrib/nlohmann_json/doc/examples/rend.link | 1 + .../nlohmann_json/doc/examples/rend.output | 1 + .../nlohmann_json/doc/examples/sax_parse.cpp | 130 + .../nlohmann_json/doc/examples/sax_parse.link | 1 + .../doc/examples/sax_parse.output | 2 + contrib/nlohmann_json/doc/examples/size.cpp | 29 + contrib/nlohmann_json/doc/examples/size.link | 1 + .../nlohmann_json/doc/examples/size.output | 9 + .../doc/examples/swap__array_t.cpp | 20 + .../doc/examples/swap__array_t.link | 1 + .../doc/examples/swap__array_t.output | 2 + .../doc/examples/swap__binary_t.cpp | 20 + .../doc/examples/swap__binary_t.link | 1 + .../doc/examples/swap__binary_t.output | 2 + .../doc/examples/swap__object_t.cpp | 20 + .../doc/examples/swap__object_t.link | 1 + .../doc/examples/swap__object_t.output | 2 + .../doc/examples/swap__reference.cpp | 18 + .../doc/examples/swap__reference.link | 1 + .../doc/examples/swap__reference.output | 2 + .../doc/examples/swap__string_t.cpp | 20 + .../doc/examples/swap__string_t.link | 1 + .../doc/examples/swap__string_t.output | 2 + .../nlohmann_json/doc/examples/to_bson.cpp | 21 + .../nlohmann_json/doc/examples/to_bson.link | 1 + .../nlohmann_json/doc/examples/to_bson.output | 1 + .../nlohmann_json/doc/examples/to_cbor.cpp | 21 + .../nlohmann_json/doc/examples/to_cbor.link | 1 + .../nlohmann_json/doc/examples/to_cbor.output | 1 + .../nlohmann_json/doc/examples/to_msgpack.cpp | 21 + .../doc/examples/to_msgpack.link | 1 + .../doc/examples/to_msgpack.output | 1 + .../nlohmann_json/doc/examples/to_ubjson.cpp | 63 + .../nlohmann_json/doc/examples/to_ubjson.link | 1 + .../doc/examples/to_ubjson.output | 4 + contrib/nlohmann_json/doc/examples/type.cpp | 28 + contrib/nlohmann_json/doc/examples/type.link | 1 + .../nlohmann_json/doc/examples/type.output | 8 + .../nlohmann_json/doc/examples/type_error.cpp | 20 + .../doc/examples/type_error.link | 1 + .../doc/examples/type_error.output | 2 + .../nlohmann_json/doc/examples/type_name.cpp | 27 + .../nlohmann_json/doc/examples/type_name.link | 1 + .../doc/examples/type_name.output | 8 + .../nlohmann_json/doc/examples/unflatten.cpp | 26 + .../nlohmann_json/doc/examples/unflatten.link | 1 + .../doc/examples/unflatten.output | 18 + contrib/nlohmann_json/doc/examples/update.cpp | 18 + .../nlohmann_json/doc/examples/update.link | 1 + .../nlohmann_json/doc/examples/update.output | 5 + .../doc/examples/update__range.cpp | 18 + .../doc/examples/update__range.link | 1 + .../doc/examples/update__range.output | 5 + .../doc/images/callback_events.png | Bin 0 -> 46039 bytes .../doc/images/range-begin-end.svg | 435 + .../doc/images/range-rbegin-rend.svg | 1232 + contrib/nlohmann_json/doc/index.md | 335 + contrib/nlohmann_json/doc/json.gif | Bin 0 -> 1710522 bytes .../doc/mkdocs/docs/api/basic_json/dump.md | 74 + .../doc/mkdocs/docs/api/basic_json/index.md | 253 + .../doc/mkdocs/docs/api/basic_json/meta.md | 45 + .../doc/mkdocs/docs/api/basic_json/parse.md | 146 + .../mkdocs/docs/features/arbitrary_types.md | 264 + .../docs/features/binary_formats/bson.md | 94 + .../docs/features/binary_formats/cbor.md | 177 + .../docs/features/binary_formats/index.md | 45 + .../features/binary_formats/messagepack.md | 139 + .../docs/features/binary_formats/ubjson.md | 133 + .../doc/mkdocs/docs/features/binary_values.md | 295 + .../doc/mkdocs/docs/features/comments.md | 83 + .../features/element_access/checked_access.md | 77 + .../features/element_access/default_value.md | 32 + .../docs/features/element_access/index.md | 9 + .../element_access/unchecked_access.md | 102 + .../mkdocs/docs/features/enum_conversion.md | 53 + .../doc/mkdocs/docs/features/iterators.md | 155 + .../doc/mkdocs/docs/features/json_patch.md | 45 + .../doc/mkdocs/docs/features/json_pointer.md | 15 + .../doc/mkdocs/docs/features/macros.md | 79 + .../doc/mkdocs/docs/features/merge_patch.md | 20 + .../doc/mkdocs/docs/features/object_order.md | 67 + .../doc/mkdocs/docs/features/parsing/index.md | 13 + .../docs/features/parsing/parse_exceptions.md | 114 + .../docs/features/parsing/parser_callbacks.md | 79 + .../docs/features/parsing/sax_interface.md | 68 + .../doc/mkdocs/docs/features/types.md | 267 + .../doc/mkdocs/docs/home/code_of_conduct.md | 46 + .../doc/mkdocs/docs/home/design_goals.md | 17 + .../doc/mkdocs/docs/home/exceptions.md | 833 + .../nlohmann_json/doc/mkdocs/docs/home/faq.md | 91 + .../doc/mkdocs/docs/home/license.md | 21 + .../doc/mkdocs/docs/home/releases.md | 1225 + .../doc/mkdocs/docs/home/sponsors.md | 11 + .../nlohmann_json/doc/mkdocs/docs/hooks.py | 10 + .../nlohmann_json/doc/mkdocs/docs/index.md | 7 + .../doc/mkdocs/docs/integration/cmake.md | 103 + .../docs/integration/conan/CMakeLists.txt | 9 + .../docs/integration/conan/Conanfile.txt | 5 + .../mkdocs/docs/integration/conan/example.cpp | 9 + .../doc/mkdocs/docs/integration/example.cpp | 9 + .../doc/mkdocs/docs/integration/index.md | 14 + .../docs/integration/package_managers.md | 143 + contrib/nlohmann_json/doc/mkdocs/mkdocs.yml | 135 + .../nlohmann_json/doc/mkdocs/requirements.txt | 29 + .../doc/scripts/git-update-ghpages | 193 + .../doc/scripts/send_to_wandbox.py | 120 + contrib/nlohmann_json/doc/usages/ios.png | Bin 0 -> 208669 bytes contrib/nlohmann_json/doc/usages/macos.png | Bin 0 -> 1305068 bytes .../include/nlohmann/adl_serializer.hpp | 49 + .../nlohmann/byte_container_with_subtype.hpp | 166 + .../nlohmann/detail/conversions/from_json.hpp | 403 + .../nlohmann/detail/conversions/to_chars.hpp | 1105 + .../nlohmann/detail/conversions/to_json.hpp | 374 + .../include/nlohmann/detail/exceptions.hpp | 357 + .../include/nlohmann/detail/hash.hpp | 117 + .../nlohmann/detail/input/binary_reader.hpp | 2459 ++ .../nlohmann/detail/input/input_adapters.hpp | 454 + .../nlohmann/detail/input/json_sax.hpp | 695 + .../include/nlohmann/detail/input/lexer.hpp | 1623 + .../include/nlohmann/detail/input/parser.hpp | 501 + .../nlohmann/detail/input/position_t.hpp | 27 + .../detail/iterators/internal_iterator.hpp | 25 + .../nlohmann/detail/iterators/iter_impl.hpp | 637 + .../detail/iterators/iteration_proxy.hpp | 178 + .../detail/iterators/iterator_traits.hpp | 51 + .../iterators/json_reverse_iterator.hpp | 119 + .../detail/iterators/primitive_iterator.hpp | 120 + .../include/nlohmann/detail/json_pointer.hpp | 975 + .../include/nlohmann/detail/json_ref.hpp | 76 + .../include/nlohmann/detail/macro_scope.hpp | 296 + .../include/nlohmann/detail/macro_unscope.hpp | 23 + .../nlohmann/detail/meta/cpp_future.hpp | 62 + .../include/nlohmann/detail/meta/detected.hpp | 58 + .../include/nlohmann/detail/meta/is_sax.hpp | 149 + .../nlohmann/detail/meta/type_traits.hpp | 396 + .../include/nlohmann/detail/meta/void_t.hpp | 13 + .../nlohmann/detail/output/binary_writer.hpp | 1595 + .../detail/output/output_adapters.hpp | 123 + .../nlohmann/detail/output/serializer.hpp | 947 + .../include/nlohmann/detail/value_t.hpp | 81 + .../nlohmann_json/include/nlohmann/json.hpp | 8791 ++++++ .../include/nlohmann/json_fwd.hpp | 78 + .../include/nlohmann/ordered_map.hpp | 171 + .../nlohmann/thirdparty/hedley/hedley.hpp | 1911 ++ .../thirdparty/hedley/hedley_undef.hpp | 143 + contrib/nlohmann_json/nlohmann_json.natvis | 32 + .../single_include/nlohmann/json.hpp | 25447 ++++++++++++++++ contrib/nlohmann_json/test/CMakeLists.txt | 198 + .../cmake_add_subdirectory/CMakeLists.txt | 16 + .../project/CMakeLists.txt | 13 + .../cmake_add_subdirectory/project/main.cpp | 8 + .../test/cmake_fetch_content/CMakeLists.txt | 20 + .../project/CMakeLists.txt | 20 + .../test/cmake_fetch_content/project/main.cpp | 8 + .../test/cmake_import/CMakeLists.txt | 17 + .../test/cmake_import/project/CMakeLists.txt | 12 + .../test/cmake_import/project/main.cpp | 8 + .../test/cmake_import_minver/CMakeLists.txt | 17 + .../project/CMakeLists.txt | 8 + .../test/cmake_import_minver/project/main.cpp | 8 + .../CMakeLists.txt | 16 + .../project/Bar.cpp | 3 + .../project/Bar.hpp | 4 + .../project/CMakeLists.txt | 21 + .../project/Foo.cpp | 3 + .../project/Foo.hpp | 4 + .../project/main.cpp | 8 + .../reports/2016-08-29-fuzz/exec_speed.png | Bin 0 -> 28144 bytes .../test/reports/2016-08-29-fuzz/fuzz.tiff | Bin 0 -> 235588 bytes .../reports/2016-08-29-fuzz/high_freq.png | Bin 0 -> 26251 bytes .../test/reports/2016-08-29-fuzz/index.html | 10 + .../test/reports/2016-08-29-fuzz/low_freq.png | Bin 0 -> 11752 bytes .../2016-09-09-nativejson_benchmark/README.md | 31 + .../conformance_Nlohmann (C++11).md | 670 + .../conformance_overall_Result.png | Bin 0 -> 169617 bytes ..._mac64_clang7.0_1._Parse_Memory_(byte).png | Bin 0 -> 196128 bytes ...0GHz_mac64_clang7.0_1._Parse_Time_(ms).png | Bin 0 -> 149308 bytes ..._mac64_clang7.0_2._Stringify_Time_(ms).png | Bin 0 -> 139615 bytes ...z_mac64_clang7.0_3._Prettify_Time_(ms).png | Bin 0 -> 100027 bytes ..._clang7.0_7._Code_size_FileSize_(byte).png | Bin 0 -> 186055 bytes .../reports/2016-10-02-fuzz/exec_speed.png | Bin 0 -> 31420 bytes .../test/reports/2016-10-02-fuzz/fuzz.tiff | Bin 0 -> 264782 bytes .../reports/2016-10-02-fuzz/high_freq.png | Bin 0 -> 23019 bytes .../test/reports/2016-10-02-fuzz/index.html | 10 + .../test/reports/2016-10-02-fuzz/low_freq.png | Bin 0 -> 14234 bytes contrib/nlohmann_json/test/src/UBSAN.supp | 1 + .../test/src/fuzzer-driver_afl.cpp | 38 + .../test/src/fuzzer-parse_bson.cpp | 73 + .../test/src/fuzzer-parse_cbor.cpp | 68 + .../test/src/fuzzer-parse_json.cpp | 69 + .../test/src/fuzzer-parse_msgpack.cpp | 68 + .../test/src/fuzzer-parse_ubjson.cpp | 84 + contrib/nlohmann_json/test/src/test_utils.hpp | 25 + .../test/src/unit-algorithms.cpp | 320 + .../nlohmann_json/test/src/unit-allocator.cpp | 279 + .../test/src/unit-alt-string.cpp | 299 + .../test/src/unit-assert_macro.cpp | 65 + contrib/nlohmann_json/test/src/unit-bson.cpp | 1330 + .../nlohmann_json/test/src/unit-capacity.cpp | 563 + contrib/nlohmann_json/test/src/unit-cbor.cpp | 2729 ++ .../test/src/unit-class_const_iterator.cpp | 419 + .../test/src/unit-class_iterator.cpp | 403 + .../test/src/unit-class_lexer.cpp | 248 + .../test/src/unit-class_parser.cpp | 1886 ++ .../test/src/unit-comparison.cpp | 270 + .../nlohmann_json/test/src/unit-concepts.cpp | 171 + .../test/src/unit-constructor1.cpp | 1591 + .../test/src/unit-constructor2.cpp | 207 + .../test/src/unit-convenience.cpp | 118 + .../test/src/unit-conversions.cpp | 1709 ++ .../test/src/unit-deserialization.cpp | 1098 + .../test/src/unit-element_access1.cpp | 1006 + .../test/src/unit-element_access2.cpp | 1109 + contrib/nlohmann_json/test/src/unit-hash.cpp | 84 + .../test/src/unit-inspection.cpp | 480 + contrib/nlohmann_json/test/src/unit-items.cpp | 1450 + .../test/src/unit-iterators1.cpp | 1692 + .../test/src/unit-iterators2.cpp | 906 + .../test/src/unit-json_patch.cpp | 1297 + .../test/src/unit-json_pointer.cpp | 695 + .../test/src/unit-large_json.cpp | 50 + .../test/src/unit-merge_patch.cpp | 262 + contrib/nlohmann_json/test/src/unit-meta.cpp | 57 + .../nlohmann_json/test/src/unit-modifiers.cpp | 1008 + .../nlohmann_json/test/src/unit-msgpack.cpp | 1885 ++ .../nlohmann_json/test/src/unit-noexcept.cpp | 97 + .../test/src/unit-ordered_json.cpp | 79 + .../test/src/unit-ordered_map.cpp | 292 + .../test/src/unit-pointer_access.cpp | 500 + .../nlohmann_json/test/src/unit-readme.cpp | 327 + .../test/src/unit-reference_access.cpp | 318 + .../test/src/unit-regression1.cpp | 1610 + .../test/src/unit-regression2.cpp | 488 + .../test/src/unit-serialization.cpp | 322 + .../test/src/unit-testsuites.cpp | 1416 + .../nlohmann_json/test/src/unit-to_chars.cpp | 537 + .../nlohmann_json/test/src/unit-ubjson.cpp | 2569 ++ contrib/nlohmann_json/test/src/unit-udt.cpp | 845 + .../nlohmann_json/test/src/unit-udt_macro.cpp | 330 + .../nlohmann_json/test/src/unit-unicode.cpp | 1611 + .../test/src/unit-user_defined_input.cpp | 119 + .../nlohmann_json/test/src/unit-wstring.cpp | 117 + contrib/nlohmann_json/test/src/unit.cpp | 31 + .../test/thirdparty/Fuzzer/CMakeLists.txt | 45 + .../test/thirdparty/Fuzzer/FuzzerCorpus.h | 217 + .../thirdparty/Fuzzer/FuzzerCrossOver.cpp | 52 + .../test/thirdparty/Fuzzer/FuzzerDefs.h | 89 + .../test/thirdparty/Fuzzer/FuzzerDictionary.h | 124 + .../test/thirdparty/Fuzzer/FuzzerDriver.cpp | 545 + .../thirdparty/Fuzzer/FuzzerExtFunctions.def | 50 + .../thirdparty/Fuzzer/FuzzerExtFunctions.h | 35 + .../Fuzzer/FuzzerExtFunctionsDlsym.cpp | 52 + .../Fuzzer/FuzzerExtFunctionsWeak.cpp | 53 + .../Fuzzer/FuzzerExtFunctionsWeakAlias.cpp | 56 + .../test/thirdparty/Fuzzer/FuzzerFlags.def | 115 + .../test/thirdparty/Fuzzer/FuzzerIO.cpp | 117 + .../test/thirdparty/Fuzzer/FuzzerIO.h | 64 + .../test/thirdparty/Fuzzer/FuzzerIOPosix.cpp | 88 + .../thirdparty/Fuzzer/FuzzerIOWindows.cpp | 282 + .../test/thirdparty/Fuzzer/FuzzerInterface.h | 67 + .../test/thirdparty/Fuzzer/FuzzerInternal.h | 182 + .../test/thirdparty/Fuzzer/FuzzerLoop.cpp | 792 + .../test/thirdparty/Fuzzer/FuzzerMain.cpp | 21 + .../test/thirdparty/Fuzzer/FuzzerMerge.cpp | 261 + .../test/thirdparty/Fuzzer/FuzzerMerge.h | 70 + .../test/thirdparty/Fuzzer/FuzzerMutate.cpp | 527 + .../test/thirdparty/Fuzzer/FuzzerMutate.h | 145 + .../test/thirdparty/Fuzzer/FuzzerOptions.h | 68 + .../test/thirdparty/Fuzzer/FuzzerRandom.h | 36 + .../test/thirdparty/Fuzzer/FuzzerSHA1.cpp | 222 + .../test/thirdparty/Fuzzer/FuzzerSHA1.h | 33 + .../test/thirdparty/Fuzzer/FuzzerTracePC.cpp | 339 + .../test/thirdparty/Fuzzer/FuzzerTracePC.h | 158 + .../thirdparty/Fuzzer/FuzzerTraceState.cpp | 325 + .../test/thirdparty/Fuzzer/FuzzerUtil.cpp | 218 + .../test/thirdparty/Fuzzer/FuzzerUtil.h | 72 + .../thirdparty/Fuzzer/FuzzerUtilDarwin.cpp | 152 + .../thirdparty/Fuzzer/FuzzerUtilLinux.cpp | 24 + .../thirdparty/Fuzzer/FuzzerUtilPosix.cpp | 117 + .../thirdparty/Fuzzer/FuzzerUtilWindows.cpp | 182 + .../thirdparty/Fuzzer/FuzzerValueBitMap.h | 87 + .../test/thirdparty/Fuzzer/README.txt | 2 + .../test/thirdparty/Fuzzer/afl/afl_driver.cpp | 295 + .../test/thirdparty/Fuzzer/build.sh | 10 + .../test/thirdparty/Fuzzer/cxx.dict | 122 + .../standalone/StandaloneFuzzTargetMain.c | 41 + .../thirdparty/Fuzzer/test/AFLDriverTest.cpp | 22 + .../Fuzzer/test/AbsNegAndConstant64Test.cpp | 23 + .../Fuzzer/test/AbsNegAndConstantTest.cpp | 23 + .../Fuzzer/test/AccumulateAllocationsTest.cpp | 17 + .../Fuzzer/test/BufferOverflowOnInput.cpp | 23 + .../thirdparty/Fuzzer/test/CMakeLists.txt | 217 + .../Fuzzer/test/CallerCalleeTest.cpp | 59 + .../thirdparty/Fuzzer/test/CounterTest.cpp | 18 + .../Fuzzer/test/CustomCrossOverTest.cpp | 63 + .../Fuzzer/test/CustomMutatorTest.cpp | 38 + .../test/thirdparty/Fuzzer/test/DSO1.cpp | 12 + .../test/thirdparty/Fuzzer/test/DSO2.cpp | 12 + .../thirdparty/Fuzzer/test/DSOTestExtra.cpp | 11 + .../thirdparty/Fuzzer/test/DSOTestMain.cpp | 31 + .../test/thirdparty/Fuzzer/test/DivTest.cpp | 20 + .../test/thirdparty/Fuzzer/test/EmptyTest.cpp | 11 + .../test/FourIndependentBranchesTest.cpp | 22 + .../Fuzzer/test/FullCoverageSetTest.cpp | 24 + .../thirdparty/Fuzzer/test/FuzzerUnittest.cpp | 738 + .../thirdparty/Fuzzer/test/InitializeTest.cpp | 28 + .../test/thirdparty/Fuzzer/test/LeakTest.cpp | 17 + .../Fuzzer/test/LeakTimeoutTest.cpp | 17 + .../test/thirdparty/Fuzzer/test/LoadTest.cpp | 22 + .../thirdparty/Fuzzer/test/MemcmpTest.cpp | 31 + .../Fuzzer/test/NthRunCrashTest.cpp | 18 + .../Fuzzer/test/NullDerefOnEmptyTest.cpp | 19 + .../thirdparty/Fuzzer/test/NullDerefTest.cpp | 26 + .../Fuzzer/test/OneHugeAllocTest.cpp | 28 + .../test/OutOfMemorySingleLargeMallocTest.cpp | 27 + .../Fuzzer/test/OutOfMemoryTest.cpp | 31 + .../Fuzzer/test/RepeatedBytesTest.cpp | 29 + .../thirdparty/Fuzzer/test/RepeatedMemcmp.cpp | 22 + .../Fuzzer/test/ShrinkControlFlowTest.cpp | 28 + .../Fuzzer/test/ShrinkValueProfileTest.cpp | 22 + .../Fuzzer/test/SignedIntOverflowTest.cpp | 28 + .../thirdparty/Fuzzer/test/SimpleCmpTest.cpp | 46 + .../Fuzzer/test/SimpleDictionaryTest.cpp | 29 + .../thirdparty/Fuzzer/test/SimpleHashTest.cpp | 40 + .../thirdparty/Fuzzer/test/SimpleTest.cpp | 27 + .../Fuzzer/test/SimpleThreadedTest.cpp | 25 + .../Fuzzer/test/SingleMemcmpTest.cpp | 17 + .../Fuzzer/test/SingleStrcmpTest.cpp | 17 + .../Fuzzer/test/SingleStrncmpTest.cpp | 17 + .../test/thirdparty/Fuzzer/test/SpamyTest.cpp | 21 + .../thirdparty/Fuzzer/test/StrcmpTest.cpp | 32 + .../thirdparty/Fuzzer/test/StrncmpOOBTest.cpp | 21 + .../thirdparty/Fuzzer/test/StrncmpTest.cpp | 28 + .../thirdparty/Fuzzer/test/StrstrTest.cpp | 28 + .../thirdparty/Fuzzer/test/SwapCmpTest.cpp | 34 + .../thirdparty/Fuzzer/test/Switch2Test.cpp | 35 + .../thirdparty/Fuzzer/test/SwitchTest.cpp | 58 + .../Fuzzer/test/ThreadedLeakTest.cpp | 18 + .../thirdparty/Fuzzer/test/ThreadedTest.cpp | 26 + .../Fuzzer/test/TimeoutEmptyTest.cpp | 14 + .../thirdparty/Fuzzer/test/TimeoutTest.cpp | 26 + .../Fuzzer/test/TraceMallocTest.cpp | 27 + .../Fuzzer/test/UninstrumentedTest.cpp | 11 + .../Fuzzer/test/afl-driver-extra-stats.test | 28 + .../Fuzzer/test/afl-driver-stderr.test | 10 + .../thirdparty/Fuzzer/test/caller-callee.test | 2 + .../test/thirdparty/Fuzzer/test/coverage.test | 19 + .../test/thirdparty/Fuzzer/test/dict1.txt | 4 + .../thirdparty/Fuzzer/test/dump_coverage.test | 16 + .../Fuzzer/test/fuzzer-customcrossover.test | 10 + .../Fuzzer/test/fuzzer-custommutator.test | 4 + .../thirdparty/Fuzzer/test/fuzzer-dict.test | 6 + .../thirdparty/Fuzzer/test/fuzzer-dirs.test | 15 + .../thirdparty/Fuzzer/test/fuzzer-fdmask.test | 30 + .../Fuzzer/test/fuzzer-finalstats.test | 11 + .../thirdparty/Fuzzer/test/fuzzer-flags.test | 10 + .../thirdparty/Fuzzer/test/fuzzer-jobs.test | 29 + .../thirdparty/Fuzzer/test/fuzzer-leak.test | 35 + .../Fuzzer/test/fuzzer-oom-with-profile.test | 6 + .../thirdparty/Fuzzer/test/fuzzer-oom.test | 11 + .../Fuzzer/test/fuzzer-printcovpcs.test | 8 + .../thirdparty/Fuzzer/test/fuzzer-runs.test | 8 + .../thirdparty/Fuzzer/test/fuzzer-seed.test | 3 + .../thirdparty/Fuzzer/test/fuzzer-segv.test | 5 + .../Fuzzer/test/fuzzer-singleinputs.test | 16 + .../Fuzzer/test/fuzzer-threaded.test | 7 + .../Fuzzer/test/fuzzer-timeout.test | 19 + .../Fuzzer/test/fuzzer-traces-hooks.test | 25 + .../thirdparty/Fuzzer/test/fuzzer-ubsan.test | 4 + .../test/thirdparty/Fuzzer/test/fuzzer.test | 57 + .../test/thirdparty/Fuzzer/test/hi.txt | 1 + .../test/thirdparty/Fuzzer/test/lit.cfg | 29 + .../thirdparty/Fuzzer/test/lit.site.cfg.in | 4 + .../test/thirdparty/Fuzzer/test/merge.test | 46 + .../Fuzzer/test/minimize_crash.test | 6 + .../Fuzzer/test/no-coverage/CMakeLists.txt | 29 + .../Fuzzer/test/repeated-bytes.test | 2 + .../test/thirdparty/Fuzzer/test/shrink.test | 7 + .../thirdparty/Fuzzer/test/simple-cmp.test | 2 + .../thirdparty/Fuzzer/test/standalone.test | 4 + .../test/thirdparty/Fuzzer/test/swap-cmp.test | 2 + .../thirdparty/Fuzzer/test/trace-malloc.test | 10 + .../Fuzzer/test/ubsan/CMakeLists.txt | 15 + .../test/thirdparty/Fuzzer/test/ulimit.test | 2 + .../Fuzzer/test/uninstrumented/CMakeLists.txt | 16 + .../test/thirdparty/Fuzzer/test/unit/lit.cfg | 7 + .../Fuzzer/test/unit/lit.site.cfg.in | 2 + .../Fuzzer/test/value-profile-cmp.test | 2 + .../Fuzzer/test/value-profile-cmp2.test | 2 + .../Fuzzer/test/value-profile-cmp3.test | 2 + .../Fuzzer/test/value-profile-cmp4.test | 2 + .../Fuzzer/test/value-profile-div.test | 3 + .../Fuzzer/test/value-profile-load.test | 3 + .../Fuzzer/test/value-profile-mem.test | 2 + .../Fuzzer/test/value-profile-set.test | 3 + .../Fuzzer/test/value-profile-strcmp.test | 2 + .../Fuzzer/test/value-profile-strncmp.test | 2 + .../Fuzzer/test/value-profile-switch.test | 3 + .../test/thirdparty/doctest/LICENSE.txt | 21 + .../test/thirdparty/doctest/doctest.h | 5956 ++++ .../doctest/doctest_compatibility.h | 37 + .../test/thirdparty/fifo_map/LICENSE.MIT | 21 + .../test/thirdparty/fifo_map/fifo_map.hpp | 530 + .../test/thirdparty/imapdl/filterbr.py | 109 + .../test/thirdparty/imapdl/gpl-3.0.txt | 674 + .../third_party/amalgamate/CHANGES.md | 10 + .../third_party/amalgamate/LICENSE.md | 27 + .../third_party/amalgamate/README.md | 66 + .../third_party/amalgamate/amalgamate.py | 299 + .../third_party/amalgamate/config.json | 8 + .../nlohmann_json/third_party/cpplint/LICENSE | 27 + .../third_party/cpplint/README.rst | 80 + .../third_party/cpplint/cpplint.py | 6583 ++++ .../third_party/cpplint/update.sh | 5 + .../third_party/macro_builder/main.cpp | 43 + contrib/nlohmann_json/wsjcpp.yml | 23 + 880 files changed, 143095 insertions(+) create mode 100644 contrib/nlohmann_json/.circleci/config.yml create mode 100644 contrib/nlohmann_json/.clang-format create mode 100644 contrib/nlohmann_json/.clang-tidy create mode 100644 contrib/nlohmann_json/.github/CODEOWNERS create mode 100644 contrib/nlohmann_json/.github/CONTRIBUTING.md create mode 100644 contrib/nlohmann_json/.github/FUNDING.yml create mode 100644 contrib/nlohmann_json/.github/ISSUE_TEMPLATE/Bug_report.md create mode 100644 contrib/nlohmann_json/.github/ISSUE_TEMPLATE/config.yml create mode 100644 contrib/nlohmann_json/.github/PULL_REQUEST_TEMPLATE.md create mode 100644 contrib/nlohmann_json/.github/SECURITY.md create mode 100644 contrib/nlohmann_json/.github/config.yml create mode 100644 contrib/nlohmann_json/.github/stale.yml create mode 100644 contrib/nlohmann_json/.github/workflows/codeql-analysis.yml create mode 100644 contrib/nlohmann_json/.github/workflows/macos.yml create mode 100644 contrib/nlohmann_json/.github/workflows/ubuntu.yml create mode 100644 contrib/nlohmann_json/.github/workflows/windows.yml create mode 100644 contrib/nlohmann_json/.gitignore create mode 100644 contrib/nlohmann_json/.travis.yml create mode 100644 contrib/nlohmann_json/CMakeLists.txt create mode 100644 contrib/nlohmann_json/CODE_OF_CONDUCT.md create mode 100644 contrib/nlohmann_json/ChangeLog.md create mode 100644 contrib/nlohmann_json/LICENSE.MIT create mode 100644 contrib/nlohmann_json/README.md create mode 100644 contrib/nlohmann_json/appveyor.yml create mode 100644 contrib/nlohmann_json/benchmarks/CMakeLists.txt create mode 100644 contrib/nlohmann_json/benchmarks/src/benchmarks.cpp create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/AUTHORS create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/BUILD.bazel create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CMakeLists.txt create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTING.md create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTORS create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/LICENSE create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/README.md create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/WORKSPACE create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/appveyor.yml create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/AddCXXCompilerFlag.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/CXXFeatureCheck.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Config.cmake.in create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/GetGitVersion.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/HandleGTest.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMAr.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMNm.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMRanLib.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/benchmark.pc.in create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/gnu_posix_regex.cpp create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/llvm-toolchain.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/posix_regex.cpp create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/split_list.cmake create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/std_regex.cpp create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/steady_clock.cpp create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/thread_safety_attributes.cpp create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/AssemblyTests.md create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/tools.md create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/include/benchmark/benchmark.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/mingw.py create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/releasing.md create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/CMakeLists.txt create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/arraysize.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_api_internal.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_main.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/check.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/console_reporter.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/csv_reporter.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/cycleclock.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/internal_macros.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/json_reporter.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/log.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/mutex.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/re.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/reporter.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sysinfo.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_manager.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_timer.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.cc create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.h create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare.py create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare_bench.py create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run1.json create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run2.json create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test2_run.json create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/__init__.py create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/report.py create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/util.py create mode 100755 contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/strip_asm.py create mode 100644 contrib/nlohmann_json/cmake/config.cmake.in create mode 100644 contrib/nlohmann_json/cmake/download_test_data.cmake create mode 100644 contrib/nlohmann_json/cmake/nlohmann_jsonConfigVersion.cmake.in create mode 100644 contrib/nlohmann_json/cmake/pkg-config.pc.in create mode 100644 contrib/nlohmann_json/doc/Doxyfile create mode 100644 contrib/nlohmann_json/doc/avatars.png create mode 100644 contrib/nlohmann_json/doc/css/mylayout.css create mode 100644 contrib/nlohmann_json/doc/css/mylayout_docset.css create mode 100644 contrib/nlohmann_json/doc/examples/README.cpp create mode 100644 contrib/nlohmann_json/doc/examples/README.link create mode 100644 contrib/nlohmann_json/doc/examples/README.output create mode 100644 contrib/nlohmann_json/doc/examples/accept__string.cpp create mode 100644 contrib/nlohmann_json/doc/examples/accept__string.link create mode 100644 contrib/nlohmann_json/doc/examples/accept__string.output create mode 100644 contrib/nlohmann_json/doc/examples/array.cpp create mode 100644 contrib/nlohmann_json/doc/examples/array.link create mode 100644 contrib/nlohmann_json/doc/examples/array.output create mode 100644 contrib/nlohmann_json/doc/examples/at__object_t_key_type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/at__object_t_key_type.link create mode 100644 contrib/nlohmann_json/doc/examples/at__object_t_key_type.output create mode 100644 contrib/nlohmann_json/doc/examples/at__object_t_key_type_const.cpp create mode 100644 contrib/nlohmann_json/doc/examples/at__object_t_key_type_const.link create mode 100644 contrib/nlohmann_json/doc/examples/at__object_t_key_type_const.output create mode 100644 contrib/nlohmann_json/doc/examples/at__size_type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/at__size_type.link create mode 100644 contrib/nlohmann_json/doc/examples/at__size_type.output create mode 100644 contrib/nlohmann_json/doc/examples/at__size_type_const.cpp create mode 100644 contrib/nlohmann_json/doc/examples/at__size_type_const.link create mode 100644 contrib/nlohmann_json/doc/examples/at__size_type_const.output create mode 100644 contrib/nlohmann_json/doc/examples/at_json_pointer.cpp create mode 100644 contrib/nlohmann_json/doc/examples/at_json_pointer.link create mode 100644 contrib/nlohmann_json/doc/examples/at_json_pointer.output create mode 100644 contrib/nlohmann_json/doc/examples/at_json_pointer_const.cpp create mode 100644 contrib/nlohmann_json/doc/examples/at_json_pointer_const.link create mode 100644 contrib/nlohmann_json/doc/examples/at_json_pointer_const.output create mode 100644 contrib/nlohmann_json/doc/examples/back.cpp create mode 100644 contrib/nlohmann_json/doc/examples/back.link create mode 100644 contrib/nlohmann_json/doc/examples/back.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__CompatibleType.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__CompatibleType.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__CompatibleType.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__InputIt_InputIt.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__InputIt_InputIt.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__InputIt_InputIt.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__basic_json.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__basic_json.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__basic_json.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__copyassignment.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__copyassignment.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__copyassignment.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__list_init_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__list_init_t.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__list_init_t.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__moveconstructor.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__moveconstructor.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__moveconstructor.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__nullptr_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__nullptr_t.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__nullptr_t.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__size_type_basic_json.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__size_type_basic_json.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__size_type_basic_json.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value_ptr.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value_ptr.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value_ptr.output create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value_t.link create mode 100644 contrib/nlohmann_json/doc/examples/basic_json__value_t.output create mode 100644 contrib/nlohmann_json/doc/examples/begin.cpp create mode 100644 contrib/nlohmann_json/doc/examples/begin.link create mode 100644 contrib/nlohmann_json/doc/examples/begin.output create mode 100644 contrib/nlohmann_json/doc/examples/cbegin.cpp create mode 100644 contrib/nlohmann_json/doc/examples/cbegin.link create mode 100644 contrib/nlohmann_json/doc/examples/cbegin.output create mode 100644 contrib/nlohmann_json/doc/examples/cend.cpp create mode 100644 contrib/nlohmann_json/doc/examples/cend.link create mode 100644 contrib/nlohmann_json/doc/examples/cend.output create mode 100644 contrib/nlohmann_json/doc/examples/clear.cpp create mode 100644 contrib/nlohmann_json/doc/examples/clear.link create mode 100644 contrib/nlohmann_json/doc/examples/clear.output create mode 100644 contrib/nlohmann_json/doc/examples/contains.cpp create mode 100644 contrib/nlohmann_json/doc/examples/contains.link create mode 100644 contrib/nlohmann_json/doc/examples/contains.output create mode 100644 contrib/nlohmann_json/doc/examples/contains_json_pointer.cpp create mode 100644 contrib/nlohmann_json/doc/examples/contains_json_pointer.link create mode 100644 contrib/nlohmann_json/doc/examples/contains_json_pointer.output create mode 100644 contrib/nlohmann_json/doc/examples/count.cpp create mode 100644 contrib/nlohmann_json/doc/examples/count.link create mode 100644 contrib/nlohmann_json/doc/examples/count.output create mode 100644 contrib/nlohmann_json/doc/examples/crbegin.cpp create mode 100644 contrib/nlohmann_json/doc/examples/crbegin.link create mode 100644 contrib/nlohmann_json/doc/examples/crbegin.output create mode 100644 contrib/nlohmann_json/doc/examples/crend.cpp create mode 100644 contrib/nlohmann_json/doc/examples/crend.link create mode 100644 contrib/nlohmann_json/doc/examples/crend.output create mode 100644 contrib/nlohmann_json/doc/examples/diff.cpp create mode 100644 contrib/nlohmann_json/doc/examples/diff.link create mode 100644 contrib/nlohmann_json/doc/examples/diff.output create mode 100644 contrib/nlohmann_json/doc/examples/dump.cpp create mode 100644 contrib/nlohmann_json/doc/examples/dump.link create mode 100644 contrib/nlohmann_json/doc/examples/dump.output create mode 100644 contrib/nlohmann_json/doc/examples/emplace.cpp create mode 100644 contrib/nlohmann_json/doc/examples/emplace.link create mode 100644 contrib/nlohmann_json/doc/examples/emplace.output create mode 100644 contrib/nlohmann_json/doc/examples/emplace_back.cpp create mode 100644 contrib/nlohmann_json/doc/examples/emplace_back.link create mode 100644 contrib/nlohmann_json/doc/examples/emplace_back.output create mode 100644 contrib/nlohmann_json/doc/examples/empty.cpp create mode 100644 contrib/nlohmann_json/doc/examples/empty.link create mode 100644 contrib/nlohmann_json/doc/examples/empty.output create mode 100644 contrib/nlohmann_json/doc/examples/end.cpp create mode 100644 contrib/nlohmann_json/doc/examples/end.link create mode 100644 contrib/nlohmann_json/doc/examples/end.output create mode 100644 contrib/nlohmann_json/doc/examples/erase__IteratorType.cpp create mode 100644 contrib/nlohmann_json/doc/examples/erase__IteratorType.link create mode 100644 contrib/nlohmann_json/doc/examples/erase__IteratorType.output create mode 100644 contrib/nlohmann_json/doc/examples/erase__IteratorType_IteratorType.cpp create mode 100644 contrib/nlohmann_json/doc/examples/erase__IteratorType_IteratorType.link create mode 100644 contrib/nlohmann_json/doc/examples/erase__IteratorType_IteratorType.output create mode 100644 contrib/nlohmann_json/doc/examples/erase__key_type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/erase__key_type.link create mode 100644 contrib/nlohmann_json/doc/examples/erase__key_type.output create mode 100644 contrib/nlohmann_json/doc/examples/erase__size_type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/erase__size_type.link create mode 100644 contrib/nlohmann_json/doc/examples/erase__size_type.output create mode 100644 contrib/nlohmann_json/doc/examples/exception.cpp create mode 100644 contrib/nlohmann_json/doc/examples/exception.link create mode 100644 contrib/nlohmann_json/doc/examples/exception.output create mode 100644 contrib/nlohmann_json/doc/examples/find__key_type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/find__key_type.link create mode 100644 contrib/nlohmann_json/doc/examples/find__key_type.output create mode 100644 contrib/nlohmann_json/doc/examples/flatten.cpp create mode 100644 contrib/nlohmann_json/doc/examples/flatten.link create mode 100644 contrib/nlohmann_json/doc/examples/flatten.output create mode 100644 contrib/nlohmann_json/doc/examples/from_bson.cpp create mode 100644 contrib/nlohmann_json/doc/examples/from_bson.link create mode 100644 contrib/nlohmann_json/doc/examples/from_bson.output create mode 100644 contrib/nlohmann_json/doc/examples/from_cbor.cpp create mode 100644 contrib/nlohmann_json/doc/examples/from_cbor.link create mode 100644 contrib/nlohmann_json/doc/examples/from_cbor.output create mode 100644 contrib/nlohmann_json/doc/examples/from_msgpack.cpp create mode 100644 contrib/nlohmann_json/doc/examples/from_msgpack.link create mode 100644 contrib/nlohmann_json/doc/examples/from_msgpack.output create mode 100644 contrib/nlohmann_json/doc/examples/from_ubjson.cpp create mode 100644 contrib/nlohmann_json/doc/examples/from_ubjson.link create mode 100644 contrib/nlohmann_json/doc/examples/from_ubjson.output create mode 100644 contrib/nlohmann_json/doc/examples/front.cpp create mode 100644 contrib/nlohmann_json/doc/examples/front.link create mode 100644 contrib/nlohmann_json/doc/examples/front.output create mode 100644 contrib/nlohmann_json/doc/examples/get__PointerType.cpp create mode 100644 contrib/nlohmann_json/doc/examples/get__PointerType.link create mode 100644 contrib/nlohmann_json/doc/examples/get__PointerType.output create mode 100644 contrib/nlohmann_json/doc/examples/get__ValueType_const.cpp create mode 100644 contrib/nlohmann_json/doc/examples/get__ValueType_const.link create mode 100644 contrib/nlohmann_json/doc/examples/get__ValueType_const.output create mode 100644 contrib/nlohmann_json/doc/examples/get_ptr.cpp create mode 100644 contrib/nlohmann_json/doc/examples/get_ptr.link create mode 100644 contrib/nlohmann_json/doc/examples/get_ptr.output create mode 100644 contrib/nlohmann_json/doc/examples/get_ref.cpp create mode 100644 contrib/nlohmann_json/doc/examples/get_ref.link create mode 100644 contrib/nlohmann_json/doc/examples/get_ref.output create mode 100644 contrib/nlohmann_json/doc/examples/get_to.cpp create mode 100644 contrib/nlohmann_json/doc/examples/get_to.link create mode 100644 contrib/nlohmann_json/doc/examples/get_to.output create mode 100644 contrib/nlohmann_json/doc/examples/insert.cpp create mode 100644 contrib/nlohmann_json/doc/examples/insert.link create mode 100644 contrib/nlohmann_json/doc/examples/insert.output create mode 100644 contrib/nlohmann_json/doc/examples/insert__count.cpp create mode 100644 contrib/nlohmann_json/doc/examples/insert__count.link create mode 100644 contrib/nlohmann_json/doc/examples/insert__count.output create mode 100644 contrib/nlohmann_json/doc/examples/insert__ilist.cpp create mode 100644 contrib/nlohmann_json/doc/examples/insert__ilist.link create mode 100644 contrib/nlohmann_json/doc/examples/insert__ilist.output create mode 100644 contrib/nlohmann_json/doc/examples/insert__range.cpp create mode 100644 contrib/nlohmann_json/doc/examples/insert__range.link create mode 100644 contrib/nlohmann_json/doc/examples/insert__range.output create mode 100644 contrib/nlohmann_json/doc/examples/insert__range_object.cpp create mode 100644 contrib/nlohmann_json/doc/examples/insert__range_object.link create mode 100644 contrib/nlohmann_json/doc/examples/insert__range_object.output create mode 100644 contrib/nlohmann_json/doc/examples/invalid_iterator.cpp create mode 100644 contrib/nlohmann_json/doc/examples/invalid_iterator.link create mode 100644 contrib/nlohmann_json/doc/examples/invalid_iterator.output create mode 100644 contrib/nlohmann_json/doc/examples/is_array.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_array.link create mode 100644 contrib/nlohmann_json/doc/examples/is_array.output create mode 100644 contrib/nlohmann_json/doc/examples/is_binary.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_binary.link create mode 100644 contrib/nlohmann_json/doc/examples/is_binary.output create mode 100644 contrib/nlohmann_json/doc/examples/is_boolean.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_boolean.link create mode 100644 contrib/nlohmann_json/doc/examples/is_boolean.output create mode 100644 contrib/nlohmann_json/doc/examples/is_discarded.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_discarded.link create mode 100644 contrib/nlohmann_json/doc/examples/is_discarded.output create mode 100644 contrib/nlohmann_json/doc/examples/is_null.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_null.link create mode 100644 contrib/nlohmann_json/doc/examples/is_null.output create mode 100644 contrib/nlohmann_json/doc/examples/is_number.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_number.link create mode 100644 contrib/nlohmann_json/doc/examples/is_number.output create mode 100644 contrib/nlohmann_json/doc/examples/is_number_float.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_number_float.link create mode 100644 contrib/nlohmann_json/doc/examples/is_number_float.output create mode 100644 contrib/nlohmann_json/doc/examples/is_number_integer.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_number_integer.link create mode 100644 contrib/nlohmann_json/doc/examples/is_number_integer.output create mode 100644 contrib/nlohmann_json/doc/examples/is_number_unsigned.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_number_unsigned.link create mode 100644 contrib/nlohmann_json/doc/examples/is_number_unsigned.output create mode 100644 contrib/nlohmann_json/doc/examples/is_object.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_object.link create mode 100644 contrib/nlohmann_json/doc/examples/is_object.output create mode 100644 contrib/nlohmann_json/doc/examples/is_primitive.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_primitive.link create mode 100644 contrib/nlohmann_json/doc/examples/is_primitive.output create mode 100644 contrib/nlohmann_json/doc/examples/is_string.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_string.link create mode 100644 contrib/nlohmann_json/doc/examples/is_string.output create mode 100644 contrib/nlohmann_json/doc/examples/is_structured.cpp create mode 100644 contrib/nlohmann_json/doc/examples/is_structured.link create mode 100644 contrib/nlohmann_json/doc/examples/is_structured.output create mode 100644 contrib/nlohmann_json/doc/examples/items.cpp create mode 100644 contrib/nlohmann_json/doc/examples/items.link create mode 100644 contrib/nlohmann_json/doc/examples/items.output create mode 100644 contrib/nlohmann_json/doc/examples/iterator_wrapper.cpp create mode 100644 contrib/nlohmann_json/doc/examples/iterator_wrapper.link create mode 100644 contrib/nlohmann_json/doc/examples/iterator_wrapper.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__back.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__back.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__back.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__empty.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__empty.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__empty.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__operator_add.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__operator_add.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__operator_add.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__operator_add_binary.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__operator_add_binary.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__operator_add_binary.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__parent_pointer.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__parent_pointer.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__parent_pointer.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__pop_back.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__pop_back.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__pop_back.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__push_back.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__push_back.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__push_back.output create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__to_string.cpp create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__to_string.link create mode 100644 contrib/nlohmann_json/doc/examples/json_pointer__to_string.output create mode 100644 contrib/nlohmann_json/doc/examples/max_size.cpp create mode 100644 contrib/nlohmann_json/doc/examples/max_size.link create mode 100644 contrib/nlohmann_json/doc/examples/max_size.output create mode 100644 contrib/nlohmann_json/doc/examples/merge_patch.cpp create mode 100644 contrib/nlohmann_json/doc/examples/merge_patch.link create mode 100644 contrib/nlohmann_json/doc/examples/merge_patch.output create mode 100644 contrib/nlohmann_json/doc/examples/meta.cpp create mode 100644 contrib/nlohmann_json/doc/examples/meta.link create mode 100644 contrib/nlohmann_json/doc/examples/meta.output create mode 100644 contrib/nlohmann_json/doc/examples/object.cpp create mode 100644 contrib/nlohmann_json/doc/examples/object.link create mode 100644 contrib/nlohmann_json/doc/examples/object.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__ValueType.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__ValueType.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__ValueType.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__equal.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__equal.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__equal.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__equal__nullptr_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__equal__nullptr_t.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__equal__nullptr_t.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__greater.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__greater.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__greater.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__greaterequal.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__greaterequal.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__greaterequal.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__less.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__less.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__less.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__lessequal.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__lessequal.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__lessequal.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__notequal.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__notequal.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__notequal.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__notequal__nullptr_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__notequal__nullptr_t.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__notequal__nullptr_t.output create mode 100644 contrib/nlohmann_json/doc/examples/operator__value_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator__value_t.link create mode 100644 contrib/nlohmann_json/doc/examples/operator__value_t.output create mode 100644 contrib/nlohmann_json/doc/examples/operator_deserialize.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator_deserialize.link create mode 100644 contrib/nlohmann_json/doc/examples/operator_deserialize.output create mode 100644 contrib/nlohmann_json/doc/examples/operator_serialize.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operator_serialize.link create mode 100644 contrib/nlohmann_json/doc/examples/operator_serialize.output create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__key_type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__key_type.link create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__key_type.output create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__key_type_const.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__key_type_const.link create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__key_type_const.output create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__size_type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__size_type.link create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__size_type.output create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__size_type_const.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__size_type_const.link create mode 100644 contrib/nlohmann_json/doc/examples/operatorarray__size_type_const.output create mode 100644 contrib/nlohmann_json/doc/examples/operatorjson_pointer.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operatorjson_pointer.link create mode 100644 contrib/nlohmann_json/doc/examples/operatorjson_pointer.output create mode 100644 contrib/nlohmann_json/doc/examples/operatorjson_pointer_const.cpp create mode 100644 contrib/nlohmann_json/doc/examples/operatorjson_pointer_const.link create mode 100644 contrib/nlohmann_json/doc/examples/operatorjson_pointer_const.output create mode 100644 contrib/nlohmann_json/doc/examples/other_error.cpp create mode 100644 contrib/nlohmann_json/doc/examples/other_error.link create mode 100644 contrib/nlohmann_json/doc/examples/other_error.output create mode 100644 contrib/nlohmann_json/doc/examples/out_of_range.cpp create mode 100644 contrib/nlohmann_json/doc/examples/out_of_range.link create mode 100644 contrib/nlohmann_json/doc/examples/out_of_range.output create mode 100644 contrib/nlohmann_json/doc/examples/parse__array__parser_callback_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/parse__array__parser_callback_t.link create mode 100644 contrib/nlohmann_json/doc/examples/parse__array__parser_callback_t.output create mode 100644 contrib/nlohmann_json/doc/examples/parse__contiguouscontainer__parser_callback_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/parse__contiguouscontainer__parser_callback_t.link create mode 100644 contrib/nlohmann_json/doc/examples/parse__contiguouscontainer__parser_callback_t.output create mode 100644 contrib/nlohmann_json/doc/examples/parse__istream__parser_callback_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/parse__istream__parser_callback_t.link create mode 100644 contrib/nlohmann_json/doc/examples/parse__istream__parser_callback_t.output create mode 100644 contrib/nlohmann_json/doc/examples/parse__iteratortype__parser_callback_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/parse__iteratortype__parser_callback_t.link create mode 100644 contrib/nlohmann_json/doc/examples/parse__iteratortype__parser_callback_t.output create mode 100644 contrib/nlohmann_json/doc/examples/parse__string__parser_callback_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/parse__string__parser_callback_t.link create mode 100644 contrib/nlohmann_json/doc/examples/parse__string__parser_callback_t.output create mode 100644 contrib/nlohmann_json/doc/examples/parse_error.cpp create mode 100644 contrib/nlohmann_json/doc/examples/parse_error.link create mode 100644 contrib/nlohmann_json/doc/examples/parse_error.output create mode 100644 contrib/nlohmann_json/doc/examples/patch.cpp create mode 100644 contrib/nlohmann_json/doc/examples/patch.link create mode 100644 contrib/nlohmann_json/doc/examples/patch.output create mode 100644 contrib/nlohmann_json/doc/examples/push_back.cpp create mode 100644 contrib/nlohmann_json/doc/examples/push_back.link create mode 100644 contrib/nlohmann_json/doc/examples/push_back.output create mode 100644 contrib/nlohmann_json/doc/examples/push_back__initializer_list.cpp create mode 100644 contrib/nlohmann_json/doc/examples/push_back__initializer_list.link create mode 100644 contrib/nlohmann_json/doc/examples/push_back__initializer_list.output create mode 100644 contrib/nlohmann_json/doc/examples/push_back__object_t__value.cpp create mode 100644 contrib/nlohmann_json/doc/examples/push_back__object_t__value.link create mode 100644 contrib/nlohmann_json/doc/examples/push_back__object_t__value.output create mode 100644 contrib/nlohmann_json/doc/examples/rbegin.cpp create mode 100644 contrib/nlohmann_json/doc/examples/rbegin.link create mode 100644 contrib/nlohmann_json/doc/examples/rbegin.output create mode 100644 contrib/nlohmann_json/doc/examples/rend.cpp create mode 100644 contrib/nlohmann_json/doc/examples/rend.link create mode 100644 contrib/nlohmann_json/doc/examples/rend.output create mode 100644 contrib/nlohmann_json/doc/examples/sax_parse.cpp create mode 100644 contrib/nlohmann_json/doc/examples/sax_parse.link create mode 100644 contrib/nlohmann_json/doc/examples/sax_parse.output create mode 100644 contrib/nlohmann_json/doc/examples/size.cpp create mode 100644 contrib/nlohmann_json/doc/examples/size.link create mode 100644 contrib/nlohmann_json/doc/examples/size.output create mode 100644 contrib/nlohmann_json/doc/examples/swap__array_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/swap__array_t.link create mode 100644 contrib/nlohmann_json/doc/examples/swap__array_t.output create mode 100644 contrib/nlohmann_json/doc/examples/swap__binary_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/swap__binary_t.link create mode 100644 contrib/nlohmann_json/doc/examples/swap__binary_t.output create mode 100644 contrib/nlohmann_json/doc/examples/swap__object_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/swap__object_t.link create mode 100644 contrib/nlohmann_json/doc/examples/swap__object_t.output create mode 100644 contrib/nlohmann_json/doc/examples/swap__reference.cpp create mode 100644 contrib/nlohmann_json/doc/examples/swap__reference.link create mode 100644 contrib/nlohmann_json/doc/examples/swap__reference.output create mode 100644 contrib/nlohmann_json/doc/examples/swap__string_t.cpp create mode 100644 contrib/nlohmann_json/doc/examples/swap__string_t.link create mode 100644 contrib/nlohmann_json/doc/examples/swap__string_t.output create mode 100644 contrib/nlohmann_json/doc/examples/to_bson.cpp create mode 100644 contrib/nlohmann_json/doc/examples/to_bson.link create mode 100644 contrib/nlohmann_json/doc/examples/to_bson.output create mode 100644 contrib/nlohmann_json/doc/examples/to_cbor.cpp create mode 100644 contrib/nlohmann_json/doc/examples/to_cbor.link create mode 100644 contrib/nlohmann_json/doc/examples/to_cbor.output create mode 100644 contrib/nlohmann_json/doc/examples/to_msgpack.cpp create mode 100644 contrib/nlohmann_json/doc/examples/to_msgpack.link create mode 100644 contrib/nlohmann_json/doc/examples/to_msgpack.output create mode 100644 contrib/nlohmann_json/doc/examples/to_ubjson.cpp create mode 100644 contrib/nlohmann_json/doc/examples/to_ubjson.link create mode 100644 contrib/nlohmann_json/doc/examples/to_ubjson.output create mode 100644 contrib/nlohmann_json/doc/examples/type.cpp create mode 100644 contrib/nlohmann_json/doc/examples/type.link create mode 100644 contrib/nlohmann_json/doc/examples/type.output create mode 100644 contrib/nlohmann_json/doc/examples/type_error.cpp create mode 100644 contrib/nlohmann_json/doc/examples/type_error.link create mode 100644 contrib/nlohmann_json/doc/examples/type_error.output create mode 100644 contrib/nlohmann_json/doc/examples/type_name.cpp create mode 100644 contrib/nlohmann_json/doc/examples/type_name.link create mode 100644 contrib/nlohmann_json/doc/examples/type_name.output create mode 100644 contrib/nlohmann_json/doc/examples/unflatten.cpp create mode 100644 contrib/nlohmann_json/doc/examples/unflatten.link create mode 100644 contrib/nlohmann_json/doc/examples/unflatten.output create mode 100644 contrib/nlohmann_json/doc/examples/update.cpp create mode 100644 contrib/nlohmann_json/doc/examples/update.link create mode 100644 contrib/nlohmann_json/doc/examples/update.output create mode 100644 contrib/nlohmann_json/doc/examples/update__range.cpp create mode 100644 contrib/nlohmann_json/doc/examples/update__range.link create mode 100644 contrib/nlohmann_json/doc/examples/update__range.output create mode 100644 contrib/nlohmann_json/doc/images/callback_events.png create mode 100644 contrib/nlohmann_json/doc/images/range-begin-end.svg create mode 100644 contrib/nlohmann_json/doc/images/range-rbegin-rend.svg create mode 100644 contrib/nlohmann_json/doc/index.md create mode 100644 contrib/nlohmann_json/doc/json.gif create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/api/basic_json/dump.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/api/basic_json/index.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/api/basic_json/meta.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/api/basic_json/parse.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/arbitrary_types.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/binary_formats/bson.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/binary_formats/cbor.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/binary_formats/index.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/binary_formats/messagepack.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/binary_formats/ubjson.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/binary_values.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/comments.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/element_access/checked_access.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/element_access/default_value.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/element_access/index.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/element_access/unchecked_access.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/enum_conversion.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/iterators.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/json_patch.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/json_pointer.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/macros.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/merge_patch.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/object_order.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/parsing/index.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/parsing/parse_exceptions.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/parsing/parser_callbacks.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/parsing/sax_interface.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/features/types.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/home/code_of_conduct.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/home/design_goals.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/home/exceptions.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/home/faq.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/home/license.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/home/releases.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/home/sponsors.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/hooks.py create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/index.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/integration/cmake.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/integration/conan/CMakeLists.txt create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/integration/conan/Conanfile.txt create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/integration/conan/example.cpp create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/integration/example.cpp create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/integration/index.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/docs/integration/package_managers.md create mode 100644 contrib/nlohmann_json/doc/mkdocs/mkdocs.yml create mode 100644 contrib/nlohmann_json/doc/mkdocs/requirements.txt create mode 100755 contrib/nlohmann_json/doc/scripts/git-update-ghpages create mode 100755 contrib/nlohmann_json/doc/scripts/send_to_wandbox.py create mode 100755 contrib/nlohmann_json/doc/usages/ios.png create mode 100644 contrib/nlohmann_json/doc/usages/macos.png create mode 100644 contrib/nlohmann_json/include/nlohmann/adl_serializer.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/byte_container_with_subtype.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/conversions/from_json.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/conversions/to_chars.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/conversions/to_json.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/exceptions.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/hash.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/input/binary_reader.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/input/input_adapters.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/input/json_sax.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/input/lexer.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/input/parser.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/input/position_t.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/iterators/internal_iterator.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/iterators/iter_impl.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/iterators/iteration_proxy.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/iterators/iterator_traits.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/iterators/json_reverse_iterator.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/iterators/primitive_iterator.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/json_pointer.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/json_ref.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/macro_scope.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/macro_unscope.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/meta/cpp_future.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/meta/detected.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/meta/is_sax.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/meta/type_traits.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/meta/void_t.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/output/binary_writer.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/output/output_adapters.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/output/serializer.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/detail/value_t.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/json.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/json_fwd.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/ordered_map.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/thirdparty/hedley/hedley.hpp create mode 100644 contrib/nlohmann_json/include/nlohmann/thirdparty/hedley/hedley_undef.hpp create mode 100644 contrib/nlohmann_json/nlohmann_json.natvis create mode 100644 contrib/nlohmann_json/single_include/nlohmann/json.hpp create mode 100644 contrib/nlohmann_json/test/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_add_subdirectory/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_add_subdirectory/project/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_add_subdirectory/project/main.cpp create mode 100644 contrib/nlohmann_json/test/cmake_fetch_content/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_fetch_content/project/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_fetch_content/project/main.cpp create mode 100644 contrib/nlohmann_json/test/cmake_import/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_import/project/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_import/project/main.cpp create mode 100644 contrib/nlohmann_json/test/cmake_import_minver/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_import_minver/project/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_import_minver/project/main.cpp create mode 100644 contrib/nlohmann_json/test/cmake_target_include_directories/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_target_include_directories/project/Bar.cpp create mode 100644 contrib/nlohmann_json/test/cmake_target_include_directories/project/Bar.hpp create mode 100644 contrib/nlohmann_json/test/cmake_target_include_directories/project/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/cmake_target_include_directories/project/Foo.cpp create mode 100644 contrib/nlohmann_json/test/cmake_target_include_directories/project/Foo.hpp create mode 100644 contrib/nlohmann_json/test/cmake_target_include_directories/project/main.cpp create mode 100644 contrib/nlohmann_json/test/reports/2016-08-29-fuzz/exec_speed.png create mode 100644 contrib/nlohmann_json/test/reports/2016-08-29-fuzz/fuzz.tiff create mode 100644 contrib/nlohmann_json/test/reports/2016-08-29-fuzz/high_freq.png create mode 100644 contrib/nlohmann_json/test/reports/2016-08-29-fuzz/index.html create mode 100644 contrib/nlohmann_json/test/reports/2016-08-29-fuzz/low_freq.png create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/README.md create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/conformance_Nlohmann (C++11).md create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/conformance_overall_Result.png create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Memory_(byte).png create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_1._Parse_Time_(ms).png create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_2._Stringify_Time_(ms).png create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_3._Prettify_Time_(ms).png create mode 100644 contrib/nlohmann_json/test/reports/2016-09-09-nativejson_benchmark/performance_Corei7-4980HQ@2.80GHz_mac64_clang7.0_7._Code_size_FileSize_(byte).png create mode 100644 contrib/nlohmann_json/test/reports/2016-10-02-fuzz/exec_speed.png create mode 100644 contrib/nlohmann_json/test/reports/2016-10-02-fuzz/fuzz.tiff create mode 100644 contrib/nlohmann_json/test/reports/2016-10-02-fuzz/high_freq.png create mode 100644 contrib/nlohmann_json/test/reports/2016-10-02-fuzz/index.html create mode 100644 contrib/nlohmann_json/test/reports/2016-10-02-fuzz/low_freq.png create mode 100644 contrib/nlohmann_json/test/src/UBSAN.supp create mode 100644 contrib/nlohmann_json/test/src/fuzzer-driver_afl.cpp create mode 100644 contrib/nlohmann_json/test/src/fuzzer-parse_bson.cpp create mode 100644 contrib/nlohmann_json/test/src/fuzzer-parse_cbor.cpp create mode 100644 contrib/nlohmann_json/test/src/fuzzer-parse_json.cpp create mode 100644 contrib/nlohmann_json/test/src/fuzzer-parse_msgpack.cpp create mode 100644 contrib/nlohmann_json/test/src/fuzzer-parse_ubjson.cpp create mode 100644 contrib/nlohmann_json/test/src/test_utils.hpp create mode 100644 contrib/nlohmann_json/test/src/unit-algorithms.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-allocator.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-alt-string.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-assert_macro.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-bson.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-capacity.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-cbor.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-class_const_iterator.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-class_iterator.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-class_lexer.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-class_parser.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-comparison.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-concepts.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-constructor1.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-constructor2.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-convenience.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-conversions.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-deserialization.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-element_access1.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-element_access2.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-hash.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-inspection.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-items.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-iterators1.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-iterators2.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-json_patch.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-json_pointer.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-large_json.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-merge_patch.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-meta.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-modifiers.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-msgpack.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-noexcept.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-ordered_json.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-ordered_map.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-pointer_access.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-readme.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-reference_access.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-regression1.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-regression2.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-serialization.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-testsuites.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-to_chars.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-ubjson.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-udt.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-udt_macro.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-unicode.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-user_defined_input.cpp create mode 100644 contrib/nlohmann_json/test/src/unit-wstring.cpp create mode 100644 contrib/nlohmann_json/test/src/unit.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerCorpus.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerCrossOver.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerDefs.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerDictionary.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerDriver.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerExtFunctions.def create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerExtFunctions.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerExtFunctionsDlsym.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerExtFunctionsWeak.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerExtFunctionsWeakAlias.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerFlags.def create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerIO.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerIO.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerIOPosix.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerIOWindows.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerInterface.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerInternal.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerLoop.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerMain.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerMerge.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerMerge.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerMutate.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerMutate.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerOptions.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerRandom.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerSHA1.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerSHA1.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerTracePC.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerTracePC.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerTraceState.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerUtil.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerUtil.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerUtilDarwin.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerUtilLinux.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerUtilPosix.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerUtilWindows.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/FuzzerValueBitMap.h create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/README.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/afl/afl_driver.cpp create mode 100755 contrib/nlohmann_json/test/thirdparty/Fuzzer/build.sh create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/cxx.dict create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/standalone/StandaloneFuzzTargetMain.c create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/AFLDriverTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/AbsNegAndConstant64Test.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/AbsNegAndConstantTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/AccumulateAllocationsTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/BufferOverflowOnInput.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/CallerCalleeTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/CounterTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/CustomCrossOverTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/CustomMutatorTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/DSO1.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/DSO2.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/DSOTestExtra.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/DSOTestMain.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/DivTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/EmptyTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/FourIndependentBranchesTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/FullCoverageSetTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/FuzzerUnittest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/InitializeTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/LeakTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/LeakTimeoutTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/LoadTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/MemcmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/NthRunCrashTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/NullDerefOnEmptyTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/NullDerefTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/OneHugeAllocTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/OutOfMemorySingleLargeMallocTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/OutOfMemoryTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/RepeatedBytesTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/RepeatedMemcmp.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/ShrinkControlFlowTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/ShrinkValueProfileTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SignedIntOverflowTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SimpleCmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SimpleDictionaryTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SimpleHashTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SimpleTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SimpleThreadedTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SingleMemcmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SingleStrcmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SingleStrncmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SpamyTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/StrcmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/StrncmpOOBTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/StrncmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/StrstrTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SwapCmpTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/Switch2Test.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/SwitchTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/ThreadedLeakTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/ThreadedTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/TimeoutEmptyTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/TimeoutTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/TraceMallocTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/UninstrumentedTest.cpp create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/afl-driver-extra-stats.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/afl-driver-stderr.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/caller-callee.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/coverage.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/dict1.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/dump_coverage.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-customcrossover.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-custommutator.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-dict.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-dirs.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-fdmask.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-finalstats.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-flags.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-jobs.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-leak.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-oom-with-profile.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-oom.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-printcovpcs.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-runs.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-seed.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-segv.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-singleinputs.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-threaded.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-timeout.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-traces-hooks.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer-ubsan.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/fuzzer.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/hi.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/lit.cfg create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/lit.site.cfg.in create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/merge.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/minimize_crash.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/no-coverage/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/repeated-bytes.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/shrink.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/simple-cmp.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/standalone.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/swap-cmp.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/trace-malloc.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/ubsan/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/ulimit.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/uninstrumented/CMakeLists.txt create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/unit/lit.cfg create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/unit/lit.site.cfg.in create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-cmp.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-cmp2.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-cmp3.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-cmp4.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-div.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-load.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-mem.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-set.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-strcmp.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-strncmp.test create mode 100644 contrib/nlohmann_json/test/thirdparty/Fuzzer/test/value-profile-switch.test create mode 100755 contrib/nlohmann_json/test/thirdparty/doctest/LICENSE.txt create mode 100755 contrib/nlohmann_json/test/thirdparty/doctest/doctest.h create mode 100644 contrib/nlohmann_json/test/thirdparty/doctest/doctest_compatibility.h create mode 100644 contrib/nlohmann_json/test/thirdparty/fifo_map/LICENSE.MIT create mode 100644 contrib/nlohmann_json/test/thirdparty/fifo_map/fifo_map.hpp create mode 100755 contrib/nlohmann_json/test/thirdparty/imapdl/filterbr.py create mode 100644 contrib/nlohmann_json/test/thirdparty/imapdl/gpl-3.0.txt create mode 100644 contrib/nlohmann_json/third_party/amalgamate/CHANGES.md create mode 100644 contrib/nlohmann_json/third_party/amalgamate/LICENSE.md create mode 100644 contrib/nlohmann_json/third_party/amalgamate/README.md create mode 100755 contrib/nlohmann_json/third_party/amalgamate/amalgamate.py create mode 100644 contrib/nlohmann_json/third_party/amalgamate/config.json create mode 100644 contrib/nlohmann_json/third_party/cpplint/LICENSE create mode 100644 contrib/nlohmann_json/third_party/cpplint/README.rst create mode 100755 contrib/nlohmann_json/third_party/cpplint/cpplint.py create mode 100755 contrib/nlohmann_json/third_party/cpplint/update.sh create mode 100644 contrib/nlohmann_json/third_party/macro_builder/main.cpp create mode 100644 contrib/nlohmann_json/wsjcpp.yml diff --git a/contrib/nlohmann_json/.circleci/config.yml b/contrib/nlohmann_json/.circleci/config.yml new file mode 100644 index 00000000000..91ceaf7f6ca --- /dev/null +++ b/contrib/nlohmann_json/.circleci/config.yml @@ -0,0 +1,48 @@ +version: 2 +jobs: + build_stable: + docker: + - image: debian:stretch + + steps: + - checkout + + - run: + name: Install required tools + command: 'apt-get update && apt-get install -y gcc g++ git cmake' + - run: + name: Run CMake + command: 'mkdir build ; cd build ; cmake .. -DJSON_BuildTests=On' + - run: + name: Compile + command: 'cmake --build build' + - run: + name: Execute test suite + command: 'cd build ; ctest --output-on-failure -j 2' + + build_bleeding_edge: + docker: + - image: archlinux + + steps: + - checkout + + - run: + name: Install required tools + command: 'pacman -Sy --noconfirm base base-devel gcc git cmake' + - run: + name: Run CMake + command: 'mkdir build ; cd build ; cmake .. -DJSON_BuildTests=On' + - run: + name: Compile + command: 'cmake --build build' + - run: + name: Execute test suite + command: 'cd build ; ctest --output-on-failure -j 2' + +workflows: + version: 2 + build_and_test_all: + jobs: + - build_stable + - build_bleeding_edge diff --git a/contrib/nlohmann_json/.clang-format b/contrib/nlohmann_json/.clang-format new file mode 100644 index 00000000000..5b9e3fd5300 --- /dev/null +++ b/contrib/nlohmann_json/.clang-format @@ -0,0 +1,84 @@ +#AccessModifierOffset: 2 +AlignAfterOpenBracket: Align +AlignConsecutiveAssignments: false +#AlignConsecutiveBitFields: false +AlignConsecutiveDeclarations: false +AlignConsecutiveMacros: false +AlignEscapedNewlines: Right +#AlignOperands: AlignAfterOperator +AlignTrailingComments: true +AllowAllArgumentsOnNextLine: false +AllowAllConstructorInitializersOnNextLine: false +AllowAllParametersOfDeclarationOnNextLine: false +AllowShortBlocksOnASingleLine: Empty +AllowShortCaseLabelsOnASingleLine: false +#AllowShortEnumsOnASingleLine: true +AllowShortFunctionsOnASingleLine: Empty +AllowShortIfStatementsOnASingleLine: Never +AllowShortLambdasOnASingleLine: Empty +AllowShortLoopsOnASingleLine: false +AlwaysBreakAfterReturnType: None +AlwaysBreakBeforeMultilineStrings: false +AlwaysBreakTemplateDeclarations: Yes +BinPackArguments: false +BinPackParameters: false +#BitFieldColonSpacing: Both +BreakBeforeBraces: Custom # or Allman +BraceWrapping: + AfterCaseLabel: true + AfterClass: true + AfterControlStatement: Always + AfterEnum: true + AfterFunction: true + AfterNamespace: false + AfterStruct: true + AfterUnion: true + AfterExternBlock: false + BeforeCatch: true + BeforeElse: true + #BeforeLambdaBody: false + #BeforeWhile: false + SplitEmptyFunction: false + SplitEmptyRecord: false + SplitEmptyNamespace: false +BreakBeforeTernaryOperators: true +BreakConstructorInitializers: BeforeComma +BreakStringLiterals: false +ColumnLimit: 0 +CompactNamespaces: false +ConstructorInitializerIndentWidth: 2 +Cpp11BracedListStyle: true +PointerAlignment: Left +FixNamespaceComments: true +IncludeBlocks: Preserve +#IndentCaseBlocks: false +IndentCaseLabels: true +IndentGotoLabels: false +IndentPPDirectives: BeforeHash +IndentWidth: 4 +KeepEmptyLinesAtTheStartOfBlocks: false +MaxEmptyLinesToKeep: 1 +NamespaceIndentation: None +ReflowComments: false +SortIncludes: true +SortUsingDeclarations: true +SpaceAfterCStyleCast: false +SpaceAfterLogicalNot: false +SpaceAfterTemplateKeyword: false +SpaceBeforeAssignmentOperators: true +SpaceBeforeCpp11BracedList: false +SpaceBeforeParens: ControlStatements +SpaceBeforeRangeBasedForLoopColon: true +SpaceBeforeSquareBrackets: false +SpaceInEmptyBlock: false +SpaceInEmptyParentheses: false +SpacesBeforeTrailingComments: 2 +SpacesInAngles: false +SpacesInCStyleCastParentheses: false +SpacesInConditionalStatement: false +SpacesInContainerLiterals: false +SpacesInParentheses: false +SpacesInSquareBrackets: false +Standard: c++11 +TabWidth: 4 +UseTab: Never diff --git a/contrib/nlohmann_json/.clang-tidy b/contrib/nlohmann_json/.clang-tidy new file mode 100644 index 00000000000..046d84f870d --- /dev/null +++ b/contrib/nlohmann_json/.clang-tidy @@ -0,0 +1,23 @@ +Checks: '*, + -cppcoreguidelines-avoid-goto, + -cppcoreguidelines-avoid-magic-numbers, + -cppcoreguidelines-macro-usage, + -fuchsia-default-arguments-calls, + -fuchsia-default-arguments-declarations, + -fuchsia-overloaded-operator, + -google-explicit-constructor, + -google-runtime-references, + -hicpp-avoid-goto, + -hicpp-explicit-conversions, + -hicpp-no-array-decay, + -hicpp-uppercase-literal-suffix, + -llvm-header-guard, + -llvm-include-order, + -misc-non-private-member-variables-in-classes, + -modernize-use-trailing-return-type, + -readability-magic-numbers, + -readability-uppercase-literal-suffix' + +CheckOptions: + - key: hicpp-special-member-functions.AllowSoleDefaultDtor + value: 1 diff --git a/contrib/nlohmann_json/.github/CODEOWNERS b/contrib/nlohmann_json/.github/CODEOWNERS new file mode 100644 index 00000000000..4d5ee044025 --- /dev/null +++ b/contrib/nlohmann_json/.github/CODEOWNERS @@ -0,0 +1,6 @@ +# JSON for Modern C++ has been originally written by Niels Lohmann. +# Since 2013 over 140 contributors have helped to improve the library. +# This CODEOWNERS file is only to make sure that @nlohmann is requested +# for a code review in case of a pull request. + +* @nlohmann diff --git a/contrib/nlohmann_json/.github/CONTRIBUTING.md b/contrib/nlohmann_json/.github/CONTRIBUTING.md new file mode 100644 index 00000000000..7f12d507084 --- /dev/null +++ b/contrib/nlohmann_json/.github/CONTRIBUTING.md @@ -0,0 +1,71 @@ +[![Issue Stats](http://issuestats.com/github/nlohmann/json/badge/pr?style=flat)](http://issuestats.com/github/nlohmann/json) [![Issue Stats](http://issuestats.com/github/nlohmann/json/badge/issue?style=flat)](http://issuestats.com/github/nlohmann/json) + +# How to contribute + +This project started as a little excuse to exercise some of the cool new C++11 features. Over time, people actually started to use the JSON library (yey!) and started to help improve it by proposing features, finding bugs, or even fixing my mistakes. I am really [thankful](https://github.com/nlohmann/json/blob/master/README.md#thanks) for this and try to keep track of all the helpers. + +To make it as easy as possible for you to contribute and for me to keep an overview, here are a few guidelines which should help us avoid all kinds of unnecessary work or disappointment. And of course, this document is subject to discussion, so please [create an issue](https://github.com/nlohmann/json/issues/new/choose) or a pull request if you find a way to improve it! + +## Private reports + +Usually, all issues are tracked publicly on [GitHub](https://github.com/nlohmann/json/issues). If you want to make a private report (e.g., for a vulnerability or to attach an example that is not meant to be published), please send an email to . + +## Prerequisites + +Please [create an issue](https://github.com/nlohmann/json/issues/new/choose), assuming one does not already exist, and describe your concern. Note you need a [GitHub account](https://github.com/signup/free) for this. + +## Describe your issue + +Clearly describe the issue: + +- If it is a bug, please describe how to **reproduce** it. If possible, attach a complete example which demonstrates the error. Please also state what you **expected** to happen instead of the error. +- If you propose a change or addition, try to give an **example** how the improved code could look like or how to use it. +- If you found a compilation error, please tell us which **compiler** (version and operating system) you used and paste the (relevant part of) the error messages to the ticket. + +Please stick to the provided issue templates ([bug report](https://github.com/nlohmann/json/blob/develop/.github/ISSUE_TEMPLATE/Bug_report.md), [feature request](https://github.com/nlohmann/json/blob/develop/.github/ISSUE_TEMPLATE/Feature_request.md), or [question](https://github.com/nlohmann/json/blob/develop/.github/ISSUE_TEMPLATE/question.md)) if possible. + +## Files to change + +:exclamation: Before you make any changes, note the single-header file [`single_include/nlohmann/json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp) is **generated** from the source files in the [`include/nlohmann` directory](https://github.com/nlohmann/json/tree/develop/include/nlohmann). Please **do not** edit file `single_include/nlohmann/json.hpp` directly, but change the `include/nlohmann` sources and regenerate file `single_include/nlohmann/json.hpp` by executing `make amalgamate`. + +To make changes, you need to edit the following files: + +1. [`include/nlohmann/*`](https://github.com/nlohmann/json/tree/develop/include/nlohmann) - These files are the sources of the library. Before testing or creating a pull request, execute `make amalgamate` to regenerate `single_include/nlohmann/json.hpp`. + +2. [`test/src/unit-*.cpp`](https://github.com/nlohmann/json/tree/develop/test/src) - These files contain the [doctest](https://github.com/onqtam/doctest) unit tests which currently cover [100 %](https://coveralls.io/github/nlohmann/json) of the library's code. + + If you add or change a feature, please also add a unit test to this file. The unit tests can be compiled and executed with + + ```sh + $ mkdir build + $ cd build + $ cmake .. + $ cmake --build . + $ ctest + ``` + + The test cases are also executed with several different compilers on [Travis](https://travis-ci.org/nlohmann/json) once you open a pull request. + + +## Note + +- If you open a pull request, the code will be automatically tested with [Valgrind](http://valgrind.org)'s Memcheck tool to detect memory leaks. Please be aware that the execution with Valgrind _may_ in rare cases yield different behavior than running the code directly. This can result in failing unit tests which run successfully without Valgrind. +- There is a Makefile target `make pretty` which runs [Artistic Style](http://astyle.sourceforge.net) to fix indentation. If possible, run it before opening the pull request. Otherwise, we shall run it afterward. + +## Please don't + +- The C++11 support varies between different **compilers** and versions. Please note the [list of supported compilers](https://github.com/nlohmann/json/blob/master/README.md#supported-compilers). Some compilers like GCC 4.7 (and earlier), Clang 3.3 (and earlier), or Microsoft Visual Studio 13.0 and earlier are known not to work due to missing or incomplete C++11 support. Please refrain from proposing changes that work around these compiler's limitations with `#ifdef`s or other means. +- Specifically, I am aware of compilation problems with **Microsoft Visual Studio** (there even is an [issue label](https://github.com/nlohmann/json/issues?utf8=✓&q=label%3A%22visual+studio%22+) for these kind of bugs). I understand that even in 2016, complete C++11 support isn't there yet. But please also understand that I do not want to drop features or uglify the code just to make Microsoft's sub-standard compiler happy. The past has shown that there are ways to express the functionality such that the code compiles with the most recent MSVC - unfortunately, this is not the main objective of the project. +- Please refrain from proposing changes that would **break [JSON](https://json.org) conformance**. If you propose a conformant extension of JSON to be supported by the library, please motivate this extension. + - We shall not extend the library to **support comments**. There is quite some [controversy](https://www.reddit.com/r/programming/comments/4v6chu/why_json_doesnt_support_comments_douglas_crockford/) around this topic, and there were quite some [issues](https://github.com/nlohmann/json/issues/376) on this. We believe that JSON is fine without comments. + - We do not preserve the **insertion order of object elements**. The [JSON standard](https://tools.ietf.org/html/rfc7159.html) defines objects as "an unordered collection of zero or more name/value pairs". To this end, this library does not preserve insertion order of name/value pairs. (In fact, keys will be traversed in alphabetical order as `std::map` with `std::less` is used by default.) Note this behavior conforms to the standard, and we shall not change it to any other order. If you do want to preserve the insertion order, you can specialize the object type with containers like [`tsl::ordered_map`](https://github.com/Tessil/ordered-map) or [`nlohmann::fifo_map`](https://github.com/nlohmann/fifo_map). + +- Please do not open pull requests that address **multiple issues**. + +## Wanted + +The following areas really need contribution: + +- Extending the **continuous integration** toward more exotic compilers such as Android NDK, Intel's Compiler, or the bleeding-edge versions Clang. +- Improving the efficiency of the **JSON parser**. The current parser is implemented as a naive recursive descent parser with hand coded string handling. More sophisticated approaches like LALR parsers would be really appreciated. That said, parser generators like Bison or ANTLR do not play nice with single-header files -- I really would like to keep the parser inside the `json.hpp` header, and I am not aware of approaches similar to [`re2c`](http://re2c.org) for parsing. +- Extending and updating existing **benchmarks** to include (the most recent version of) this library. Though efficiency is not everything, speed and memory consumption are very important characteristics for C++ developers, so having proper comparisons would be interesting. diff --git a/contrib/nlohmann_json/.github/FUNDING.yml b/contrib/nlohmann_json/.github/FUNDING.yml new file mode 100644 index 00000000000..a6c972e819c --- /dev/null +++ b/contrib/nlohmann_json/.github/FUNDING.yml @@ -0,0 +1,2 @@ +github: nlohmann +custom: http://paypal.me/nlohmann diff --git a/contrib/nlohmann_json/.github/ISSUE_TEMPLATE/Bug_report.md b/contrib/nlohmann_json/.github/ISSUE_TEMPLATE/Bug_report.md new file mode 100644 index 00000000000..6dfa7d2d89c --- /dev/null +++ b/contrib/nlohmann_json/.github/ISSUE_TEMPLATE/Bug_report.md @@ -0,0 +1,57 @@ +--- +name: Bug report +about: Create a report to help us improve +title: '' +labels: 'kind: bug' +assignees: '' + +--- + + + +#### What is the issue you have? + + + + +#### Please describe the steps to reproduce the issue. + + + + +1. +2. +3. + +#### Can you provide a small but working code example? + + + +#### What is the expected behavior? + + + +#### And what is the actual behavior instead? + + + +#### Which compiler and operating system are you using? + + + + +- Compiler: ___ +- Operating system: ___ + +#### Which version of the library did you use? + + + +- [ ] latest release version 3.9.1 +- [ ] other release - please state the version: ___ +- [ ] the `develop` branch + +#### If you experience a compilation error: can you [compile and run the unit tests](https://github.com/nlohmann/json#execute-unit-tests)? + +- [ ] yes +- [ ] no - please copy/paste the error message below diff --git a/contrib/nlohmann_json/.github/ISSUE_TEMPLATE/config.yml b/contrib/nlohmann_json/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 00000000000..0e966338422 --- /dev/null +++ b/contrib/nlohmann_json/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: Ask a question + url: https://github.com/nlohmann/json/discussions + about: Ask questions and discuss with other community members diff --git a/contrib/nlohmann_json/.github/PULL_REQUEST_TEMPLATE.md b/contrib/nlohmann_json/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 00000000000..5f303a6e0a2 --- /dev/null +++ b/contrib/nlohmann_json/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,19 @@ +[Describe your pull request here. Please read the text below the line, and make sure you follow the checklist.] + +* * * + +## Pull request checklist + +Read the [Contribution Guidelines](https://github.com/nlohmann/json/blob/develop/.github/CONTRIBUTING.md) for detailed information. + +- [ ] Changes are described in the pull request, or an [existing issue is referenced](https://github.com/nlohmann/json/issues). +- [ ] The test suite [compiles and runs](https://github.com/nlohmann/json/blob/develop/README.md#execute-unit-tests) without error. +- [ ] [Code coverage](https://coveralls.io/github/nlohmann/json) is 100%. Test cases can be added by editing the [test suite](https://github.com/nlohmann/json/tree/develop/test/src). +- [ ] The source code is amalgamated; that is, after making changes to the sources in the `include/nlohmann` directory, run `make amalgamate` to create the single-header file `single_include/nlohmann/json.hpp`. The whole process is described [here](https://github.com/nlohmann/json/blob/develop/.github/CONTRIBUTING.md#files-to-change). + +## Please don't + +- The C++11 support varies between different **compilers** and versions. Please note the [list of supported compilers](https://github.com/nlohmann/json/blob/master/README.md#supported-compilers). Some compilers like GCC 4.7 (and earlier), Clang 3.3 (and earlier), or Microsoft Visual Studio 13.0 and earlier are known not to work due to missing or incomplete C++11 support. Please refrain from proposing changes that work around these compiler's limitations with `#ifdef`s or other means. +- Specifically, I am aware of compilation problems with **Microsoft Visual Studio** (there even is an [issue label](https://github.com/nlohmann/json/issues?utf8=✓&q=label%3A%22visual+studio%22+) for these kind of bugs). I understand that even in 2016, complete C++11 support isn't there yet. But please also understand that I do not want to drop features or uglify the code just to make Microsoft's sub-standard compiler happy. The past has shown that there are ways to express the functionality such that the code compiles with the most recent MSVC - unfortunately, this is not the main objective of the project. +- Please refrain from proposing changes that would **break [JSON](https://json.org) conformance**. If you propose a conformant extension of JSON to be supported by the library, please motivate this extension. +- Please do not open pull requests that address **multiple issues**. diff --git a/contrib/nlohmann_json/.github/SECURITY.md b/contrib/nlohmann_json/.github/SECURITY.md new file mode 100644 index 00000000000..4d010ebda99 --- /dev/null +++ b/contrib/nlohmann_json/.github/SECURITY.md @@ -0,0 +1,5 @@ +# Security Policy + +## Reporting a Vulnerability + +Usually, all issues are tracked publicly on [GitHub](https://github.com/nlohmann/json/issues). If you want to make a private report (e.g., for a vulnerability or to attach an example that is not meant to be published), please send an email to . You can use [this key](https://keybase.io/nlohmann/pgp_keys.asc?fingerprint=797167ae41c0a6d9232e48457f3cea63ae251b69) for encryption. diff --git a/contrib/nlohmann_json/.github/config.yml b/contrib/nlohmann_json/.github/config.yml new file mode 100644 index 00000000000..7a8f41e6d65 --- /dev/null +++ b/contrib/nlohmann_json/.github/config.yml @@ -0,0 +1,19 @@ +# Configuration for sentiment-bot - https://github.com/behaviorbot/sentiment-bot + +# *Required* toxicity threshold between 0 and .99 with the higher numbers being the most toxic +# Anything higher than this threshold will be marked as toxic and commented on +sentimentBotToxicityThreshold: .7 + +# *Required* Comment to reply with +sentimentBotReplyComment: > + Please be sure to review the [code of conduct](https://github.com/nlohmann/json/blob/develop/CODE_OF_CONDUCT.md) and be respectful of other users. cc/ @nlohmann + + +# Configuration for request-info - https://github.com/behaviorbot/request-info + +# *Required* Comment to reply with +requestInfoReplyComment: > + We would appreciate it if you could provide us with more info about this issue or pull request! Please check the [issue template](https://github.com/nlohmann/json/blob/develop/.github/ISSUE_TEMPLATE.md) and the [pull request template](https://github.com/nlohmann/json/blob/develop/.github/PULL_REQUEST_TEMPLATE.md). + +# *OPTIONAL* Label to be added to Issues and Pull Requests with insufficient information given +requestInfoLabelToAdd: "state: needs more info" diff --git a/contrib/nlohmann_json/.github/stale.yml b/contrib/nlohmann_json/.github/stale.yml new file mode 100644 index 00000000000..d30c78be773 --- /dev/null +++ b/contrib/nlohmann_json/.github/stale.yml @@ -0,0 +1,17 @@ +# Number of days of inactivity before an issue becomes stale +daysUntilStale: 30 +# Number of days of inactivity before a stale issue is closed +daysUntilClose: 7 +# Issues with these labels will never be considered stale +exemptLabels: + - pinned + - security +# Label to use when marking an issue as stale +staleLabel: "state: stale" +# Comment to post when marking an issue as stale. Set to `false` to disable +markComment: > + This issue has been automatically marked as stale because it has not had + recent activity. It will be closed if no further activity occurs. Thank you + for your contributions. +# Comment to post when closing a stale issue. Set to `false` to disable +closeComment: false diff --git a/contrib/nlohmann_json/.github/workflows/codeql-analysis.yml b/contrib/nlohmann_json/.github/workflows/codeql-analysis.yml new file mode 100644 index 00000000000..5ee44a04e66 --- /dev/null +++ b/contrib/nlohmann_json/.github/workflows/codeql-analysis.yml @@ -0,0 +1,54 @@ +name: "Code scanning - action" + +on: + push: + branches: [develop, ] + pull_request: + # The branches below must be a subset of the branches above + branches: [develop] + schedule: + - cron: '0 19 * * 1' + +jobs: + CodeQL-Build: + + runs-on: ubuntu-latest + + steps: + - name: Checkout repository + uses: actions/checkout@v2 + with: + # We must fetch at least the immediate parents so that if this is + # a pull request then we can checkout the head. + fetch-depth: 2 + + # If this run was triggered by a pull request event, then checkout + # the head of the pull request instead of the merge commit. + - run: git checkout HEAD^2 + if: ${{ github.event_name == 'pull_request' }} + + # Initializes the CodeQL tools for scanning. + - name: Initialize CodeQL + uses: github/codeql-action/init@v1 + # Override language selection by uncommenting this and choosing your languages + # with: + # languages: go, javascript, csharp, python, cpp, java + + # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). + # If this step fails, then you should remove it and run the build manually (see below) + - name: Autobuild + uses: github/codeql-action/autobuild@v1 + + # ℹ️ Command-line programs to run using the OS shell. + # 📚 https://git.io/JvXDl + + # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines + # and modify them (or add more) to build your code if your project + # uses a compiled language + + #- run: | + # make bootstrap + # make release + + - name: Perform CodeQL Analysis + uses: github/codeql-action/analyze@v1 diff --git a/contrib/nlohmann_json/.github/workflows/macos.yml b/contrib/nlohmann_json/.github/workflows/macos.yml new file mode 100644 index 00000000000..5b178ad055f --- /dev/null +++ b/contrib/nlohmann_json/.github/workflows/macos.yml @@ -0,0 +1,17 @@ +name: macOS + +on: [push, pull_request] + +jobs: + build: + + runs-on: macos-latest + + steps: + - uses: actions/checkout@v1 + - name: cmake + run: cmake -S . -B build -D CMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On + - name: build + run: cmake --build build --parallel 10 + - name: test + run: cd build ; ctest -j 10 --output-on-failure diff --git a/contrib/nlohmann_json/.github/workflows/ubuntu.yml b/contrib/nlohmann_json/.github/workflows/ubuntu.yml new file mode 100644 index 00000000000..2eefc1c35b2 --- /dev/null +++ b/contrib/nlohmann_json/.github/workflows/ubuntu.yml @@ -0,0 +1,17 @@ +name: Ubuntu + +on: [push, pull_request] + +jobs: + build: + + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v1 + - name: cmake + run: cmake -S . -B build -D CMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On + - name: build + run: cmake --build build --parallel 10 + - name: test + run: cd build ; ctest -j 10 --output-on-failure diff --git a/contrib/nlohmann_json/.github/workflows/windows.yml b/contrib/nlohmann_json/.github/workflows/windows.yml new file mode 100644 index 00000000000..5846cf7500e --- /dev/null +++ b/contrib/nlohmann_json/.github/workflows/windows.yml @@ -0,0 +1,68 @@ +name: Windows + +on: [push, pull_request] + +jobs: + msvc2019: + runs-on: windows-latest + + steps: + - uses: actions/checkout@v1 + - name: cmake + run: cmake -S . -B build -G "Visual Studio 16 2019" -D CMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On + - name: build + run: cmake --build build --parallel 10 + - name: test + run: cd build ; ctest -j 10 -C Debug --exclude-regex "test-unicode" --output-on-failure + + clang9: + runs-on: windows-latest + + steps: + - uses: actions/checkout@v1 + - name: install Clang + run: curl -fsSL -o LLVM9.exe https://releases.llvm.org/9.0.0/LLVM-9.0.0-win64.exe ; 7z x LLVM9.exe -y -o"C:/Program Files/LLVM" + - name: cmake + run: cmake -S . -B build -DCMAKE_CXX_COMPILER="C:/Program Files/LLVM/bin/clang++.exe" -G"MinGW Makefiles" -DCMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On + - name: build + run: cmake --build build --parallel 10 + - name: test + run: cd build ; ctest -j 10 -C Debug --exclude-regex "test-unicode" --output-on-failure + + clang10: + runs-on: windows-latest + + steps: + - uses: actions/checkout@v1 + - name: install Clang + run: curl -fsSL -o LLVM10.exe https://github.com/llvm/llvm-project/releases/download/llvmorg-10.0.0/LLVM-10.0.0-win64.exe ; 7z x LLVM10.exe -y -o"C:/Program Files/LLVM" + - name: cmake + run: cmake -S . -B build -DCMAKE_CXX_COMPILER="C:/Program Files/LLVM/bin/clang++.exe" -G"MinGW Makefiles" -DCMAKE_BUILD_TYPE=Debug -DJSON_BuildTests=On + - name: build + run: cmake --build build --parallel 10 + - name: test + run: cd build ; ctest -j 10 -C Debug --exclude-regex "test-unicode" --output-on-failure + + clang-cl-10-x64: + runs-on: windows-latest + + steps: + - uses: actions/checkout@v1 + - name: cmake + run: cmake -S . -B build -G "Visual Studio 16 2019" -A x64 -T ClangCL -DJSON_BuildTests=On + - name: build + run: cmake --build build --config Debug --parallel 10 + - name: test + run: cd build ; ctest -j 10 -C Debug --exclude-regex "test-unicode" --output-on-failure + + clang-cl-10-x86: + runs-on: windows-latest + + steps: + - uses: actions/checkout@v1 + - name: cmake + run: cmake -S . -B build -G "Visual Studio 16 2019" -A Win32 -T ClangCL -DJSON_BuildTests=On + - name: build + run: cmake --build build --config Debug --parallel 10 + - name: test + run: cd build ; ctest -j 10 -C Debug --exclude-regex "test-unicode" --output-on-failure diff --git a/contrib/nlohmann_json/.gitignore b/contrib/nlohmann_json/.gitignore new file mode 100644 index 00000000000..7e5a881e33e --- /dev/null +++ b/contrib/nlohmann_json/.gitignore @@ -0,0 +1,35 @@ +json_unit +json_benchmarks +json_benchmarks_simple +fuzz-testing + +*.dSYM +*.o +*.gcno +*.gcda + +build +build_coverage +clang_analyze_build + +doc/xml +doc/html +me.nlohmann.json.docset + +benchmarks/files/numbers/*.json + +.wsjcpp-logs/* +.wsjcpp/* + +.idea +/cmake-build-* + +test/test-* +/.vs + +doc/mkdocs/venv/ +doc/mkdocs/docs/images +doc/mkdocs/docs/examples +doc/mkdocs/site +doc/mkdocs/docs/__pycache__/ +doc/xml diff --git a/contrib/nlohmann_json/.travis.yml b/contrib/nlohmann_json/.travis.yml new file mode 100644 index 00000000000..bf749c1e338 --- /dev/null +++ b/contrib/nlohmann_json/.travis.yml @@ -0,0 +1,348 @@ +######################### +# project configuration # +######################### + +# C++ project +language: cpp + +dist: trusty +sudo: required +group: edge + + +################ +# build matrix # +################ + +matrix: + include: + + # Valgrind + - os: linux + compiler: gcc + env: + - COMPILER=g++-4.9 + - CMAKE_OPTIONS=-DJSON_Valgrind=ON + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-4.9', 'valgrind', 'ninja-build'] + + # clang sanitizer + - os: linux + compiler: clang + env: + - COMPILER=clang++-7 + - CMAKE_OPTIONS=-DJSON_Sanitizer=ON + - UBSAN_OPTIONS=print_stacktrace=1,suppressions=$(pwd)/test/src/UBSAN.supp + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-trusty-7'] + packages: ['g++-6', 'clang-7', 'ninja-build'] + before_script: + - export PATH=$PATH:/usr/lib/llvm-7/bin + + # cppcheck + - os: linux + compiler: gcc + env: + - COMPILER=g++-4.9 + - SPECIAL=cppcheck + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-4.9', 'cppcheck', 'ninja-build'] + after_success: + - make cppcheck + + # no exceptions + - os: linux + compiler: gcc + env: + - COMPILER=g++-4.9 + - CMAKE_OPTIONS=-DJSON_NoExceptions=ON + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-4.9', 'ninja-build'] + + # check amalgamation + - os: linux + compiler: gcc + env: + - COMPILER=g++-4.9 + - SPECIAL=amalgamation + - MULTIPLE_HEADERS=ON + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-4.9', 'astyle', 'ninja-build'] + after_success: + - make check-amalgamation + + # Coveralls (http://gronlier.fr/blog/2015/01/adding-code-coverage-to-your-c-project/) + + - os: linux + compiler: gcc + dist: bionic + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-7', 'ninja-build'] + before_script: + - pip install --user cpp-coveralls + after_success: + - coveralls --build-root test --include include/nlohmann --gcov 'gcov-7' --gcov-options '\-lp' + env: + - COMPILER=g++-7 + - CMAKE_OPTIONS=-DJSON_Coverage=ON + - MULTIPLE_HEADERS=ON + + # Coverity (only for branch coverity_scan) + + - os: linux + compiler: clang + before_install: echo -n | openssl s_client -connect scan.coverity.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' | sudo tee -a /etc/ssl/certs/ca-certificates.crt + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-precise-3.6'] + packages: ['g++-6', 'clang-3.6', 'ninja-build'] + coverity_scan: + project: + name: "nlohmann/json" + description: "Build submitted via Travis CI" + notification_email: niels.lohmann@gmail.com + build_command_prepend: "mkdir coverity_build ; cd coverity_build ; cmake .. ; cd .." + build_command: "make -C coverity_build" + branch_pattern: coverity_scan + env: + - SPECIAL=coverity + - COMPILER=clang++-3.6 + # The next declaration is the encrypted COVERITY_SCAN_TOKEN, created + # via the "travis encrypt" command using the project repo's public key + - secure: "m89SSgE+ASLO38rSKx7MTXK3n5NkP9bIx95jwY71YEiuFzib30PDJ/DifKnXxBjvy/AkCGztErQRk/8ZCvq+4HXozU2knEGnL/RUitvlwbhzfh2D4lmS3BvWBGS3N3NewoPBrRmdcvnT0xjOGXxtZaJ3P74TkB9GBnlz/HmKORA=" + + # OSX / Clang + + - os: osx + osx_image: xcode9.3 + + - os: osx + osx_image: xcode9.4 + + - os: osx + osx_image: xcode10 + + - os: osx + osx_image: xcode10.1 + + - os: osx + osx_image: xcode10.2 + + - os: osx + osx_image: xcode11.2 + + - os: osx + osx_image: xcode12 + + - os: osx + osx_image: xcode12 + env: + - IMPLICIT_CONVERSIONS=OFF + + # Linux / GCC + + - os: linux + compiler: gcc + env: COMPILER=g++-4.8 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-4.8', 'ninja-build'] + + - os: linux + compiler: gcc + env: COMPILER=g++-4.9 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-4.9', 'ninja-build'] + + - os: linux + compiler: gcc + env: COMPILER=g++-5 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-5', 'ninja-build'] + + - os: linux + compiler: gcc + env: COMPILER=g++-6 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-6', 'ninja-build'] + + - os: linux + compiler: gcc + env: COMPILER=g++-7 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-7', 'ninja-build'] + + - os: linux + compiler: gcc + env: COMPILER=g++-8 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-8', 'ninja-build'] + + - os: linux + compiler: gcc + env: COMPILER=g++-9 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-9', 'ninja-build'] + + - os: linux + compiler: gcc + env: + - COMPILER=g++-9 + - IMPLICIT_CONVERSIONS=OFF + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-9', 'ninja-build'] + + - os: linux + compiler: gcc + env: + - COMPILER=g++-9 + - CXXFLAGS=-std=c++2a + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-9', 'ninja-build'] + + # Linux / Clang + + - os: linux + compiler: clang + env: COMPILER=clang++-3.5 + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-precise-3.5'] + packages: ['g++-6', 'clang-3.5', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-3.6 + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-precise-3.6'] + packages: ['g++-6', 'clang-3.6', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-3.7 + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-precise-3.7'] + packages: ['g++-6', 'clang-3.7', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-3.8 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-6', 'clang-3.8', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-3.9 + addons: + apt: + sources: ['ubuntu-toolchain-r-test'] + packages: ['g++-6', 'clang-3.9', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-4.0 + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-trusty-4.0'] + packages: ['g++-6', 'clang-4.0', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-5.0 + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-trusty-5.0'] + packages: ['g++-6', 'clang-5.0', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-6.0 + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-trusty-6.0'] + packages: ['g++-6', 'clang-6.0', 'ninja-build'] + + - os: linux + compiler: clang + env: COMPILER=clang++-7 + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-trusty-7'] + packages: ['g++-6', 'clang-7', 'ninja-build'] + + - os: linux + compiler: clang + env: + - COMPILER=clang++-7 + - CXXFLAGS=-std=c++1z + addons: + apt: + sources: ['ubuntu-toolchain-r-test', 'llvm-toolchain-trusty-7'] + packages: ['g++-6', 'clang-7', 'ninja-build'] + +################ +# build script # +################ + +script: + # get CMake and Ninja (only for systems with brew - macOS) + - | + if [[ (-x $(which brew)) ]]; then + brew update + brew install cmake ninja + brew upgrade cmake + cmake --version + fi + + # make sure CXX is correctly set + - if [[ "${COMPILER}" != "" ]]; then export CXX=${COMPILER}; fi + # by default, use the single-header version + - if [[ "${MULTIPLE_HEADERS}" == "" ]]; then export MULTIPLE_HEADERS=OFF; fi + # by default, use implicit conversions + - if [[ "${IMPLICIT_CONVERSIONS}" == "" ]]; then export IMPLICIT_CONVERSIONS=ON; fi + + # compile and execute unit tests + - mkdir -p build && cd build + - cmake .. ${CMAKE_OPTIONS} -DJSON_MultipleHeaders=${MULTIPLE_HEADERS} -DJSON_ImplicitConversions=${IMPLICIT_CONVERSIONS} -DJSON_BuildTests=On -GNinja && cmake --build . --config Release + - ctest -C Release --timeout 2700 -V -j + - cd .. + + # check if homebrew works (only checks develop branch) + - if [ `which brew` ]; then + brew update ; + brew tap nlohmann/json ; + brew install nlohmann_json --HEAD ; + brew test nlohmann_json ; + fi diff --git a/contrib/nlohmann_json/CMakeLists.txt b/contrib/nlohmann_json/CMakeLists.txt new file mode 100644 index 00000000000..fa77a5aed2a --- /dev/null +++ b/contrib/nlohmann_json/CMakeLists.txt @@ -0,0 +1,164 @@ +cmake_minimum_required(VERSION 3.1) + +## +## PROJECT +## name and version +## +project(nlohmann_json VERSION 3.9.1 LANGUAGES CXX) + +## +## INCLUDE +## +## +include(ExternalProject) + +## +## OPTIONS +## + +if (POLICY CMP0077) + # Allow CMake 3.13+ to override options when using FetchContent / add_subdirectory. + cmake_policy(SET CMP0077 NEW) +endif () + +option(JSON_BuildTests "Build the unit tests when BUILD_TESTING is enabled." ON) +option(JSON_Install "Install CMake targets during install step." ON) +option(JSON_MultipleHeaders "Use non-amalgamated version of the library." OFF) +option(JSON_ImplicitConversions "Enable implicit conversions." ON) + +## +## CONFIGURATION +## +include(GNUInstallDirs) + +set(NLOHMANN_JSON_TARGET_NAME ${PROJECT_NAME}) +set(NLOHMANN_JSON_CONFIG_INSTALL_DIR "${CMAKE_INSTALL_LIBDIR}/cmake/${PROJECT_NAME}" CACHE INTERNAL "") +set(NLOHMANN_JSON_INCLUDE_INSTALL_DIR "${CMAKE_INSTALL_INCLUDEDIR}") +set(NLOHMANN_JSON_TARGETS_EXPORT_NAME "${PROJECT_NAME}Targets") +set(NLOHMANN_JSON_CMAKE_CONFIG_TEMPLATE "cmake/config.cmake.in") +set(NLOHMANN_JSON_CMAKE_CONFIG_DIR "${CMAKE_CURRENT_BINARY_DIR}") +set(NLOHMANN_JSON_CMAKE_VERSION_CONFIG_FILE "${NLOHMANN_JSON_CMAKE_CONFIG_DIR}/${PROJECT_NAME}ConfigVersion.cmake") +set(NLOHMANN_JSON_CMAKE_PROJECT_CONFIG_FILE "${NLOHMANN_JSON_CMAKE_CONFIG_DIR}/${PROJECT_NAME}Config.cmake") +set(NLOHMANN_JSON_CMAKE_PROJECT_TARGETS_FILE "${NLOHMANN_JSON_CMAKE_CONFIG_DIR}/${PROJECT_NAME}Targets.cmake") +set(NLOHMANN_JSON_PKGCONFIG_INSTALL_DIR "${CMAKE_INSTALL_LIBDIR}/pkgconfig") + +if (JSON_MultipleHeaders) + set(NLOHMANN_JSON_INCLUDE_BUILD_DIR "${PROJECT_SOURCE_DIR}/include/") + message(STATUS "Using the multi-header code from ${NLOHMANN_JSON_INCLUDE_BUILD_DIR}") +else() + set(NLOHMANN_JSON_INCLUDE_BUILD_DIR "${PROJECT_SOURCE_DIR}/single_include/") + message(STATUS "Using the single-header code from ${NLOHMANN_JSON_INCLUDE_BUILD_DIR}") +endif() + +if (NOT JSON_ImplicitConversions) + message(STATUS "Implicit conversions are disabled") +endif() + +## +## TARGET +## create target and add include path +## +add_library(${NLOHMANN_JSON_TARGET_NAME} INTERFACE) +add_library(${PROJECT_NAME}::${NLOHMANN_JSON_TARGET_NAME} ALIAS ${NLOHMANN_JSON_TARGET_NAME}) +if (${CMAKE_VERSION} VERSION_LESS "3.8.0") + target_compile_features(${NLOHMANN_JSON_TARGET_NAME} INTERFACE cxx_range_for) +else() + target_compile_features(${NLOHMANN_JSON_TARGET_NAME} INTERFACE cxx_std_11) +endif() + +target_compile_definitions( + ${NLOHMANN_JSON_TARGET_NAME} + INTERFACE + JSON_USE_IMPLICIT_CONVERSIONS=$ +) + +target_include_directories( + ${NLOHMANN_JSON_TARGET_NAME} + INTERFACE + $ + $ +) + +## add debug view definition file for msvc (natvis) +if (MSVC) + set(NLOHMANN_ADD_NATVIS TRUE) + set(NLOHMANN_NATVIS_FILE "nlohmann_json.natvis") + target_sources( + ${NLOHMANN_JSON_TARGET_NAME} + INTERFACE + $ + $ + ) +endif() + +# Install a pkg-config file, so other tools can find this. +CONFIGURE_FILE( + "${CMAKE_CURRENT_SOURCE_DIR}/cmake/pkg-config.pc.in" + "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}.pc" +) + +## +## TESTS +## create and configure the unit test target +## +include(CTest) #adds option BUILD_TESTING (default ON) + +if(BUILD_TESTING AND JSON_BuildTests) + enable_testing() + add_subdirectory(test) +endif() + +## +## INSTALL +## install header files, generate and install cmake config files for find_package() +## +include(CMakePackageConfigHelpers) +# use a custom package version config file instead of +# write_basic_package_version_file to ensure that it's architecture-independent +# https://github.com/nlohmann/json/issues/1697 +configure_file( + "cmake/nlohmann_jsonConfigVersion.cmake.in" + ${NLOHMANN_JSON_CMAKE_VERSION_CONFIG_FILE} + @ONLY +) +configure_file( + ${NLOHMANN_JSON_CMAKE_CONFIG_TEMPLATE} + ${NLOHMANN_JSON_CMAKE_PROJECT_CONFIG_FILE} + @ONLY +) + +if(JSON_Install) + install( + DIRECTORY ${NLOHMANN_JSON_INCLUDE_BUILD_DIR} + DESTINATION ${NLOHMANN_JSON_INCLUDE_INSTALL_DIR} + ) + install( + FILES ${NLOHMANN_JSON_CMAKE_PROJECT_CONFIG_FILE} ${NLOHMANN_JSON_CMAKE_VERSION_CONFIG_FILE} + DESTINATION ${NLOHMANN_JSON_CONFIG_INSTALL_DIR} + ) + if (NLOHMANN_ADD_NATVIS) + install( + FILES ${NLOHMANN_NATVIS_FILE} + DESTINATION . + ) +endif() + export( + TARGETS ${NLOHMANN_JSON_TARGET_NAME} + NAMESPACE ${PROJECT_NAME}:: + FILE ${NLOHMANN_JSON_CMAKE_PROJECT_TARGETS_FILE} + ) + install( + TARGETS ${NLOHMANN_JSON_TARGET_NAME} + EXPORT ${NLOHMANN_JSON_TARGETS_EXPORT_NAME} + INCLUDES DESTINATION ${NLOHMANN_JSON_INCLUDE_INSTALL_DIR} + ) + install( + EXPORT ${NLOHMANN_JSON_TARGETS_EXPORT_NAME} + NAMESPACE ${PROJECT_NAME}:: + DESTINATION ${NLOHMANN_JSON_CONFIG_INSTALL_DIR} + ) + install( + FILES "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}.pc" + DESTINATION ${NLOHMANN_JSON_PKGCONFIG_INSTALL_DIR} + ) +endif() diff --git a/contrib/nlohmann_json/CODE_OF_CONDUCT.md b/contrib/nlohmann_json/CODE_OF_CONDUCT.md new file mode 100644 index 00000000000..770b8173e1d --- /dev/null +++ b/contrib/nlohmann_json/CODE_OF_CONDUCT.md @@ -0,0 +1,46 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. + +## Our Standards + +Examples of behavior that contributes to creating a positive environment include: + +* Using welcoming and inclusive language +* Being respectful of differing viewpoints and experiences +* Gracefully accepting constructive criticism +* Focusing on what is best for the community +* Showing empathy towards other community members + +Examples of unacceptable behavior by participants include: + +* The use of sexualized language or imagery and unwelcome sexual attention or advances +* Trolling, insulting/derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or electronic address, without explicit permission +* Other conduct which could reasonably be considered inappropriate in a professional setting + +## Our Responsibilities + +Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. + +Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. + +## Scope + +This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at mail@nlohmann.me. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. + +Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] + +[homepage]: http://contributor-covenant.org +[version]: http://contributor-covenant.org/version/1/4/ diff --git a/contrib/nlohmann_json/ChangeLog.md b/contrib/nlohmann_json/ChangeLog.md new file mode 100644 index 00000000000..e4cec7c5ae0 --- /dev/null +++ b/contrib/nlohmann_json/ChangeLog.md @@ -0,0 +1,2297 @@ +# Changelog +All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org/). + +## [v3.9.1](https://github.com/nlohmann/json/releases/tag/v3.9.1) (2020-08-06) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.9.0...v3.9.1) + +- Can't parse not formatted JSON. [\#2340](https://github.com/nlohmann/json/issues/2340) +- parse returns desired array contained in array when JSON text begins with square bracket on gcc 7.5.0 [\#2339](https://github.com/nlohmann/json/issues/2339) +- Unexpected deserialization difference between Mac and Linux [\#2338](https://github.com/nlohmann/json/issues/2338) +- Reading ordered\_json from file causes compile error [\#2331](https://github.com/nlohmann/json/issues/2331) +- ignore\_comment=true fails on multiple consecutive lines starting with comments [\#2330](https://github.com/nlohmann/json/issues/2330) +- Update documentation about Homebrew installation and CMake integration - Homebrew [\#2326](https://github.com/nlohmann/json/issues/2326) +- Chinese character initialize error [\#2325](https://github.com/nlohmann/json/issues/2325) +- json.update and vector\does not work with ordered\_json [\#2315](https://github.com/nlohmann/json/issues/2315) +- Ambiguous call to overloaded function [\#2210](https://github.com/nlohmann/json/issues/2210) + +- Fix fallthrough warning [\#2333](https://github.com/nlohmann/json/pull/2333) ([nlohmann](https://github.com/nlohmann)) +- Fix lexer to properly cope with repeated comments [\#2332](https://github.com/nlohmann/json/pull/2332) ([nlohmann](https://github.com/nlohmann)) +- Fix name of Homebrew formula in documentation [\#2327](https://github.com/nlohmann/json/pull/2327) ([nlohmann](https://github.com/nlohmann)) +- fix typo [\#2320](https://github.com/nlohmann/json/pull/2320) ([wx257osn2](https://github.com/wx257osn2)) +- Fix a bug due to missing overloads in ordered\_map container [\#2319](https://github.com/nlohmann/json/pull/2319) ([nlohmann](https://github.com/nlohmann)) +- cmake: install pkg-config file relative to current\_binary\_dir [\#2318](https://github.com/nlohmann/json/pull/2318) ([eli-schwartz](https://github.com/eli-schwartz)) +- Fixed installation of pkg-config file on other than Ubuntu [\#2314](https://github.com/nlohmann/json/pull/2314) ([xvitaly](https://github.com/xvitaly)) +- Cleanup [\#2303](https://github.com/nlohmann/json/pull/2303) ([nlohmann](https://github.com/nlohmann)) + +## [v3.9.0](https://github.com/nlohmann/json/releases/tag/v3.9.0) (2020-07-27) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.8.0...v3.9.0) + +- Unknown Type Name clang error when using NLOHMANN\_DEFINE\_TYPE\_NON\_INTRUSIVE [\#2313](https://github.com/nlohmann/json/issues/2313) +- Clang 10.0 / GCC 10.1 warnings on disabled exceptions [\#2304](https://github.com/nlohmann/json/issues/2304) +- Application stalls indefinitely with message byte size 10 [\#2293](https://github.com/nlohmann/json/issues/2293) +- linker error [\#2292](https://github.com/nlohmann/json/issues/2292) +- Add support for high-precision numbers in UBJSON encoding [\#2286](https://github.com/nlohmann/json/issues/2286) +- NLOHMANN\_DEFINE\_TYPE\_NON\_INTRUSIVE fails if the length of the argument is 10 [\#2280](https://github.com/nlohmann/json/issues/2280) +- Custom types : MACRO expansion bug [\#2267](https://github.com/nlohmann/json/issues/2267) +- to/from\_json Failing To Convert String [\#2238](https://github.com/nlohmann/json/issues/2238) +- clang 9.0 report warning: unused type alias 'size\_type' \[-Wunused-local-typedef\] [\#2221](https://github.com/nlohmann/json/issues/2221) +- Enormous array created when working with map\ [\#2220](https://github.com/nlohmann/json/issues/2220) +- Can I disable sorting of json values [\#2219](https://github.com/nlohmann/json/issues/2219) +- Getting Qt types to work [\#2217](https://github.com/nlohmann/json/issues/2217) +- Convert to Qt QVariant [\#2216](https://github.com/nlohmann/json/issues/2216) +- How to custom serialize same data type of vector? [\#2215](https://github.com/nlohmann/json/issues/2215) +- json constructor does not support std::optional [\#2214](https://github.com/nlohmann/json/issues/2214) +- Failing to Parse Valid JSON [\#2209](https://github.com/nlohmann/json/issues/2209) +- \(De-\)Serialization of std::variant with namespaces [\#2208](https://github.com/nlohmann/json/issues/2208) +- Addint support for complex type [\#2207](https://github.com/nlohmann/json/issues/2207) +- array\_index possible out of range [\#2205](https://github.com/nlohmann/json/issues/2205) +- Object deserialized as array [\#2204](https://github.com/nlohmann/json/issues/2204) +- Sending to a function a reference to a sub-branch [\#2200](https://github.com/nlohmann/json/issues/2200) +- How to Serialize derived class to JSON object? [\#2199](https://github.com/nlohmann/json/issues/2199) +- JSON incorrectly serialized [\#2198](https://github.com/nlohmann/json/issues/2198) +- Exception Unhandled out\_of\_range error [\#2197](https://github.com/nlohmann/json/issues/2197) +- msgpack serialisation : float is treated as 64bit float, not 32bit float. [\#2196](https://github.com/nlohmann/json/issues/2196) +- Is it possible to use compile-time type guarantees for JSON structures? [\#2195](https://github.com/nlohmann/json/issues/2195) +- Question : performance against python dict [\#2194](https://github.com/nlohmann/json/issues/2194) +- vs2017 compile error [\#2192](https://github.com/nlohmann/json/issues/2192) +- Check if a key exists [\#2191](https://github.com/nlohmann/json/issues/2191) +- Failed to run tests due to missing test data on builders without Internet access [\#2190](https://github.com/nlohmann/json/issues/2190) +- 3.8.0: unit-cbor.cpp test failures [\#2189](https://github.com/nlohmann/json/issues/2189) +- 'nlohmann/json.hpp' file not found [\#2188](https://github.com/nlohmann/json/issues/2188) +- How to send json data over the wire? [\#2185](https://github.com/nlohmann/json/issues/2185) +- Ubuntu 16 not supporting nlohmann/json? [\#2184](https://github.com/nlohmann/json/issues/2184) +- .get\ causing emdash errors [\#2180](https://github.com/nlohmann/json/issues/2180) +- Object properties should not be re-sorted alphabetically [\#2179](https://github.com/nlohmann/json/issues/2179) +- Custom type registration : instrusive API [\#2175](https://github.com/nlohmann/json/issues/2175) +- Many version of the function "void to\_json\(json& j, const MyStruct& struct\)" [\#2171](https://github.com/nlohmann/json/issues/2171) +- How should strings be escaped? [\#2155](https://github.com/nlohmann/json/issues/2155) +- Adding a value to an existing json puts it at the beginning instead of the end [\#2149](https://github.com/nlohmann/json/issues/2149) +- The header file is big, can we use what we need. [\#2134](https://github.com/nlohmann/json/issues/2134) +- Changing the default format for unordered\_map \(or other set\) [\#2132](https://github.com/nlohmann/json/issues/2132) +- Getting size of deserialized bson document [\#2131](https://github.com/nlohmann/json/issues/2131) +- implicit conversion failure [\#2128](https://github.com/nlohmann/json/issues/2128) +- Error thrown when parsing in a subclass [\#2124](https://github.com/nlohmann/json/issues/2124) +- explicit conversion to string not considered for std::map keys in GCC8 [\#2096](https://github.com/nlohmann/json/issues/2096) +- Add support for JSONC [\#2061](https://github.com/nlohmann/json/issues/2061) +- Library provides template arg for string\_type but assumes std::string in some places [\#2059](https://github.com/nlohmann/json/issues/2059) +- incremental parsing with sax\_parser [\#2030](https://github.com/nlohmann/json/issues/2030) +- Question about flatten and unflatten [\#1989](https://github.com/nlohmann/json/issues/1989) +- CBOR parser doesn't skip tags [\#1968](https://github.com/nlohmann/json/issues/1968) +- Compilation failure using Clang on Windows [\#1898](https://github.com/nlohmann/json/issues/1898) +- Fail to build when including json.hpp as a system include [\#1818](https://github.com/nlohmann/json/issues/1818) +- Parsing string into json doesn't preserve the order correctly. [\#1817](https://github.com/nlohmann/json/issues/1817) +- \[C++17\] Allow std::optional to convert to nlohmann::json [\#1749](https://github.com/nlohmann/json/issues/1749) +- How can I save json object in file in order? [\#1717](https://github.com/nlohmann/json/issues/1717) +- Support for Comments [\#1513](https://github.com/nlohmann/json/issues/1513) +- clang compiler: error : unknown type name 'not' [\#1119](https://github.com/nlohmann/json/issues/1119) +- dump\(\) without alphabetical order [\#1106](https://github.com/nlohmann/json/issues/1106) +- operator T\(\) considered harmful [\#958](https://github.com/nlohmann/json/issues/958) +- Order of the elements in JSON object [\#952](https://github.com/nlohmann/json/issues/952) +- How to prevent alphabetical sorting of data? [\#727](https://github.com/nlohmann/json/issues/727) +- Why is an object ordering values by Alphabetical Order? [\#660](https://github.com/nlohmann/json/issues/660) +- Feature request: Comments [\#597](https://github.com/nlohmann/json/issues/597) +- Head Elements Sorting [\#543](https://github.com/nlohmann/json/issues/543) +- Automatic ordered JSON [\#424](https://github.com/nlohmann/json/issues/424) +- Support for comments. [\#376](https://github.com/nlohmann/json/issues/376) +- Optional comment support. [\#363](https://github.com/nlohmann/json/issues/363) +- Strip comments / Minify [\#294](https://github.com/nlohmann/json/issues/294) +- maintaining order of keys during iteration [\#106](https://github.com/nlohmann/json/issues/106) + +- Update documentation [\#2312](https://github.com/nlohmann/json/pull/2312) ([nlohmann](https://github.com/nlohmann)) +- Fix bug in CBOR tag handling [\#2308](https://github.com/nlohmann/json/pull/2308) ([nlohmann](https://github.com/nlohmann)) +- added inline to NLOHMANN\_DEFINE\_TYPE\_NON\_INTRUSIVE macro [\#2306](https://github.com/nlohmann/json/pull/2306) ([jwittbrodt](https://github.com/jwittbrodt)) +- fixes unused variable 'ex' for \#2304 [\#2305](https://github.com/nlohmann/json/pull/2305) ([AODQ](https://github.com/AODQ)) +- Add test with multiple translation units [\#2301](https://github.com/nlohmann/json/pull/2301) ([nlohmann](https://github.com/nlohmann)) +- Merge GitHub actions [\#2300](https://github.com/nlohmann/json/pull/2300) ([nlohmann](https://github.com/nlohmann)) +- Fix unused parameter [\#2299](https://github.com/nlohmann/json/pull/2299) ([nlohmann](https://github.com/nlohmann)) +- Add support for high-precision numbers in UBJSON encoding [\#2297](https://github.com/nlohmann/json/pull/2297) ([nlohmann](https://github.com/nlohmann)) +- fix eof for get\_binary and get\_string [\#2294](https://github.com/nlohmann/json/pull/2294) ([jprochazk](https://github.com/jprochazk)) +- Serialisation macros: increase upper bound on number of member variables [\#2287](https://github.com/nlohmann/json/pull/2287) ([pfeatherstone](https://github.com/pfeatherstone)) +- add inline specifier for detail::combine [\#2285](https://github.com/nlohmann/json/pull/2285) ([T0b1-iOS](https://github.com/T0b1-iOS)) +- Add static assertion for missing binary function in SAX interface [\#2282](https://github.com/nlohmann/json/pull/2282) ([nlohmann](https://github.com/nlohmann)) +- Add test for target\_include\_directories [\#2279](https://github.com/nlohmann/json/pull/2279) ([nlohmann](https://github.com/nlohmann)) +- Clean up maintainer Makefiles and fix some linter warnings [\#2274](https://github.com/nlohmann/json/pull/2274) ([nlohmann](https://github.com/nlohmann)) +- Add option to ignore CBOR tags [\#2273](https://github.com/nlohmann/json/pull/2273) ([nlohmann](https://github.com/nlohmann)) +- Hash function without allocation [\#2269](https://github.com/nlohmann/json/pull/2269) ([nlohmann](https://github.com/nlohmann)) +- Add ClangCL for MSVC [\#2268](https://github.com/nlohmann/json/pull/2268) ([t-b](https://github.com/t-b)) +- Makefile: Always use SED variable [\#2264](https://github.com/nlohmann/json/pull/2264) ([t-b](https://github.com/t-b)) +- Add Xcode 12 CI [\#2262](https://github.com/nlohmann/json/pull/2262) ([nlohmann](https://github.com/nlohmann)) +- Make library work with Clang on Windows [\#2259](https://github.com/nlohmann/json/pull/2259) ([nlohmann](https://github.com/nlohmann)) +- Add ordered\_json specialization with ordered object keys [\#2258](https://github.com/nlohmann/json/pull/2258) ([nlohmann](https://github.com/nlohmann)) +- Add pkg-config file [\#2253](https://github.com/nlohmann/json/pull/2253) ([ericonr](https://github.com/ericonr)) +- Fix regression from \#2181 [\#2251](https://github.com/nlohmann/json/pull/2251) ([nlohmann](https://github.com/nlohmann)) +- Tag binary values in cbor if set [\#2244](https://github.com/nlohmann/json/pull/2244) ([matthewbauer](https://github.com/matthewbauer)) +- Make assert configurable via JSON\_ASSERT [\#2242](https://github.com/nlohmann/json/pull/2242) ([nlohmann](https://github.com/nlohmann)) +- Add specialization of get\_to [\#2233](https://github.com/nlohmann/json/pull/2233) ([nlohmann](https://github.com/nlohmann)) +- Refine documentation of error\_handler parameter [\#2232](https://github.com/nlohmann/json/pull/2232) ([nlohmann](https://github.com/nlohmann)) +- Simplify conversion from/to custom types [\#2225](https://github.com/nlohmann/json/pull/2225) ([nlohmann](https://github.com/nlohmann)) +- Remove unused typedefs [\#2224](https://github.com/nlohmann/json/pull/2224) ([nlohmann](https://github.com/nlohmann)) +- Enable CMake policy CMP0077 [\#2222](https://github.com/nlohmann/json/pull/2222) ([alexreinking](https://github.com/alexreinking)) +- Add option to ignore comments in parse/accept functions [\#2212](https://github.com/nlohmann/json/pull/2212) ([nlohmann](https://github.com/nlohmann)) +- Fix Clang-Tidy warnings [\#2211](https://github.com/nlohmann/json/pull/2211) ([nlohmann](https://github.com/nlohmann)) +- Simple ordered\_json that works on all supported compilers [\#2206](https://github.com/nlohmann/json/pull/2206) ([gatopeich](https://github.com/gatopeich)) +- Use unsigned indizies for array index in json pointer [\#2203](https://github.com/nlohmann/json/pull/2203) ([t-b](https://github.com/t-b)) +- Add option to not rely on Internet connectivity during test stage [\#2202](https://github.com/nlohmann/json/pull/2202) ([nlohmann](https://github.com/nlohmann)) +- Serialize floating-point numbers with 32 bit when possible \(MessagePack\) [\#2201](https://github.com/nlohmann/json/pull/2201) ([nlohmann](https://github.com/nlohmann)) +- Fix consistency in function `int\_to\_string\(\)` [\#2193](https://github.com/nlohmann/json/pull/2193) ([dota17](https://github.com/dota17)) +- Fix issue\#1275 [\#2181](https://github.com/nlohmann/json/pull/2181) ([dota17](https://github.com/dota17)) +- C++20 support by removing swap specialization [\#2176](https://github.com/nlohmann/json/pull/2176) ([gracicot](https://github.com/gracicot)) +- Feat/explicit conversion operator [\#1559](https://github.com/nlohmann/json/pull/1559) ([theodelrieu](https://github.com/theodelrieu)) + +## [v3.8.0](https://github.com/nlohmann/json/releases/tag/v3.8.0) (2020-06-14) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.7.3...v3.8.0) + +- sorry delete this issue, i'm stupid [\#2187](https://github.com/nlohmann/json/issues/2187) +- Append to a std::nlohmann::json type [\#2186](https://github.com/nlohmann/json/issues/2186) +- Some troubles to compile the last revision [\#2177](https://github.com/nlohmann/json/issues/2177) +- ​\#​ Top level CMakeLists.txt​ +​project​\(FOO\) +... +​option​\(FOO\_USE\_EXTERNAL\_JSON ​"Use an external JSON library"​ ​OFF​\) +... +​add\_subdirectory​\(thirdparty\) +... +​add\_library​\(foo ...\) +... +​\#​ Note that the namespaced target will always be available regardless of the​ +​\#​ import method​ +​target\_link\_libraries​\(foo ​PRIVATE​ nlohmann\_json::nlohmann\_json\) [\#2170](https://github.com/nlohmann/json/issues/2170) +- https://www.github.com/nlohmann/json/tree/develop/include%2Fnlohmann%2Fjson\_fwd.hpp [\#2169](https://github.com/nlohmann/json/issues/2169) +- templated from\_json of non primitive types causes gcc error [\#2168](https://github.com/nlohmann/json/issues/2168) +- few warnings/errors in copy assignment [\#2167](https://github.com/nlohmann/json/issues/2167) +- Different output when upgrading from clang 9 to clang 10 [\#2166](https://github.com/nlohmann/json/issues/2166) +- Cannot build with VS 2019 / C++17 [\#2163](https://github.com/nlohmann/json/issues/2163) +- Q: When I received an illegal string,How the program knows? [\#2162](https://github.com/nlohmann/json/issues/2162) +- Problem while reading a json file [\#2161](https://github.com/nlohmann/json/issues/2161) +- converting std::chrono::system\_clock::time\_point to json. [\#2159](https://github.com/nlohmann/json/issues/2159) +- how to parse vector\ format [\#2157](https://github.com/nlohmann/json/issues/2157) +- nlohmann::json and =nullptr [\#2156](https://github.com/nlohmann/json/issues/2156) +- test-cbor fails [\#2154](https://github.com/nlohmann/json/issues/2154) +- Accessing array inside array syntax? [\#2151](https://github.com/nlohmann/json/issues/2151) +- Best way to catch errors when querying json [\#2150](https://github.com/nlohmann/json/issues/2150) +- JSON Data Mapping Key-Value from other Key-Value [\#2148](https://github.com/nlohmann/json/issues/2148) +- Conflicts with std \ compiling with GCC 10 [\#2146](https://github.com/nlohmann/json/issues/2146) +- Incorrect CMake FetchContent example [\#2142](https://github.com/nlohmann/json/issues/2142) +- Help for a Beginner? [\#2141](https://github.com/nlohmann/json/issues/2141) +- Read Json from File [\#2139](https://github.com/nlohmann/json/issues/2139) +- How to feed a predefined integer value into json string [\#2138](https://github.com/nlohmann/json/issues/2138) +- getting json array inside json object [\#2135](https://github.com/nlohmann/json/issues/2135) +- Add .contains example to doc [\#2133](https://github.com/nlohmann/json/issues/2133) +- Is it safe to return string.c\_str\(\) received from get\(\)? [\#2130](https://github.com/nlohmann/json/issues/2130) +- GCC 10: Compilation error when including any before including json header in C++17 mode [\#2129](https://github.com/nlohmann/json/issues/2129) +- Intersection of two json files [\#2127](https://github.com/nlohmann/json/issues/2127) +- App crashes when dump method called for non ascii chars. [\#2126](https://github.com/nlohmann/json/issues/2126) +- iterator based erase method [\#2122](https://github.com/nlohmann/json/issues/2122) +- quick and convenient api to get/set nested json values [\#2120](https://github.com/nlohmann/json/issues/2120) +- assigning nullptr to std::string [\#2118](https://github.com/nlohmann/json/issues/2118) +- usless\_cast warnings with gcc 9.3 and 10.1 \(C++17\) [\#2114](https://github.com/nlohmann/json/issues/2114) +- clang 10 warning [\#2113](https://github.com/nlohmann/json/issues/2113) +- Possible incorrect \_MSC\_VER reference [\#2112](https://github.com/nlohmann/json/issues/2112) +- warning under gcc 10.1 [\#2110](https://github.com/nlohmann/json/issues/2110) +- Wdeprecated-declarations from GCC v10.1.0 [\#2109](https://github.com/nlohmann/json/issues/2109) +- Global std::vector from json [\#2108](https://github.com/nlohmann/json/issues/2108) +- heap-buffer-overflow when using nlohmann/json, ASAN, and gtest [\#2107](https://github.com/nlohmann/json/issues/2107) +- exception 0x770DC5AF when i read an special char in json file [\#2106](https://github.com/nlohmann/json/issues/2106) +- json::parse\(\) fails to parse a dump\(2,' '\) output, yet does successfully parse dump\(\) [\#2105](https://github.com/nlohmann/json/issues/2105) +- run test-udt error in MSVC 19.16.27034.0 [\#2103](https://github.com/nlohmann/json/issues/2103) +- Unable to dump to stringstream [\#2102](https://github.com/nlohmann/json/issues/2102) +- Can't ad an object in another objet [\#2101](https://github.com/nlohmann/json/issues/2101) +- Implicit conversion causes "cannot use operator\[\] with a string argument with string" [\#2098](https://github.com/nlohmann/json/issues/2098) +- C++20: char8\_t [\#2097](https://github.com/nlohmann/json/issues/2097) +- Compilation issues when included in project [\#2094](https://github.com/nlohmann/json/issues/2094) +- string value with null character causes infinite loop [\#2093](https://github.com/nlohmann/json/issues/2093) +- corrupted size vs. prev\_size \(aborted\) [\#2092](https://github.com/nlohmann/json/issues/2092) +- Get string field content without return std::string copy [\#2091](https://github.com/nlohmann/json/issues/2091) +- JSON Comments \(JSON 5\) [\#2090](https://github.com/nlohmann/json/issues/2090) +- Remove \#include \ [\#2089](https://github.com/nlohmann/json/issues/2089) +- JSON library as a git submodule [\#2088](https://github.com/nlohmann/json/issues/2088) +- Apple Clang 11.0.3 on MacOS Catalina 10.15.4 not compiling [\#2087](https://github.com/nlohmann/json/issues/2087) +- Value function return empty object even if it exist [\#2086](https://github.com/nlohmann/json/issues/2086) +- Cannot debug but Run works [\#2085](https://github.com/nlohmann/json/issues/2085) +- Question about serialization. [\#2084](https://github.com/nlohmann/json/issues/2084) +- How to include in an external project [\#2083](https://github.com/nlohmann/json/issues/2083) +- Missing tests for binary values [\#2082](https://github.com/nlohmann/json/issues/2082) +- How to override default string serialization? [\#2079](https://github.com/nlohmann/json/issues/2079) +- Can't have a json type as a property in an arbitrary type [\#2078](https://github.com/nlohmann/json/issues/2078) +- New release? [\#2075](https://github.com/nlohmann/json/issues/2075) +- CMake FetchContent \> Updating the documentation? [\#2073](https://github.com/nlohmann/json/issues/2073) +- How to convert STL Vector \(of user defined type\) to Json [\#2072](https://github.com/nlohmann/json/issues/2072) +- how to make an array of objects [\#2070](https://github.com/nlohmann/json/issues/2070) +- ‘\_\_int64’ was not declared [\#2068](https://github.com/nlohmann/json/issues/2068) +- \[json.exception.type\_error.317\] cannot serialize binary data to text JSON [\#2067](https://github.com/nlohmann/json/issues/2067) +- Unexpected end of input; expected '\[', '{', or a literal [\#2066](https://github.com/nlohmann/json/issues/2066) +- Json structure can be nested? [\#2065](https://github.com/nlohmann/json/issues/2065) +- Bug: returning reference to local temporary object [\#2064](https://github.com/nlohmann/json/issues/2064) +- Allow to use non strict parsing [\#2063](https://github.com/nlohmann/json/issues/2063) +- Crashing on json::at [\#2062](https://github.com/nlohmann/json/issues/2062) +- How to convert a const std::vector\ message to a json, to be able to parse it and extract information from it? Can you point to any examples? [\#2058](https://github.com/nlohmann/json/issues/2058) +- Nice library [\#2057](https://github.com/nlohmann/json/issues/2057) +- json.hpp:15372:22: error: expected unqualified-id if \(not std::isfinite\(x\)\): Started getting this bug after updating my XCode [\#2056](https://github.com/nlohmann/json/issues/2056) +- Confused as how I can extract the values from the JSON object. [\#2055](https://github.com/nlohmann/json/issues/2055) +- Warnings with GCC 10 [\#2052](https://github.com/nlohmann/json/issues/2052) +- Warnings with Clang 10 [\#2049](https://github.com/nlohmann/json/issues/2049) +- Update doctest [\#2048](https://github.com/nlohmann/json/issues/2048) +- Unclear error message: "cannot use operator\[\] with a string argument with array" [\#2047](https://github.com/nlohmann/json/issues/2047) +- Serializing std::variant\\> [\#2045](https://github.com/nlohmann/json/issues/2045) +- Crash when parse big jsonfile [\#2042](https://github.com/nlohmann/json/issues/2042) +- How to check if a key exists without silently generating null objects on the path [\#2041](https://github.com/nlohmann/json/issues/2041) +- Crash when traversing over items\(\) of temporary json objects [\#2040](https://github.com/nlohmann/json/issues/2040) +- How to parse multiple line value ? [\#2039](https://github.com/nlohmann/json/issues/2039) +- SAX API uses unsigned std::size\_t but -1 if element size is not known; [\#2037](https://github.com/nlohmann/json/issues/2037) +- How to parse big decimal data [\#2036](https://github.com/nlohmann/json/issues/2036) +- how use template \ struct adl\_serializer [\#2035](https://github.com/nlohmann/json/issues/2035) +- auto iterator returned by find to handle value depending if is string or numeric. [\#2032](https://github.com/nlohmann/json/issues/2032) +- pass find returned iterator to numeric variable. [\#2031](https://github.com/nlohmann/json/issues/2031) +- Parse error on valid json file [\#2029](https://github.com/nlohmann/json/issues/2029) +- Is here any elegant way to combine serialization and deserialization code? [\#2028](https://github.com/nlohmann/json/issues/2028) +- Notes about dump function [\#2027](https://github.com/nlohmann/json/issues/2027) +- Different JSON printouts for empty dictionary on Linux and Mac. [\#2026](https://github.com/nlohmann/json/issues/2026) +- easier way to get exception reason out of json\_sax\_dom\_callback\_parser without exceptions [\#2024](https://github.com/nlohmann/json/issues/2024) +- Using fifo\_map with base class and derived class [\#2023](https://github.com/nlohmann/json/issues/2023) +- Error reading JSON File [\#2022](https://github.com/nlohmann/json/issues/2022) +- Parse causing crash on android. Cannot catch. [\#2021](https://github.com/nlohmann/json/issues/2021) +- Extra backslashes in nested json [\#2020](https://github.com/nlohmann/json/issues/2020) +- How to create patch for merge\_patch input ? [\#2018](https://github.com/nlohmann/json/issues/2018) +- CppUTest/include/CppUTestExt/MockSupport.h:40: error: default argument for ‘MockFailureReporter\* failureReporterForThisCall’ has type ‘void\*’ [\#2017](https://github.com/nlohmann/json/issues/2017) +- including another file [\#2016](https://github.com/nlohmann/json/issues/2016) +- GNU PREREQ Error with gcc 9.3.0 [\#2015](https://github.com/nlohmann/json/issues/2015) +- Parse error: json.exception.parse\_error.101 - invalid string: ill-formed UTF-8 byte [\#2014](https://github.com/nlohmann/json/issues/2014) +- Add more flexibility to basic\_json's ObjectType \(and ArrayType\) [\#2013](https://github.com/nlohmann/json/issues/2013) +- afl persistent mode [\#2012](https://github.com/nlohmann/json/issues/2012) +- Compiler Errors under VS2019 in Appveyor CI [\#2009](https://github.com/nlohmann/json/issues/2009) +- Another compilation failure with Visual Studio [\#2007](https://github.com/nlohmann/json/issues/2007) +- Implicit cast to std::string broken again with VS2019 16.5.0 [\#2006](https://github.com/nlohmann/json/issues/2006) +- error: no matching member function for call to 'AddRaw' [\#2005](https://github.com/nlohmann/json/issues/2005) +- When I re-create an object again after the network request, an error is reported [\#2003](https://github.com/nlohmann/json/issues/2003) +- How to merge \(and not replace\) different Json::Value objects in jsoncpp [\#2001](https://github.com/nlohmann/json/issues/2001) +- scalar transforms to list [\#2000](https://github.com/nlohmann/json/issues/2000) +- Dump JSON containing multibyte characters [\#1999](https://github.com/nlohmann/json/issues/1999) +- Build error when modify value [\#1998](https://github.com/nlohmann/json/issues/1998) +- How do i include a vector of pointers in my json? [\#1997](https://github.com/nlohmann/json/issues/1997) +- Compiler error wrt incomplete types changed in gcc8.3.0-26 [\#1996](https://github.com/nlohmann/json/issues/1996) +- NaN-like comparison behavior of discarded is inconvenient [\#1988](https://github.com/nlohmann/json/issues/1988) +- Maintaining JSON package in my CMake [\#1987](https://github.com/nlohmann/json/issues/1987) +- reading int number and string number [\#1986](https://github.com/nlohmann/json/issues/1986) +- Build error: keyword is hidden by macro definition! [\#1985](https://github.com/nlohmann/json/issues/1985) +- JSON patch diff for op=add formation is not as per standard \(RFC 6902\) [\#1983](https://github.com/nlohmann/json/issues/1983) +- json\_pointer.contains\(\) exception is incorrectly raised [\#1982](https://github.com/nlohmann/json/issues/1982) +- Error with non existing key [\#1981](https://github.com/nlohmann/json/issues/1981) +- Closed [\#1978](https://github.com/nlohmann/json/issues/1978) +- Where is the library built and what is the name? [\#1977](https://github.com/nlohmann/json/issues/1977) +- The cmake\_import example does not build [\#1976](https://github.com/nlohmann/json/issues/1976) +- Dumping core when reading invalid file [\#1975](https://github.com/nlohmann/json/issues/1975) +- Abort in dump\(\) method [\#1973](https://github.com/nlohmann/json/issues/1973) +- Unclear docs regarding parser\_callback\_t callbacks [\#1972](https://github.com/nlohmann/json/issues/1972) +- Possible memory leak on push\_back [\#1971](https://github.com/nlohmann/json/issues/1971) +- Is it possible to get a safe mutable reference/pointer to internal variant used in nlohmann json? [\#1970](https://github.com/nlohmann/json/issues/1970) +- Getting a flatten json to map\ [\#1957](https://github.com/nlohmann/json/issues/1957) +- forced type conversion or lexical cast without exception. [\#1955](https://github.com/nlohmann/json/issues/1955) +- Add json\_view type support to avoid excessive copying [\#1954](https://github.com/nlohmann/json/issues/1954) +- Adding "examples" section for real-life usages [\#1953](https://github.com/nlohmann/json/issues/1953) +- GDB pretty printing support [\#1952](https://github.com/nlohmann/json/issues/1952) +- Add nlohmann::json::key\_type [\#1951](https://github.com/nlohmann/json/issues/1951) +- cannot use operator\[\] with a string argument with string [\#1949](https://github.com/nlohmann/json/issues/1949) +- std::ifstream \>\> json error [\#1948](https://github.com/nlohmann/json/issues/1948) +- Cannot update json data in an iterator? [\#1947](https://github.com/nlohmann/json/issues/1947) +- How can i build this library in VS 2017? [\#1943](https://github.com/nlohmann/json/issues/1943) +- json\_pointer.contains\(\) exceptions when path not found [\#1942](https://github.com/nlohmann/json/issues/1942) +- Nested objects serialize/deserialize [\#1941](https://github.com/nlohmann/json/issues/1941) +- Compile warning on architectures that are not x86 [\#1939](https://github.com/nlohmann/json/issues/1939) +- Version of nlohmann-json-dev in debian packages [\#1938](https://github.com/nlohmann/json/issues/1938) +- Create a json object for every cycle [\#1937](https://github.com/nlohmann/json/issues/1937) +- How to get the object name? [\#1936](https://github.com/nlohmann/json/issues/1936) +- Reserve and resize function for basic json [\#1935](https://github.com/nlohmann/json/issues/1935) +- How to use json parse in tsl::ordread\_map? [\#1934](https://github.com/nlohmann/json/issues/1934) +- C++14 support is not enabled with msvc2015 [\#1932](https://github.com/nlohmann/json/issues/1932) +- Need help with to\_json for derived class, keep getting "cannot use operator" [\#1931](https://github.com/nlohmann/json/issues/1931) +- How to handle std::vector\ [\#1930](https://github.com/nlohmann/json/issues/1930) +- Heap corruption issue [\#1929](https://github.com/nlohmann/json/issues/1929) +- Add `std::wistream` support. [\#1928](https://github.com/nlohmann/json/issues/1928) +- This i can write and read any file thanks [\#1927](https://github.com/nlohmann/json/issues/1927) +- How can I get this simple example working? [\#1926](https://github.com/nlohmann/json/issues/1926) +- emplace\_back does not seems to work with the int 0 [\#1925](https://github.com/nlohmann/json/issues/1925) +- Why nlohmann does not release memory [\#1924](https://github.com/nlohmann/json/issues/1924) +- Is it possible to have template `json::parse` with `noexcept` specifier? [\#1922](https://github.com/nlohmann/json/issues/1922) +- JSON to wstring? [\#1921](https://github.com/nlohmann/json/issues/1921) +- GCC 10 tests build failure [\#1920](https://github.com/nlohmann/json/issues/1920) +- Size of binary json representations [\#1919](https://github.com/nlohmann/json/issues/1919) +- Accessing strings \(for example in keys or values\) without having the lib create a copy of it. [\#1916](https://github.com/nlohmann/json/issues/1916) +- operator== documentation should show how to apply custom comparison function [\#1915](https://github.com/nlohmann/json/issues/1915) +- char8\_t and std::u8string support [\#1914](https://github.com/nlohmann/json/issues/1914) +- std::is\_pod is deprecated in C++20 [\#1913](https://github.com/nlohmann/json/issues/1913) +- Incomplete types reported by \(experimental\) GCC10 [\#1912](https://github.com/nlohmann/json/issues/1912) +- Compile warnings on MSVC 14.2 [\#1911](https://github.com/nlohmann/json/issues/1911) +- How to parse json file with type composition of std::optional and std::variant [\#1910](https://github.com/nlohmann/json/issues/1910) +- why root\_schema be implemented as unique\_ptr in json-validator.cpp,could I use it as shared\_ptr? [\#1908](https://github.com/nlohmann/json/issues/1908) +- compile error in gcc-6.3.0 [\#1906](https://github.com/nlohmann/json/issues/1906) +- Scalar constexpr is odr-used when used as json initializer [\#1905](https://github.com/nlohmann/json/issues/1905) +- install Slack app [\#1904](https://github.com/nlohmann/json/issues/1904) +- typo in a comment [\#1903](https://github.com/nlohmann/json/issues/1903) +- Watch JSON variables in Debug [\#1902](https://github.com/nlohmann/json/issues/1902) +- does Json sdk cares about dfc dfd utf8 issue? [\#1901](https://github.com/nlohmann/json/issues/1901) +- Allow multiple line string value in JSON [\#1897](https://github.com/nlohmann/json/issues/1897) +- Writing map to json file [\#1896](https://github.com/nlohmann/json/issues/1896) +- Small documentation mistake [\#1895](https://github.com/nlohmann/json/issues/1895) +- why static function `parse` cann't find in visual studio 2019 [\#1894](https://github.com/nlohmann/json/issues/1894) +- Best way to handle json files with missing key value pairs. [\#1893](https://github.com/nlohmann/json/issues/1893) +- accessing json object as multimap [\#1892](https://github.com/nlohmann/json/issues/1892) +- What is the best way to parse vec3s into glm::vec3 [\#1891](https://github.com/nlohmann/json/issues/1891) +- Get array of items without using vector [\#1890](https://github.com/nlohmann/json/issues/1890) +- Build errors \(clang 11.0.0\) on macOS 10.15.2 [\#1889](https://github.com/nlohmann/json/issues/1889) +- Multiple arrays to vectors help [\#1888](https://github.com/nlohmann/json/issues/1888) +- json::parse\(begin, end\) parse error on first character using uchar\* [\#1887](https://github.com/nlohmann/json/issues/1887) +- issue in free\(\) [\#1886](https://github.com/nlohmann/json/issues/1886) +- is\_number\_unsigned\(\) returns false for positive integers \(int or 0 or 1 literals\) [\#1885](https://github.com/nlohmann/json/issues/1885) +- MSVC build failure with /Zc:\_\_cplusplus and C++17 [\#1883](https://github.com/nlohmann/json/issues/1883) +- RFC 6901 op:replace & arrays [\#1882](https://github.com/nlohmann/json/issues/1882) +- Problem with serialization of my custom template doubly-linked list [\#1881](https://github.com/nlohmann/json/issues/1881) +- is\_array\(\) is True, but raise 'cannot use operator\[\] for object iterators' [\#1880](https://github.com/nlohmann/json/issues/1880) +- Serialize dynamic array [\#1879](https://github.com/nlohmann/json/issues/1879) +- Serialization of struct object. [\#1877](https://github.com/nlohmann/json/issues/1877) +- warning:c4503 [\#1875](https://github.com/nlohmann/json/issues/1875) +- Why are flattened empty objects/arrays not representable? [\#1874](https://github.com/nlohmann/json/issues/1874) +- Container Overflow \(ASAN\) when using operator \>\> on an ifs [\#1873](https://github.com/nlohmann/json/issues/1873) +- Sub-array to vector or map object? [\#1870](https://github.com/nlohmann/json/issues/1870) +- WIP: QT \(cute\) type supports [\#1869](https://github.com/nlohmann/json/issues/1869) +- Compiler flags to disable features and shrink code size [\#1868](https://github.com/nlohmann/json/issues/1868) +- null strings [\#1867](https://github.com/nlohmann/json/issues/1867) +- Struct with array of struct and \_\_attribute\_\_\(\(packed\)\) [\#1866](https://github.com/nlohmann/json/issues/1866) +- Best way to extract numbers in the string? [\#1865](https://github.com/nlohmann/json/issues/1865) +- Displaying \\?\Volume{guid} from string to json giving error [\#1864](https://github.com/nlohmann/json/issues/1864) +- not working when compiling as x86 [\#1863](https://github.com/nlohmann/json/issues/1863) +- Skipping evaluation of log line expressions with a macro, is it possible? [\#1862](https://github.com/nlohmann/json/issues/1862) +- Suppress warnings [\#1861](https://github.com/nlohmann/json/issues/1861) +- conflit with g++ compile option -mwindows [\#1860](https://github.com/nlohmann/json/issues/1860) +- How to serialize nested classes to semi-flat JSON object? [\#1859](https://github.com/nlohmann/json/issues/1859) +- Memory Requirement for large json file [\#1858](https://github.com/nlohmann/json/issues/1858) +- Query a binary format \(BSON, CBOR, MessagePack, UBJSON\) [\#1856](https://github.com/nlohmann/json/issues/1856) +- Documentation on operator\[\] behavior with missing keys [\#1855](https://github.com/nlohmann/json/issues/1855) +- Problem in converting string into JSON; Can't parse successfully. [\#1854](https://github.com/nlohmann/json/issues/1854) +- json.at\_or\_default\(key, defaultval\) [\#1852](https://github.com/nlohmann/json/issues/1852) +- please improve the enum conversion documentation \(my example gist provided\) [\#1851](https://github.com/nlohmann/json/issues/1851) +- Default value returned on ValueType nlohmann::basic\_json::value \(const typename object\_t::key\_type& key, const ValueType& default\_value\) [\#1850](https://github.com/nlohmann/json/issues/1850) +- Accounting for arbitrary precision numerical literals [\#1849](https://github.com/nlohmann/json/issues/1849) +- While trying to make a simple array, I get a nested array instead [\#1848](https://github.com/nlohmann/json/issues/1848) +- How to reuse the parser and serializer intermediate storage? [\#1847](https://github.com/nlohmann/json/issues/1847) +- Too much content in json.hpp leads to slow compilation [\#1845](https://github.com/nlohmann/json/issues/1845) +- Cannot read some data in json file [\#1843](https://github.com/nlohmann/json/issues/1843) +- Precompiled JSON library? [\#1842](https://github.com/nlohmann/json/issues/1842) +- Please change assert into throw\(maybe\) in line 17946 [\#1841](https://github.com/nlohmann/json/issues/1841) +- JSON for modern C++ ECCN information [\#1840](https://github.com/nlohmann/json/issues/1840) +- CI: reduce build time for Travis valgrind [\#1836](https://github.com/nlohmann/json/issues/1836) +- How do I traverse a json object and add new elements into the hierarchy [\#1834](https://github.com/nlohmann/json/issues/1834) +- Invalid UTF-8 byte at index 1: 0x65 [\#1831](https://github.com/nlohmann/json/issues/1831) +- Serialize big data in json [\#1828](https://github.com/nlohmann/json/issues/1828) +- Backslash '\' in value causes exception [\#1827](https://github.com/nlohmann/json/issues/1827) +- from\_json for non default constructible class with dependency injection [\#1819](https://github.com/nlohmann/json/issues/1819) +- Semi-frequent timeouts in `test-unicode\_all` with 3.6.1 \(aarch64\) [\#1816](https://github.com/nlohmann/json/issues/1816) +- input\_adapter not user extensible [\#1813](https://github.com/nlohmann/json/issues/1813) +- crash at json::destroy on android [\#1812](https://github.com/nlohmann/json/issues/1812) +- Logs are repeating while cmake [\#1809](https://github.com/nlohmann/json/issues/1809) +- Add a the possibility to add dynamic json objects [\#1795](https://github.com/nlohmann/json/issues/1795) +- Unnecessary test data file in the release [\#1790](https://github.com/nlohmann/json/issues/1790) +- Add support for parse stack limiting [\#1788](https://github.com/nlohmann/json/issues/1788) +- GCC -Wuseless-cast warnings [\#1777](https://github.com/nlohmann/json/issues/1777) +- compilation issue with NVCC 9.0 [\#1773](https://github.com/nlohmann/json/issues/1773) +- Unexpected behavior with fifo\_map json when copy and append [\#1763](https://github.com/nlohmann/json/issues/1763) +- Parse error [\#1761](https://github.com/nlohmann/json/issues/1761) +- Assignment \(using value\(\)\) to nonexistent element behaves differently on Xcode 8 vs Xcode 10 [\#1758](https://github.com/nlohmann/json/issues/1758) +- Readme out of date [\#1756](https://github.com/nlohmann/json/issues/1756) +- cmake\_\* tests don't use the build system's compiler [\#1747](https://github.com/nlohmann/json/issues/1747) +- Static assertions for template type properties required [\#1729](https://github.com/nlohmann/json/issues/1729) +- Use float and possibly half in json::to\_cbor [\#1719](https://github.com/nlohmann/json/issues/1719) +- json::from\_cbor does not respect allow\_exceptions = false when input is string literal [\#1715](https://github.com/nlohmann/json/issues/1715) +- /Zc:\_\_cplusplus leads to C2416 [\#1695](https://github.com/nlohmann/json/issues/1695) +- `unflatten` vs objects with number-ish keys [\#1575](https://github.com/nlohmann/json/issues/1575) +- A "thinner" source code tar as part of release? [\#1572](https://github.com/nlohmann/json/issues/1572) +- Repository is almost 450MB [\#1497](https://github.com/nlohmann/json/issues/1497) +- Substantial performance penalty caused by polymorphic input adapter [\#1457](https://github.com/nlohmann/json/issues/1457) +- Move tests to a separate repo [\#1235](https://github.com/nlohmann/json/issues/1235) +- reduce repos size [\#1185](https://github.com/nlohmann/json/issues/1185) +- CMakeLists.txt in release zips? [\#1184](https://github.com/nlohmann/json/issues/1184) +- Minimal branch? [\#1066](https://github.com/nlohmann/json/issues/1066) +- Move test blobs to a submodule? [\#732](https://github.com/nlohmann/json/issues/732) +- \[Question\] When using this as git submodule, will it clone the whole thing include test data and benchmark? [\#620](https://github.com/nlohmann/json/issues/620) +- Need to improve ignores.. [\#567](https://github.com/nlohmann/json/issues/567) +- Minimal repository \(current size very large\) [\#556](https://github.com/nlohmann/json/issues/556) +- For a header-only library you have to clone 214MB [\#482](https://github.com/nlohmann/json/issues/482) +- 17 MB / 90 MB repo size!? [\#96](https://github.com/nlohmann/json/issues/96) + +- Improve parse\_ubjson\_fuzzer [\#2182](https://github.com/nlohmann/json/pull/2182) ([tanuj208](https://github.com/tanuj208)) +- Add input adapter tests [\#2178](https://github.com/nlohmann/json/pull/2178) ([nlohmann](https://github.com/nlohmann)) +- Fix warnings [\#2174](https://github.com/nlohmann/json/pull/2174) ([nlohmann](https://github.com/nlohmann)) +- Fix PR\#1006 [\#2158](https://github.com/nlohmann/json/pull/2158) ([dota17](https://github.com/dota17)) +- Fix issue\#1972 [\#2153](https://github.com/nlohmann/json/pull/2153) ([dota17](https://github.com/dota17)) +- Update URLs to HTTPS [\#2152](https://github.com/nlohmann/json/pull/2152) ([TotalCaesar659](https://github.com/TotalCaesar659)) +- Fix Issue\#1813: user defined input adapters [\#2145](https://github.com/nlohmann/json/pull/2145) ([FrancoisChabot](https://github.com/FrancoisChabot)) +- Fix issue\#1939: Cast character to unsigned for comparison [\#2144](https://github.com/nlohmann/json/pull/2144) ([XyFreak](https://github.com/XyFreak)) +- Fix issue\#2142: readme: fix typo in CMake FetchContent example [\#2143](https://github.com/nlohmann/json/pull/2143) ([quentin-dev](https://github.com/quentin-dev)) +- Respect allow\_exceptions=false for binary formats [\#2140](https://github.com/nlohmann/json/pull/2140) ([nlohmann](https://github.com/nlohmann)) +- Fix issue 2112 [\#2137](https://github.com/nlohmann/json/pull/2137) ([dota17](https://github.com/dota17)) +- Add bleeding edge GCC to CI [\#2136](https://github.com/nlohmann/json/pull/2136) ([aokellermann](https://github.com/aokellermann)) +- Clean up implementation of binary type [\#2125](https://github.com/nlohmann/json/pull/2125) ([nlohmann](https://github.com/nlohmann)) +- Fixed a compilation error in MSVC [\#2121](https://github.com/nlohmann/json/pull/2121) ([gistrec](https://github.com/gistrec)) +- Overwork CI [\#2119](https://github.com/nlohmann/json/pull/2119) ([nlohmann](https://github.com/nlohmann)) +- Fix warnings from Clang 10 and GCC 9 [\#2116](https://github.com/nlohmann/json/pull/2116) ([nlohmann](https://github.com/nlohmann)) +- Do not include \ when using C++17 [\#2115](https://github.com/nlohmann/json/pull/2115) ([nlohmann](https://github.com/nlohmann)) +- Fix issue\#2086: disallow json::value\_t type parameter in value\(\) [\#2104](https://github.com/nlohmann/json/pull/2104) ([dota17](https://github.com/dota17)) +- Fix Coveralls integration [\#2100](https://github.com/nlohmann/json/pull/2100) ([nlohmann](https://github.com/nlohmann)) +- Add tests for binary values [\#2099](https://github.com/nlohmann/json/pull/2099) ([nlohmann](https://github.com/nlohmann)) +- Use external test data [\#2081](https://github.com/nlohmann/json/pull/2081) ([nlohmann](https://github.com/nlohmann)) +- Remove Doozer CI [\#2080](https://github.com/nlohmann/json/pull/2080) ([nlohmann](https://github.com/nlohmann)) +- Fix README.md. Missing ``` [\#2077](https://github.com/nlohmann/json/pull/2077) ([ArthurSonzogni](https://github.com/ArthurSonzogni)) +- Fix error message about invalid surrogate pairs [\#2076](https://github.com/nlohmann/json/pull/2076) ([rmisev](https://github.com/rmisev)) +- Add CMake fetchcontent documentation and tests [\#2074](https://github.com/nlohmann/json/pull/2074) ([ArthurSonzogni](https://github.com/ArthurSonzogni)) +- Properly pass serialize\_binary to dump function [\#2071](https://github.com/nlohmann/json/pull/2071) ([nlohmann](https://github.com/nlohmann)) +- Fix returning reference to local temporary object [\#2069](https://github.com/nlohmann/json/pull/2069) ([nlohmann](https://github.com/nlohmann)) +- updated wandbox link [\#2060](https://github.com/nlohmann/json/pull/2060) ([alexandermyasnikov](https://github.com/alexandermyasnikov)) +- Fix bug in diff function [\#2054](https://github.com/nlohmann/json/pull/2054) ([nlohmann](https://github.com/nlohmann)) +- Fix GCC compiler warnings [\#2053](https://github.com/nlohmann/json/pull/2053) ([nlohmann](https://github.com/nlohmann)) +- Fix Clang compiler warnings [\#2051](https://github.com/nlohmann/json/pull/2051) ([nlohmann](https://github.com/nlohmann)) +- Update doctest to 2.3.7 [\#2050](https://github.com/nlohmann/json/pull/2050) ([nlohmann](https://github.com/nlohmann)) +- Fix issue\#1719 [\#2044](https://github.com/nlohmann/json/pull/2044) ([dota17](https://github.com/dota17)) +- Add missing testcase about NaN in unit-constructor1.cpp [\#2043](https://github.com/nlohmann/json/pull/2043) ([dota17](https://github.com/dota17)) +- Templatize basic\_json constructor from json\_ref [\#2034](https://github.com/nlohmann/json/pull/2034) ([ArtemSarmini](https://github.com/ArtemSarmini)) +- fix \#1982:json\_pointer.contains\(\) exception is incorrectly raised [\#2019](https://github.com/nlohmann/json/pull/2019) ([dota17](https://github.com/dota17)) +- catch exceptions for json\_pointer : ..../+99 [\#1990](https://github.com/nlohmann/json/pull/1990) ([dota17](https://github.com/dota17)) +- fix warnings in serializer.hpp for VS2019 [\#1969](https://github.com/nlohmann/json/pull/1969) ([dota17](https://github.com/dota17)) +- Fix C26451 warnnings in to\_chars.hpp [\#1967](https://github.com/nlohmann/json/pull/1967) ([dota17](https://github.com/dota17)) +- templated input adapters [\#1950](https://github.com/nlohmann/json/pull/1950) ([FrancoisChabot](https://github.com/FrancoisChabot)) +- make CMake's version config file architecture-independent [\#1746](https://github.com/nlohmann/json/pull/1746) ([uhoreg](https://github.com/uhoreg)) +- Add binary type support to all binary file formats, as well as an internally represented binary type [\#1662](https://github.com/nlohmann/json/pull/1662) ([OmnipotentEntity](https://github.com/OmnipotentEntity)) + +## [v3.7.3](https://github.com/nlohmann/json/releases/tag/v3.7.3) (2019-11-17) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.7.2...v3.7.3) + +- Project branches [\#1839](https://github.com/nlohmann/json/issues/1839) +- Quadratic destruction complexity introduced in \#1436 [\#1837](https://github.com/nlohmann/json/issues/1837) +- Trying to open a file [\#1814](https://github.com/nlohmann/json/issues/1814) +- Comparing data type with value\_t::number\_integer fails [\#1783](https://github.com/nlohmann/json/issues/1783) +- CMake version config file is architecture-dependent [\#1697](https://github.com/nlohmann/json/issues/1697) + +- Fix quadratic destruction complexity [\#1838](https://github.com/nlohmann/json/pull/1838) ([nickaein](https://github.com/nickaein)) + +## [v3.7.2](https://github.com/nlohmann/json/releases/tag/v3.7.2) (2019-11-10) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.7.1...v3.7.2) + +- Segmentation fault in destructor in case of large inputs [\#1835](https://github.com/nlohmann/json/issues/1835) +- type\_name\(\) is not consistent with type\(\) [\#1833](https://github.com/nlohmann/json/issues/1833) +- json::parse is not a member [\#1832](https://github.com/nlohmann/json/issues/1832) +- How do you deal with json\* ? [\#1829](https://github.com/nlohmann/json/issues/1829) +- Combined find\_package/add\_subdirectory not linking libraries [\#1771](https://github.com/nlohmann/json/issues/1771) +- example code for ifstream reading a json file results in no operator error [\#1766](https://github.com/nlohmann/json/issues/1766) +- Warning: unsequenced modification and access to 'range' [\#1674](https://github.com/nlohmann/json/issues/1674) +- Segmentation fault \(stack overflow\) due to unbounded recursion [\#1419](https://github.com/nlohmann/json/issues/1419) +- Stack-overflow \(OSS-Fuzz 4234\) [\#832](https://github.com/nlohmann/json/issues/832) + +- Configure WhiteSource Bolt for GitHub [\#1830](https://github.com/nlohmann/json/pull/1830) ([whitesource-bolt-for-github[bot]](https://github.com/apps/whitesource-bolt-for-github)) +- Prevent stackoverflow caused by recursive deconstruction [\#1436](https://github.com/nlohmann/json/pull/1436) ([nickaein](https://github.com/nickaein)) + +## [v3.7.1](https://github.com/nlohmann/json/releases/tag/v3.7.1) (2019-11-06) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.7.0...v3.7.1) + +- std::is\_constructible is always true with tuple [\#1825](https://github.com/nlohmann/json/issues/1825) +- Can't compile from\_json\(std::valarray\\). [\#1824](https://github.com/nlohmann/json/issues/1824) +- json class should have a get\_or member function [\#1823](https://github.com/nlohmann/json/issues/1823) +- NLOHMANN\_JSON\_SERIALIZE\_ENUM macro capture's json objects by value [\#1822](https://github.com/nlohmann/json/issues/1822) +- Parse fails when number literals start with zero [\#1820](https://github.com/nlohmann/json/issues/1820) +- Weird behaviour of `contains` with `json\_pointer` [\#1815](https://github.com/nlohmann/json/issues/1815) +- strange behaviour with json\_pointer and .contains\(\) [\#1811](https://github.com/nlohmann/json/issues/1811) +- Can \#1695 be re-opened? [\#1808](https://github.com/nlohmann/json/issues/1808) +- Merge two json objects [\#1807](https://github.com/nlohmann/json/issues/1807) +- std::is\_constructible\\> when to\_json not defined [\#1805](https://github.com/nlohmann/json/issues/1805) +- Private data on parsing [\#1802](https://github.com/nlohmann/json/issues/1802) +- Capturing Line and Position when querying [\#1800](https://github.com/nlohmann/json/issues/1800) +- json error on parsing DBL\_MAX from string [\#1796](https://github.com/nlohmann/json/issues/1796) +- De/Serialisation of vector of tupple object with nested obect need Help please [\#1794](https://github.com/nlohmann/json/issues/1794) +- Output json is corrupted [\#1793](https://github.com/nlohmann/json/issues/1793) +- variable name byte sometimes used as a \#define [\#1792](https://github.com/nlohmann/json/issues/1792) +- Can't read json file [\#1791](https://github.com/nlohmann/json/issues/1791) +- Problems with special German letters [\#1789](https://github.com/nlohmann/json/issues/1789) +- Support for trailing commas [\#1787](https://github.com/nlohmann/json/issues/1787) +- json\_pointer construction bug [\#1786](https://github.com/nlohmann/json/issues/1786) +- Visual Studio 2017 warning [\#1784](https://github.com/nlohmann/json/issues/1784) +- ciso646 header become obsolete [\#1782](https://github.com/nlohmann/json/issues/1782) +- Migrate LGTM.com installation from OAuth to GitHub App [\#1781](https://github.com/nlohmann/json/issues/1781) +- JSON comparison, contains and operator& [\#1778](https://github.com/nlohmann/json/issues/1778) +- pass a json object to a class contructor adds an array around the object [\#1776](https://github.com/nlohmann/json/issues/1776) +- 'Float' number\_float\_function\_t template parameter name conflicts with C '\#define Float float' [\#1775](https://github.com/nlohmann/json/issues/1775) +- A weird building problem :-\( [\#1774](https://github.com/nlohmann/json/issues/1774) +- What is this json\_ref? [\#1772](https://github.com/nlohmann/json/issues/1772) +- Interoperability with other languages [\#1770](https://github.com/nlohmann/json/issues/1770) +- Json dump [\#1768](https://github.com/nlohmann/json/issues/1768) +- json\_pointer\<\>::back\(\) should be const [\#1764](https://github.com/nlohmann/json/issues/1764) +- How to get value from array [\#1762](https://github.com/nlohmann/json/issues/1762) +- Merge two jsons [\#1757](https://github.com/nlohmann/json/issues/1757) +- Unable to locate nlohmann\_jsonConfig.cmake [\#1755](https://github.com/nlohmann/json/issues/1755) +- json.hpp won;t compile VS2019 CLR/CLI app but does in console app [\#1754](https://github.com/nlohmann/json/issues/1754) +- \[Nested Json Objects\] Segmentation fault [\#1753](https://github.com/nlohmann/json/issues/1753) +- remove/replace assert with exceptions [\#1752](https://github.com/nlohmann/json/issues/1752) +- Add array support for update\(\) function [\#1751](https://github.com/nlohmann/json/issues/1751) +- Is there a reason the `get\_to` method is defined in `include/nlohmann/json.hpp` but not in `single\_include/nlohmann/json.hpp`? [\#1750](https://github.com/nlohmann/json/issues/1750) +- how to validate json object before calling dump\(\) [\#1748](https://github.com/nlohmann/json/issues/1748) +- Unable to invoke accessors on json objects in lldb [\#1745](https://github.com/nlohmann/json/issues/1745) +- Escaping string before parsing [\#1743](https://github.com/nlohmann/json/issues/1743) +- Construction in a member initializer list using curly braces is set as 'array' [\#1742](https://github.com/nlohmann/json/issues/1742) +- Read a subkey from json object [\#1740](https://github.com/nlohmann/json/issues/1740) +- Serialize vector of glm:vec2 [\#1739](https://github.com/nlohmann/json/issues/1739) +- Support nlohmann::basic\_json::value with JSON\_NOEXCEPTION [\#1738](https://github.com/nlohmann/json/issues/1738) +- how to know the parse is error [\#1737](https://github.com/nlohmann/json/issues/1737) +- How to check if a given key exists in a JSON object [\#1736](https://github.com/nlohmann/json/issues/1736) +- Allow The Colon Key-Value Delimiter To Have A Space Before It \[@ READ ONLY\] [\#1735](https://github.com/nlohmann/json/issues/1735) +- Allow Tail { "Key": "Value" } Comma \[@ READ ONLY\] [\#1734](https://github.com/nlohmann/json/issues/1734) +- No-throw json::value\(\) [\#1733](https://github.com/nlohmann/json/issues/1733) +- JsonObject.dump\(\) [\#1732](https://github.com/nlohmann/json/issues/1732) +- basic\_json has no member "parse" [\#1731](https://github.com/nlohmann/json/issues/1731) +- Exception "type must be string, but is array" [\#1730](https://github.com/nlohmann/json/issues/1730) +- json::contains usage to find a path [\#1727](https://github.com/nlohmann/json/issues/1727) +- How to create JSON Object from my Structures of Data and Json File from that Object [\#1726](https://github.com/nlohmann/json/issues/1726) +- please provide an API to read JSON from file directly. [\#1725](https://github.com/nlohmann/json/issues/1725) +- How to modify a value stored at a key? [\#1723](https://github.com/nlohmann/json/issues/1723) +- CMake not correctly finding the configuration package for 3.7.0 [\#1721](https://github.com/nlohmann/json/issues/1721) +- name typo in the "spack package management" section of README.md [\#1720](https://github.com/nlohmann/json/issues/1720) +- How to add json to another json? [\#1718](https://github.com/nlohmann/json/issues/1718) +- json::parse\(\) ubsan regression with v3.7.0 [\#1716](https://github.com/nlohmann/json/issues/1716) +- What I am doing wrong?!? [\#1714](https://github.com/nlohmann/json/issues/1714) +- Potential memory leak detected by Valgrind [\#1713](https://github.com/nlohmann/json/issues/1713) +- json::parse is not thread safe? [\#1712](https://github.com/nlohmann/json/issues/1712) +- static analysis alarm by cppcheck [\#1711](https://github.com/nlohmann/json/issues/1711) +- The compilation time is slow [\#1710](https://github.com/nlohmann/json/issues/1710) +- not linking properly with cmake [\#1709](https://github.com/nlohmann/json/issues/1709) +- Error in dump\(\) with int64\_t minimum value [\#1708](https://github.com/nlohmann/json/issues/1708) +- Crash on trying to deserialize json string on 3ds homebrew [\#1707](https://github.com/nlohmann/json/issues/1707) +- Can't compile VS2019. 13 Errors [\#1706](https://github.com/nlohmann/json/issues/1706) +- find an object that matches the search criteria [\#1705](https://github.com/nlohmann/json/issues/1705) +- IntelliSense goes crazy on VS2019 [\#1704](https://github.com/nlohmann/json/issues/1704) +- Installing on Ubuntu 16.04 [\#1703](https://github.com/nlohmann/json/issues/1703) +- Where is json::parse now? [\#1702](https://github.com/nlohmann/json/issues/1702) +- Forward header should't be amalgamated [\#1700](https://github.com/nlohmann/json/issues/1700) +- Json support for Cmake version 2.8.12 [\#1699](https://github.com/nlohmann/json/issues/1699) +- Intruisive scientific notation when using .dump\(\); [\#1698](https://github.com/nlohmann/json/issues/1698) +- Is there support for automatic serialization/deserialization? [\#1696](https://github.com/nlohmann/json/issues/1696) +- on MSVC dump\(\) will hard crash for larger json [\#1693](https://github.com/nlohmann/json/issues/1693) +- puzzled implicit conversions [\#1692](https://github.com/nlohmann/json/issues/1692) +- Information: My project uses this awesome library [\#1691](https://github.com/nlohmann/json/issues/1691) +- Consider listing files explicitly instead of using GLOB [\#1686](https://github.com/nlohmann/json/issues/1686) +- Failing tests on MSVC with VS2019 15.9.13 x64 [\#1685](https://github.com/nlohmann/json/issues/1685) +- Consider putting the user-defined literals in a namespace [\#1682](https://github.com/nlohmann/json/issues/1682) +- Change from v2 to v3. Encoding with cp1252 [\#1680](https://github.com/nlohmann/json/issues/1680) +- How to add Fifo\_map into json using Cmake [\#1679](https://github.com/nlohmann/json/issues/1679) +- include.zip should contain meson.build [\#1672](https://github.com/nlohmann/json/issues/1672) +- \[Question\] How do I parse JSON into custom types? [\#1669](https://github.com/nlohmann/json/issues/1669) +- Binary \(0x05\) data type for BSON to JSON conversion [\#1668](https://github.com/nlohmann/json/issues/1668) +- Possible to call dump from lldb? [\#1666](https://github.com/nlohmann/json/issues/1666) +- Segmentation fault when linked with libunwind [\#1665](https://github.com/nlohmann/json/issues/1665) +- Should I include single-header after my to\_json and from\_json custom functions declaration? Why not? [\#1663](https://github.com/nlohmann/json/issues/1663) +- Errors/Warnings in VS 2019 when Including Header File [\#1659](https://github.com/nlohmann/json/issues/1659) +- Return null object from object's const operator\[\] as well. [\#1658](https://github.com/nlohmann/json/issues/1658) +- Can't stream json object in to std::basic\_stringstream\ [\#1656](https://github.com/nlohmann/json/issues/1656) +- C2440 in vs2015 cannot convert from 'initializer-list' to nlohmann::basic\_json [\#1655](https://github.com/nlohmann/json/issues/1655) +- Issues around get and pointers [\#1653](https://github.com/nlohmann/json/issues/1653) +- Non-member operator== breaks enum \(de\)serialization [\#1647](https://github.com/nlohmann/json/issues/1647) +- Valgrind: bytes in 1 blocks are definitely lost [\#1646](https://github.com/nlohmann/json/issues/1646) +- Convenient way to make 'basic\_json' accept 'QString' as an key type as well? [\#1640](https://github.com/nlohmann/json/issues/1640) +- mongodb: nan, inf [\#1599](https://github.com/nlohmann/json/issues/1599) +- Error in adl\_serializer [\#1590](https://github.com/nlohmann/json/issues/1590) +- Injecting class during serialization [\#1584](https://github.com/nlohmann/json/issues/1584) +- output\_adapter not user extensible [\#1534](https://github.com/nlohmann/json/issues/1534) +- Inclusion of nlohmann/json.hpp causes OS/ABI to change on Linux [\#1410](https://github.com/nlohmann/json/issues/1410) +- Add library versioning using inline namespaces [\#1394](https://github.com/nlohmann/json/issues/1394) +- CBOR byte string support [\#1129](https://github.com/nlohmann/json/issues/1129) +- How to deserialize array with derived objects [\#716](https://github.com/nlohmann/json/issues/716) + +- Add restriction for tuple specialization of to\_json [\#1826](https://github.com/nlohmann/json/pull/1826) ([cbegue](https://github.com/cbegue)) +- Fix for \#1647 [\#1821](https://github.com/nlohmann/json/pull/1821) ([AnthonyVH](https://github.com/AnthonyVH)) +- Fix issue \#1805 [\#1806](https://github.com/nlohmann/json/pull/1806) ([cbegue](https://github.com/cbegue)) +- Fix some spelling errors - mostly in comments & documentation. [\#1803](https://github.com/nlohmann/json/pull/1803) ([flopp](https://github.com/flopp)) +- Update Hedley to v11. [\#1799](https://github.com/nlohmann/json/pull/1799) ([nemequ](https://github.com/nemequ)) +- iteration\_proxy: Fix integer truncation from std::size\_t to int [\#1797](https://github.com/nlohmann/json/pull/1797) ([t-b](https://github.com/t-b)) +- appveyor.yml: Add MSVC 16 2019 support [\#1780](https://github.com/nlohmann/json/pull/1780) ([t-b](https://github.com/t-b)) +- test/CMakeLists.txt: Use an explicit list instead of GLOB [\#1779](https://github.com/nlohmann/json/pull/1779) ([t-b](https://github.com/t-b)) +- Make json\_pointer::back const \(resolves \#1764\) [\#1769](https://github.com/nlohmann/json/pull/1769) ([chris0x44](https://github.com/chris0x44)) +- did you mean 'serialization'? [\#1767](https://github.com/nlohmann/json/pull/1767) ([0xflotus](https://github.com/0xflotus)) +- Allow items\(\) to be used with custom string [\#1765](https://github.com/nlohmann/json/pull/1765) ([crazyjul](https://github.com/crazyjul)) +- Cppcheck fixes [\#1760](https://github.com/nlohmann/json/pull/1760) ([Xav83](https://github.com/Xav83)) +- Fix and add test's for SFINAE problem [\#1741](https://github.com/nlohmann/json/pull/1741) ([tete17](https://github.com/tete17)) +- Fix clang sanitizer invocation [\#1728](https://github.com/nlohmann/json/pull/1728) ([t-b](https://github.com/t-b)) +- Add gcc 9 and compile with experimental C++20 support [\#1724](https://github.com/nlohmann/json/pull/1724) ([t-b](https://github.com/t-b)) +- Fix int64 min issue [\#1722](https://github.com/nlohmann/json/pull/1722) ([t-b](https://github.com/t-b)) +- release: add singleinclude and meson.build to include.zip [\#1694](https://github.com/nlohmann/json/pull/1694) ([eli-schwartz](https://github.com/eli-schwartz)) + +## [v3.7.0](https://github.com/nlohmann/json/releases/tag/v3.7.0) (2019-07-28) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.6.1...v3.7.0) + +- How can I retrieve uknown strings from json file in my C++ program. [\#1684](https://github.com/nlohmann/json/issues/1684) +- contains\(\) is sometimes causing stack-based buffer overrun exceptions [\#1683](https://github.com/nlohmann/json/issues/1683) +- How to deserialize arrays from json [\#1681](https://github.com/nlohmann/json/issues/1681) +- Compilation failed in VS2015 [\#1678](https://github.com/nlohmann/json/issues/1678) +- Why the compiled object file is so huge? [\#1677](https://github.com/nlohmann/json/issues/1677) +- From Version 2.1.1 to 3.6.1 serialize std::set [\#1676](https://github.com/nlohmann/json/issues/1676) +- Qt deprecation model halting compiltion [\#1675](https://github.com/nlohmann/json/issues/1675) +- Build For Raspberry pi , Rapbery with new Compiler C++17 [\#1671](https://github.com/nlohmann/json/issues/1671) +- Build from Raspberry pi [\#1667](https://github.com/nlohmann/json/issues/1667) +- Can not translate map with integer key to dict string ? [\#1664](https://github.com/nlohmann/json/issues/1664) +- Double type converts to scientific notation [\#1661](https://github.com/nlohmann/json/issues/1661) +- Missing v3.6.1 tag on master branch [\#1657](https://github.com/nlohmann/json/issues/1657) +- Support Fleese Binary Data Format [\#1654](https://github.com/nlohmann/json/issues/1654) +- Suggestion: replace alternative tokens for !, && and || with their symbols [\#1652](https://github.com/nlohmann/json/issues/1652) +- Build failure test-allocator.vcxproj [\#1651](https://github.com/nlohmann/json/issues/1651) +- How to provide function json& to\_json\(\) which is similar as 'void to\_json\(json&j, const CObject& obj\)' ? [\#1650](https://github.com/nlohmann/json/issues/1650) +- Can't throw exception when starting file is a number [\#1649](https://github.com/nlohmann/json/issues/1649) +- to\_json / from\_json with nested type [\#1648](https://github.com/nlohmann/json/issues/1648) +- How to create a json object from a std::string, created by j.dump? [\#1645](https://github.com/nlohmann/json/issues/1645) +- Problem getting vector \(array\) of strings [\#1644](https://github.com/nlohmann/json/issues/1644) +- json.hpp compilation issue with other typedefs with same name [\#1642](https://github.com/nlohmann/json/issues/1642) +- nlohmann::adl\_serializer\::to\_json no matching overloaded function found [\#1641](https://github.com/nlohmann/json/issues/1641) +- overwrite adl\_serializer\ to change behaviour [\#1638](https://github.com/nlohmann/json/issues/1638) +- json.SelectToken\("Manufacturers.Products.Price"\); [\#1637](https://github.com/nlohmann/json/issues/1637) +- Add json type as value [\#1636](https://github.com/nlohmann/json/issues/1636) +- Unit conversion test error: conversion from 'nlohmann::json' to non-scalar type 'std::string\_view' requested [\#1634](https://github.com/nlohmann/json/issues/1634) +- nlohmann VS JsonCpp by C++17 [\#1633](https://github.com/nlohmann/json/issues/1633) +- To integrate an inline helper function that return type name as string [\#1632](https://github.com/nlohmann/json/issues/1632) +- Return JSON as reference [\#1631](https://github.com/nlohmann/json/issues/1631) +- Updating from an older version causes problems with assing a json object to a struct [\#1630](https://github.com/nlohmann/json/issues/1630) +- Can without default constructor function for user defined classes when only to\_json is needed? [\#1629](https://github.com/nlohmann/json/issues/1629) +- Compilation fails with clang 6.x-8.x in C++14 mode [\#1628](https://github.com/nlohmann/json/issues/1628) +- Treating floating point as string [\#1627](https://github.com/nlohmann/json/issues/1627) +- error parsing character å [\#1626](https://github.com/nlohmann/json/issues/1626) +- \[Help\] How to Improve Json Output Performance with Large Json Arrays [\#1624](https://github.com/nlohmann/json/issues/1624) +- Suggested link changes for reporting new issues \[blob/develop/REAME.md and blob/develop/.github/CONTRIBUTING.md\] [\#1623](https://github.com/nlohmann/json/issues/1623) +- Broken link to issue template in CONTRIBUTING.md [\#1622](https://github.com/nlohmann/json/issues/1622) +- Missing word in README.md file [\#1621](https://github.com/nlohmann/json/issues/1621) +- Package manager instructions in README for brew is incorrect [\#1620](https://github.com/nlohmann/json/issues/1620) +- Building with Visual Studio 2019 [\#1619](https://github.com/nlohmann/json/issues/1619) +- Precedence of to\_json and builtin harmful [\#1617](https://github.com/nlohmann/json/issues/1617) +- The type json is missing from the html documentation [\#1616](https://github.com/nlohmann/json/issues/1616) +- variant is not support in Release 3.6.1? [\#1615](https://github.com/nlohmann/json/issues/1615) +- Replace assert with throw for const operator\[\] [\#1614](https://github.com/nlohmann/json/issues/1614) +- Memory Overhead is Too High \(10x or more\) [\#1613](https://github.com/nlohmann/json/issues/1613) +- program crash everytime, when other data type incomming in json stream as expected [\#1612](https://github.com/nlohmann/json/issues/1612) +- Improved Enum Support [\#1611](https://github.com/nlohmann/json/issues/1611) +- is it possible convert json object back to stl container ? [\#1610](https://github.com/nlohmann/json/issues/1610) +- Add C++17-like emplace.back\(\) for arrays. [\#1609](https://github.com/nlohmann/json/issues/1609) +- is\_nothrow\_copy\_constructible fails for json::const\_iterator on MSVC2015 x86 Debug build [\#1608](https://github.com/nlohmann/json/issues/1608) +- Reading and writing array elements [\#1607](https://github.com/nlohmann/json/issues/1607) +- Converting json::value to int [\#1605](https://github.com/nlohmann/json/issues/1605) +- I have a vector of keys and and a string of value and i want to create nested json array [\#1604](https://github.com/nlohmann/json/issues/1604) +- In compatible JSON object from nlohmann::json to nohman::json - unexpected end of input; expected '\[', '{', or a literal [\#1603](https://github.com/nlohmann/json/issues/1603) +- json parser crash if having a large number integer in message [\#1602](https://github.com/nlohmann/json/issues/1602) +- Value method with undocumented throwing 302 exception [\#1601](https://github.com/nlohmann/json/issues/1601) +- Accessing value with json pointer adds key if not existing [\#1600](https://github.com/nlohmann/json/issues/1600) +- README.md broken link to project documentation [\#1597](https://github.com/nlohmann/json/issues/1597) +- Random Kudos: Thanks for your work on this! [\#1596](https://github.com/nlohmann/json/issues/1596) +- json::parse return value and errors [\#1595](https://github.com/nlohmann/json/issues/1595) +- initializer list constructor makes curly brace initialization fragile [\#1594](https://github.com/nlohmann/json/issues/1594) +- trying to log message for missing keyword, difference between \["foo"\] and at\("foo"\) [\#1593](https://github.com/nlohmann/json/issues/1593) +- std::string and std::wstring `to\_json` [\#1592](https://github.com/nlohmann/json/issues/1592) +- I have a C structure which I need to convert to a JSON. How do I do it? Haven't found proper examples so far. [\#1591](https://github.com/nlohmann/json/issues/1591) +- dump\_escaped possible error ? [\#1589](https://github.com/nlohmann/json/issues/1589) +- json::parse\(\) into a vector\ results in unhandled exception [\#1587](https://github.com/nlohmann/json/issues/1587) +- push\_back\(\)/emplace\_back\(\) on array invalidates pointers to existing array items [\#1586](https://github.com/nlohmann/json/issues/1586) +- Getting nlohmann::detail::parse\_error on JSON generated by nlohmann::json not sure why [\#1583](https://github.com/nlohmann/json/issues/1583) +- getting error terminate called after throwing an instance of 'std::domain\_error' what\(\): cannot use at\(\) with string [\#1582](https://github.com/nlohmann/json/issues/1582) +- how i create json file [\#1581](https://github.com/nlohmann/json/issues/1581) +- prevent rounding of double datatype values [\#1580](https://github.com/nlohmann/json/issues/1580) +- Documentation Container Overview Doesn't Reference Const Methods [\#1579](https://github.com/nlohmann/json/issues/1579) +- Writing an array into a nlohmann::json object [\#1578](https://github.com/nlohmann/json/issues/1578) +- compilation error when using with another library [\#1577](https://github.com/nlohmann/json/issues/1577) +- Homebrew on OSX doesn't install cmake config file [\#1576](https://github.com/nlohmann/json/issues/1576) +- JSON Parse Out of Range Error [\#1574](https://github.com/nlohmann/json/issues/1574) +- Integrating into existing CMake Project [\#1573](https://github.com/nlohmann/json/issues/1573) +- conversion to std::string failed [\#1571](https://github.com/nlohmann/json/issues/1571) +- jPtr operation does not throw [\#1569](https://github.com/nlohmann/json/issues/1569) +- How to generate dll file for this project [\#1568](https://github.com/nlohmann/json/issues/1568) +- how to pass variable data to json in c [\#1567](https://github.com/nlohmann/json/issues/1567) +- I want to achieve an upgraded function. [\#1566](https://github.com/nlohmann/json/issues/1566) +- How to determine the type of elements read from a JSON array? [\#1564](https://github.com/nlohmann/json/issues/1564) +- try\_get\_to [\#1563](https://github.com/nlohmann/json/issues/1563) +- example code compile error [\#1562](https://github.com/nlohmann/json/issues/1562) +- How to iterate over nested json object [\#1561](https://github.com/nlohmann/json/issues/1561) +- Build Option/Separate Function to Allow to Throw on Duplicate Keys [\#1560](https://github.com/nlohmann/json/issues/1560) +- Compiler Switches -Weffc++ & -Wshadow are throwing errors [\#1558](https://github.com/nlohmann/json/issues/1558) +- warning: use of the 'nodiscard' attribute is a C++17 extension [\#1557](https://github.com/nlohmann/json/issues/1557) +- Import/Export compressed JSON files [\#1556](https://github.com/nlohmann/json/issues/1556) +- GDB renderers for json library [\#1554](https://github.com/nlohmann/json/issues/1554) +- Is it possible to construct a json string object from a binary buffer? [\#1553](https://github.com/nlohmann/json/issues/1553) +- json objects in list [\#1552](https://github.com/nlohmann/json/issues/1552) +- Matrix output [\#1550](https://github.com/nlohmann/json/issues/1550) +- Using json merge\_patch on ordered non-alphanumeric datasets [\#1549](https://github.com/nlohmann/json/issues/1549) +- Invalid parsed value for big integer [\#1548](https://github.com/nlohmann/json/issues/1548) +- Integrating with android ndk issues. [\#1547](https://github.com/nlohmann/json/issues/1547) +- add noexcept json::value\("key", default\) method variant? [\#1546](https://github.com/nlohmann/json/issues/1546) +- Thank you! 🙌 [\#1545](https://github.com/nlohmann/json/issues/1545) +- Output and input matrix [\#1544](https://github.com/nlohmann/json/issues/1544) +- Add regression tests for MSVC [\#1543](https://github.com/nlohmann/json/issues/1543) +- \[Help Needed!\] Season of Docs [\#1542](https://github.com/nlohmann/json/issues/1542) +- program still abort\(\) or exit\(\) with try catch [\#1541](https://github.com/nlohmann/json/issues/1541) +- Have a json::type\_error exception because of JSON object [\#1540](https://github.com/nlohmann/json/issues/1540) +- Using versioned namespaces [\#1539](https://github.com/nlohmann/json/issues/1539) +- Quoted numbers [\#1538](https://github.com/nlohmann/json/issues/1538) +- Reading a JSON file into an object [\#1537](https://github.com/nlohmann/json/issues/1537) +- Releases 3.6.0 and 3.6.1 don't build on conda / windows [\#1536](https://github.com/nlohmann/json/issues/1536) +- \[Clang\] warning: use of the 'nodiscard' attribute is a C++17 extension \[-Wc++17-extensions\] [\#1535](https://github.com/nlohmann/json/issues/1535) +- wchar\_t/std::wstring json can be created but not accessed [\#1533](https://github.com/nlohmann/json/issues/1533) +- json stringify [\#1532](https://github.com/nlohmann/json/issues/1532) +- How can I use std::string\_view as the json\_key to "operator \[\]" ? [\#1529](https://github.com/nlohmann/json/issues/1529) +- How can I use it from gcc on RPI [\#1528](https://github.com/nlohmann/json/issues/1528) +- std::pair treated as an array instead of key-value in `std::vector\\>` [\#1520](https://github.com/nlohmann/json/issues/1520) +- Excessive Memory Usage for Large Json File [\#1516](https://github.com/nlohmann/json/issues/1516) +- SAX dumper [\#1512](https://github.com/nlohmann/json/issues/1512) +- Conversion to user type containing a std::vector not working with documented approach [\#1511](https://github.com/nlohmann/json/issues/1511) +- How to get position info or parser context with custom from\_json\(\) that may throw exceptions? [\#1508](https://github.com/nlohmann/json/issues/1508) +- Inconsistent use of type alias. [\#1507](https://github.com/nlohmann/json/issues/1507) +- Is there a current way to represent strings as json int? [\#1503](https://github.com/nlohmann/json/issues/1503) +- Intermittent issues with loadJSON [\#1484](https://github.com/nlohmann/json/issues/1484) +- use json construct std::string [\#1462](https://github.com/nlohmann/json/issues/1462) +- JSON Creation [\#1461](https://github.com/nlohmann/json/issues/1461) +- Null bytes in files are treated like EOF [\#1095](https://github.com/nlohmann/json/issues/1095) +- Feature: to\_string\(const json& j\); [\#916](https://github.com/nlohmann/json/issues/916) + +- Use GNUInstallDirs instead of hard-coded path. [\#1673](https://github.com/nlohmann/json/pull/1673) ([ghost](https://github.com/ghost)) +- Package Manager: MSYS2 \(pacman\) [\#1670](https://github.com/nlohmann/json/pull/1670) ([podsvirov](https://github.com/podsvirov)) +- Fix json.hpp compilation issue with other typedefs with same name \(Issue \#1642\) [\#1643](https://github.com/nlohmann/json/pull/1643) ([kevinlul](https://github.com/kevinlul)) +- Add explicit conversion from json to std::string\_view in conversion unit test [\#1639](https://github.com/nlohmann/json/pull/1639) ([taylorhoward92](https://github.com/taylorhoward92)) +- Minor fixes in docs [\#1625](https://github.com/nlohmann/json/pull/1625) ([nickaein](https://github.com/nickaein)) +- Fix broken links to documentation [\#1598](https://github.com/nlohmann/json/pull/1598) ([nickaein](https://github.com/nickaein)) +- Added to\_string and added basic tests [\#1585](https://github.com/nlohmann/json/pull/1585) ([Macr0Nerd](https://github.com/Macr0Nerd)) +- Regression tests for MSVC [\#1570](https://github.com/nlohmann/json/pull/1570) ([nickaein](https://github.com/nickaein)) +- Fix/1511 [\#1555](https://github.com/nlohmann/json/pull/1555) ([theodelrieu](https://github.com/theodelrieu)) +- Remove C++17 extension warning from clang; \#1535 [\#1551](https://github.com/nlohmann/json/pull/1551) ([heavywatal](https://github.com/heavywatal)) +- moved from Catch to doctest for unit tests [\#1439](https://github.com/nlohmann/json/pull/1439) ([onqtam](https://github.com/onqtam)) + +## [v3.6.1](https://github.com/nlohmann/json/releases/tag/v3.6.1) (2019-03-20) + +[Full Changelog](https://github.com/nlohmann/json/compare/3.6.1...v3.6.1) + +## [3.6.1](https://github.com/nlohmann/json/releases/tag/3.6.1) (2019-03-20) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.6.0...3.6.1) + +- Failed to build with \ [\#1531](https://github.com/nlohmann/json/issues/1531) +- Compiling 3.6.0 with GCC \> 7, array vs std::array \#590 is back [\#1530](https://github.com/nlohmann/json/issues/1530) +- 3.6.0: warning: missing initializer for member 'std::array\::\_M\_elems' \[-Wmissing-field-initializers\] [\#1527](https://github.com/nlohmann/json/issues/1527) +- unable to parse json [\#1525](https://github.com/nlohmann/json/issues/1525) + +## [v3.6.0](https://github.com/nlohmann/json/releases/tag/v3.6.0) (2019-03-19) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.5.0...v3.6.0) + +- How can I turn a string of a json array into a json array? [\#1526](https://github.com/nlohmann/json/issues/1526) +- Minor: missing a std:: namespace tag [\#1521](https://github.com/nlohmann/json/issues/1521) +- how to precision to four decimal for double when use to\_json [\#1519](https://github.com/nlohmann/json/issues/1519) +- error parse [\#1518](https://github.com/nlohmann/json/issues/1518) +- Compile error: template argument deduction/substitution failed [\#1515](https://github.com/nlohmann/json/issues/1515) +- std::complex type [\#1510](https://github.com/nlohmann/json/issues/1510) +- CBOR byte string support [\#1509](https://github.com/nlohmann/json/issues/1509) +- Compilation error getting a std::pair\<\> on latest VS 2017 compiler [\#1506](https://github.com/nlohmann/json/issues/1506) +- "Integration" section of documentation needs update? [\#1505](https://github.com/nlohmann/json/issues/1505) +- Json object from string from a TCP socket [\#1504](https://github.com/nlohmann/json/issues/1504) +- MSVC warning C4946 \("reinterpret\_cast used between related classes"\) compiling json.hpp [\#1502](https://github.com/nlohmann/json/issues/1502) +- How to programmatically fill an n-th dimensional JSON object? [\#1501](https://github.com/nlohmann/json/issues/1501) +- Error compiling with clang and `JSON\_NOEXCEPTION`: need to include `cstdlib` [\#1500](https://github.com/nlohmann/json/issues/1500) +- The code compiles unsuccessfully with android-ndk-r10e [\#1499](https://github.com/nlohmann/json/issues/1499) +- Cmake 3.1 in develop, when is it likely to make it into a stable release? [\#1498](https://github.com/nlohmann/json/issues/1498) +- Some Help please object inside array [\#1494](https://github.com/nlohmann/json/issues/1494) +- How to get data into vector of user-defined type from a Json object [\#1493](https://github.com/nlohmann/json/issues/1493) +- how to find subelement without loop [\#1490](https://github.com/nlohmann/json/issues/1490) +- json to std::map [\#1487](https://github.com/nlohmann/json/issues/1487) +- Type in README.md [\#1486](https://github.com/nlohmann/json/issues/1486) +- Error in parsing and reading msgpack-lite [\#1485](https://github.com/nlohmann/json/issues/1485) +- Compiling issues with libc 2.12 [\#1483](https://github.com/nlohmann/json/issues/1483) +- How do I use reference or pointer binding values? [\#1482](https://github.com/nlohmann/json/issues/1482) +- Compilation fails in MSVC with the Microsoft Language Extensions disabled [\#1481](https://github.com/nlohmann/json/issues/1481) +- Functional visit [\#1480](https://github.com/nlohmann/json/issues/1480) +- \[Question\] Unescaped dump [\#1479](https://github.com/nlohmann/json/issues/1479) +- Some Help please [\#1478](https://github.com/nlohmann/json/issues/1478) +- Global variables are stored within the JSON file, how do I declare them as global variables when I read them out in my C++ program? [\#1476](https://github.com/nlohmann/json/issues/1476) +- Unable to modify one of the values within the JSON file, and save it [\#1475](https://github.com/nlohmann/json/issues/1475) +- Documentation of parse function has two identical @pre causes [\#1473](https://github.com/nlohmann/json/issues/1473) +- GCC 9.0 build failure [\#1472](https://github.com/nlohmann/json/issues/1472) +- Can we have an `exists\(\)` method? [\#1471](https://github.com/nlohmann/json/issues/1471) +- How to parse multi object json from file? [\#1470](https://github.com/nlohmann/json/issues/1470) +- How to returns the name of the upper object? [\#1467](https://github.com/nlohmann/json/issues/1467) +- Error: "tuple\_size" has already been declared in the current scope [\#1466](https://github.com/nlohmann/json/issues/1466) +- Checking keys of two jsons against eachother [\#1465](https://github.com/nlohmann/json/issues/1465) +- Disable installation when used as meson subproject [\#1463](https://github.com/nlohmann/json/issues/1463) +- Unpack list of integers to a std::vector\ [\#1460](https://github.com/nlohmann/json/issues/1460) +- Implement DRY definition of JSON representation of a c++ class [\#1459](https://github.com/nlohmann/json/issues/1459) +- json.exception.type\_error.305 with GCC 4.9 when using C++ {} initializer [\#1458](https://github.com/nlohmann/json/issues/1458) +- API to convert an "uninitialized" json into an empty object or empty array [\#1456](https://github.com/nlohmann/json/issues/1456) +- How to parse a vector of objects with const attributes [\#1453](https://github.com/nlohmann/json/issues/1453) +- NLOHMANN\_JSON\_SERIALIZE\_ENUM potentially requires duplicate definitions [\#1450](https://github.com/nlohmann/json/issues/1450) +- Question about making json object from file directory [\#1449](https://github.com/nlohmann/json/issues/1449) +- .get\(\) throws error if used with userdefined structs in unordered\_map [\#1448](https://github.com/nlohmann/json/issues/1448) +- Integer Overflow \(OSS-Fuzz 12506\) [\#1447](https://github.com/nlohmann/json/issues/1447) +- If a string has too many invalid UTF-8 characters, json::dump attempts to index an array out of bounds. [\#1445](https://github.com/nlohmann/json/issues/1445) +- Setting values of .JSON file [\#1444](https://github.com/nlohmann/json/issues/1444) +- alias object\_t::key\_type in basic\_json [\#1442](https://github.com/nlohmann/json/issues/1442) +- Latest Ubuntu package is 2.1.1 [\#1438](https://github.com/nlohmann/json/issues/1438) +- lexer.hpp\(1363\) '\_snprintf': is not a member | Visualstudio 2017 [\#1437](https://github.com/nlohmann/json/issues/1437) +- Static method invites inadvertent logic error. [\#1433](https://github.com/nlohmann/json/issues/1433) +- EOS compilation produces "fatal error: 'nlohmann/json.hpp' file not found" [\#1432](https://github.com/nlohmann/json/issues/1432) +- Support for bad commas [\#1429](https://github.com/nlohmann/json/issues/1429) +- Please have one base exception class for all json exceptions [\#1427](https://github.com/nlohmann/json/issues/1427) +- Compilation warning: 'tuple\_size' defined as a class template here but previously declared as a struct template [\#1426](https://github.com/nlohmann/json/issues/1426) +- Which version can be used with GCC 4.8.2 ? [\#1424](https://github.com/nlohmann/json/issues/1424) +- Ignore nullptr values on constructing json object from a container [\#1422](https://github.com/nlohmann/json/issues/1422) +- Support for custom float precision via unquoted strings [\#1421](https://github.com/nlohmann/json/issues/1421) +- It is possible to call `json::find` with a json\_pointer as argument. This causes runtime UB/crash. [\#1418](https://github.com/nlohmann/json/issues/1418) +- Dump throwing exception [\#1416](https://github.com/nlohmann/json/issues/1416) +- Build error [\#1415](https://github.com/nlohmann/json/issues/1415) +- Append version to include.zip [\#1412](https://github.com/nlohmann/json/issues/1412) +- error C2039: '\_snprintf': is not a member of 'std' - Windows [\#1408](https://github.com/nlohmann/json/issues/1408) +- Deserializing to vector [\#1407](https://github.com/nlohmann/json/issues/1407) +- Efficient way to set a `json` object as value into another `json` key [\#1406](https://github.com/nlohmann/json/issues/1406) +- Document return value of parse\(\) when allow\_exceptions == false and parsing fails [\#1405](https://github.com/nlohmann/json/issues/1405) +- Unexpected behaviour with structured binding [\#1404](https://github.com/nlohmann/json/issues/1404) +- Which native types does get\\(\) allow? [\#1403](https://github.com/nlohmann/json/issues/1403) +- Add something like Json::StaticString [\#1402](https://github.com/nlohmann/json/issues/1402) +- -Wmismatched-tags in 3.5.0? [\#1401](https://github.com/nlohmann/json/issues/1401) +- Coverity Scan reports an UNCAUGHT\_EXCEPT issue [\#1400](https://github.com/nlohmann/json/issues/1400) +- fff [\#1399](https://github.com/nlohmann/json/issues/1399) +- sorry this is not an issue, just a Question, How to change a key value in a file and save it ? [\#1398](https://github.com/nlohmann/json/issues/1398) +- appveyor x64 builds appear to be using Win32 toolset [\#1374](https://github.com/nlohmann/json/issues/1374) +- Serializing/Deserializing a Class containing a vector of itself [\#1373](https://github.com/nlohmann/json/issues/1373) +- Retrieving array elements. [\#1369](https://github.com/nlohmann/json/issues/1369) +- Deserialize [\#1366](https://github.com/nlohmann/json/issues/1366) +- call of overloaded for push\_back and operator+= is ambiguous [\#1352](https://github.com/nlohmann/json/issues/1352) +- got an error and cann't figure it out [\#1351](https://github.com/nlohmann/json/issues/1351) +- Improve number-to-string conversion [\#1334](https://github.com/nlohmann/json/issues/1334) +- Implicit type conversion error on MSVC [\#1333](https://github.com/nlohmann/json/issues/1333) +- NuGet Package [\#1132](https://github.com/nlohmann/json/issues/1132) + +- Change macros to numeric\_limits [\#1514](https://github.com/nlohmann/json/pull/1514) ([naszta](https://github.com/naszta)) +- fix GCC 7.1.1 - 7.2.1 on CentOS [\#1496](https://github.com/nlohmann/json/pull/1496) ([lieff](https://github.com/lieff)) +- Update Buckaroo instructions in README.md [\#1495](https://github.com/nlohmann/json/pull/1495) ([njlr](https://github.com/njlr)) +- Fix gcc9 build error test/src/unit-allocator.cpp \(Issue \#1472\) [\#1492](https://github.com/nlohmann/json/pull/1492) ([stac47](https://github.com/stac47)) +- Fix typo in README.md [\#1491](https://github.com/nlohmann/json/pull/1491) ([nickaein](https://github.com/nickaein)) +- Do proper endian conversions [\#1489](https://github.com/nlohmann/json/pull/1489) ([andreas-schwab](https://github.com/andreas-schwab)) +- Fix documentation [\#1477](https://github.com/nlohmann/json/pull/1477) ([nickaein](https://github.com/nickaein)) +- Implement contains\(\) member function [\#1474](https://github.com/nlohmann/json/pull/1474) ([nickaein](https://github.com/nickaein)) +- Add operator/= and operator/ to construct a JSON pointer by appending two JSON pointers [\#1469](https://github.com/nlohmann/json/pull/1469) ([garethsb-sony](https://github.com/garethsb-sony)) +- Disable Clang -Wmismatched-tags warning on tuple\_size / tuple\_element [\#1468](https://github.com/nlohmann/json/pull/1468) ([past-due](https://github.com/past-due)) +- Disable installation when used as meson subproject. \#1463 [\#1464](https://github.com/nlohmann/json/pull/1464) ([elvisoric](https://github.com/elvisoric)) +- docs: README typo [\#1455](https://github.com/nlohmann/json/pull/1455) ([wythe](https://github.com/wythe)) +- remove extra semicolon from readme [\#1451](https://github.com/nlohmann/json/pull/1451) ([Afforix](https://github.com/Afforix)) +- attempt to fix \#1445, flush buffer in serializer::dump\_escaped in UTF8\_REJECT case. [\#1446](https://github.com/nlohmann/json/pull/1446) ([scinart](https://github.com/scinart)) +- Use C++11 features supported by CMake 3.1. [\#1441](https://github.com/nlohmann/json/pull/1441) ([iwanders](https://github.com/iwanders)) +- :rotating\_light: fixed unused variable warning [\#1435](https://github.com/nlohmann/json/pull/1435) ([pboettch](https://github.com/pboettch)) +- allow push\_back\(\) and pop\_back\(\) calls on json\_pointer [\#1434](https://github.com/nlohmann/json/pull/1434) ([pboettch](https://github.com/pboettch)) +- Add instructions about using nlohmann/json with the conda package manager [\#1430](https://github.com/nlohmann/json/pull/1430) ([nicoddemus](https://github.com/nicoddemus)) +- Updated year in README.md [\#1425](https://github.com/nlohmann/json/pull/1425) ([jef](https://github.com/jef)) +- Fixed broken links in the README file [\#1423](https://github.com/nlohmann/json/pull/1423) ([skypjack](https://github.com/skypjack)) +- Fixed broken links in the README file [\#1420](https://github.com/nlohmann/json/pull/1420) ([skypjack](https://github.com/skypjack)) +- docs: typo in README [\#1417](https://github.com/nlohmann/json/pull/1417) ([wythe](https://github.com/wythe)) +- Fix x64 target platform for appveyor [\#1414](https://github.com/nlohmann/json/pull/1414) ([nickaein](https://github.com/nickaein)) +- Improve dump\_integer performance [\#1411](https://github.com/nlohmann/json/pull/1411) ([nickaein](https://github.com/nickaein)) +- buildsystem: relax requirement on cmake version [\#1409](https://github.com/nlohmann/json/pull/1409) ([yann-morin-1998](https://github.com/yann-morin-1998)) +- Added Support for Structured Bindings [\#1391](https://github.com/nlohmann/json/pull/1391) ([pratikpc](https://github.com/pratikpc)) +- CMake: Optional Install if Embedded [\#1330](https://github.com/nlohmann/json/pull/1330) ([ax3l](https://github.com/ax3l)) + +## [v3.5.0](https://github.com/nlohmann/json/releases/tag/v3.5.0) (2018-12-21) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.4.0...v3.5.0) + +- Copyconstructor inserts original into array with single element [\#1397](https://github.com/nlohmann/json/issues/1397) +- Get value without explicit typecasting [\#1395](https://github.com/nlohmann/json/issues/1395) +- Big file parsing [\#1393](https://github.com/nlohmann/json/issues/1393) +- some static analysis warning at line 11317 [\#1390](https://github.com/nlohmann/json/issues/1390) +- Adding Structured Binding Support [\#1388](https://github.com/nlohmann/json/issues/1388) +- map\ exhibits unexpected behavior [\#1387](https://github.com/nlohmann/json/issues/1387) +- Error Code Return [\#1386](https://github.com/nlohmann/json/issues/1386) +- using unordered\_map as object type [\#1385](https://github.com/nlohmann/json/issues/1385) +- float precision [\#1384](https://github.com/nlohmann/json/issues/1384) +- \[json.exception.type\_error.316\] invalid UTF-8 byte at index 1: 0xC3 [\#1383](https://github.com/nlohmann/json/issues/1383) +- Inconsistent Constructor \(GCC vs. Clang\) [\#1381](https://github.com/nlohmann/json/issues/1381) +- \#define or || [\#1379](https://github.com/nlohmann/json/issues/1379) +- How to iterate inside the values ? [\#1377](https://github.com/nlohmann/json/issues/1377) +- items\(\) unable to get the elements [\#1375](https://github.com/nlohmann/json/issues/1375) +- conversion json to std::map doesn't work for types \ [\#1372](https://github.com/nlohmann/json/issues/1372) +- A minor issue in the build instructions [\#1371](https://github.com/nlohmann/json/issues/1371) +- Using this library without stream ? [\#1370](https://github.com/nlohmann/json/issues/1370) +- Writing and reading BSON data [\#1368](https://github.com/nlohmann/json/issues/1368) +- Retrieving array elements from object type iterator. [\#1367](https://github.com/nlohmann/json/issues/1367) +- json::dump\(\) silently crashes if items contain accented letters [\#1365](https://github.com/nlohmann/json/issues/1365) +- warnings in MSVC \(2015\) in 3.4.0 related to bool... [\#1364](https://github.com/nlohmann/json/issues/1364) +- Cant compile with -C++17 and beyond compiler options [\#1362](https://github.com/nlohmann/json/issues/1362) +- json to concrete type conversion through reference or pointer fails [\#1361](https://github.com/nlohmann/json/issues/1361) +- the first attributes of JSON string is misplaced [\#1360](https://github.com/nlohmann/json/issues/1360) +- Copy-construct using initializer-list converts objects to arrays [\#1359](https://github.com/nlohmann/json/issues/1359) +- About value\(key, default\_value\) and operator\[\]\(key\) [\#1358](https://github.com/nlohmann/json/issues/1358) +- Problem with printing json response object [\#1356](https://github.com/nlohmann/json/issues/1356) +- Serializing pointer segfaults [\#1355](https://github.com/nlohmann/json/issues/1355) +- Read `long long int` data as a number. [\#1354](https://github.com/nlohmann/json/issues/1354) +- eclipse oxygen in ubuntu get\ is ambiguous [\#1353](https://github.com/nlohmann/json/issues/1353) +- Can't build on Visual Studio 2017 v15.8.9 [\#1350](https://github.com/nlohmann/json/issues/1350) +- cannot parse from string? [\#1349](https://github.com/nlohmann/json/issues/1349) +- Error: out\_of\_range [\#1348](https://github.com/nlohmann/json/issues/1348) +- expansion pattern 'CompatibleObjectType' contains no argument packs, with CUDA 10 [\#1347](https://github.com/nlohmann/json/issues/1347) +- Unable to update a value for a nested\(multi-level\) json file [\#1344](https://github.com/nlohmann/json/issues/1344) +- Fails to compile when std::iterator\_traits is not SFINAE friendly. [\#1341](https://github.com/nlohmann/json/issues/1341) +- EOF flag not set on exhausted input streams. [\#1340](https://github.com/nlohmann/json/issues/1340) +- Shadowed Member in merge\_patch [\#1339](https://github.com/nlohmann/json/issues/1339) +- Periods/literal dots in keys? [\#1338](https://github.com/nlohmann/json/issues/1338) +- Protect macro expansion of commonly defined macros [\#1337](https://github.com/nlohmann/json/issues/1337) +- How to validate an input before parsing? [\#1336](https://github.com/nlohmann/json/issues/1336) +- Non-verifying dump\(\) alternative for debugging/logging needed [\#1335](https://github.com/nlohmann/json/issues/1335) +- Json Libarary is not responding for me in c++ [\#1332](https://github.com/nlohmann/json/issues/1332) +- Question - how to find an object in an array [\#1331](https://github.com/nlohmann/json/issues/1331) +- Nesting additional data in json object [\#1328](https://github.com/nlohmann/json/issues/1328) +- can to\_json\(\) be defined inside a class? [\#1324](https://github.com/nlohmann/json/issues/1324) +- CodeBlocks IDE can't find `json.hpp` header [\#1318](https://github.com/nlohmann/json/issues/1318) +- Change json\_pointer to provide an iterator begin/end/etc, don't use vectors, and also enable string\_view [\#1312](https://github.com/nlohmann/json/issues/1312) +- Xcode - adding it to library [\#1300](https://github.com/nlohmann/json/issues/1300) +- unicode: accept char16\_t, char32\_t sequences [\#1298](https://github.com/nlohmann/json/issues/1298) +- unicode: char16\_t\* is compiler error, but char16\_t\[\] is accepted [\#1297](https://github.com/nlohmann/json/issues/1297) +- Dockerfile Project Help Needed [\#1296](https://github.com/nlohmann/json/issues/1296) +- Comparisons between large unsigned and negative signed integers [\#1295](https://github.com/nlohmann/json/issues/1295) +- CMake alias to `nlohmann::json` [\#1291](https://github.com/nlohmann/json/issues/1291) +- Release zips without tests [\#1285](https://github.com/nlohmann/json/issues/1285) +- separate object\_t::key\_type from basic\_json::key\_type, and use an allocator which returns object\_t::key\_type [\#1274](https://github.com/nlohmann/json/issues/1274) +- Is there a nice way to associate external values with json elements? [\#1256](https://github.com/nlohmann/json/issues/1256) +- Delete by json\_pointer [\#1248](https://github.com/nlohmann/json/issues/1248) +- Expose lexer, as a StAX parser [\#1219](https://github.com/nlohmann/json/issues/1219) +- Subclassing json\(\) & error on recursive load [\#1201](https://github.com/nlohmann/json/issues/1201) +- Check value for existence by json\_pointer [\#1194](https://github.com/nlohmann/json/issues/1194) + +- Feature/add file input adapter [\#1392](https://github.com/nlohmann/json/pull/1392) ([dumarjo](https://github.com/dumarjo)) +- Link to issue \#958 broken [\#1382](https://github.com/nlohmann/json/pull/1382) ([kjpus](https://github.com/kjpus)) +- readme: fix typo [\#1380](https://github.com/nlohmann/json/pull/1380) ([manu-chroma](https://github.com/manu-chroma)) +- recommend using explicit from JSON conversions [\#1363](https://github.com/nlohmann/json/pull/1363) ([theodelrieu](https://github.com/theodelrieu)) +- Fix merge\_patch shadow warning [\#1346](https://github.com/nlohmann/json/pull/1346) ([ax3l](https://github.com/ax3l)) +- Allow installation via Meson [\#1345](https://github.com/nlohmann/json/pull/1345) ([mpoquet](https://github.com/mpoquet)) +- Set eofbit on exhausted input stream. [\#1343](https://github.com/nlohmann/json/pull/1343) ([mefyl](https://github.com/mefyl)) +- Add a SFINAE friendly iterator\_traits and use that instead. [\#1342](https://github.com/nlohmann/json/pull/1342) ([dgavedissian](https://github.com/dgavedissian)) +- Fix EOL Whitespaces & CMake Spelling [\#1329](https://github.com/nlohmann/json/pull/1329) ([ax3l](https://github.com/ax3l)) +- Add BSON support [\#1320](https://github.com/nlohmann/json/pull/1320) ([nlohmann](https://github.com/nlohmann)) + +## [v3.4.0](https://github.com/nlohmann/json/releases/tag/v3.4.0) (2018-10-30) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.3.0...v3.4.0) + +- Big uint64\_t values are serialized wrong [\#1327](https://github.com/nlohmann/json/issues/1327) +- \[Question\] Efficient check for equivalency? [\#1325](https://github.com/nlohmann/json/issues/1325) +- Can't use ifstream and .clear\(\) [\#1321](https://github.com/nlohmann/json/issues/1321) +- \[Warning\] -Wparentheses on line 555 on single\_include [\#1319](https://github.com/nlohmann/json/issues/1319) +- Compilation error using at and find with enum struct [\#1316](https://github.com/nlohmann/json/issues/1316) +- Parsing JSON from a web address [\#1311](https://github.com/nlohmann/json/issues/1311) +- How to convert JSON to Struct with embeded subject [\#1310](https://github.com/nlohmann/json/issues/1310) +- Null safety/coalescing function? [\#1309](https://github.com/nlohmann/json/issues/1309) +- Building fails using single include file: json.hpp [\#1308](https://github.com/nlohmann/json/issues/1308) +- json::parse\(std::string\) Exception inside packaged Lib [\#1306](https://github.com/nlohmann/json/issues/1306) +- Problem in Dockerfile with installation of library [\#1304](https://github.com/nlohmann/json/issues/1304) +- compile error in from\_json converting to container with std::pair [\#1299](https://github.com/nlohmann/json/issues/1299) +- Json that I am trying to parse, and I am lost Structure Array below top level [\#1293](https://github.com/nlohmann/json/issues/1293) +- Serializing std::variant causes stack overflow [\#1292](https://github.com/nlohmann/json/issues/1292) +- How do I go about customising from\_json to support \_\_int128\_t/\_\_uint128\_t? [\#1290](https://github.com/nlohmann/json/issues/1290) +- merge\_patch: inconsistent behaviour merging empty sub-object [\#1289](https://github.com/nlohmann/json/issues/1289) +- Buffer over/underrun using UBJson? [\#1288](https://github.com/nlohmann/json/issues/1288) +- Enable the latest C++ standard with Visual Studio [\#1287](https://github.com/nlohmann/json/issues/1287) +- truncation of constant value in to\_cbor\(\) [\#1286](https://github.com/nlohmann/json/issues/1286) +- eosio.wasmsdk error [\#1284](https://github.com/nlohmann/json/issues/1284) +- use the same interface for writing arrays and non-arrays [\#1283](https://github.com/nlohmann/json/issues/1283) +- How to read json file with optional entries and entries with different types [\#1281](https://github.com/nlohmann/json/issues/1281) +- merge result not as espected [\#1279](https://github.com/nlohmann/json/issues/1279) +- how to get only "name" from below json [\#1278](https://github.com/nlohmann/json/issues/1278) +- syntax error on right json string [\#1276](https://github.com/nlohmann/json/issues/1276) +- Parsing JSON Array where members have no key, using custom types [\#1267](https://github.com/nlohmann/json/issues/1267) +- I get a json exception periodically from json::parse for the same json [\#1263](https://github.com/nlohmann/json/issues/1263) +- serialize std::variant\<...\> [\#1261](https://github.com/nlohmann/json/issues/1261) +- GCC 8.2.1. Compilation error: invalid conversion from... [\#1246](https://github.com/nlohmann/json/issues/1246) +- BSON support [\#1244](https://github.com/nlohmann/json/issues/1244) +- enum to json mapping [\#1208](https://github.com/nlohmann/json/issues/1208) +- Soften the landing when dumping non-UTF8 strings \(type\_error.316 exception\) [\#1198](https://github.com/nlohmann/json/issues/1198) + +- Add macro to define enum/JSON mapping [\#1323](https://github.com/nlohmann/json/pull/1323) ([nlohmann](https://github.com/nlohmann)) +- Properly convert constants to CharType [\#1315](https://github.com/nlohmann/json/pull/1315) ([nlohmann](https://github.com/nlohmann)) +- Allow to set error handler for decoding errors [\#1314](https://github.com/nlohmann/json/pull/1314) ([nlohmann](https://github.com/nlohmann)) +- Add Meson related info to README [\#1305](https://github.com/nlohmann/json/pull/1305) ([koponomarenko](https://github.com/koponomarenko)) +- Improve diagnostic messages for binary formats [\#1303](https://github.com/nlohmann/json/pull/1303) ([nlohmann](https://github.com/nlohmann)) +- add new is\_constructible\_\* traits used in from\_json [\#1301](https://github.com/nlohmann/json/pull/1301) ([theodelrieu](https://github.com/theodelrieu)) +- add constraints for variadic json\_ref constructors [\#1294](https://github.com/nlohmann/json/pull/1294) ([theodelrieu](https://github.com/theodelrieu)) +- Improve diagnostic messages [\#1282](https://github.com/nlohmann/json/pull/1282) ([nlohmann](https://github.com/nlohmann)) +- Removed linter warnings [\#1280](https://github.com/nlohmann/json/pull/1280) ([nlohmann](https://github.com/nlohmann)) +- Thirdparty benchmark: Fix Clang detection. [\#1277](https://github.com/nlohmann/json/pull/1277) ([Lord-Kamina](https://github.com/Lord-Kamina)) + +## [v3.3.0](https://github.com/nlohmann/json/releases/tag/v3.3.0) (2018-10-05) + +[Full Changelog](https://github.com/nlohmann/json/compare/3.3.0...v3.3.0) + +## [3.3.0](https://github.com/nlohmann/json/releases/tag/3.3.0) (2018-10-05) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.2.0...3.3.0) + +- When key is not found print the key name into error too [\#1273](https://github.com/nlohmann/json/issues/1273) +- Visual Studio 2017 15.8.5 "conditional expression is constant" warning on Line 1851 in json.hpp [\#1268](https://github.com/nlohmann/json/issues/1268) +- how can we get this working on WSL? [\#1264](https://github.com/nlohmann/json/issues/1264) +- Help needed [\#1259](https://github.com/nlohmann/json/issues/1259) +- A way to get to a JSON values "key" [\#1258](https://github.com/nlohmann/json/issues/1258) +- While compiling got 76 errors [\#1255](https://github.com/nlohmann/json/issues/1255) +- Two blackslashes on json output file [\#1253](https://github.com/nlohmann/json/issues/1253) +- Including nlohmann the badwrong way. [\#1250](https://github.com/nlohmann/json/issues/1250) +- how to build with clang? [\#1247](https://github.com/nlohmann/json/issues/1247) +- Cmake target\_link\_libraries unable to find nlohmann\_json since version 3.2.0 [\#1243](https://github.com/nlohmann/json/issues/1243) +- \[Question\] Access to end\(\) iterator reference [\#1242](https://github.com/nlohmann/json/issues/1242) +- Parsing different json format [\#1241](https://github.com/nlohmann/json/issues/1241) +- Parsing Multiple JSON Files [\#1240](https://github.com/nlohmann/json/issues/1240) +- Doesn't compile under C++17 [\#1239](https://github.com/nlohmann/json/issues/1239) +- Conversion operator for nlohmann::json is not SFINAE friendly [\#1237](https://github.com/nlohmann/json/issues/1237) +- Custom deserialization of number\_float\_t [\#1236](https://github.com/nlohmann/json/issues/1236) +- deprecated-declarations warnings when compiling tests with GCC 8.2.1. [\#1233](https://github.com/nlohmann/json/issues/1233) +- Incomplete type with json\_fwd.hpp [\#1232](https://github.com/nlohmann/json/issues/1232) +- Parse Error [\#1229](https://github.com/nlohmann/json/issues/1229) +- json::get function with argument [\#1227](https://github.com/nlohmann/json/issues/1227) +- questions regarding from\_json [\#1226](https://github.com/nlohmann/json/issues/1226) +- Lambda in unevaluated context [\#1225](https://github.com/nlohmann/json/issues/1225) +- NLohmann doesn't compile when enabling strict warning policies [\#1224](https://github.com/nlohmann/json/issues/1224) +- Creating array of objects [\#1223](https://github.com/nlohmann/json/issues/1223) +- Somewhat unhelpful error message "cannot use operator\[\] with object" [\#1220](https://github.com/nlohmann/json/issues/1220) +- single\_include json.hpp [\#1218](https://github.com/nlohmann/json/issues/1218) +- Maps with enum class keys which are convertible to JSON strings should be converted to JSON dictionaries [\#1217](https://github.com/nlohmann/json/issues/1217) +- Adding JSON Array to the Array [\#1216](https://github.com/nlohmann/json/issues/1216) +- Best way to output a vector of a given type to json [\#1215](https://github.com/nlohmann/json/issues/1215) +- compiler warning: double definition of macro JSON\_INTERNAL\_CATCH [\#1213](https://github.com/nlohmann/json/issues/1213) +- Compilation error when using MOCK\_METHOD1 from GMock and nlohmann::json [\#1212](https://github.com/nlohmann/json/issues/1212) +- Issues parsing a previously encoded binary \(non-UTF8\) string. [\#1211](https://github.com/nlohmann/json/issues/1211) +- Yet another ordering question: char \* and parse\(\) [\#1209](https://github.com/nlohmann/json/issues/1209) +- Error using gcc 8.1.0 on Ubuntu 14.04 [\#1207](https://github.com/nlohmann/json/issues/1207) +- "type must be string, but is " std::string\(j.type\_name\(\) [\#1206](https://github.com/nlohmann/json/issues/1206) +- Returning empty json object from a function of type const json& ? [\#1205](https://github.com/nlohmann/json/issues/1205) +- VS2017 compiler suggests using constexpr if [\#1204](https://github.com/nlohmann/json/issues/1204) +- Template instatiation error on compiling [\#1203](https://github.com/nlohmann/json/issues/1203) +- BUG - json dump field with unicode -\> array of ints \(instead of string\) [\#1197](https://github.com/nlohmann/json/issues/1197) +- Compile error using Code::Blocks // mingw-w64 GCC 8.1.0 - "Incomplete Type" [\#1193](https://github.com/nlohmann/json/issues/1193) +- SEGFAULT on arm target [\#1190](https://github.com/nlohmann/json/issues/1190) +- Compiler crash with old Clang [\#1179](https://github.com/nlohmann/json/issues/1179) +- Custom Precision on floating point numbers [\#1170](https://github.com/nlohmann/json/issues/1170) +- Can we have a json\_view class like std::string\_view? [\#1158](https://github.com/nlohmann/json/issues/1158) +- improve error handling [\#1152](https://github.com/nlohmann/json/issues/1152) +- We should remove static\_asserts [\#960](https://github.com/nlohmann/json/issues/960) + +- Fix warning C4127: conditional expression is constant [\#1272](https://github.com/nlohmann/json/pull/1272) ([antonioborondo](https://github.com/antonioborondo)) +- Turn off additional deprecation warnings for GCC. [\#1271](https://github.com/nlohmann/json/pull/1271) ([chuckatkins](https://github.com/chuckatkins)) +- docs: Add additional CMake documentation [\#1270](https://github.com/nlohmann/json/pull/1270) ([chuckatkins](https://github.com/chuckatkins)) +- unit-testsuites.cpp: fix hangup if file not found [\#1262](https://github.com/nlohmann/json/pull/1262) ([knilch0r](https://github.com/knilch0r)) +- Fix broken cmake imported target alias [\#1260](https://github.com/nlohmann/json/pull/1260) ([chuckatkins](https://github.com/chuckatkins)) +- GCC 48 [\#1257](https://github.com/nlohmann/json/pull/1257) ([henryiii](https://github.com/henryiii)) +- Add version and license to meson.build [\#1252](https://github.com/nlohmann/json/pull/1252) ([koponomarenko](https://github.com/koponomarenko)) +- \#1179 Reordered the code. It seems to stop clang 3.4.2 in RHEL 7 from crash… [\#1249](https://github.com/nlohmann/json/pull/1249) ([LEgregius](https://github.com/LEgregius)) +- Use a version check to provide backwards comatible CMake imported target names [\#1245](https://github.com/nlohmann/json/pull/1245) ([chuckatkins](https://github.com/chuckatkins)) +- Fix issue \#1237 [\#1238](https://github.com/nlohmann/json/pull/1238) ([theodelrieu](https://github.com/theodelrieu)) +- Add a get overload taking a parameter. [\#1231](https://github.com/nlohmann/json/pull/1231) ([theodelrieu](https://github.com/theodelrieu)) +- Move lambda out of unevaluated context [\#1230](https://github.com/nlohmann/json/pull/1230) ([mandreyel](https://github.com/mandreyel)) +- Remove static asserts [\#1228](https://github.com/nlohmann/json/pull/1228) ([theodelrieu](https://github.com/theodelrieu)) +- Better error 305 [\#1221](https://github.com/nlohmann/json/pull/1221) ([rivertam](https://github.com/rivertam)) +- Fix \#1213 [\#1214](https://github.com/nlohmann/json/pull/1214) ([simnalamburt](https://github.com/simnalamburt)) +- Export package to allow builds without installing [\#1202](https://github.com/nlohmann/json/pull/1202) ([dennisfischer](https://github.com/dennisfischer)) + +## [v3.2.0](https://github.com/nlohmann/json/releases/tag/v3.2.0) (2018-08-20) + +[Full Changelog](https://github.com/nlohmann/json/compare/3.2.0...v3.2.0) + +## [3.2.0](https://github.com/nlohmann/json/releases/tag/3.2.0) (2018-08-20) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.1.2...3.2.0) + +- Am I doing this wrong? Getting an empty string [\#1199](https://github.com/nlohmann/json/issues/1199) +- Incompatible Pointer Type [\#1196](https://github.com/nlohmann/json/issues/1196) +- json.exception.type\_error.316 [\#1195](https://github.com/nlohmann/json/issues/1195) +- Strange warnings in Code::Blocks 17.12, GNU GCC [\#1192](https://github.com/nlohmann/json/issues/1192) +- \[Question\] Current place in code to change floating point resolution [\#1191](https://github.com/nlohmann/json/issues/1191) +- Add key name when throwing type error [\#1189](https://github.com/nlohmann/json/issues/1189) +- Not able to include in visual studio code? [\#1188](https://github.com/nlohmann/json/issues/1188) +- Get an Index or row number of an element [\#1186](https://github.com/nlohmann/json/issues/1186) +- Difference between `merge\_patch` and `update` [\#1183](https://github.com/nlohmann/json/issues/1183) +- Is there a way to get an element from a JSON without throwing an exception on failure? [\#1182](https://github.com/nlohmann/json/issues/1182) +- to\_string? [\#1181](https://github.com/nlohmann/json/issues/1181) +- How to cache a json object's pointer into a map? [\#1180](https://github.com/nlohmann/json/issues/1180) +- Can this library work within a Qt project for Android using Qt Creator? [\#1178](https://github.com/nlohmann/json/issues/1178) +- How to get all keys of one object? [\#1177](https://github.com/nlohmann/json/issues/1177) +- How can I only parse the first level and get the value as string? [\#1175](https://github.com/nlohmann/json/issues/1175) +- I have a query regarding nlohmann::basic\_json::basic\_json [\#1174](https://github.com/nlohmann/json/issues/1174) +- unordered\_map with vectors won't convert to json? [\#1173](https://github.com/nlohmann/json/issues/1173) +- return json objects from functions [\#1172](https://github.com/nlohmann/json/issues/1172) +- Problem when exporting to CBOR [\#1171](https://github.com/nlohmann/json/issues/1171) +- Roundtripping null to nullptr does not work [\#1169](https://github.com/nlohmann/json/issues/1169) +- MSVC fails to compile std::swap specialization for nlohmann::json [\#1168](https://github.com/nlohmann/json/issues/1168) +- Unexpected behaviour of is\_null - Part II [\#1167](https://github.com/nlohmann/json/issues/1167) +- Floating point imprecision [\#1166](https://github.com/nlohmann/json/issues/1166) +- Combine json objects into one? [\#1165](https://github.com/nlohmann/json/issues/1165) +- Is there any way to know if the object has changed? [\#1164](https://github.com/nlohmann/json/issues/1164) +- Value throws on null string [\#1163](https://github.com/nlohmann/json/issues/1163) +- Weird template issue in large project [\#1162](https://github.com/nlohmann/json/issues/1162) +- \_json returns a different result vs ::parse [\#1161](https://github.com/nlohmann/json/issues/1161) +- Showing difference between two json objects [\#1160](https://github.com/nlohmann/json/issues/1160) +- no instance of overloaded function "std::swap" matches the specified type [\#1159](https://github.com/nlohmann/json/issues/1159) +- resize\(...\)? [\#1157](https://github.com/nlohmann/json/issues/1157) +- Issue with struct nested in class' to\_json [\#1155](https://github.com/nlohmann/json/issues/1155) +- Deserialize std::map with std::nan [\#1154](https://github.com/nlohmann/json/issues/1154) +- Parse throwing errors [\#1149](https://github.com/nlohmann/json/issues/1149) +- cocoapod integration [\#1148](https://github.com/nlohmann/json/issues/1148) +- wstring parsing [\#1147](https://github.com/nlohmann/json/issues/1147) +- Is it possible to dump a two-dimensional array to "\[\[null\],\[1,2,3\]\]"? [\#1146](https://github.com/nlohmann/json/issues/1146) +- Want to write a class member variable and a struct variable \( this structure is inside the class\) to the json file [\#1145](https://github.com/nlohmann/json/issues/1145) +- Does json support converting an instance of a struct into json string? [\#1143](https://github.com/nlohmann/json/issues/1143) +- \#Most efficient way to search for child parameters \(recursive find?\) [\#1141](https://github.com/nlohmann/json/issues/1141) +- could not find to\_json\(\) method in T's namespace [\#1140](https://github.com/nlohmann/json/issues/1140) +- chars get treated as JSON numbers not JSON strings [\#1139](https://github.com/nlohmann/json/issues/1139) +- How do I count number of objects in array? [\#1137](https://github.com/nlohmann/json/issues/1137) +- Serializing a vector of classes? [\#1136](https://github.com/nlohmann/json/issues/1136) +- Compile error. Unable convert form nullptr to nullptr&& [\#1135](https://github.com/nlohmann/json/issues/1135) +- std::unordered\_map in struct, serialization [\#1133](https://github.com/nlohmann/json/issues/1133) +- dump\(\) can't handle umlauts [\#1131](https://github.com/nlohmann/json/issues/1131) +- Add a way to get a key reference from the iterator [\#1127](https://github.com/nlohmann/json/issues/1127) +- can't not parse "\\“ string [\#1123](https://github.com/nlohmann/json/issues/1123) +- if json file contain Internationalization chars , get exception [\#1122](https://github.com/nlohmann/json/issues/1122) +- How to use a json::iterator dereferenced value in code? [\#1120](https://github.com/nlohmann/json/issues/1120) +- Disable implicit conversions from json to std::initializer\_list\ for any T [\#1118](https://github.com/nlohmann/json/issues/1118) +- Implicit conversions to complex types can lead to surprising and confusing errors [\#1116](https://github.com/nlohmann/json/issues/1116) +- How can I write from\_json for a complex datatype that is not default constructible? [\#1115](https://github.com/nlohmann/json/issues/1115) +- Compile error in VS2015 when compiling unit-conversions.cpp [\#1114](https://github.com/nlohmann/json/issues/1114) +- ADL Serializer for std::any / boost::any [\#1113](https://github.com/nlohmann/json/issues/1113) +- Unexpected behaviour of is\_null [\#1112](https://github.com/nlohmann/json/issues/1112) +- How to resolve " undefined reference to `std::\_\_throw\_bad\_cast\(\)'" [\#1111](https://github.com/nlohmann/json/issues/1111) +- cannot compile on ubuntu 18.04 and 16.04 [\#1110](https://github.com/nlohmann/json/issues/1110) +- JSON representation for floating point values has too many digits [\#1109](https://github.com/nlohmann/json/issues/1109) +- Not working for classes containing "\_declspec\(dllimport\)" in their declaration [\#1108](https://github.com/nlohmann/json/issues/1108) +- Get keys from json object [\#1107](https://github.com/nlohmann/json/issues/1107) +- Cannot deserialize types using std::ratio [\#1105](https://github.com/nlohmann/json/issues/1105) +- i want to learn json [\#1104](https://github.com/nlohmann/json/issues/1104) +- Type checking during compile [\#1103](https://github.com/nlohmann/json/issues/1103) +- Iterate through sub items [\#1102](https://github.com/nlohmann/json/issues/1102) +- cppcheck failing for version 3.1.2 [\#1101](https://github.com/nlohmann/json/issues/1101) +- Deserializing std::map [\#1100](https://github.com/nlohmann/json/issues/1100) +- accessing key by reference [\#1098](https://github.com/nlohmann/json/issues/1098) +- clang 3.8.0 croaks while trying to compile with debug symbols [\#1097](https://github.com/nlohmann/json/issues/1097) +- Serialize a list of class objects with json [\#1096](https://github.com/nlohmann/json/issues/1096) +- Small question [\#1094](https://github.com/nlohmann/json/issues/1094) +- Upgrading to 3.x: to\_/from\_json with enum class [\#1093](https://github.com/nlohmann/json/issues/1093) +- Q: few questions about json construction [\#1092](https://github.com/nlohmann/json/issues/1092) +- general crayCC compilation failure [\#1091](https://github.com/nlohmann/json/issues/1091) +- Merge Patch clears original data [\#1090](https://github.com/nlohmann/json/issues/1090) +- \[Question\] how to use nlohmann/json in c++? [\#1088](https://github.com/nlohmann/json/issues/1088) +- C++17 decomposition declaration support [\#1087](https://github.com/nlohmann/json/issues/1087) +- \[Question\] Access multi-level json objects [\#1086](https://github.com/nlohmann/json/issues/1086) +- Serializing vector [\#1085](https://github.com/nlohmann/json/issues/1085) +- update nested value in multi hierarchy json object [\#1084](https://github.com/nlohmann/json/issues/1084) +- Overriding default values? [\#1083](https://github.com/nlohmann/json/issues/1083) +- detail namespace collision with Cereal? [\#1082](https://github.com/nlohmann/json/issues/1082) +- Error using json.dump\(\); [\#1081](https://github.com/nlohmann/json/issues/1081) +- Consuming TCP Stream [\#1080](https://github.com/nlohmann/json/issues/1080) +- Compilation error with strong typed enums in map in combination with namespaces [\#1079](https://github.com/nlohmann/json/issues/1079) +- cassert error [\#1076](https://github.com/nlohmann/json/issues/1076) +- Valid json data not being parsed [\#1075](https://github.com/nlohmann/json/issues/1075) +- Feature request :: Better testing for key existance without try/catch [\#1074](https://github.com/nlohmann/json/issues/1074) +- Hi, I have input like a.b.c and want to convert it to \"a\"{\"b\": \"c\"} form. Any suggestions how do I do this? Thanks. [\#1073](https://github.com/nlohmann/json/issues/1073) +- ADL deserializer not picked up for non default-constructible type [\#1072](https://github.com/nlohmann/json/issues/1072) +- Deserializing std::array doesn't compiler \(no insert\(\)\) [\#1071](https://github.com/nlohmann/json/issues/1071) +- Serializing OpenCV Mat problem [\#1070](https://github.com/nlohmann/json/issues/1070) +- Compilation error with ICPC compiler [\#1068](https://github.com/nlohmann/json/issues/1068) +- Not existing value, crash [\#1065](https://github.com/nlohmann/json/issues/1065) +- cyryllic symbols [\#1064](https://github.com/nlohmann/json/issues/1064) +- newbie usage question [\#1063](https://github.com/nlohmann/json/issues/1063) +- Trying j\["strTest"\] = "%A" produces "strTest": "-0X1.CCCCCCCCCCCCCP+205" [\#1062](https://github.com/nlohmann/json/issues/1062) +- convert json value to std::string??? [\#1061](https://github.com/nlohmann/json/issues/1061) +- Commented out test cases, should they be removed? [\#1060](https://github.com/nlohmann/json/issues/1060) +- different behaviour between clang and gcc with braced initialization [\#1059](https://github.com/nlohmann/json/issues/1059) +- json array: initialize with prescribed size and `resize` method. [\#1057](https://github.com/nlohmann/json/issues/1057) +- Is it possible to use exceptions istead of assertions? [\#1056](https://github.com/nlohmann/json/issues/1056) +- when using assign operator in with json object a static assertion fails.. [\#1055](https://github.com/nlohmann/json/issues/1055) +- Iterate over leafs of a JSON data structure: enrich the JSON pointer API [\#1054](https://github.com/nlohmann/json/issues/1054) +- \[Feature request\] Access by path [\#1053](https://github.com/nlohmann/json/issues/1053) +- document that implicit js -\> primitive conversion does not work for std::string::value\_type and why [\#1052](https://github.com/nlohmann/json/issues/1052) +- error: ‘BasicJsonType’ in namespace ‘::’ does not name a type [\#1051](https://github.com/nlohmann/json/issues/1051) +- Destructor is called when filling object through assignement [\#1050](https://github.com/nlohmann/json/issues/1050) +- Is this thing thread safe for reads? [\#1049](https://github.com/nlohmann/json/issues/1049) +- clang-tidy: Call to virtual function during construction [\#1046](https://github.com/nlohmann/json/issues/1046) +- Using STL algorithms with JSON containers with expected results? [\#1045](https://github.com/nlohmann/json/issues/1045) +- Usage with gtest/gmock not working as expected [\#1044](https://github.com/nlohmann/json/issues/1044) +- Consequences of from\_json / to\_json being in namespace of data struct. [\#1042](https://github.com/nlohmann/json/issues/1042) +- const\_reference operator\[\]\(const typename object\_t::key\_type& key\) const throw instead of assert [\#1039](https://github.com/nlohmann/json/issues/1039) +- Trying to retrieve data from nested objects [\#1038](https://github.com/nlohmann/json/issues/1038) +- Direct download link for json\_fwd.hpp? [\#1037](https://github.com/nlohmann/json/issues/1037) +- I know the library supports UTF-8, but failed to dump the value [\#1036](https://github.com/nlohmann/json/issues/1036) +- Putting a Vec3-like vector into a json object [\#1035](https://github.com/nlohmann/json/issues/1035) +- Ternary operator crash [\#1034](https://github.com/nlohmann/json/issues/1034) +- Issued with Clion Inspection Resolution since 2018.1 [\#1033](https://github.com/nlohmann/json/issues/1033) +- Some testcases fail and one never finishes [\#1032](https://github.com/nlohmann/json/issues/1032) +- Can this class work with wchar\_t / std::wstring? [\#1031](https://github.com/nlohmann/json/issues/1031) +- Makefile: Valgrind flags have no effect [\#1030](https://github.com/nlohmann/json/issues/1030) +- 「==」 Should be 「\>」 [\#1029](https://github.com/nlohmann/json/issues/1029) +- HOCON reader? [\#1027](https://github.com/nlohmann/json/issues/1027) +- add json string in previous string?? [\#1025](https://github.com/nlohmann/json/issues/1025) +- RFC: fluent parsing interface [\#1023](https://github.com/nlohmann/json/issues/1023) +- Does it support chinese character? [\#1022](https://github.com/nlohmann/json/issues/1022) +- to/from\_msgpack only works with standard typization [\#1021](https://github.com/nlohmann/json/issues/1021) +- Build failure using latest clang and GCC compilers [\#1020](https://github.com/nlohmann/json/issues/1020) +- can two json objects be concatenated? [\#1019](https://github.com/nlohmann/json/issues/1019) +- Erase by integer index [\#1018](https://github.com/nlohmann/json/issues/1018) +- Function find overload taking a json\_pointer [\#1017](https://github.com/nlohmann/json/issues/1017) +- I think should implement an parser function [\#1016](https://github.com/nlohmann/json/issues/1016) +- Readme gif [\#1015](https://github.com/nlohmann/json/issues/1015) +- Python bindings [\#1014](https://github.com/nlohmann/json/issues/1014) +- how to add two json string in single object?? [\#1012](https://github.com/nlohmann/json/issues/1012) +- how to serialize class Object \(convert data in object into json\)?? [\#1011](https://github.com/nlohmann/json/issues/1011) +- Enable forward declaration of json by making json a class instead of a using declaration [\#997](https://github.com/nlohmann/json/issues/997) +- compilation error while using intel c++ compiler 2018 [\#994](https://github.com/nlohmann/json/issues/994) +- How to create a json variable? [\#990](https://github.com/nlohmann/json/issues/990) +- istream \>\> json --- 1st character skipped in stream [\#976](https://github.com/nlohmann/json/issues/976) +- Add a SAX parser [\#971](https://github.com/nlohmann/json/issues/971) +- Add Key name to Exception [\#932](https://github.com/nlohmann/json/issues/932) +- How to solve large json file? [\#927](https://github.com/nlohmann/json/issues/927) +- json\_pointer public push\_back, pop\_back [\#837](https://github.com/nlohmann/json/issues/837) +- Using input\_adapter in a slightly unexpected way [\#834](https://github.com/nlohmann/json/issues/834) + +- Fix -Wno-sometimes-uninitialized by initializing "result" in parse\_sax [\#1200](https://github.com/nlohmann/json/pull/1200) ([thyu](https://github.com/thyu)) +- \[RFC\] Introduce a new macro function: JSON\_INTERNAL\_CATCH [\#1187](https://github.com/nlohmann/json/pull/1187) ([simnalamburt](https://github.com/simnalamburt)) +- Fix unit tests that were silently skipped or crashed \(depending on the compiler\) [\#1176](https://github.com/nlohmann/json/pull/1176) ([grembo](https://github.com/grembo)) +- Refactor/no virtual sax [\#1153](https://github.com/nlohmann/json/pull/1153) ([theodelrieu](https://github.com/theodelrieu)) +- Fixed compiler error in VS 2015 for debug mode [\#1151](https://github.com/nlohmann/json/pull/1151) ([sonulohani](https://github.com/sonulohani)) +- Fix links to cppreference named requirements \(formerly concepts\) [\#1144](https://github.com/nlohmann/json/pull/1144) ([jrakow](https://github.com/jrakow)) +- meson: fix include directory [\#1142](https://github.com/nlohmann/json/pull/1142) ([jrakow](https://github.com/jrakow)) +- Feature/unordered map conversion [\#1138](https://github.com/nlohmann/json/pull/1138) ([theodelrieu](https://github.com/theodelrieu)) +- fixed compile error for \#1045 [\#1134](https://github.com/nlohmann/json/pull/1134) ([Daniel599](https://github.com/Daniel599)) +- test \(non\)equality for alt\_string implementation [\#1130](https://github.com/nlohmann/json/pull/1130) ([agrianius](https://github.com/agrianius)) +- remove stringstream dependency [\#1117](https://github.com/nlohmann/json/pull/1117) ([TinyTinni](https://github.com/TinyTinni)) +- Provide a from\_json overload for std::map [\#1089](https://github.com/nlohmann/json/pull/1089) ([theodelrieu](https://github.com/theodelrieu)) +- fix typo in README [\#1078](https://github.com/nlohmann/json/pull/1078) ([martin-mfg](https://github.com/martin-mfg)) +- Fix typo [\#1058](https://github.com/nlohmann/json/pull/1058) ([dns13](https://github.com/dns13)) +- Misc cmake packaging enhancements [\#1048](https://github.com/nlohmann/json/pull/1048) ([chuckatkins](https://github.com/chuckatkins)) +- Fixed incorrect LLVM version number in README [\#1047](https://github.com/nlohmann/json/pull/1047) ([jammehcow](https://github.com/jammehcow)) +- Fix trivial typo in comment. [\#1043](https://github.com/nlohmann/json/pull/1043) ([coryan](https://github.com/coryan)) +- Package Manager: Spack [\#1041](https://github.com/nlohmann/json/pull/1041) ([ax3l](https://github.com/ax3l)) +- CMake: 3.8+ is Sufficient [\#1040](https://github.com/nlohmann/json/pull/1040) ([ax3l](https://github.com/ax3l)) +- Added support for string\_view in C++17 [\#1028](https://github.com/nlohmann/json/pull/1028) ([gracicot](https://github.com/gracicot)) +- Added public target\_compile\_features for auto and constexpr [\#1026](https://github.com/nlohmann/json/pull/1026) ([ktonon](https://github.com/ktonon)) + +## [v3.1.2](https://github.com/nlohmann/json/releases/tag/v3.1.2) (2018-03-14) + +[Full Changelog](https://github.com/nlohmann/json/compare/3.1.2...v3.1.2) + +## [3.1.2](https://github.com/nlohmann/json/releases/tag/3.1.2) (2018-03-14) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.1.1...3.1.2) + +- STL containers are always serialized to a nested array like \[\[1,2,3\]\] [\#1013](https://github.com/nlohmann/json/issues/1013) +- The library doesn't want to insert an unordered\_map [\#1010](https://github.com/nlohmann/json/issues/1010) +- Convert Json to uint8\_t [\#1008](https://github.com/nlohmann/json/issues/1008) +- How to compare two JSON objects? [\#1007](https://github.com/nlohmann/json/issues/1007) +- Syntax checking [\#1003](https://github.com/nlohmann/json/issues/1003) +- more than one operator '=' matches these operands [\#1002](https://github.com/nlohmann/json/issues/1002) +- How to check if key existed [\#1000](https://github.com/nlohmann/json/issues/1000) +- nlohmann::json::parse exhaust memory in go binding [\#999](https://github.com/nlohmann/json/issues/999) +- Range-based iteration over a non-array object [\#998](https://github.com/nlohmann/json/issues/998) +- get\ for types that are not default constructible [\#996](https://github.com/nlohmann/json/issues/996) +- Prevent Null values to appear in .dump\(\) [\#995](https://github.com/nlohmann/json/issues/995) +- number parsing [\#993](https://github.com/nlohmann/json/issues/993) +- C2664 \(C++/CLR\) cannot convert 'nullptr' to 'nullptr &&' [\#987](https://github.com/nlohmann/json/issues/987) +- Uniform initialization from another json object differs between gcc and clang. [\#985](https://github.com/nlohmann/json/issues/985) +- Problem with adding the lib as a submodule [\#983](https://github.com/nlohmann/json/issues/983) +- UTF-8/Unicode error [\#982](https://github.com/nlohmann/json/issues/982) +- "forcing MSVC stacktrace to show which T we're talking about." error [\#980](https://github.com/nlohmann/json/issues/980) +- reverse order of serialization [\#979](https://github.com/nlohmann/json/issues/979) +- Assigning between different json types [\#977](https://github.com/nlohmann/json/issues/977) +- Support serialisation of `unique\_ptr\<\>` and `shared\_ptr\<\>` [\#975](https://github.com/nlohmann/json/issues/975) +- Unexpected end of input \(not same as one before\) [\#974](https://github.com/nlohmann/json/issues/974) +- Segfault on direct initializing json object [\#973](https://github.com/nlohmann/json/issues/973) +- Segmentation fault on G++ when trying to assign json string literal to custom json type. [\#972](https://github.com/nlohmann/json/issues/972) +- os\_defines.h:44:19: error: missing binary operator before token "\(" [\#970](https://github.com/nlohmann/json/issues/970) +- Passing an iteration object by reference to a function [\#967](https://github.com/nlohmann/json/issues/967) +- Json and fmt::lib's format\_arg\(\) [\#964](https://github.com/nlohmann/json/issues/964) + +- Allowing for user-defined string type in lexer/parser [\#1009](https://github.com/nlohmann/json/pull/1009) ([nlohmann](https://github.com/nlohmann)) +- dump to alternative string type, as defined in basic\_json template [\#1006](https://github.com/nlohmann/json/pull/1006) ([agrianius](https://github.com/agrianius)) +- Fix memory leak during parser callback [\#1001](https://github.com/nlohmann/json/pull/1001) ([nlohmann](https://github.com/nlohmann)) +- fixed misprinted condition detected by PVS Studio. [\#992](https://github.com/nlohmann/json/pull/992) ([bogemic](https://github.com/bogemic)) +- Fix/basic json conversion [\#986](https://github.com/nlohmann/json/pull/986) ([theodelrieu](https://github.com/theodelrieu)) +- Make integration section concise [\#981](https://github.com/nlohmann/json/pull/981) ([wla80](https://github.com/wla80)) + +## [v3.1.1](https://github.com/nlohmann/json/releases/tag/v3.1.1) (2018-02-13) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.1.0...v3.1.1) + +- Updation of child object isn't reflected in parent Object [\#968](https://github.com/nlohmann/json/issues/968) +- How to add user defined C++ path to sublime text [\#966](https://github.com/nlohmann/json/issues/966) +- fast number parsing [\#965](https://github.com/nlohmann/json/issues/965) +- With non-unique keys, later stored entries are not taken into account anymore [\#963](https://github.com/nlohmann/json/issues/963) +- Timeout \(OSS-Fuzz 6034\) [\#962](https://github.com/nlohmann/json/issues/962) +- Incorrect parsing of indefinite length CBOR strings. [\#961](https://github.com/nlohmann/json/issues/961) +- Reload a json file at runtime without emptying my std::ifstream [\#959](https://github.com/nlohmann/json/issues/959) +- Split headers should be part of the release [\#956](https://github.com/nlohmann/json/issues/956) +- Coveralls shows no coverage data [\#953](https://github.com/nlohmann/json/issues/953) +- Feature request: Implicit conversion to bool [\#951](https://github.com/nlohmann/json/issues/951) +- converting json to vector of type with templated constructor [\#924](https://github.com/nlohmann/json/issues/924) +- No structured bindings support? [\#901](https://github.com/nlohmann/json/issues/901) +- \[Request\] Macro generating from\_json\(\) and to\_json\(\) [\#895](https://github.com/nlohmann/json/issues/895) +- basic\_json::value throws exception instead of returning default value [\#871](https://github.com/nlohmann/json/issues/871) + +- Fix constraints on from\_json\(CompatibleArrayType\) [\#969](https://github.com/nlohmann/json/pull/969) ([theodelrieu](https://github.com/theodelrieu)) +- Make coveralls watch the include folder [\#957](https://github.com/nlohmann/json/pull/957) ([theodelrieu](https://github.com/theodelrieu)) +- Fix links in README.md [\#955](https://github.com/nlohmann/json/pull/955) ([patrikhuber](https://github.com/patrikhuber)) +- Add a note about installing the library with cget [\#954](https://github.com/nlohmann/json/pull/954) ([pfultz2](https://github.com/pfultz2)) + +## [v3.1.0](https://github.com/nlohmann/json/releases/tag/v3.1.0) (2018-02-01) + +[Full Changelog](https://github.com/nlohmann/json/compare/3.1.0...v3.1.0) + +## [3.1.0](https://github.com/nlohmann/json/releases/tag/3.1.0) (2018-02-01) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.0.1...3.1.0) + +- I have a proposal [\#949](https://github.com/nlohmann/json/issues/949) +- VERSION define\(s\) [\#948](https://github.com/nlohmann/json/issues/948) +- v3.0.1 compile error in icc 16.0.4 [\#947](https://github.com/nlohmann/json/issues/947) +- Use in VS2017 15.5.5 [\#946](https://github.com/nlohmann/json/issues/946) +- Process for reporting Security Bugs? [\#945](https://github.com/nlohmann/json/issues/945) +- Please expose a NLOHMANN\_JSON\_VERSION macro [\#943](https://github.com/nlohmann/json/issues/943) +- Change header include directory to nlohmann/json [\#942](https://github.com/nlohmann/json/issues/942) +- string\_type in binary\_reader [\#941](https://github.com/nlohmann/json/issues/941) +- compile error with clang 5.0 -std=c++1z and no string\_view [\#939](https://github.com/nlohmann/json/issues/939) +- Allow overriding JSON\_THROW to something else than abort\(\) [\#938](https://github.com/nlohmann/json/issues/938) +- Handle invalid string in Json file [\#937](https://github.com/nlohmann/json/issues/937) +- Unused variable 'kMinExp' [\#935](https://github.com/nlohmann/json/issues/935) +- yytext is already defined [\#933](https://github.com/nlohmann/json/issues/933) +- Equality operator fails [\#931](https://github.com/nlohmann/json/issues/931) +- use in visual studio 2015 [\#929](https://github.com/nlohmann/json/issues/929) +- Relative includes of json\_fwd.hpp in detail/meta.hpp. \[Develop branch\] [\#928](https://github.com/nlohmann/json/issues/928) +- GCC 7.x issue [\#926](https://github.com/nlohmann/json/issues/926) +- json\_fwd.hpp not installed [\#923](https://github.com/nlohmann/json/issues/923) +- Use Google Benchmarks [\#921](https://github.com/nlohmann/json/issues/921) +- Move class json\_pointer to separate file [\#920](https://github.com/nlohmann/json/issues/920) +- Unable to locate 'to\_json\(\)' and 'from\_json\(\)' methods in the same namespace [\#917](https://github.com/nlohmann/json/issues/917) +- \[answered\]Read key1 from .value example [\#914](https://github.com/nlohmann/json/issues/914) +- Don't use `define private public` in test files [\#913](https://github.com/nlohmann/json/issues/913) +- value\(\) template argument type deduction [\#912](https://github.com/nlohmann/json/issues/912) +- Installation path is incorrect [\#910](https://github.com/nlohmann/json/issues/910) +- H [\#909](https://github.com/nlohmann/json/issues/909) +- Build failure using clang 5 [\#908](https://github.com/nlohmann/json/issues/908) +- Amalgate [\#907](https://github.com/nlohmann/json/issues/907) +- Update documentation and tests wrt. split headers [\#906](https://github.com/nlohmann/json/issues/906) +- Lib not working on ubuntu 16.04 [\#905](https://github.com/nlohmann/json/issues/905) +- Problem when writing to file. [\#904](https://github.com/nlohmann/json/issues/904) +- C2864 error when compiling with VS2015 and VS 2017 [\#903](https://github.com/nlohmann/json/issues/903) +- \[json.exception.type\_error.304\] cannot use at\(\) with object [\#902](https://github.com/nlohmann/json/issues/902) +- How do I forward nlohmann::json declaration? [\#899](https://github.com/nlohmann/json/issues/899) +- How to effectively store binary data? [\#898](https://github.com/nlohmann/json/issues/898) +- How to get the length of a JSON string without retrieving its std::string? [\#897](https://github.com/nlohmann/json/issues/897) +- Regression Tests Failure using "ctest" [\#887](https://github.com/nlohmann/json/issues/887) +- Discuss: add JSON Merge Patch \(RFC 7396\)? [\#877](https://github.com/nlohmann/json/issues/877) +- Discuss: replace static "iterator\_wrapper" function with "items" member function [\#874](https://github.com/nlohmann/json/issues/874) +- Make optional user-data available in from\_json [\#864](https://github.com/nlohmann/json/issues/864) +- Casting to std::string not working in VS2015 [\#861](https://github.com/nlohmann/json/issues/861) +- Sequential reading of JSON arrays [\#851](https://github.com/nlohmann/json/issues/851) +- Idea: Handle Multimaps Better [\#816](https://github.com/nlohmann/json/issues/816) +- Floating point rounding [\#777](https://github.com/nlohmann/json/issues/777) +- Loss of precision when serializing \ [\#360](https://github.com/nlohmann/json/issues/360) + +- Templatize std::string in binary\_reader \#941 [\#950](https://github.com/nlohmann/json/pull/950) ([kaidokert](https://github.com/kaidokert)) +- fix cmake install directory \(for real this time\) [\#944](https://github.com/nlohmann/json/pull/944) ([theodelrieu](https://github.com/theodelrieu)) +- Allow overriding THROW/CATCH/TRY macros with no-exceptions \#938 [\#940](https://github.com/nlohmann/json/pull/940) ([kaidokert](https://github.com/kaidokert)) +- Removed compiler warning about unused variable 'kMinExp' [\#936](https://github.com/nlohmann/json/pull/936) ([zerodefect](https://github.com/zerodefect)) +- Fix a typo in README.md [\#930](https://github.com/nlohmann/json/pull/930) ([Pipeliner](https://github.com/Pipeliner)) +- Howto installation of json\_fwd.hpp \(fixes \#923\) [\#925](https://github.com/nlohmann/json/pull/925) ([zerodefect](https://github.com/zerodefect)) +- fix sfinae on basic\_json UDT constructor [\#919](https://github.com/nlohmann/json/pull/919) ([theodelrieu](https://github.com/theodelrieu)) +- Floating-point formatting [\#915](https://github.com/nlohmann/json/pull/915) ([abolz](https://github.com/abolz)) +- Fix/cmake install [\#911](https://github.com/nlohmann/json/pull/911) ([theodelrieu](https://github.com/theodelrieu)) +- fix link to the documentation of the emplace function [\#900](https://github.com/nlohmann/json/pull/900) ([Dobiasd](https://github.com/Dobiasd)) +- JSON Merge Patch \(RFC 7396\) [\#876](https://github.com/nlohmann/json/pull/876) ([nlohmann](https://github.com/nlohmann)) +- Refactor/split it [\#700](https://github.com/nlohmann/json/pull/700) ([theodelrieu](https://github.com/theodelrieu)) + +## [v3.0.1](https://github.com/nlohmann/json/releases/tag/v3.0.1) (2017-12-29) + +[Full Changelog](https://github.com/nlohmann/json/compare/3.0.1...v3.0.1) + +## [3.0.1](https://github.com/nlohmann/json/releases/tag/3.0.1) (2017-12-29) + +[Full Changelog](https://github.com/nlohmann/json/compare/v3.0.0...3.0.1) + +- Problem parsing array to global vector [\#896](https://github.com/nlohmann/json/issues/896) +- Invalid RFC6902 copy operation succeeds [\#894](https://github.com/nlohmann/json/issues/894) +- How to rename a key during looping? [\#893](https://github.com/nlohmann/json/issues/893) +- clang++-6.0 \(6.0.0-svn321357-1\) warning [\#892](https://github.com/nlohmann/json/issues/892) +- Make json.hpp aware of the modules TS? [\#891](https://github.com/nlohmann/json/issues/891) +- All enum values not handled in switch cases. \( -Wswitch-enum \) [\#889](https://github.com/nlohmann/json/issues/889) +- JSON Pointer resolve failure resulting in incorrect exception code [\#888](https://github.com/nlohmann/json/issues/888) +- Unexpected nested arrays from std::vector [\#886](https://github.com/nlohmann/json/issues/886) +- erase multiple elements from a json object [\#884](https://github.com/nlohmann/json/issues/884) +- Container function overview in Doxygen is not updated [\#883](https://github.com/nlohmann/json/issues/883) +- How to use this for binary file uploads [\#881](https://github.com/nlohmann/json/issues/881) +- Allow setting JSON\_BuildTests=OFF from parent CMakeLists.txt [\#846](https://github.com/nlohmann/json/issues/846) +- Unit test fails for local-independent str-to-num [\#845](https://github.com/nlohmann/json/issues/845) +- Another idea about type support [\#774](https://github.com/nlohmann/json/issues/774) + +- Includes CTest module/adds BUILD\_TESTING option [\#885](https://github.com/nlohmann/json/pull/885) ([TinyTinni](https://github.com/TinyTinni)) +- Fix MSVC warning C4819 [\#882](https://github.com/nlohmann/json/pull/882) ([erengy](https://github.com/erengy)) +- Merge branch 'develop' into coverity\_scan [\#880](https://github.com/nlohmann/json/pull/880) ([nlohmann](https://github.com/nlohmann)) +- :wrench: Fix up a few more effc++ items [\#858](https://github.com/nlohmann/json/pull/858) ([mattismyname](https://github.com/mattismyname)) + +## [v3.0.0](https://github.com/nlohmann/json/releases/tag/v3.0.0) (2017-12-17) + +[Full Changelog](https://github.com/nlohmann/json/compare/3.0.0...v3.0.0) + +## [3.0.0](https://github.com/nlohmann/json/releases/tag/3.0.0) (2017-12-17) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.1.1...3.0.0) + +- unicode strings [\#878](https://github.com/nlohmann/json/issues/878) +- Visual Studio 2017 15.5 C++17 std::allocator deprecations [\#872](https://github.com/nlohmann/json/issues/872) +- Typo "excpetion" [\#869](https://github.com/nlohmann/json/issues/869) +- Explicit array example in README.md incorrect [\#867](https://github.com/nlohmann/json/issues/867) +- why don't you release this from Feb. ? [\#865](https://github.com/nlohmann/json/issues/865) +- json::parse throws std::invalid\_argument when processing string generated by json::dump\(\) [\#863](https://github.com/nlohmann/json/issues/863) +- code analysis: potential bug? [\#859](https://github.com/nlohmann/json/issues/859) +- MSVC2017, 15.5 new issues. [\#857](https://github.com/nlohmann/json/issues/857) +- very basic: fetching string value/content without quotes [\#853](https://github.com/nlohmann/json/issues/853) +- Ambiguous function call to get with pointer type and constant json object in VS2015 \(15.4.4\) [\#852](https://github.com/nlohmann/json/issues/852) +- How to put object in the array as a member? [\#850](https://github.com/nlohmann/json/issues/850) +- misclick, please ignore [\#849](https://github.com/nlohmann/json/issues/849) +- Make XML great again. [\#847](https://github.com/nlohmann/json/issues/847) +- Converting to array not working [\#843](https://github.com/nlohmann/json/issues/843) +- Iteration weirdness [\#842](https://github.com/nlohmann/json/issues/842) +- Use reference or pointer as Object value [\#841](https://github.com/nlohmann/json/issues/841) +- Ambiguity in parsing nested maps [\#840](https://github.com/nlohmann/json/issues/840) +- could not find from\_json\(\) method in T's namespace [\#839](https://github.com/nlohmann/json/issues/839) +- Incorrect parse error with binary data in keys? [\#838](https://github.com/nlohmann/json/issues/838) +- using dump\(\) when std::wstring is StringType with VS2017 [\#836](https://github.com/nlohmann/json/issues/836) +- Show the path of the currently parsed value when an error occurs [\#835](https://github.com/nlohmann/json/issues/835) +- Repetitive data type while reading [\#833](https://github.com/nlohmann/json/issues/833) +- Storing multiple types inside map [\#831](https://github.com/nlohmann/json/issues/831) +- Application terminating [\#830](https://github.com/nlohmann/json/issues/830) +- Missing CMake hunter package? [\#828](https://github.com/nlohmann/json/issues/828) +- std::map\ from json object yields C2665: 'std::pair\::pair': none of the 2 overloads could convert all the argument types [\#827](https://github.com/nlohmann/json/issues/827) +- object.dump gives quoted string, want to use .dump\(\) to generate javascripts. [\#826](https://github.com/nlohmann/json/issues/826) +- Assertion failed on \["NoExistKey"\] of an not existing key of const json& [\#825](https://github.com/nlohmann/json/issues/825) +- vs2015 error : static member will remain uninitialized at runtime but use in constant-expressions is supported [\#824](https://github.com/nlohmann/json/issues/824) +- Code Checking Warnings from json.hpp on VS2017 Community [\#821](https://github.com/nlohmann/json/issues/821) +- Missing iostream in try online [\#820](https://github.com/nlohmann/json/issues/820) +- Floating point value loses decimal point during dump [\#818](https://github.com/nlohmann/json/issues/818) +- Conan package for the library [\#817](https://github.com/nlohmann/json/issues/817) +- stream error [\#815](https://github.com/nlohmann/json/issues/815) +- Link error when using find\(\) on the latest commit [\#814](https://github.com/nlohmann/json/issues/814) +- ABI issue with json object between 2 shared libraries [\#813](https://github.com/nlohmann/json/issues/813) +- scan\_string\(\) return token\_type::parse\_error; when parse ansi file [\#812](https://github.com/nlohmann/json/issues/812) +- segfault when using fifo\_map with json [\#810](https://github.com/nlohmann/json/issues/810) +- This shit is shit [\#809](https://github.com/nlohmann/json/issues/809) +- \_finite and \_isnan are no members of "std" [\#808](https://github.com/nlohmann/json/issues/808) +- how to print out the line which causing exception? [\#806](https://github.com/nlohmann/json/issues/806) +- {} uses copy constructor, while = does not [\#805](https://github.com/nlohmann/json/issues/805) +- json.hpp:8955: multiple definition of function that is not defined twice or more. [\#804](https://github.com/nlohmann/json/issues/804) +- \[question\] to\_json for base and derived class [\#803](https://github.com/nlohmann/json/issues/803) +- Misleading error message - unexpected '"' - on incorrect utf-8 symbol [\#802](https://github.com/nlohmann/json/issues/802) +- json data = std::string\_view\("hi"\); doesn't work? [\#801](https://github.com/nlohmann/json/issues/801) +- Thread safety of parse\(\) [\#800](https://github.com/nlohmann/json/issues/800) +- Numbers as strings [\#799](https://github.com/nlohmann/json/issues/799) +- Tests failing on arm [\#797](https://github.com/nlohmann/json/issues/797) +- Using your library \(without modification\) in another library [\#796](https://github.com/nlohmann/json/issues/796) +- Iterating over sub-object [\#794](https://github.com/nlohmann/json/issues/794) +- how to get the json object again from which printed by the method of dump\(\) [\#792](https://github.com/nlohmann/json/issues/792) +- ppa to include source [\#791](https://github.com/nlohmann/json/issues/791) +- Different include paths in macOS and Ubuntu [\#790](https://github.com/nlohmann/json/issues/790) +- Missing break after line 12886 in switch/case [\#789](https://github.com/nlohmann/json/issues/789) +- All unit tests fail? [\#787](https://github.com/nlohmann/json/issues/787) +- More use of move semantics in deserialization [\#786](https://github.com/nlohmann/json/issues/786) +- warning C4706 - Visual Studio 2017 \(/W4\) [\#784](https://github.com/nlohmann/json/issues/784) +- Compile error in clang 5.0 [\#782](https://github.com/nlohmann/json/issues/782) +- Error Installing appium\_lib with Ruby v2.4.2 Due to JSON [\#781](https://github.com/nlohmann/json/issues/781) +- ::get\\(\) fails in new\(er\) release \[MSVC\] [\#780](https://github.com/nlohmann/json/issues/780) +- Type Conversion [\#779](https://github.com/nlohmann/json/issues/779) +- Segfault on nested parsing [\#778](https://github.com/nlohmann/json/issues/778) +- Build warnings: shadowing exception id [\#776](https://github.com/nlohmann/json/issues/776) +- multi-level JSON support. [\#775](https://github.com/nlohmann/json/issues/775) +- SIGABRT on dump\(\) [\#773](https://github.com/nlohmann/json/issues/773) +- \[Question\] Custom StringType template parameter \(possibility for a KeyType template parameter\) [\#772](https://github.com/nlohmann/json/issues/772) +- constexpr ALL the Things! [\#771](https://github.com/nlohmann/json/issues/771) +- error: ‘BasicJsonType’ in namespace ‘::’ does not name a type [\#770](https://github.com/nlohmann/json/issues/770) +- Program calls abort function [\#769](https://github.com/nlohmann/json/issues/769) +- \[Question\] Floating point resolution config during dump\(\) ? [\#768](https://github.com/nlohmann/json/issues/768) +- make check - no test ran [\#767](https://github.com/nlohmann/json/issues/767) +- The library cannot work properly with custom allocator based containers [\#766](https://github.com/nlohmann/json/issues/766) +- Documentation or feature request. [\#763](https://github.com/nlohmann/json/issues/763) +- warnings in msvc about mix/max macro while windows.h is used in the project [\#762](https://github.com/nlohmann/json/issues/762) +- std::signbit ambiguous [\#761](https://github.com/nlohmann/json/issues/761) +- How to use value for std::experimental::optional type? [\#760](https://github.com/nlohmann/json/issues/760) +- Cannot load json file properly [\#759](https://github.com/nlohmann/json/issues/759) +- Compilation error with unordered\_map\< int, int \> [\#758](https://github.com/nlohmann/json/issues/758) +- CBOR string [\#757](https://github.com/nlohmann/json/issues/757) +- Proposal: out\_of\_range should be a subclass of std::out\_of\_range [\#756](https://github.com/nlohmann/json/issues/756) +- Compiling with icpc [\#755](https://github.com/nlohmann/json/issues/755) +- Getter is setting the value to null if the key does not exist [\#754](https://github.com/nlohmann/json/issues/754) +- parsing works sometimes and crashes others [\#752](https://github.com/nlohmann/json/issues/752) +- Static\_assert failed "incompatible pointer type" with Xcode [\#751](https://github.com/nlohmann/json/issues/751) +- user-defined literal operator not found [\#750](https://github.com/nlohmann/json/issues/750) +- getting clean string from it.key\(\) [\#748](https://github.com/nlohmann/json/issues/748) +- Best method for exploring and obtaining values of nested json objects when the names are not known beforehand? [\#747](https://github.com/nlohmann/json/issues/747) +- null char at the end of string [\#746](https://github.com/nlohmann/json/issues/746) +- Incorrect sample for operator \>\> in docs [\#745](https://github.com/nlohmann/json/issues/745) +- User-friendly documentation [\#744](https://github.com/nlohmann/json/issues/744) +- Retrieve all values that match a json path [\#743](https://github.com/nlohmann/json/issues/743) +- Compilation issue with gcc 7.2 [\#742](https://github.com/nlohmann/json/issues/742) +- CMake target nlohmann\_json does not have src into its interface includes [\#741](https://github.com/nlohmann/json/issues/741) +- Error when serializing empty json: type must be string, but is object [\#740](https://github.com/nlohmann/json/issues/740) +- Conversion error for std::map\ [\#739](https://github.com/nlohmann/json/issues/739) +- Dumping Json to file as array [\#738](https://github.com/nlohmann/json/issues/738) +- nesting json objects [\#737](https://github.com/nlohmann/json/issues/737) +- where to find general help? [\#736](https://github.com/nlohmann/json/issues/736) +- Compilation Error on Clang 5.0 Upgrade [\#735](https://github.com/nlohmann/json/issues/735) +- Compilation error with std::map\ on vs 2015 [\#734](https://github.com/nlohmann/json/issues/734) +- Benchmarks for Binary formats [\#733](https://github.com/nlohmann/json/issues/733) +- Support \n symbols in json string. [\#731](https://github.com/nlohmann/json/issues/731) +- Project's name is too generic and hard to search for [\#730](https://github.com/nlohmann/json/issues/730) +- Visual Studio 2015 IntelliTrace problems [\#729](https://github.com/nlohmann/json/issues/729) +- How to erase nested objects inside other objects? [\#728](https://github.com/nlohmann/json/issues/728) +- Serialization for CBOR [\#726](https://github.com/nlohmann/json/issues/726) +- Using json Object as value in a map [\#725](https://github.com/nlohmann/json/issues/725) +- std::regex and nlohmann::json value [\#724](https://github.com/nlohmann/json/issues/724) +- Warnings when compiling with VisualStudio 2015 [\#723](https://github.com/nlohmann/json/issues/723) +- Has this lib the unicode \(wstring\) support? [\#722](https://github.com/nlohmann/json/issues/722) +- When will be 3.0 in master? [\#721](https://github.com/nlohmann/json/issues/721) +- Determine the type from error message. [\#720](https://github.com/nlohmann/json/issues/720) +- Compile-Error C2100 \(MS VS2015\) in line 887 json.hpp [\#719](https://github.com/nlohmann/json/issues/719) +- from\_json not working for boost::optional example [\#718](https://github.com/nlohmann/json/issues/718) +- about from\_json and to\_json function [\#717](https://github.com/nlohmann/json/issues/717) +- How to detect parse failure? [\#715](https://github.com/nlohmann/json/issues/715) +- Parse throw std::ios\_base::failure exception when failbit set to true [\#714](https://github.com/nlohmann/json/issues/714) +- Is there a way of format just making a pretty print without changing the key's orders ? [\#713](https://github.com/nlohmann/json/issues/713) +- Serialization of array of not same model items [\#712](https://github.com/nlohmann/json/issues/712) +- pointer to json parse vector [\#711](https://github.com/nlohmann/json/issues/711) +- Gtest SEH Exception [\#709](https://github.com/nlohmann/json/issues/709) +- broken from\_json implementation for pair and tuple [\#707](https://github.com/nlohmann/json/issues/707) +- Unevaluated lambda in assert breaks gcc 7 build [\#705](https://github.com/nlohmann/json/issues/705) +- Issues when adding values to firebase database [\#704](https://github.com/nlohmann/json/issues/704) +- Floating point equality - revisited [\#703](https://github.com/nlohmann/json/issues/703) +- Conversion from valarray\ to json fails to build [\#702](https://github.com/nlohmann/json/issues/702) +- internal compiler error \(gcc7\) [\#701](https://github.com/nlohmann/json/issues/701) +- One build system to rule them all [\#698](https://github.com/nlohmann/json/issues/698) +- Generated nlohmann\_jsonConfig.cmake does not set JSON\_INCLUDE\_DIR [\#695](https://github.com/nlohmann/json/issues/695) +- support the Chinese language in json string [\#694](https://github.com/nlohmann/json/issues/694) +- NaN problem within develop branch [\#693](https://github.com/nlohmann/json/issues/693) +- Please post example of specialization for boost::filesystem [\#692](https://github.com/nlohmann/json/issues/692) +- Impossible to do an array of composite objects [\#691](https://github.com/nlohmann/json/issues/691) +- How to save json to file? [\#690](https://github.com/nlohmann/json/issues/690) +- my simple json parser [\#689](https://github.com/nlohmann/json/issues/689) +- problem with new struct parsing syntax [\#688](https://github.com/nlohmann/json/issues/688) +- Parse error while parse the json string contains UTF 8 encoded document bytes string [\#684](https://github.com/nlohmann/json/issues/684) +- \[question\] how to get a string value by pointer [\#683](https://github.com/nlohmann/json/issues/683) +- create json object from string variable [\#681](https://github.com/nlohmann/json/issues/681) +- adl\_serializer and CRTP [\#680](https://github.com/nlohmann/json/issues/680) +- Is there a way to control the precision of serialized floating point numbers? [\#677](https://github.com/nlohmann/json/issues/677) +- Is there a way to get the path of a value? [\#676](https://github.com/nlohmann/json/issues/676) +- Could the parser locate errors to line? [\#675](https://github.com/nlohmann/json/issues/675) +- There is performance inefficiency found by coverity tool json2.1.1/include/nlohmann/json.hpp [\#673](https://github.com/nlohmann/json/issues/673) +- include problem, when cmake on osx [\#672](https://github.com/nlohmann/json/issues/672) +- Operator= ambiguous in C++1z and GCC 7.1.1 [\#670](https://github.com/nlohmann/json/issues/670) +- should't the cmake install target be to nlohman/json.hpp [\#668](https://github.com/nlohmann/json/issues/668) +- deserialise from `std::vector` [\#667](https://github.com/nlohmann/json/issues/667) +- How to iterate? [\#665](https://github.com/nlohmann/json/issues/665) +- could this json lib work on windows? [\#664](https://github.com/nlohmann/json/issues/664) +- How does from\_json work? [\#662](https://github.com/nlohmann/json/issues/662) +- insert\(or merge\) object should replace same key , not ignore [\#661](https://github.com/nlohmann/json/issues/661) +- Parse method doesn't handle newlines. [\#659](https://github.com/nlohmann/json/issues/659) +- Compilation "note" on GCC 6 ARM [\#658](https://github.com/nlohmann/json/issues/658) +- Adding additional push\_back/operator+= rvalue overloads for JSON object [\#657](https://github.com/nlohmann/json/issues/657) +- dump's parameter "ensure\_ascii" creates too long sequences [\#656](https://github.com/nlohmann/json/issues/656) +- Question: parsing `void \*` [\#655](https://github.com/nlohmann/json/issues/655) +- how should I check a string is valid JSON string ? [\#653](https://github.com/nlohmann/json/issues/653) +- Question: thread safety of read only accesses [\#651](https://github.com/nlohmann/json/issues/651) +- Eclipse: Method 'size' could not be resolved [\#649](https://github.com/nlohmann/json/issues/649) +- Update/Add object fields [\#648](https://github.com/nlohmann/json/issues/648) +- No exception raised for Out Of Range input of numbers [\#647](https://github.com/nlohmann/json/issues/647) +- Package Name [\#646](https://github.com/nlohmann/json/issues/646) +- What is the meaning of operator\[\]\(T\* key\) [\#645](https://github.com/nlohmann/json/issues/645) +- Which is the correct way to json objects as parameters to functions? [\#644](https://github.com/nlohmann/json/issues/644) +- Method to get string representations of values [\#642](https://github.com/nlohmann/json/issues/642) +- CBOR serialization of a given JSON value does not serialize [\#641](https://github.com/nlohmann/json/issues/641) +- Are we forced to use "-fexceptions" flag in android ndk project [\#640](https://github.com/nlohmann/json/issues/640) +- Comparison of objects containing floats [\#639](https://github.com/nlohmann/json/issues/639) +- 'localeconv' is not supported by NDK for SDK \<=20 [\#638](https://github.com/nlohmann/json/issues/638) +- \[Question\] cLion integration [\#637](https://github.com/nlohmann/json/issues/637) +- How to construct an iteratable usage in nlohmann json? [\#636](https://github.com/nlohmann/json/issues/636) +- \[Question\] copy assign json-container to vector [\#635](https://github.com/nlohmann/json/issues/635) +- Get size without .dump\(\) [\#634](https://github.com/nlohmann/json/issues/634) +- Segmentation fault when parsing invalid json file [\#633](https://github.com/nlohmann/json/issues/633) +- How to serialize from json to vector\? [\#632](https://github.com/nlohmann/json/issues/632) +- no member named 'thousands\_sep' in 'lconv' [\#631](https://github.com/nlohmann/json/issues/631) +- \[Question\] Any fork for \(the unsupported\) Visual Studio 2012 version? [\#628](https://github.com/nlohmann/json/issues/628) +- Dependency injection in serializer [\#627](https://github.com/nlohmann/json/issues/627) +- from\_json for std::array [\#625](https://github.com/nlohmann/json/issues/625) +- Discussion: How to structure the parsing function families [\#623](https://github.com/nlohmann/json/issues/623) +- Question: How to erase subtree [\#622](https://github.com/nlohmann/json/issues/622) +- Insertion into nested json field [\#621](https://github.com/nlohmann/json/issues/621) +- Question: return static json object from function [\#618](https://github.com/nlohmann/json/issues/618) +- icc16 error [\#617](https://github.com/nlohmann/json/issues/617) +- \[-Wdeprecated-declarations\] in row `j \>\> ss;` in file `json.hpp:7405:26` and FAILED unit tests with MinGWx64! [\#616](https://github.com/nlohmann/json/issues/616) +- to\_json for pairs, tuples [\#614](https://github.com/nlohmann/json/issues/614) +- Using uninitialized memory 'buf' in line 11173 v2.1.1? [\#613](https://github.com/nlohmann/json/issues/613) +- How to parse multiple same Keys of JSON and save them? [\#612](https://github.com/nlohmann/json/issues/612) +- "Multiple declarations" error when using types defined with `typedef` [\#611](https://github.com/nlohmann/json/issues/611) +- 2.1.1+ breaks compilation of shared\_ptr\ == 0 [\#610](https://github.com/nlohmann/json/issues/610) +- a bug of inheritance ? [\#608](https://github.com/nlohmann/json/issues/608) +- std::map key conversion with to\_json [\#607](https://github.com/nlohmann/json/issues/607) +- json.hpp:6384:62: error: wrong number of template arguments \(1, should be 2\) [\#606](https://github.com/nlohmann/json/issues/606) +- Incremental parsing: Where's the push version? [\#605](https://github.com/nlohmann/json/issues/605) +- Is there a way to validate the structure of a json object ? [\#604](https://github.com/nlohmann/json/issues/604) +- \[Question\] Issue when using Appveyor when compiling library [\#603](https://github.com/nlohmann/json/issues/603) +- BOM not skipped when using json:parse\(iterator\) [\#602](https://github.com/nlohmann/json/issues/602) +- Use of the binary type in CBOR and Message Pack [\#601](https://github.com/nlohmann/json/issues/601) +- Newbie issue: how does one convert a map in Json back to std::map? [\#600](https://github.com/nlohmann/json/issues/600) +- Plugin system [\#599](https://github.com/nlohmann/json/issues/599) +- Using custom types for scalars? [\#596](https://github.com/nlohmann/json/issues/596) +- Issues with the arithmetic in iterator and reverse iterator [\#593](https://github.com/nlohmann/json/issues/593) +- not enough examples [\#592](https://github.com/nlohmann/json/issues/592) +- in-class initialization for type 'const T' is not yet implemented [\#591](https://github.com/nlohmann/json/issues/591) +- compiling with gcc 7 -\> error on bool operator \< [\#590](https://github.com/nlohmann/json/issues/590) +- Parsing from stream leads to an array [\#589](https://github.com/nlohmann/json/issues/589) +- Buggy support for binary string data [\#587](https://github.com/nlohmann/json/issues/587) +- C++17's ambiguous conversion [\#586](https://github.com/nlohmann/json/issues/586) +- How does the messagepack encoding/decoding compare to msgpack-cpp in terms of performance? [\#585](https://github.com/nlohmann/json/issues/585) +- is it possible to check existence of a value deep in hierarchy? [\#584](https://github.com/nlohmann/json/issues/584) +- loading from a stream and exceptions [\#582](https://github.com/nlohmann/json/issues/582) +- Visual Studio seems not to have all min\(\) function versions [\#581](https://github.com/nlohmann/json/issues/581) +- Supporting of the json schema [\#580](https://github.com/nlohmann/json/issues/580) +- Stack-overflow \(OSS-Fuzz 1444\) [\#577](https://github.com/nlohmann/json/issues/577) +- Heap-buffer-overflow \(OSS-Fuzz 1400\) [\#575](https://github.com/nlohmann/json/issues/575) +- JSON escape quotes [\#574](https://github.com/nlohmann/json/issues/574) +- error: static\_assert failed [\#573](https://github.com/nlohmann/json/issues/573) +- Storing floats, and round trip serialisation/deserialisation diffs [\#572](https://github.com/nlohmann/json/issues/572) +- JSON.getLong produces inconsistent results [\#571](https://github.com/nlohmann/json/issues/571) +- Request: Object.at\(\) with default return value [\#570](https://github.com/nlohmann/json/issues/570) +- Internal structure gets corrupted while parsing [\#569](https://github.com/nlohmann/json/issues/569) +- create template \ basic\_json from\_cbor\(Iter begin, Iter end\) [\#568](https://github.com/nlohmann/json/issues/568) +- Conan.io [\#566](https://github.com/nlohmann/json/issues/566) +- contradictory documentation regarding json::find [\#565](https://github.com/nlohmann/json/issues/565) +- Unexpected '\"' in middle of array [\#564](https://github.com/nlohmann/json/issues/564) +- Support parse std::pair to Json object [\#563](https://github.com/nlohmann/json/issues/563) +- json and Microsoft Visual c++ Compiler Nov 2012 CTP [\#562](https://github.com/nlohmann/json/issues/562) +- from\_json declaration order and exceptions [\#561](https://github.com/nlohmann/json/issues/561) +- Tip: Don't upgrade to VS2017 if using json initializer list constructs [\#559](https://github.com/nlohmann/json/issues/559) +- parse error - unexpected end of input [\#558](https://github.com/nlohmann/json/issues/558) +- Cant modify existing numbers inside a json object [\#557](https://github.com/nlohmann/json/issues/557) +- Better support for SAX style serialize and deserialize in new version? [\#554](https://github.com/nlohmann/json/issues/554) +- Cannot convert from json array to std::array [\#553](https://github.com/nlohmann/json/issues/553) +- Do not define an unnamed namespace in a header file \(DCL59-CPP\) [\#552](https://github.com/nlohmann/json/issues/552) +- Parse error on known good json file [\#551](https://github.com/nlohmann/json/issues/551) +- Warning on Intel compiler \(icc 17\) [\#550](https://github.com/nlohmann/json/issues/550) +- multiple versions of 'vsnprintf' [\#549](https://github.com/nlohmann/json/issues/549) +- illegal indirection [\#548](https://github.com/nlohmann/json/issues/548) +- Ambiguous compare operators with clang-5.0 [\#547](https://github.com/nlohmann/json/issues/547) +- Using tsl::ordered\_map [\#546](https://github.com/nlohmann/json/issues/546) +- Compiler support errors are inconvenient [\#544](https://github.com/nlohmann/json/issues/544) +- Duplicate symbols error happens while to\_json/from\_json method implemented inside entity definition header file [\#542](https://github.com/nlohmann/json/issues/542) +- consider adding a bool json::is\_valid\(std::string const&\) non-member function [\#541](https://github.com/nlohmann/json/issues/541) +- Help request [\#539](https://github.com/nlohmann/json/issues/539) +- How to deal with missing keys in `from\_json`? [\#538](https://github.com/nlohmann/json/issues/538) +- recursive from\_msgpack implementation will stack overflow [\#537](https://github.com/nlohmann/json/issues/537) +- Exception objects must be nothrow copy constructible \(ERR60-CPP\) [\#531](https://github.com/nlohmann/json/issues/531) +- Support for multiple root elements [\#529](https://github.com/nlohmann/json/issues/529) +- Port has\_shape from dropbox/json11 [\#528](https://github.com/nlohmann/json/issues/528) +- dump\_float: truncation from ptrdiff\_t to long [\#527](https://github.com/nlohmann/json/issues/527) +- Make exception base class visible in basic\_json [\#525](https://github.com/nlohmann/json/issues/525) +- msgpack unit test failures on ppc64 arch [\#524](https://github.com/nlohmann/json/issues/524) +- How about split the implementation out, and only leave the interface? [\#523](https://github.com/nlohmann/json/issues/523) +- VC++2017 not enough actual parameters for macro 'max' [\#522](https://github.com/nlohmann/json/issues/522) +- crash on empty ifstream [\#521](https://github.com/nlohmann/json/issues/521) +- Suggestion: Support tabs for indentation when serializing to stream. [\#520](https://github.com/nlohmann/json/issues/520) +- Abrt in get\_number \(OSS-Fuzz 885\) [\#519](https://github.com/nlohmann/json/issues/519) +- Abrt on unknown address \(OSS-Fuzz 884\) [\#518](https://github.com/nlohmann/json/issues/518) +- Stack-overflow \(OSS-Fuzz 869\) [\#517](https://github.com/nlohmann/json/issues/517) +- Assertion error \(OSS-Fuzz 868\) [\#516](https://github.com/nlohmann/json/issues/516) +- NaN to json and back [\#515](https://github.com/nlohmann/json/issues/515) +- Comparison of NaN [\#514](https://github.com/nlohmann/json/issues/514) +- why it's not possible to serialize c++11 enums directly [\#513](https://github.com/nlohmann/json/issues/513) +- clang compile error: use of overloaded operator '\<=' is ambiguous with \(nlohmann::json{{"a", 5}}\)\["a"\] \<= 10 [\#512](https://github.com/nlohmann/json/issues/512) +- Why not also look inside the type for \(static\) to\_json and from\_json funtions? [\#511](https://github.com/nlohmann/json/issues/511) +- Parser issues [\#509](https://github.com/nlohmann/json/issues/509) +- I may not understand [\#507](https://github.com/nlohmann/json/issues/507) +- VS2017 min / max problem for 2.1.1 [\#506](https://github.com/nlohmann/json/issues/506) +- CBOR/MessagePack is not read until the end [\#505](https://github.com/nlohmann/json/issues/505) +- Assertion error \(OSS-Fuzz 856\) [\#504](https://github.com/nlohmann/json/issues/504) +- Return position in parse error exceptions [\#503](https://github.com/nlohmann/json/issues/503) +- conversion from/to C array is not supported [\#502](https://github.com/nlohmann/json/issues/502) +- error C2338: could not find to\_json\(\) method in T's namespace [\#501](https://github.com/nlohmann/json/issues/501) +- Test suite fails in en\_GB.UTF-8 [\#500](https://github.com/nlohmann/json/issues/500) +- cannot use operator\[\] with number [\#499](https://github.com/nlohmann/json/issues/499) +- consider using \_\_cpp\_exceptions and/or \_\_EXCEPTIONS to disable/enable exception support [\#498](https://github.com/nlohmann/json/issues/498) +- Stack-overflow \(OSS-Fuzz issue 814\) [\#497](https://github.com/nlohmann/json/issues/497) +- Using in Unreal Engine - handling custom types conversion [\#495](https://github.com/nlohmann/json/issues/495) +- Conversion from vector\ to json fails to build [\#494](https://github.com/nlohmann/json/issues/494) +- fill\_line\_buffer incorrectly tests m\_stream for eof but not fail or bad bits [\#493](https://github.com/nlohmann/json/issues/493) +- Compiling with \_GLIBCXX\_DEBUG yields iterator-comparison warnings during tests [\#492](https://github.com/nlohmann/json/issues/492) +- crapy interface [\#491](https://github.com/nlohmann/json/issues/491) +- Fix Visual Studo 2013 builds. [\#490](https://github.com/nlohmann/json/issues/490) +- Failed to compile with -D\_GLIBCXX\_PARALLEL [\#489](https://github.com/nlohmann/json/issues/489) +- Input several field with the same name [\#488](https://github.com/nlohmann/json/issues/488) +- read in .json file yields strange sizes [\#487](https://github.com/nlohmann/json/issues/487) +- json::value\_t can't be a map's key type in VC++ 2015 [\#486](https://github.com/nlohmann/json/issues/486) +- Using fifo\_map [\#485](https://github.com/nlohmann/json/issues/485) +- Cannot get float pointer for value stored as `0` [\#484](https://github.com/nlohmann/json/issues/484) +- byte string support [\#483](https://github.com/nlohmann/json/issues/483) +- https://github.com/nlohmann/json\#execute-unit-tests [\#481](https://github.com/nlohmann/json/issues/481) +- Remove deprecated constructor basic\_json\(std::istream&\) [\#480](https://github.com/nlohmann/json/issues/480) +- writing the binary json file? [\#479](https://github.com/nlohmann/json/issues/479) +- CBOR/MessagePack from uint8\_t \* and size [\#478](https://github.com/nlohmann/json/issues/478) +- Streaming binary representations [\#477](https://github.com/nlohmann/json/issues/477) +- Reuse memory in to\_cbor and to\_msgpack functions [\#476](https://github.com/nlohmann/json/issues/476) +- Error Using JSON Library with arrays C++ [\#475](https://github.com/nlohmann/json/issues/475) +- Moving forward to version 3.0.0 [\#474](https://github.com/nlohmann/json/issues/474) +- Inconsistent behavior in conversion to array type [\#473](https://github.com/nlohmann/json/issues/473) +- Create a \[key:member\_pointer\] map to ease parsing custom types [\#471](https://github.com/nlohmann/json/issues/471) +- MSVC 2015 update 2 [\#469](https://github.com/nlohmann/json/issues/469) +- VS2017 implicit to std::string conversion fix. [\#464](https://github.com/nlohmann/json/issues/464) +- How to make sure a string or string literal is a valid JSON? [\#458](https://github.com/nlohmann/json/issues/458) +- basic\_json templated on a "policy" class [\#456](https://github.com/nlohmann/json/issues/456) +- json::value\(const json\_pointer&, ValueType\) requires exceptions to return the default value. [\#440](https://github.com/nlohmann/json/issues/440) +- is it possible merge two json object [\#428](https://github.com/nlohmann/json/issues/428) +- Is it possible to turn this into a shared library? [\#420](https://github.com/nlohmann/json/issues/420) +- Further thoughts on performance improvements [\#418](https://github.com/nlohmann/json/issues/418) +- nan number stored as null [\#388](https://github.com/nlohmann/json/issues/388) +- Behavior of operator\>\> should more closely resemble that of built-in overloads. [\#367](https://github.com/nlohmann/json/issues/367) +- Request: range-based-for over a json-object to expose .first/.second [\#350](https://github.com/nlohmann/json/issues/350) +- feature wish: JSONPath [\#343](https://github.com/nlohmann/json/issues/343) +- UTF-8/Unicode escape and dump [\#330](https://github.com/nlohmann/json/issues/330) +- Serialized value not always can be parsed. [\#329](https://github.com/nlohmann/json/issues/329) +- Is there a way to forward declare nlohmann::json? [\#314](https://github.com/nlohmann/json/issues/314) +- Exception line [\#301](https://github.com/nlohmann/json/issues/301) +- Do not throw exception when default\_value's type does not match the actual type [\#278](https://github.com/nlohmann/json/issues/278) +- dump\(\) method doesn't work with a custom allocator [\#268](https://github.com/nlohmann/json/issues/268) +- Readme documentation enhancements [\#248](https://github.com/nlohmann/json/issues/248) +- Use user-defined exceptions [\#244](https://github.com/nlohmann/json/issues/244) +- Incorrect C++11 allocator model support [\#161](https://github.com/nlohmann/json/issues/161) + +- :white\_check\_mark: re-added tests for algorithms [\#879](https://github.com/nlohmann/json/pull/879) ([nlohmann](https://github.com/nlohmann)) +- Overworked library toward 3.0.0 release [\#875](https://github.com/nlohmann/json/pull/875) ([nlohmann](https://github.com/nlohmann)) +- :rotating\_light: remove C4996 warnings \#872 [\#873](https://github.com/nlohmann/json/pull/873) ([nlohmann](https://github.com/nlohmann)) +- :boom: throwing an exception in case dump encounters a non-UTF-8 string \#838 [\#870](https://github.com/nlohmann/json/pull/870) ([nlohmann](https://github.com/nlohmann)) +- :memo: fixing documentation \#867 [\#868](https://github.com/nlohmann/json/pull/868) ([nlohmann](https://github.com/nlohmann)) +- iter\_impl template conformance with C++17 [\#860](https://github.com/nlohmann/json/pull/860) ([bogemic](https://github.com/bogemic)) +- Std allocator conformance cpp17 [\#856](https://github.com/nlohmann/json/pull/856) ([bogemic](https://github.com/bogemic)) +- cmake: use BUILD\_INTERFACE/INSTALL\_INTERFACE [\#855](https://github.com/nlohmann/json/pull/855) ([theodelrieu](https://github.com/theodelrieu)) +- to/from\_json: add a MSVC-specific static\_assert to force a stacktrace [\#854](https://github.com/nlohmann/json/pull/854) ([theodelrieu](https://github.com/theodelrieu)) +- Add .natvis for MSVC debug view [\#844](https://github.com/nlohmann/json/pull/844) ([TinyTinni](https://github.com/TinyTinni)) +- Updated hunter package links [\#829](https://github.com/nlohmann/json/pull/829) ([jowr](https://github.com/jowr)) +- Typos README [\#811](https://github.com/nlohmann/json/pull/811) ([Itja](https://github.com/Itja)) +- add forwarding references to json\_ref constructor [\#807](https://github.com/nlohmann/json/pull/807) ([theodelrieu](https://github.com/theodelrieu)) +- Add transparent comparator and perfect forwarding support to find\(\) and count\(\) [\#795](https://github.com/nlohmann/json/pull/795) ([jseward](https://github.com/jseward)) +- Error : 'identifier "size\_t" is undefined' in linux [\#793](https://github.com/nlohmann/json/pull/793) ([sonulohani](https://github.com/sonulohani)) +- Fix Visual Studio 2017 warnings [\#788](https://github.com/nlohmann/json/pull/788) ([jseward](https://github.com/jseward)) +- Fix warning C4706 on Visual Studio 2017 [\#785](https://github.com/nlohmann/json/pull/785) ([jseward](https://github.com/jseward)) +- Set GENERATE\_TAGFILE in Doxyfile [\#783](https://github.com/nlohmann/json/pull/783) ([eld00d](https://github.com/eld00d)) +- using more CMake [\#765](https://github.com/nlohmann/json/pull/765) ([nlohmann](https://github.com/nlohmann)) +- Simplified istream handing \#367 [\#764](https://github.com/nlohmann/json/pull/764) ([pjkundert](https://github.com/pjkundert)) +- Add info for the vcpkg package. [\#753](https://github.com/nlohmann/json/pull/753) ([gregmarr](https://github.com/gregmarr)) +- fix from\_json implementation for pair/tuple [\#708](https://github.com/nlohmann/json/pull/708) ([theodelrieu](https://github.com/theodelrieu)) +- Update json.hpp [\#686](https://github.com/nlohmann/json/pull/686) ([GoWebProd](https://github.com/GoWebProd)) +- Remove duplicate word [\#685](https://github.com/nlohmann/json/pull/685) ([daixtrose](https://github.com/daixtrose)) +- To fix compilation issue for intel OSX compiler [\#682](https://github.com/nlohmann/json/pull/682) ([kbthomp1](https://github.com/kbthomp1)) +- Digraph warning [\#679](https://github.com/nlohmann/json/pull/679) ([traits](https://github.com/traits)) +- massage -\> message [\#678](https://github.com/nlohmann/json/pull/678) ([DmitryKuk](https://github.com/DmitryKuk)) +- Fix "not constraint" grammar in docs [\#674](https://github.com/nlohmann/json/pull/674) ([wincent](https://github.com/wincent)) + +## [v2.1.1](https://github.com/nlohmann/json/releases/tag/v2.1.1) (2017-02-25) + +[Full Changelog](https://github.com/nlohmann/json/compare/2.1.1...v2.1.1) + +## [2.1.1](https://github.com/nlohmann/json/releases/tag/2.1.1) (2017-02-25) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.1.0...2.1.1) + +- warning in the library [\#472](https://github.com/nlohmann/json/issues/472) +- How to create an array of Objects? [\#470](https://github.com/nlohmann/json/issues/470) +- \[Bug?\] Cannot get int pointer, but int64\_t works [\#468](https://github.com/nlohmann/json/issues/468) +- Illegal indirection [\#467](https://github.com/nlohmann/json/issues/467) +- in vs can't find linkageId [\#466](https://github.com/nlohmann/json/issues/466) +- Roundtrip error while parsing "1000000000000000010E5" [\#465](https://github.com/nlohmann/json/issues/465) +- C4996 error and warning with Visual Studio [\#463](https://github.com/nlohmann/json/issues/463) +- Support startIndex for from\_cbor/from\_msgpack [\#462](https://github.com/nlohmann/json/issues/462) +- question: monospace font used in feature slideshow? [\#460](https://github.com/nlohmann/json/issues/460) +- Object.keys\(\) [\#459](https://github.com/nlohmann/json/issues/459) +- Use “, “ as delimiter for json-objects. [\#457](https://github.com/nlohmann/json/issues/457) +- Enum -\> string during serialization and vice versa [\#455](https://github.com/nlohmann/json/issues/455) +- doubles are printed as integers [\#454](https://github.com/nlohmann/json/issues/454) +- Warnings with Visual Studio c++ \(VS2015 Update 3\) [\#453](https://github.com/nlohmann/json/issues/453) +- Heap-buffer-overflow \(OSS-Fuzz issue 585\) [\#452](https://github.com/nlohmann/json/issues/452) +- use of undeclared identifier 'UINT8\_MAX' [\#451](https://github.com/nlohmann/json/issues/451) +- Question on the lifetime managment of objects at the lower levels [\#449](https://github.com/nlohmann/json/issues/449) +- Json should not be constructible with 'json\*' [\#448](https://github.com/nlohmann/json/issues/448) +- Move value\_t to namespace scope [\#447](https://github.com/nlohmann/json/issues/447) +- Typo in README.md [\#446](https://github.com/nlohmann/json/issues/446) +- make check compilation is unneccesarily slow [\#445](https://github.com/nlohmann/json/issues/445) +- Problem in dump\(\) in json.h caused by ss.imbue [\#444](https://github.com/nlohmann/json/issues/444) +- I want to create Windows Application in Visual Studio 2015 c++, and i have a problem [\#443](https://github.com/nlohmann/json/issues/443) +- Implicit conversion issues [\#442](https://github.com/nlohmann/json/issues/442) +- Parsing of floats locale dependent [\#302](https://github.com/nlohmann/json/issues/302) + +- Speedup CI builds using cotire [\#461](https://github.com/nlohmann/json/pull/461) ([tusharpm](https://github.com/tusharpm)) +- TurpentineDistillery feature/locale independent str to num [\#450](https://github.com/nlohmann/json/pull/450) ([nlohmann](https://github.com/nlohmann)) +- README: adjust boost::optional example [\#439](https://github.com/nlohmann/json/pull/439) ([jaredgrubb](https://github.com/jaredgrubb)) +- fix \#414 - comparing to 0 literal [\#415](https://github.com/nlohmann/json/pull/415) ([stanmihai4](https://github.com/stanmihai4)) +- locale-independent num-to-str [\#378](https://github.com/nlohmann/json/pull/378) ([TurpentineDistillery](https://github.com/TurpentineDistillery)) + +## [v2.1.0](https://github.com/nlohmann/json/releases/tag/v2.1.0) (2017-01-28) + +[Full Changelog](https://github.com/nlohmann/json/compare/2.1.0...v2.1.0) + +## [2.1.0](https://github.com/nlohmann/json/releases/tag/2.1.0) (2017-01-28) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.10...2.1.0) + +- Parsing multiple JSON objects from a string or stream [\#438](https://github.com/nlohmann/json/issues/438) +- Use-of-uninitialized-value \(OSS-Fuzz issue 477\) [\#437](https://github.com/nlohmann/json/issues/437) +- add `reserve` function for array to reserve memory before adding json values into it [\#436](https://github.com/nlohmann/json/issues/436) +- Typo in examples page [\#434](https://github.com/nlohmann/json/issues/434) +- avoid malformed json [\#433](https://github.com/nlohmann/json/issues/433) +- How to add json objects to a map? [\#432](https://github.com/nlohmann/json/issues/432) +- create json instance from raw json \(unsigned char\*\) [\#431](https://github.com/nlohmann/json/issues/431) +- Getting std::invalid\_argument: stream error when following example [\#429](https://github.com/nlohmann/json/issues/429) +- Forward declare-only header? [\#427](https://github.com/nlohmann/json/issues/427) +- Implicit conversion from array to object [\#425](https://github.com/nlohmann/json/issues/425) +- error C4996: 'strerror' when reading file [\#422](https://github.com/nlohmann/json/issues/422) +- Get an error - JSON pointer must be empty or begin with '/' [\#421](https://github.com/nlohmann/json/issues/421) +- size parameter for parse\(\) [\#419](https://github.com/nlohmann/json/issues/419) +- json.hpp forcibly defines GCC\_VERSION [\#417](https://github.com/nlohmann/json/issues/417) +- Use-of-uninitialized-value \(OSS-Fuzz issue 377\) [\#416](https://github.com/nlohmann/json/issues/416) +- comparing to 0 literal [\#414](https://github.com/nlohmann/json/issues/414) +- Single char converted to ASCII code instead of string [\#413](https://github.com/nlohmann/json/issues/413) +- How to know if a string was parsed as utf-8? [\#406](https://github.com/nlohmann/json/issues/406) +- Overloaded += to add objects to an array makes no sense? [\#404](https://github.com/nlohmann/json/issues/404) +- Finding a value in an array [\#399](https://github.com/nlohmann/json/issues/399) +- add release information in static function [\#397](https://github.com/nlohmann/json/issues/397) +- Optimize memory usage of json objects in combination with binary serialization [\#373](https://github.com/nlohmann/json/issues/373) +- Conversion operators not considered [\#369](https://github.com/nlohmann/json/issues/369) +- Append ".0" to serialized floating\_point values that are digits-only. [\#362](https://github.com/nlohmann/json/issues/362) +- Add a customization point for user-defined types [\#328](https://github.com/nlohmann/json/issues/328) +- Conformance report for reference [\#307](https://github.com/nlohmann/json/issues/307) +- Document the best way to serialize/deserialize user defined types to json [\#298](https://github.com/nlohmann/json/issues/298) +- Add StringView template typename to basic\_json [\#297](https://github.com/nlohmann/json/issues/297) +- \[Improvement\] Add option to remove exceptions [\#296](https://github.com/nlohmann/json/issues/296) +- Performance in miloyip/nativejson-benchmark [\#202](https://github.com/nlohmann/json/issues/202) + +- conversion from/to user-defined types [\#435](https://github.com/nlohmann/json/pull/435) ([nlohmann](https://github.com/nlohmann)) +- Fix documentation error [\#430](https://github.com/nlohmann/json/pull/430) ([vjon](https://github.com/vjon)) + +## [v2.0.10](https://github.com/nlohmann/json/releases/tag/v2.0.10) (2017-01-02) + +[Full Changelog](https://github.com/nlohmann/json/compare/2.0.10...v2.0.10) + +## [2.0.10](https://github.com/nlohmann/json/releases/tag/2.0.10) (2017-01-02) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.9...2.0.10) + +- Heap-buffer-overflow \(OSS-Fuzz issue 367\) [\#412](https://github.com/nlohmann/json/issues/412) +- Heap-buffer-overflow \(OSS-Fuzz issue 366\) [\#411](https://github.com/nlohmann/json/issues/411) +- Use-of-uninitialized-value \(OSS-Fuzz issue 347\) [\#409](https://github.com/nlohmann/json/issues/409) +- Heap-buffer-overflow \(OSS-Fuzz issue 344\) [\#408](https://github.com/nlohmann/json/issues/408) +- Heap-buffer-overflow \(OSS-Fuzz issue 343\) [\#407](https://github.com/nlohmann/json/issues/407) +- Heap-buffer-overflow \(OSS-Fuzz issue 342\) [\#405](https://github.com/nlohmann/json/issues/405) +- strerror throwing error in compiler VS2015 [\#403](https://github.com/nlohmann/json/issues/403) +- json::parse of std::string being underlined by Visual Studio [\#402](https://github.com/nlohmann/json/issues/402) +- Explicitly getting string without .dump\(\) [\#401](https://github.com/nlohmann/json/issues/401) +- Possible to speed up json::parse? [\#398](https://github.com/nlohmann/json/issues/398) +- the alphabetic order in the code influence console\_output. [\#396](https://github.com/nlohmann/json/issues/396) +- Execute tests with clang sanitizers [\#394](https://github.com/nlohmann/json/issues/394) +- Check if library can be used with ETL [\#361](https://github.com/nlohmann/json/issues/361) + +- Feature/clang sanitize [\#410](https://github.com/nlohmann/json/pull/410) ([Daniel599](https://github.com/Daniel599)) +- Add Doozer build badge [\#400](https://github.com/nlohmann/json/pull/400) ([andoma](https://github.com/andoma)) + +## [v2.0.9](https://github.com/nlohmann/json/releases/tag/v2.0.9) (2016-12-16) + +[Full Changelog](https://github.com/nlohmann/json/compare/2.0.9...v2.0.9) + +## [2.0.9](https://github.com/nlohmann/json/releases/tag/2.0.9) (2016-12-16) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.8...2.0.9) + +- \#pragma GCC diagnostic ignored "-Wdocumentation" [\#393](https://github.com/nlohmann/json/issues/393) +- How to parse this json file and write separate sub object as json files? [\#392](https://github.com/nlohmann/json/issues/392) +- Integer-overflow \(OSS-Fuzz issue 267\) [\#389](https://github.com/nlohmann/json/issues/389) +- Implement indefinite-length types from RFC 7049 [\#387](https://github.com/nlohmann/json/issues/387) +- template parameter "T" is not used in declaring the parameter types of function template [\#386](https://github.com/nlohmann/json/issues/386) +- Serializing json instances containing already serialized string values without escaping [\#385](https://github.com/nlohmann/json/issues/385) +- Add test cases from RFC 7049 [\#384](https://github.com/nlohmann/json/issues/384) +- Add a table of contents to the README file [\#383](https://github.com/nlohmann/json/issues/383) +- Update FAQ section in the guidelines for contributing [\#382](https://github.com/nlohmann/json/issues/382) +- Allow for forward declaring nlohmann::json [\#381](https://github.com/nlohmann/json/issues/381) +- Bug in overflow detection when parsing integers [\#380](https://github.com/nlohmann/json/issues/380) +- A unique name to mention the library? [\#377](https://github.com/nlohmann/json/issues/377) +- Non-unique keys in objects. [\#375](https://github.com/nlohmann/json/issues/375) +- Request: binary serialization/deserialization [\#358](https://github.com/nlohmann/json/issues/358) + +- Replace class iterator and const\_iterator by using a single template class to reduce code. [\#395](https://github.com/nlohmann/json/pull/395) ([Bosswestfalen](https://github.com/Bosswestfalen)) +- Clang: quiet a warning [\#391](https://github.com/nlohmann/json/pull/391) ([jaredgrubb](https://github.com/jaredgrubb)) +- Fix issue \#380: Signed integer overflow check [\#390](https://github.com/nlohmann/json/pull/390) ([qwename](https://github.com/qwename)) + +## [v2.0.8](https://github.com/nlohmann/json/releases/tag/v2.0.8) (2016-12-02) + +[Full Changelog](https://github.com/nlohmann/json/compare/2.0.8...v2.0.8) + +## [2.0.8](https://github.com/nlohmann/json/releases/tag/2.0.8) (2016-12-02) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.7...2.0.8) + +- Reading from file [\#374](https://github.com/nlohmann/json/issues/374) +- Compiler warnings? [\#372](https://github.com/nlohmann/json/issues/372) +- docs: how to release a json object in memory? [\#371](https://github.com/nlohmann/json/issues/371) +- crash in dump [\#370](https://github.com/nlohmann/json/issues/370) +- Coverity issue \(FORWARD\_NULL\) in lexer\(std::istream& s\) [\#368](https://github.com/nlohmann/json/issues/368) +- json::parse on failed stream gets stuck [\#366](https://github.com/nlohmann/json/issues/366) +- Performance improvements [\#365](https://github.com/nlohmann/json/issues/365) +- 'to\_string' is not a member of 'std' [\#364](https://github.com/nlohmann/json/issues/364) +- Crash in dump\(\) from a static object [\#359](https://github.com/nlohmann/json/issues/359) +- json::parse\(...\) vs json j; j.parse\(...\) [\#357](https://github.com/nlohmann/json/issues/357) +- Hi, is there any method to dump json to string with the insert order rather than alphabets [\#356](https://github.com/nlohmann/json/issues/356) +- Provide an example of reading from an json with only a key that has an array of strings. [\#354](https://github.com/nlohmann/json/issues/354) +- Request: access with default value. [\#353](https://github.com/nlohmann/json/issues/353) +- {} and \[\] causes parser error. [\#352](https://github.com/nlohmann/json/issues/352) +- Reading a JSON file into a JSON object [\#351](https://github.com/nlohmann/json/issues/351) +- Request: 'emplace\_back' [\#349](https://github.com/nlohmann/json/issues/349) +- Is it possible to stream data through the json parser without storing everything in memory? [\#347](https://github.com/nlohmann/json/issues/347) +- pure virtual conversion operator [\#346](https://github.com/nlohmann/json/issues/346) +- Floating point precision lost [\#345](https://github.com/nlohmann/json/issues/345) +- unit-conversions SIGSEGV on armv7hl [\#303](https://github.com/nlohmann/json/issues/303) +- Coverity scan fails [\#299](https://github.com/nlohmann/json/issues/299) +- Using QString as string type [\#274](https://github.com/nlohmann/json/issues/274) + +## [v2.0.7](https://github.com/nlohmann/json/releases/tag/v2.0.7) (2016-11-02) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.6...v2.0.7) + +- JSON5 [\#348](https://github.com/nlohmann/json/issues/348) +- Check "Parsing JSON is a Minefield" [\#344](https://github.com/nlohmann/json/issues/344) +- Allow hex numbers [\#342](https://github.com/nlohmann/json/issues/342) +- Convert strings to numbers [\#341](https://github.com/nlohmann/json/issues/341) +- ""-operators ignore the length parameter [\#340](https://github.com/nlohmann/json/issues/340) +- JSON into std::tuple [\#339](https://github.com/nlohmann/json/issues/339) +- JSON into vector [\#335](https://github.com/nlohmann/json/issues/335) +- Installing with Homebrew on Mac Errors \(El Capitan\) [\#331](https://github.com/nlohmann/json/issues/331) +- g++ make check results in error [\#312](https://github.com/nlohmann/json/issues/312) +- Cannot convert from 'json' to 'char' [\#276](https://github.com/nlohmann/json/issues/276) +- Please add a Pretty-Print option for arrays to stay always in one line [\#229](https://github.com/nlohmann/json/issues/229) +- Conversion to STL map\\> gives error [\#220](https://github.com/nlohmann/json/issues/220) +- std::unorderd\_map cannot be used as ObjectType [\#164](https://github.com/nlohmann/json/issues/164) + +- fix minor grammar/style issue in README.md [\#336](https://github.com/nlohmann/json/pull/336) ([seeekr](https://github.com/seeekr)) + +## [v2.0.6](https://github.com/nlohmann/json/releases/tag/v2.0.6) (2016-10-15) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.5...v2.0.6) + +- How to handle json files? [\#333](https://github.com/nlohmann/json/issues/333) +- This file requires compiler and library support .... [\#332](https://github.com/nlohmann/json/issues/332) +- Segmentation fault on saving json to file [\#326](https://github.com/nlohmann/json/issues/326) +- parse error - unexpected \ with 2.0.5 [\#325](https://github.com/nlohmann/json/issues/325) +- Add nested object capability to pointers [\#323](https://github.com/nlohmann/json/issues/323) +- Fix usage examples' comments for std::multiset [\#322](https://github.com/nlohmann/json/issues/322) +- json\_unit runs forever when executed in build directory [\#319](https://github.com/nlohmann/json/issues/319) +- Visual studio 2015 update3 true != TRUE [\#317](https://github.com/nlohmann/json/issues/317) +- releasing single header file in compressed format [\#316](https://github.com/nlohmann/json/issues/316) +- json object from std::ifstream [\#315](https://github.com/nlohmann/json/issues/315) + +- make has\_mapped\_type struct friendly [\#324](https://github.com/nlohmann/json/pull/324) ([vpetrigo](https://github.com/vpetrigo)) +- Fix usage examples' comments for std::multiset [\#321](https://github.com/nlohmann/json/pull/321) ([vasild](https://github.com/vasild)) +- Include dir relocation [\#318](https://github.com/nlohmann/json/pull/318) ([ChristophJud](https://github.com/ChristophJud)) +- trivial documentation fix [\#313](https://github.com/nlohmann/json/pull/313) ([5tefan](https://github.com/5tefan)) +- unit-constructor1.cpp: Fix floating point truncation warning [\#300](https://github.com/nlohmann/json/pull/300) ([t-b](https://github.com/t-b)) + +## [v2.0.5](https://github.com/nlohmann/json/releases/tag/v2.0.5) (2016-09-14) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.4...v2.0.5) + +- \[feature request\]: schema validator and comments [\#311](https://github.com/nlohmann/json/issues/311) +- make json\_benchmarks no longer working in 2.0.4 [\#310](https://github.com/nlohmann/json/issues/310) +- Segmentation fault \(core dumped\) [\#309](https://github.com/nlohmann/json/issues/309) +- No matching member function for call to 'get\_impl' [\#308](https://github.com/nlohmann/json/issues/308) + +## [v2.0.4](https://github.com/nlohmann/json/releases/tag/v2.0.4) (2016-09-11) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.3...v2.0.4) + +- Parsing fails without space at end of file [\#306](https://github.com/nlohmann/json/issues/306) +- json schema validator [\#305](https://github.com/nlohmann/json/issues/305) +- Unused variable warning [\#304](https://github.com/nlohmann/json/issues/304) + +## [v2.0.3](https://github.com/nlohmann/json/releases/tag/v2.0.3) (2016-08-31) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.2...v2.0.3) + +- warning C4706: assignment within conditional expression [\#295](https://github.com/nlohmann/json/issues/295) +- Q: Is it possible to build json tree from already UTF8 encoded values? [\#293](https://github.com/nlohmann/json/issues/293) +- Equality operator results in array when assigned object [\#292](https://github.com/nlohmann/json/issues/292) +- Support for integers not from the range \[-\(2\*\*53\)+1, \(2\*\*53\)-1\] in parser [\#291](https://github.com/nlohmann/json/issues/291) +- Support for iterator-range parsing [\#290](https://github.com/nlohmann/json/issues/290) +- Horribly inconsistent behavior between const/non-const reference in operator \[\] \(\) [\#289](https://github.com/nlohmann/json/issues/289) +- Silently get numbers into smaller types [\#288](https://github.com/nlohmann/json/issues/288) +- Incorrect parsing of large int64\_t numbers [\#287](https://github.com/nlohmann/json/issues/287) +- \[question\]: macro to disable floating point support [\#284](https://github.com/nlohmann/json/issues/284) + +## [v2.0.2](https://github.com/nlohmann/json/releases/tag/v2.0.2) (2016-07-31) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.1...v2.0.2) + +- can function dump\(\) return string in the order I push in the json object ? [\#286](https://github.com/nlohmann/json/issues/286) +- Error on the Mac: Undefined symbols for architecture x86\_64 [\#285](https://github.com/nlohmann/json/issues/285) +- value\(\) does not work with \_json\_pointer types [\#283](https://github.com/nlohmann/json/issues/283) +- Build error for std::int64 [\#282](https://github.com/nlohmann/json/issues/282) +- strings can't be accessed after dump\(\)-\>parse\(\) - type is lost [\#281](https://github.com/nlohmann/json/issues/281) +- Easy serialization of classes [\#280](https://github.com/nlohmann/json/issues/280) +- recursive data structures [\#277](https://github.com/nlohmann/json/issues/277) +- hexify\(\) function emits conversion warning [\#270](https://github.com/nlohmann/json/issues/270) + +- let the makefile choose the correct sed [\#279](https://github.com/nlohmann/json/pull/279) ([murinicanor](https://github.com/murinicanor)) +- Update hexify to use array lookup instead of ternary \(\#270\) [\#275](https://github.com/nlohmann/json/pull/275) ([dtoma](https://github.com/dtoma)) + +## [v2.0.1](https://github.com/nlohmann/json/releases/tag/v2.0.1) (2016-06-28) + +[Full Changelog](https://github.com/nlohmann/json/compare/v2.0.0...v2.0.1) + +- Compilation error. [\#273](https://github.com/nlohmann/json/issues/273) +- dump\(\) performance degradation in v2 [\#272](https://github.com/nlohmann/json/issues/272) + +- fixed a tiny typo [\#271](https://github.com/nlohmann/json/pull/271) ([feroldi](https://github.com/feroldi)) + +## [v2.0.0](https://github.com/nlohmann/json/releases/tag/v2.0.0) (2016-06-23) + +[Full Changelog](https://github.com/nlohmann/json/compare/v1.1.0...v2.0.0) + +- json::diff generates incorrect patch when removing multiple array elements. [\#269](https://github.com/nlohmann/json/issues/269) +- Docs - What does Json\[key\] return? [\#267](https://github.com/nlohmann/json/issues/267) +- Compiler Errors With JSON.hpp [\#265](https://github.com/nlohmann/json/issues/265) +- Ambiguous push\_back and operator+= overloads [\#263](https://github.com/nlohmann/json/issues/263) +- Preseving order of items in json [\#262](https://github.com/nlohmann/json/issues/262) +- '\' char problem in strings [\#261](https://github.com/nlohmann/json/issues/261) +- VS2015 compile fail [\#260](https://github.com/nlohmann/json/issues/260) +- -Wconversion warning [\#259](https://github.com/nlohmann/json/issues/259) +- Maybe a bug [\#258](https://github.com/nlohmann/json/issues/258) +- Few tests failed on Visual C++ 2015 [\#257](https://github.com/nlohmann/json/issues/257) +- Access keys when iteration with new for loop C++11 [\#256](https://github.com/nlohmann/json/issues/256) +- multiline text values [\#255](https://github.com/nlohmann/json/issues/255) +- Error when using json in g++ [\#254](https://github.com/nlohmann/json/issues/254) +- is the release 2.0? [\#253](https://github.com/nlohmann/json/issues/253) +- concatenate objects [\#252](https://github.com/nlohmann/json/issues/252) +- Encoding [\#251](https://github.com/nlohmann/json/issues/251) +- Unable to build example for constructing json object with stringstreams [\#250](https://github.com/nlohmann/json/issues/250) +- Hexadecimal support [\#249](https://github.com/nlohmann/json/issues/249) +- Update long-term goals [\#246](https://github.com/nlohmann/json/issues/246) +- Contribution To This Json Project [\#245](https://github.com/nlohmann/json/issues/245) +- Trouble using parser with initial dictionary [\#243](https://github.com/nlohmann/json/issues/243) +- Unit test fails when doing a CMake out-of-tree build [\#241](https://github.com/nlohmann/json/issues/241) +- -Wconversion warnings [\#239](https://github.com/nlohmann/json/issues/239) +- Additional integration options [\#237](https://github.com/nlohmann/json/issues/237) +- .get\\(\) works for non spaced string but returns as array for spaced/longer strings [\#236](https://github.com/nlohmann/json/issues/236) +- ambiguous overload for 'push\_back' and 'operator+=' [\#235](https://github.com/nlohmann/json/issues/235) +- Can't use basic\_json::iterator as a base iterator for std::move\_iterator [\#233](https://github.com/nlohmann/json/issues/233) +- json object's creation can freezes execution [\#231](https://github.com/nlohmann/json/issues/231) +- Incorrect dumping of parsed numbers with exponents, but without decimal places [\#230](https://github.com/nlohmann/json/issues/230) +- double values are serialized with commas as decimal points [\#228](https://github.com/nlohmann/json/issues/228) +- Move semantics with std::initializer\_list [\#225](https://github.com/nlohmann/json/issues/225) +- replace emplace [\#224](https://github.com/nlohmann/json/issues/224) +- abort during getline in yyfill [\#223](https://github.com/nlohmann/json/issues/223) +- free\(\): invalid pointer error in GCC 5.2.1 [\#221](https://github.com/nlohmann/json/issues/221) +- Error compile Android NDK error: 'strtof' is not a member of 'std' [\#219](https://github.com/nlohmann/json/issues/219) +- Wrong link in the README.md [\#217](https://github.com/nlohmann/json/issues/217) +- Wide character strings not supported [\#216](https://github.com/nlohmann/json/issues/216) +- Memory allocations using range-based for loops [\#214](https://github.com/nlohmann/json/issues/214) +- would you like to support gcc 4.8.1? [\#211](https://github.com/nlohmann/json/issues/211) +- Reading concatenated json's from an istream [\#210](https://github.com/nlohmann/json/issues/210) +- Conflicting typedef of ssize\_t on Windows 32 bit when using Boost.Python [\#204](https://github.com/nlohmann/json/issues/204) +- Inconsistency between operator\[\] and push\_back [\#203](https://github.com/nlohmann/json/issues/203) +- Small bugs in json.hpp \(get\_number\) and unit.cpp \(non-standard integer type test\) [\#199](https://github.com/nlohmann/json/issues/199) +- GCC/clang floating point parsing bug in strtod\(\) [\#195](https://github.com/nlohmann/json/issues/195) +- What is within scope? [\#192](https://github.com/nlohmann/json/issues/192) +- Bugs in miloyip/nativejson-benchmark: roundtrips [\#187](https://github.com/nlohmann/json/issues/187) +- Floating point exceptions [\#181](https://github.com/nlohmann/json/issues/181) +- map string string fails to compile [\#176](https://github.com/nlohmann/json/issues/176) +- In basic\_json::basic\_json\(const CompatibleArrayType& val\), the requirement of CompatibleArrayType is not strict enough. [\#174](https://github.com/nlohmann/json/issues/174) +- Provide a FAQ [\#163](https://github.com/nlohmann/json/issues/163) +- Implicit assignment to std::string fails [\#144](https://github.com/nlohmann/json/issues/144) + +- Fix Issue \#265 [\#266](https://github.com/nlohmann/json/pull/266) ([06needhamt](https://github.com/06needhamt)) +- Define CMake/CTest tests [\#247](https://github.com/nlohmann/json/pull/247) ([robertmrk](https://github.com/robertmrk)) +- Out of tree builds and a few other miscellaneous CMake cleanups. [\#242](https://github.com/nlohmann/json/pull/242) ([ChrisKitching](https://github.com/ChrisKitching)) +- Implement additional integration options [\#238](https://github.com/nlohmann/json/pull/238) ([robertmrk](https://github.com/robertmrk)) +- make serialization locale-independent [\#232](https://github.com/nlohmann/json/pull/232) ([nlohmann](https://github.com/nlohmann)) +- fixes \#223 by updating README.md [\#227](https://github.com/nlohmann/json/pull/227) ([kevin--](https://github.com/kevin--)) +- Use namespace std for int64\_t and uint64\_t [\#226](https://github.com/nlohmann/json/pull/226) ([lv-zheng](https://github.com/lv-zheng)) +- Added missing cerrno header to fix ERANGE compile error on android [\#222](https://github.com/nlohmann/json/pull/222) ([Teemperor](https://github.com/Teemperor)) +- Corrected readme [\#218](https://github.com/nlohmann/json/pull/218) ([Annihil](https://github.com/Annihil)) +- Create PULL\_REQUEST\_TEMPLATE.md [\#213](https://github.com/nlohmann/json/pull/213) ([whackashoe](https://github.com/whackashoe)) +- fixed noexcept; added constexpr [\#208](https://github.com/nlohmann/json/pull/208) ([nlohmann](https://github.com/nlohmann)) +- Add support for afl-fuzz testing [\#207](https://github.com/nlohmann/json/pull/207) ([mykter](https://github.com/mykter)) +- replaced ssize\_t occurrences with auto \(addresses \#204\) [\#205](https://github.com/nlohmann/json/pull/205) ([nlohmann](https://github.com/nlohmann)) +- Fix broken link [\#197](https://github.com/nlohmann/json/pull/197) ([vog](https://github.com/vog)) +- Issue \#195 - update Travis to Trusty due to gcc/clang strtod\(\) bug [\#196](https://github.com/nlohmann/json/pull/196) ([twelsby](https://github.com/twelsby)) +- Issue \#178 - Extending support to full uint64\_t/int64\_t range and unsigned type \(updated\) [\#193](https://github.com/nlohmann/json/pull/193) ([twelsby](https://github.com/twelsby)) + +## [v1.1.0](https://github.com/nlohmann/json/releases/tag/v1.1.0) (2016-01-24) + +[Full Changelog](https://github.com/nlohmann/json/compare/v1.0.0...v1.1.0) + +- Small error in pull \#185 [\#194](https://github.com/nlohmann/json/issues/194) +- Bugs in miloyip/nativejson-benchmark: floating-point parsing [\#186](https://github.com/nlohmann/json/issues/186) +- Floating point equality [\#185](https://github.com/nlohmann/json/issues/185) +- Unused variables in catch [\#180](https://github.com/nlohmann/json/issues/180) +- Typo in documentation [\#179](https://github.com/nlohmann/json/issues/179) +- Integer conversion to unsigned [\#178](https://github.com/nlohmann/json/issues/178) +- JSON performance benchmark comparision [\#177](https://github.com/nlohmann/json/issues/177) +- Since re2c is often ignored in pull requests, it may make sense to make a contributing.md file [\#175](https://github.com/nlohmann/json/issues/175) +- Question about exceptions [\#173](https://github.com/nlohmann/json/issues/173) +- Android? [\#172](https://github.com/nlohmann/json/issues/172) +- Cannot index by key of type static constexpr const char\* [\#171](https://github.com/nlohmann/json/issues/171) +- Add assertions [\#168](https://github.com/nlohmann/json/issues/168) +- MSVC 2015 build fails when attempting to compare object\_t [\#167](https://github.com/nlohmann/json/issues/167) +- Member detector is not portable [\#166](https://github.com/nlohmann/json/issues/166) +- Unnecessary const\_cast [\#162](https://github.com/nlohmann/json/issues/162) +- Question about get\_ref\(\) [\#128](https://github.com/nlohmann/json/issues/128) +- range based for loop for objects [\#83](https://github.com/nlohmann/json/issues/83) +- Consider submitting this to the Boost Library Incubator [\#66](https://github.com/nlohmann/json/issues/66) + +- Fixed issue \#199 - Small bugs in json.hpp \(get\_number\) and unit.cpp \(non-standard integer type test\) [\#200](https://github.com/nlohmann/json/pull/200) ([twelsby](https://github.com/twelsby)) +- Fixed Issue \#186 - add strto\(f|d|ld\) overload wrappers, "-0.0" special case and FP trailing zero [\#191](https://github.com/nlohmann/json/pull/191) ([twelsby](https://github.com/twelsby)) +- Issue \#185 - remove approx\(\) and use \#pragma to kill warnings [\#190](https://github.com/nlohmann/json/pull/190) ([twelsby](https://github.com/twelsby)) +- Fixed Issue \#171 - added two extra template overloads of operator\[\] for T\* arguments [\#189](https://github.com/nlohmann/json/pull/189) ([twelsby](https://github.com/twelsby)) +- Fixed issue \#167 - removed operator ValueType\(\) condition for VS2015 [\#188](https://github.com/nlohmann/json/pull/188) ([twelsby](https://github.com/twelsby)) +- Fixed some typos in CONTRIBUTING.md [\#182](https://github.com/nlohmann/json/pull/182) ([nibroc](https://github.com/nibroc)) + +## [v1.0.0](https://github.com/nlohmann/json/releases/tag/v1.0.0) (2015-12-27) + +[Full Changelog](https://github.com/nlohmann/json/compare/v1.0.0-rc1...v1.0.0) + +- add key name to exception [\#160](https://github.com/nlohmann/json/issues/160) +- Getting member discarding qualifyer [\#159](https://github.com/nlohmann/json/issues/159) +- basic\_json::iterator::value\(\) output includes quotes while basic\_json::iterator::key\(\) doesn't [\#158](https://github.com/nlohmann/json/issues/158) +- Indexing `const basic\_json\<\>` with `const basic\_string\` [\#157](https://github.com/nlohmann/json/issues/157) +- token\_type\_name\(token\_type t\): not all control paths return a value [\#156](https://github.com/nlohmann/json/issues/156) +- prevent json.hpp from emitting compiler warnings [\#154](https://github.com/nlohmann/json/issues/154) +- json::parse\(string\) does not check utf8 bom [\#152](https://github.com/nlohmann/json/issues/152) +- unsigned 64bit values output as signed [\#151](https://github.com/nlohmann/json/issues/151) +- Wish feature: json5 [\#150](https://github.com/nlohmann/json/issues/150) +- Unable to compile on MSVC 2015 with SDL checking enabled: This function or variable may be unsafe. [\#149](https://github.com/nlohmann/json/issues/149) +- "Json Object" type does not keep object order [\#148](https://github.com/nlohmann/json/issues/148) +- dump\(\) convert strings encoded by utf-8 to shift-jis on windows 10. [\#147](https://github.com/nlohmann/json/issues/147) +- Unable to get field names in a json object [\#145](https://github.com/nlohmann/json/issues/145) +- Question: Is the use of incomplete type correct? [\#138](https://github.com/nlohmann/json/issues/138) +- json.hpp:5746:32: error: 'to\_string' is not a member of 'std' [\#136](https://github.com/nlohmann/json/issues/136) +- Bug in basic\_json::operator\[\] const overload [\#135](https://github.com/nlohmann/json/issues/135) +- wrong enable\_if for const pointer \(instead of pointer-to-const\) [\#134](https://github.com/nlohmann/json/issues/134) +- overload of at\(\) with default value [\#133](https://github.com/nlohmann/json/issues/133) +- Splitting source [\#132](https://github.com/nlohmann/json/issues/132) +- Question about get\_ptr\(\) [\#127](https://github.com/nlohmann/json/issues/127) +- Visual Studio 14 Debug assertion failed [\#125](https://github.com/nlohmann/json/issues/125) +- Memory leak in face of exceptions [\#118](https://github.com/nlohmann/json/issues/118) +- Find and Count for arrays [\#117](https://github.com/nlohmann/json/issues/117) +- dynamically constructing an arbitrarily nested object [\#114](https://github.com/nlohmann/json/issues/114) +- Returning any data type [\#113](https://github.com/nlohmann/json/issues/113) +- Compile error with g++ 4.9.3 cygwin 64-bit [\#112](https://github.com/nlohmann/json/issues/112) +- insert json array issue with gcc4.8.2 [\#110](https://github.com/nlohmann/json/issues/110) +- error: unterminated raw string [\#109](https://github.com/nlohmann/json/issues/109) +- vector\ copy constructor really weird [\#108](https://github.com/nlohmann/json/issues/108) +- \[clang-3.6.2\] string/sstream with number to json issue [\#107](https://github.com/nlohmann/json/issues/107) +- object field accessors [\#103](https://github.com/nlohmann/json/issues/103) +- v8pp and json [\#95](https://github.com/nlohmann/json/issues/95) +- Wishlist [\#65](https://github.com/nlohmann/json/issues/65) +- Windows/Visual Studio \(through 2013\) is unsupported [\#62](https://github.com/nlohmann/json/issues/62) + +- Implementation of get\_ref\(\) [\#184](https://github.com/nlohmann/json/pull/184) ([dariomt](https://github.com/dariomt)) +- Replace sprintf with hex function, this fixes \#149 [\#153](https://github.com/nlohmann/json/pull/153) ([whackashoe](https://github.com/whackashoe)) +- Fix character skipping after a surrogate pair [\#146](https://github.com/nlohmann/json/pull/146) ([robertmrk](https://github.com/robertmrk)) +- Detect correctly pointer-to-const [\#137](https://github.com/nlohmann/json/pull/137) ([dariomt](https://github.com/dariomt)) +- disabled "CopyAssignable" test for MSVC in Debug mode, see \#125 [\#131](https://github.com/nlohmann/json/pull/131) ([dariomt](https://github.com/dariomt)) +- removed stream operator for iterator, resolution for \#125 [\#130](https://github.com/nlohmann/json/pull/130) ([dariomt](https://github.com/dariomt)) +- fixed typos in comments for examples [\#129](https://github.com/nlohmann/json/pull/129) ([dariomt](https://github.com/dariomt)) +- Remove superfluous inefficiency [\#126](https://github.com/nlohmann/json/pull/126) ([d-frey](https://github.com/d-frey)) +- remove invalid parameter '-stdlib=libc++' in CMakeLists.txt [\#124](https://github.com/nlohmann/json/pull/124) ([emvivre](https://github.com/emvivre)) +- exception-safe object creation, fixes \#118 [\#122](https://github.com/nlohmann/json/pull/122) ([d-frey](https://github.com/d-frey)) +- Fix small oversight. [\#121](https://github.com/nlohmann/json/pull/121) ([ColinH](https://github.com/ColinH)) +- Overload parse\(\) to accept an rvalue reference [\#120](https://github.com/nlohmann/json/pull/120) ([silverweed](https://github.com/silverweed)) +- Use the right variable name in doc string [\#115](https://github.com/nlohmann/json/pull/115) ([whoshuu](https://github.com/whoshuu)) + +## [v1.0.0-rc1](https://github.com/nlohmann/json/releases/tag/v1.0.0-rc1) (2015-07-26) + +[Full Changelog](https://github.com/nlohmann/json/compare/4502e7e51c0569419c26e75fbdd5748170603e54...v1.0.0-rc1) + +- Finish documenting the public interface in Doxygen [\#102](https://github.com/nlohmann/json/issues/102) +- Binary string causes numbers to be dumped as hex [\#101](https://github.com/nlohmann/json/issues/101) +- failed to iterator json object with reverse\_iterator [\#100](https://github.com/nlohmann/json/issues/100) +- 'noexcept' : unknown override specifier [\#99](https://github.com/nlohmann/json/issues/99) +- json float parsing problem [\#98](https://github.com/nlohmann/json/issues/98) +- Adjust wording to JSON RFC [\#97](https://github.com/nlohmann/json/issues/97) +- static analysis warnings [\#94](https://github.com/nlohmann/json/issues/94) +- reverse\_iterator operator inheritance problem [\#93](https://github.com/nlohmann/json/issues/93) +- init error [\#92](https://github.com/nlohmann/json/issues/92) +- access by \(const\) reference [\#91](https://github.com/nlohmann/json/issues/91) +- is\_integer and is\_float tests [\#90](https://github.com/nlohmann/json/issues/90) +- Nonstandard integer type [\#89](https://github.com/nlohmann/json/issues/89) +- static library build [\#84](https://github.com/nlohmann/json/issues/84) +- lexer::get\_number return NAN [\#82](https://github.com/nlohmann/json/issues/82) +- MinGW have no std::to\_string [\#80](https://github.com/nlohmann/json/issues/80) +- Incorrect behaviour of basic\_json::count method [\#78](https://github.com/nlohmann/json/issues/78) +- Invoking is\_array\(\) function creates "null" value [\#77](https://github.com/nlohmann/json/issues/77) +- dump\(\) / parse\(\) not idempotent [\#76](https://github.com/nlohmann/json/issues/76) +- Handle infinity and NaN cases [\#70](https://github.com/nlohmann/json/issues/70) +- errors in g++-4.8.1 [\#68](https://github.com/nlohmann/json/issues/68) +- Keys when iterating over objects [\#67](https://github.com/nlohmann/json/issues/67) +- Compilation results in tons of warnings [\#64](https://github.com/nlohmann/json/issues/64) +- Complete brief documentation [\#61](https://github.com/nlohmann/json/issues/61) +- Double quotation mark is not parsed correctly [\#60](https://github.com/nlohmann/json/issues/60) +- Get coverage back to 100% [\#58](https://github.com/nlohmann/json/issues/58) +- erase elements using iterators [\#57](https://github.com/nlohmann/json/issues/57) +- Removing item from array [\#56](https://github.com/nlohmann/json/issues/56) +- Serialize/Deserialize like PHP? [\#55](https://github.com/nlohmann/json/issues/55) +- Numbers as keys [\#54](https://github.com/nlohmann/json/issues/54) +- Why are elements alphabetized on key while iterating? [\#53](https://github.com/nlohmann/json/issues/53) +- Document erase, count, and iterators key and value [\#52](https://github.com/nlohmann/json/issues/52) +- Do not use std::to\_string [\#51](https://github.com/nlohmann/json/issues/51) +- Supported compilers [\#50](https://github.com/nlohmann/json/issues/50) +- Confused about iterating through json objects [\#49](https://github.com/nlohmann/json/issues/49) +- Use non-member begin/end [\#48](https://github.com/nlohmann/json/issues/48) +- Erase key [\#47](https://github.com/nlohmann/json/issues/47) +- Key iterator [\#46](https://github.com/nlohmann/json/issues/46) +- Add count member function [\#45](https://github.com/nlohmann/json/issues/45) +- Problem getting vector \(array\) of strings [\#44](https://github.com/nlohmann/json/issues/44) +- Compilation error due to assuming that private=public [\#43](https://github.com/nlohmann/json/issues/43) +- Use of deprecated implicit copy constructor [\#42](https://github.com/nlohmann/json/issues/42) +- Printing attribute names [\#39](https://github.com/nlohmann/json/issues/39) +- dumping a small number\_float just outputs 0.000000 [\#37](https://github.com/nlohmann/json/issues/37) +- find is error [\#32](https://github.com/nlohmann/json/issues/32) +- Avoid using spaces when encoding without pretty print [\#31](https://github.com/nlohmann/json/issues/31) +- Cannot encode long numbers [\#30](https://github.com/nlohmann/json/issues/30) +- segmentation fault when iterating over empty arrays/objects [\#28](https://github.com/nlohmann/json/issues/28) +- Creating an empty array [\#27](https://github.com/nlohmann/json/issues/27) +- Custom allocator support [\#25](https://github.com/nlohmann/json/issues/25) +- make the type of the used string container customizable [\#20](https://github.com/nlohmann/json/issues/20) +- Improper parsing of JSON string "\\" [\#17](https://github.com/nlohmann/json/issues/17) +- create a header-only version [\#16](https://github.com/nlohmann/json/issues/16) +- Don't return "const values" [\#15](https://github.com/nlohmann/json/issues/15) +- Add to\_string overload for indentation [\#13](https://github.com/nlohmann/json/issues/13) +- string parser does not recognize uncompliant strings [\#12](https://github.com/nlohmann/json/issues/12) +- possible double-free in find function [\#11](https://github.com/nlohmann/json/issues/11) +- UTF-8 encoding/deconding/testing [\#10](https://github.com/nlohmann/json/issues/10) +- move code into namespace [\#9](https://github.com/nlohmann/json/issues/9) +- free functions for explicit objects and arrays in initializer lists [\#8](https://github.com/nlohmann/json/issues/8) +- unique\_ptr for ownership [\#7](https://github.com/nlohmann/json/issues/7) +- Add unit tests [\#4](https://github.com/nlohmann/json/issues/4) +- Drop C++98 support [\#3](https://github.com/nlohmann/json/issues/3) +- Test case coverage [\#2](https://github.com/nlohmann/json/issues/2) +- Runtime error in Travis job [\#1](https://github.com/nlohmann/json/issues/1) + +- Keyword 'inline' is useless when member functions are defined in headers [\#87](https://github.com/nlohmann/json/pull/87) ([ahamez](https://github.com/ahamez)) +- Remove useless typename [\#86](https://github.com/nlohmann/json/pull/86) ([ahamez](https://github.com/ahamez)) +- Avoid warning with Xcode's clang [\#85](https://github.com/nlohmann/json/pull/85) ([ahamez](https://github.com/ahamez)) +- Fix typos [\#73](https://github.com/nlohmann/json/pull/73) ([aqnouch](https://github.com/aqnouch)) +- Replace `default\_callback` function with `nullptr` and check for null… [\#72](https://github.com/nlohmann/json/pull/72) ([aburgh](https://github.com/aburgh)) +- support enum [\#71](https://github.com/nlohmann/json/pull/71) ([likebeta](https://github.com/likebeta)) +- Fix performance regression introduced with the parsing callback feature. [\#69](https://github.com/nlohmann/json/pull/69) ([aburgh](https://github.com/aburgh)) +- Improve the implementations of the comparission-operators [\#63](https://github.com/nlohmann/json/pull/63) ([Florianjw](https://github.com/Florianjw)) +- Fix compilation of json\_unit with GCC 5 [\#59](https://github.com/nlohmann/json/pull/59) ([dkopecek](https://github.com/dkopecek)) +- Parse streams incrementally. [\#40](https://github.com/nlohmann/json/pull/40) ([aburgh](https://github.com/aburgh)) +- Feature/small float serialization [\#38](https://github.com/nlohmann/json/pull/38) ([jrandall](https://github.com/jrandall)) + + + +\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)* diff --git a/contrib/nlohmann_json/LICENSE.MIT b/contrib/nlohmann_json/LICENSE.MIT new file mode 100644 index 00000000000..ffef714b96e --- /dev/null +++ b/contrib/nlohmann_json/LICENSE.MIT @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2013-2020 Niels Lohmann + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/contrib/nlohmann_json/README.md b/contrib/nlohmann_json/README.md new file mode 100644 index 00000000000..ba257d9460c --- /dev/null +++ b/contrib/nlohmann_json/README.md @@ -0,0 +1,1630 @@ +[![JSON for Modern C++](https://raw.githubusercontent.com/nlohmann/json/master/doc/json.gif)](https://github.com/nlohmann/json/releases) + +[![Build Status](https://travis-ci.org/nlohmann/json.svg?branch=master)](https://travis-ci.org/nlohmann/json) +[![Build Status](https://ci.appveyor.com/api/projects/status/1acb366xfyg3qybk/branch/develop?svg=true)](https://ci.appveyor.com/project/nlohmann/json) +[![Ubuntu](https://github.com/nlohmann/json/workflows/Ubuntu/badge.svg)](https://github.com/nlohmann/json/actions?query=workflow%3AUbuntu) +[![macOS](https://github.com/nlohmann/json/workflows/macOS/badge.svg)](https://github.com/nlohmann/json/actions?query=workflow%3AmacOS) +[![Windows](https://github.com/nlohmann/json/workflows/Windows/badge.svg)](https://github.com/nlohmann/json/actions?query=workflow%3AWindows) +[![Build Status](https://circleci.com/gh/nlohmann/json.svg?style=svg)](https://circleci.com/gh/nlohmann/json) +[![Coverage Status](https://coveralls.io/repos/github/nlohmann/json/badge.svg?branch=develop)](https://coveralls.io/github/nlohmann/json?branch=develop) +[![Coverity Scan Build Status](https://scan.coverity.com/projects/5550/badge.svg)](https://scan.coverity.com/projects/nlohmann-json) +[![Codacy Badge](https://api.codacy.com/project/badge/Grade/f3732b3327e34358a0e9d1fe9f661f08)](https://www.codacy.com/app/nlohmann/json?utm_source=github.com&utm_medium=referral&utm_content=nlohmann/json&utm_campaign=Badge_Grade) +[![Language grade: C/C++](https://img.shields.io/lgtm/grade/cpp/g/nlohmann/json.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/nlohmann/json/context:cpp) +[![Fuzzing Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/json.svg)](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:json) +[![Try online](https://img.shields.io/badge/try-online-blue.svg)](https://wandbox.org/permlink/3lCHrFUZANONKv7a) +[![Documentation](https://img.shields.io/badge/docs-doxygen-blue.svg)](https://nlohmann.github.io/json/doxygen/index.html) +[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/nlohmann/json/master/LICENSE.MIT) +[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fnlohmann%2Fjson.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fnlohmann%2Fjson?ref=badge_shield) +[![GitHub Releases](https://img.shields.io/github/release/nlohmann/json.svg)](https://github.com/nlohmann/json/releases) +[![GitHub Downloads](https://img.shields.io/github/downloads/nlohmann/json/total)](https://github.com/nlohmann/json/releases) +[![GitHub Issues](https://img.shields.io/github/issues/nlohmann/json.svg)](https://github.com/nlohmann/json/issues) +[![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/nlohmann/json.svg)](https://isitmaintained.com/project/nlohmann/json "Average time to resolve an issue") +[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/289/badge)](https://bestpractices.coreinfrastructure.org/projects/289) +[![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsors-ff69b4)](https://github.com/sponsors/nlohmann) + +- [Design goals](#design-goals) +- [Sponsors](#sponsors) +- [Integration](#integration) + - [CMake](#cmake) + - [Package Managers](#package-managers) + - [Pkg-config](#pkg-config) +- [Examples](#examples) + - [JSON as first-class data type](#json-as-first-class-data-type) + - [Serialization / Deserialization](#serialization--deserialization) + - [STL-like access](#stl-like-access) + - [Conversion from STL containers](#conversion-from-stl-containers) + - [JSON Pointer and JSON Patch](#json-pointer-and-json-patch) + - [JSON Merge Patch](#json-merge-patch) + - [Implicit conversions](#implicit-conversions) + - [Conversions to/from arbitrary types](#arbitrary-types-conversions) + - [Specializing enum conversion](#specializing-enum-conversion) + - [Binary formats (BSON, CBOR, MessagePack, and UBJSON)](#binary-formats-bson-cbor-messagepack-and-ubjson) +- [Supported compilers](#supported-compilers) +- [License](#license) +- [Contact](#contact) +- [Thanks](#thanks) +- [Used third-party tools](#used-third-party-tools) +- [Projects using JSON for Modern C++](#projects-using-json-for-modern-c) +- [Notes](#notes) +- [Execute unit tests](#execute-unit-tests) + +## Design goals + +There are myriads of [JSON](https://json.org) libraries out there, and each may even have its reason to exist. Our class had these design goals: + +- **Intuitive syntax**. In languages such as Python, JSON feels like a first class data type. We used all the operator magic of modern C++ to achieve the same feeling in your code. Check out the [examples below](#examples) and you'll know what I mean. + +- **Trivial integration**. Our whole code consists of a single header file [`json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp). That's it. No library, no subproject, no dependencies, no complex build system. The class is written in vanilla C++11. All in all, everything should require no adjustment of your compiler flags or project settings. + +- **Serious testing**. Our class is heavily [unit-tested](https://github.com/nlohmann/json/tree/develop/test/src) and covers [100%](https://coveralls.io/r/nlohmann/json) of the code, including all exceptional behavior. Furthermore, we checked with [Valgrind](https://valgrind.org) and the [Clang Sanitizers](https://clang.llvm.org/docs/index.html) that there are no memory leaks. [Google OSS-Fuzz](https://github.com/google/oss-fuzz/tree/master/projects/json) additionally runs fuzz tests against all parsers 24/7, effectively executing billions of tests so far. To maintain high quality, the project is following the [Core Infrastructure Initiative (CII) best practices](https://bestpractices.coreinfrastructure.org/projects/289). + +Other aspects were not so important to us: + +- **Memory efficiency**. Each JSON object has an overhead of one pointer (the maximal size of a union) and one enumeration element (1 byte). The default generalization uses the following C++ data types: `std::string` for strings, `int64_t`, `uint64_t` or `double` for numbers, `std::map` for objects, `std::vector` for arrays, and `bool` for Booleans. However, you can template the generalized class `basic_json` to your needs. + +- **Speed**. There are certainly [faster JSON libraries](https://github.com/miloyip/nativejson-benchmark#parsing-time) out there. However, if your goal is to speed up your development by adding JSON support with a single header, then this library is the way to go. If you know how to use a `std::vector` or `std::map`, you are already set. + +See the [contribution guidelines](https://github.com/nlohmann/json/blob/master/.github/CONTRIBUTING.md#please-dont) for more information. + + +## Sponsors + +You can sponsor this library at [GitHub Sponsors](https://github.com/sponsors/nlohmann). + +### :label: Named Sponsors + +- [Michael Hartmann](https://github.com/reFX-Mike) +- [Stefan Hagen](https://github.com/sthagen) +- [Steve Sperandeo](https://github.com/homer6) + +Thanks everyone! + + +## Integration + +[`json.hpp`](https://github.com/nlohmann/json/blob/develop/single_include/nlohmann/json.hpp) is the single required file in `single_include/nlohmann` or [released here](https://github.com/nlohmann/json/releases). You need to add + +```cpp +#include + +// for convenience +using json = nlohmann::json; +``` + +to the files you want to process JSON and set the necessary switches to enable C++11 (e.g., `-std=c++11` for GCC and Clang). + +You can further use file [`include/nlohmann/json_fwd.hpp`](https://github.com/nlohmann/json/blob/develop/include/nlohmann/json_fwd.hpp) for forward-declarations. The installation of json_fwd.hpp (as part of cmake's install step), can be achieved by setting `-DJSON_MultipleHeaders=ON`. + +### CMake + +You can also use the `nlohmann_json::nlohmann_json` interface target in CMake. This target populates the appropriate usage requirements for `INTERFACE_INCLUDE_DIRECTORIES` to point to the appropriate include directories and `INTERFACE_COMPILE_FEATURES` for the necessary C++11 flags. + +#### External + +To use this library from a CMake project, you can locate it directly with `find_package()` and use the namespaced imported target from the generated package configuration: + +```cmake +# CMakeLists.txt +find_package(nlohmann_json 3.2.0 REQUIRED) +... +add_library(foo ...) +... +target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json) +``` + +The package configuration file, `nlohmann_jsonConfig.cmake`, can be used either from an install tree or directly out of the build tree. + +#### Embedded + +To embed the library directly into an existing CMake project, place the entire source tree in a subdirectory and call `add_subdirectory()` in your `CMakeLists.txt` file: + +```cmake +# Typically you don't care so much for a third party library's tests to be +# run from your own project's code. +set(JSON_BuildTests OFF CACHE INTERNAL "") + +# If you only include this third party in PRIVATE source files, you do not +# need to install it when your main project gets installed. +# set(JSON_Install OFF CACHE INTERNAL "") + +# Don't use include(nlohmann_json/CMakeLists.txt) since that carries with it +# unintended consequences that will break the build. It's generally +# discouraged (although not necessarily well documented as such) to use +# include(...) for pulling in other CMake projects anyways. +add_subdirectory(nlohmann_json) +... +add_library(foo ...) +... +target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json) +``` + +##### Embedded (FetchContent) + +Since CMake v3.11, +[FetchContent](https://cmake.org/cmake/help/v3.11/module/FetchContent.html) can +be used to automatically download the repository as a dependency at configure type. + +Example: +```cmake +include(FetchContent) + +FetchContent_Declare(json + GIT_REPOSITORY https://github.com/nlohmann/json.git + GIT_TAG v3.7.3) + +FetchContent_GetProperties(json) +if(NOT json_POPULATED) + FetchContent_Populate(json) + add_subdirectory(${json_SOURCE_DIR} ${json_BINARY_DIR} EXCLUDE_FROM_ALL) +endif() + +target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json) +``` + +**Note**: The repository https://github.com/nlohmann/json download size is huge. +It contains all the dataset used for the benchmarks. You might want to depend on +a smaller repository. For instance, you might want to replace the URL above by +https://github.com/ArthurSonzogni/nlohmann_json_cmake_fetchcontent + +#### Supporting Both + +To allow your project to support either an externally supplied or an embedded JSON library, you can use a pattern akin to the following: + +``` cmake +# Top level CMakeLists.txt +project(FOO) +... +option(FOO_USE_EXTERNAL_JSON "Use an external JSON library" OFF) +... +add_subdirectory(thirdparty) +... +add_library(foo ...) +... +# Note that the namespaced target will always be available regardless of the +# import method +target_link_libraries(foo PRIVATE nlohmann_json::nlohmann_json) +``` +```cmake +# thirdparty/CMakeLists.txt +... +if(FOO_USE_EXTERNAL_JSON) + find_package(nlohmann_json 3.2.0 REQUIRED) +else() + set(JSON_BuildTests OFF CACHE INTERNAL "") + add_subdirectory(nlohmann_json) +endif() +... +``` + +`thirdparty/nlohmann_json` is then a complete copy of this source tree. + +### Package Managers + +:beer: If you are using OS X and [Homebrew](https://brew.sh), just type `brew tap nlohmann/json` and `brew install nlohmann-json` and you're set. If you want the bleeding edge rather than the latest release, use `brew install nlohmann-json --HEAD`. + +If you are using the [Meson Build System](https://mesonbuild.com), add this source tree as a [meson subproject](https://mesonbuild.com/Subprojects.html#using-a-subproject). You may also use the `include.zip` published in this project's [Releases](https://github.com/nlohmann/json/releases) to reduce the size of the vendored source tree. Alternatively, you can get a wrap file by downloading it from [Meson WrapDB](https://wrapdb.mesonbuild.com/nlohmann_json), or simply use `meson wrap install nlohmann_json`. Please see the meson project for any issues regarding the packaging. + +The provided meson.build can also be used as an alternative to cmake for installing `nlohmann_json` system-wide in which case a pkg-config file is installed. To use it, simply have your build system require the `nlohmann_json` pkg-config dependency. In Meson, it is preferred to use the [`dependency()`](https://mesonbuild.com/Reference-manual.html#dependency) object with a subproject fallback, rather than using the subproject directly. + +If you are using [Conan](https://www.conan.io/) to manage your dependencies, merely add `nlohmann_json/x.y.z` to your `conanfile`'s requires, where `x.y.z` is the release version you want to use. Please file issues [here](https://github.com/conan-io/conan-center-index/issues) if you experience problems with the packages. + +If you are using [Spack](https://www.spack.io/) to manage your dependencies, you can use the [`nlohmann-json` package](https://spack.readthedocs.io/en/latest/package_list.html#nlohmann-json). Please see the [spack project](https://github.com/spack/spack) for any issues regarding the packaging. + +If you are using [hunter](https://github.com/cpp-pm/hunter) on your project for external dependencies, then you can use the [nlohmann_json package](https://hunter.readthedocs.io/en/latest/packages/pkg/nlohmann_json.html). Please see the hunter project for any issues regarding the packaging. + +If you are using [Buckaroo](https://buckaroo.pm), you can install this library's module with `buckaroo add github.com/buckaroo-pm/nlohmann-json`. Please file issues [here](https://github.com/buckaroo-pm/nlohmann-json). There is a demo repo [here](https://github.com/njlr/buckaroo-nholmann-json-example). + +If you are using [vcpkg](https://github.com/Microsoft/vcpkg/) on your project for external dependencies, then you can use the [nlohmann-json package](https://github.com/Microsoft/vcpkg/tree/master/ports/nlohmann-json). Please see the vcpkg project for any issues regarding the packaging. + +If you are using [cget](https://cget.readthedocs.io/en/latest/), you can install the latest development version with `cget install nlohmann/json`. A specific version can be installed with `cget install nlohmann/json@v3.1.0`. Also, the multiple header version can be installed by adding the `-DJSON_MultipleHeaders=ON` flag (i.e., `cget install nlohmann/json -DJSON_MultipleHeaders=ON`). + +If you are using [CocoaPods](https://cocoapods.org), you can use the library by adding pod `"nlohmann_json", '~>3.1.2'` to your podfile (see [an example](https://bitbucket.org/benman/nlohmann_json-cocoapod/src/master/)). Please file issues [here](https://bitbucket.org/benman/nlohmann_json-cocoapod/issues?status=new&status=open). + +If you are using [NuGet](https://www.nuget.org), you can use the package [nlohmann.json](https://www.nuget.org/packages/nlohmann.json/). Please check [this extensive description](https://github.com/nlohmann/json/issues/1132#issuecomment-452250255) on how to use the package. Please files issues [here](https://github.com/hnkb/nlohmann-json-nuget/issues). + +If you are using [conda](https://conda.io/), you can use the package [nlohmann_json](https://github.com/conda-forge/nlohmann_json-feedstock) from [conda-forge](https://conda-forge.org) executing `conda install -c conda-forge nlohmann_json`. Please file issues [here](https://github.com/conda-forge/nlohmann_json-feedstock/issues). + +If you are using [MSYS2](https://www.msys2.org/), your can use the [mingw-w64-nlohmann-json](https://packages.msys2.org/base/mingw-w64-nlohmann-json) package, just type `pacman -S mingw-w64-i686-nlohmann-json` or `pacman -S mingw-w64-x86_64-nlohmann-json` for installation. Please file issues [here](https://github.com/msys2/MINGW-packages/issues/new?title=%5Bnlohmann-json%5D) if you experience problems with the packages. + +If you are using [`build2`](https://build2.org), you can use the [`nlohmann-json`](https://cppget.org/nlohmann-json) package from the public repository https://cppget.org or directly from the [package's sources repository](https://github.com/build2-packaging/nlohmann-json). In your project's `manifest` file, just add `depends: nlohmann-json` (probably with some [version constraints](https://build2.org/build2-toolchain/doc/build2-toolchain-intro.xhtml#guide-add-remove-deps)). If you are not familiar with using dependencies in `build2`, [please read this introduction](https://build2.org/build2-toolchain/doc/build2-toolchain-intro.xhtml). +Please file issues [here](https://github.com/build2-packaging/nlohmann-json) if you experience problems with the packages. + +If you are using [`wsjcpp`](https://wsjcpp.org), you can use the command `wsjcpp install "https://github.com/nlohmann/json:develop"` to get the latest version. Note you can change the branch ":develop" to an existing tag or another branch. + +### Pkg-config + +If you are using bare Makefiles, you can use `pkg-config` to generate the include flags that point to where the library is installed: + +```sh +pkg-config nlohmann_json --cflags +``` + +Users of the Meson build system will also be able to use a system wide library, which will be found by `pkg-config`: + +```meson +json = dependency('nlohmann_json', required: true) +``` + +## Examples + +Beside the examples below, you may want to check the [documentation](https://nlohmann.github.io/json/) where each function contains a separate code example (e.g., check out [`emplace()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a5338e282d1d02bed389d852dd670d98d.html#a5338e282d1d02bed389d852dd670d98d)). All [example files](https://github.com/nlohmann/json/tree/develop/doc/examples) can be compiled and executed on their own (e.g., file [emplace.cpp](https://github.com/nlohmann/json/blob/develop/doc/examples/emplace.cpp)). + +### JSON as first-class data type + +Here are some examples to give you an idea how to use the class. + +Assume you want to create the JSON object + +```json +{ + "pi": 3.141, + "happy": true, + "name": "Niels", + "nothing": null, + "answer": { + "everything": 42 + }, + "list": [1, 0, 2], + "object": { + "currency": "USD", + "value": 42.99 + } +} +``` + +With this library, you could write: + +```cpp +// create an empty structure (null) +json j; + +// add a number that is stored as double (note the implicit conversion of j to an object) +j["pi"] = 3.141; + +// add a Boolean that is stored as bool +j["happy"] = true; + +// add a string that is stored as std::string +j["name"] = "Niels"; + +// add another null object by passing nullptr +j["nothing"] = nullptr; + +// add an object inside the object +j["answer"]["everything"] = 42; + +// add an array that is stored as std::vector (using an initializer list) +j["list"] = { 1, 0, 2 }; + +// add another object (using an initializer list of pairs) +j["object"] = { {"currency", "USD"}, {"value", 42.99} }; + +// instead, you could also write (which looks very similar to the JSON above) +json j2 = { + {"pi", 3.141}, + {"happy", true}, + {"name", "Niels"}, + {"nothing", nullptr}, + {"answer", { + {"everything", 42} + }}, + {"list", {1, 0, 2}}, + {"object", { + {"currency", "USD"}, + {"value", 42.99} + }} +}; +``` + +Note that in all these cases, you never need to "tell" the compiler which JSON value type you want to use. If you want to be explicit or express some edge cases, the functions [`json::array()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a9ad7ec0bc1082ed09d10900fbb20a21f.html#a9ad7ec0bc1082ed09d10900fbb20a21f) and [`json::object()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_aaf509a7c029100d292187068f61c99b8.html#aaf509a7c029100d292187068f61c99b8) will help: + +```cpp +// a way to express the empty array [] +json empty_array_explicit = json::array(); + +// ways to express the empty object {} +json empty_object_implicit = json({}); +json empty_object_explicit = json::object(); + +// a way to express an _array_ of key/value pairs [["currency", "USD"], ["value", 42.99]] +json array_not_object = json::array({ {"currency", "USD"}, {"value", 42.99} }); +``` + +### Serialization / Deserialization + +#### To/from strings + +You can create a JSON value (deserialization) by appending `_json` to a string literal: + +```cpp +// create object from string literal +json j = "{ \"happy\": true, \"pi\": 3.141 }"_json; + +// or even nicer with a raw string literal +auto j2 = R"( + { + "happy": true, + "pi": 3.141 + } +)"_json; +``` + +Note that without appending the `_json` suffix, the passed string literal is not parsed, but just used as JSON string value. That is, `json j = "{ \"happy\": true, \"pi\": 3.141 }"` would just store the string `"{ "happy": true, "pi": 3.141 }"` rather than parsing the actual object. + +The above example can also be expressed explicitly using [`json::parse()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a265a473e939184aa42655c9ccdf34e58.html#a265a473e939184aa42655c9ccdf34e58): + +```cpp +// parse explicitly +auto j3 = json::parse("{ \"happy\": true, \"pi\": 3.141 }"); +``` + +You can also get a string representation of a JSON value (serialize): + +```cpp +// explicit conversion to string +std::string s = j.dump(); // {"happy":true,"pi":3.141} + +// serialization with pretty printing +// pass in the amount of spaces to indent +std::cout << j.dump(4) << std::endl; +// { +// "happy": true, +// "pi": 3.141 +// } +``` + +Note the difference between serialization and assignment: + +```cpp +// store a string in a JSON value +json j_string = "this is a string"; + +// retrieve the string value +auto cpp_string = j_string.get(); +// retrieve the string value (alternative when an variable already exists) +std::string cpp_string2; +j_string.get_to(cpp_string2); + +// retrieve the serialized value (explicit JSON serialization) +std::string serialized_string = j_string.dump(); + +// output of original string +std::cout << cpp_string << " == " << cpp_string2 << " == " << j_string.get() << '\n'; +// output of serialized value +std::cout << j_string << " == " << serialized_string << std::endl; +``` + +[`.dump()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a50ec80b02d0f3f51130d4abb5d1cfdc5.html#a50ec80b02d0f3f51130d4abb5d1cfdc5) always returns the serialized value, and [`.get()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_aa6602bb24022183ab989439e19345d08.html#aa6602bb24022183ab989439e19345d08) returns the originally stored string value. + +Note the library only supports UTF-8. When you store strings with different encodings in the library, calling [`dump()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a50ec80b02d0f3f51130d4abb5d1cfdc5.html#a50ec80b02d0f3f51130d4abb5d1cfdc5) may throw an exception unless `json::error_handler_t::replace` or `json::error_handler_t::ignore` are used as error handlers. + +#### To/from streams (e.g. files, string streams) + +You can also use streams to serialize and deserialize: + +```cpp +// deserialize from standard input +json j; +std::cin >> j; + +// serialize to standard output +std::cout << j; + +// the setw manipulator was overloaded to set the indentation for pretty printing +std::cout << std::setw(4) << j << std::endl; +``` + +These operators work for any subclasses of `std::istream` or `std::ostream`. Here is the same example with files: + +```cpp +// read a JSON file +std::ifstream i("file.json"); +json j; +i >> j; + +// write prettified JSON to another file +std::ofstream o("pretty.json"); +o << std::setw(4) << j << std::endl; +``` + +Please note that setting the exception bit for `failbit` is inappropriate for this use case. It will result in program termination due to the `noexcept` specifier in use. + +#### Read from iterator range + +You can also parse JSON from an iterator range; that is, from any container accessible by iterators whose `value_type` is an integral type of 1, 2 or 4 bytes, which will be interpreted as UTF-8, UTF-16 and UTF-32 respectively. For instance, a `std::vector`, or a `std::list`: + +```cpp +std::vector v = {'t', 'r', 'u', 'e'}; +json j = json::parse(v.begin(), v.end()); +``` + +You may leave the iterators for the range [begin, end): + +```cpp +std::vector v = {'t', 'r', 'u', 'e'}; +json j = json::parse(v); +``` + +#### Custom data source + +Since the parse function accepts arbitrary iterator ranges, you can provide your own data sources by implementing the `LegacyInputIterator` concept. + +```cpp +struct MyContainer { + void advance(); + const char& get_current(); +}; + +struct MyIterator { + using difference_type = std::ptrdiff_t; + using value_type = char; + using pointer = const char*; + using reference = const char&; + using iterator_category = std::input_iterator_tag; + + MyIterator& operator++() { + MyContainer.advance(); + return *this; + } + + bool operator!=(const MyIterator& rhs) const { + return rhs.target != target; + } + + reference operator*() const { + return target.get_current(); + } + + MyContainer* target = nullptr; +}; + +MyIterator begin(MyContainer& tgt) { + return MyIterator{&tgt}; +} + +MyIterator end(const MyContainer&) { + return {}; +} + +void foo() { + MyContainer c; + json j = json::parse(c); +} +``` + +#### SAX interface + +The library uses a SAX-like interface with the following functions: + +```cpp +// called when null is parsed +bool null(); + +// called when a boolean is parsed; value is passed +bool boolean(bool val); + +// called when a signed or unsigned integer number is parsed; value is passed +bool number_integer(number_integer_t val); +bool number_unsigned(number_unsigned_t val); + +// called when a floating-point number is parsed; value and original string is passed +bool number_float(number_float_t val, const string_t& s); + +// called when a string is parsed; value is passed and can be safely moved away +bool string(string_t& val); +// called when a binary value is parsed; value is passed and can be safely moved away +bool binary(binary_t& val); + +// called when an object or array begins or ends, resp. The number of elements is passed (or -1 if not known) +bool start_object(std::size_t elements); +bool end_object(); +bool start_array(std::size_t elements); +bool end_array(); +// called when an object key is parsed; value is passed and can be safely moved away +bool key(string_t& val); + +// called when a parse error occurs; byte position, the last token, and an exception is passed +bool parse_error(std::size_t position, const std::string& last_token, const detail::exception& ex); +``` + +The return value of each function determines whether parsing should proceed. + +To implement your own SAX handler, proceed as follows: + +1. Implement the SAX interface in a class. You can use class `nlohmann::json_sax` as base class, but you can also use any class where the functions described above are implemented and public. +2. Create an object of your SAX interface class, e.g. `my_sax`. +3. Call `bool json::sax_parse(input, &my_sax)`; where the first parameter can be any input like a string or an input stream and the second parameter is a pointer to your SAX interface. + +Note the `sax_parse` function only returns a `bool` indicating the result of the last executed SAX event. It does not return a `json` value - it is up to you to decide what to do with the SAX events. Furthermore, no exceptions are thrown in case of a parse error - it is up to you what to do with the exception object passed to your `parse_error` implementation. Internally, the SAX interface is used for the DOM parser (class `json_sax_dom_parser`) as well as the acceptor (`json_sax_acceptor`), see file [`json_sax.hpp`](https://github.com/nlohmann/json/blob/develop/include/nlohmann/detail/input/json_sax.hpp). + +### STL-like access + +We designed the JSON class to behave just like an STL container. In fact, it satisfies the [**ReversibleContainer**](https://en.cppreference.com/w/cpp/named_req/ReversibleContainer) requirement. + +```cpp +// create an array using push_back +json j; +j.push_back("foo"); +j.push_back(1); +j.push_back(true); + +// also use emplace_back +j.emplace_back(1.78); + +// iterate the array +for (json::iterator it = j.begin(); it != j.end(); ++it) { + std::cout << *it << '\n'; +} + +// range-based for +for (auto& element : j) { + std::cout << element << '\n'; +} + +// getter/setter +const auto tmp = j[0].get(); +j[1] = 42; +bool foo = j.at(2); + +// comparison +j == "[\"foo\", 42, true]"_json; // true + +// other stuff +j.size(); // 3 entries +j.empty(); // false +j.type(); // json::value_t::array +j.clear(); // the array is empty again + +// convenience type checkers +j.is_null(); +j.is_boolean(); +j.is_number(); +j.is_object(); +j.is_array(); +j.is_string(); + +// create an object +json o; +o["foo"] = 23; +o["bar"] = false; +o["baz"] = 3.141; + +// also use emplace +o.emplace("weather", "sunny"); + +// special iterator member functions for objects +for (json::iterator it = o.begin(); it != o.end(); ++it) { + std::cout << it.key() << " : " << it.value() << "\n"; +} + +// the same code as range for +for (auto& el : o.items()) { + std::cout << el.key() << " : " << el.value() << "\n"; +} + +// even easier with structured bindings (C++17) +for (auto& [key, value] : o.items()) { + std::cout << key << " : " << value << "\n"; +} + +// find an entry +if (o.contains("foo")) { + // there is an entry with key "foo" +} + +// or via find and an iterator +if (o.find("foo") != o.end()) { + // there is an entry with key "foo" +} + +// or simpler using count() +int foo_present = o.count("foo"); // 1 +int fob_present = o.count("fob"); // 0 + +// delete an entry +o.erase("foo"); +``` + + +### Conversion from STL containers + +Any sequence container (`std::array`, `std::vector`, `std::deque`, `std::forward_list`, `std::list`) whose values can be used to construct JSON values (e.g., integers, floating point numbers, Booleans, string types, or again STL containers described in this section) can be used to create a JSON array. The same holds for similar associative containers (`std::set`, `std::multiset`, `std::unordered_set`, `std::unordered_multiset`), but in these cases the order of the elements of the array depends on how the elements are ordered in the respective STL container. + +```cpp +std::vector c_vector {1, 2, 3, 4}; +json j_vec(c_vector); +// [1, 2, 3, 4] + +std::deque c_deque {1.2, 2.3, 3.4, 5.6}; +json j_deque(c_deque); +// [1.2, 2.3, 3.4, 5.6] + +std::list c_list {true, true, false, true}; +json j_list(c_list); +// [true, true, false, true] + +std::forward_list c_flist {12345678909876, 23456789098765, 34567890987654, 45678909876543}; +json j_flist(c_flist); +// [12345678909876, 23456789098765, 34567890987654, 45678909876543] + +std::array c_array {{1, 2, 3, 4}}; +json j_array(c_array); +// [1, 2, 3, 4] + +std::set c_set {"one", "two", "three", "four", "one"}; +json j_set(c_set); // only one entry for "one" is used +// ["four", "one", "three", "two"] + +std::unordered_set c_uset {"one", "two", "three", "four", "one"}; +json j_uset(c_uset); // only one entry for "one" is used +// maybe ["two", "three", "four", "one"] + +std::multiset c_mset {"one", "two", "one", "four"}; +json j_mset(c_mset); // both entries for "one" are used +// maybe ["one", "two", "one", "four"] + +std::unordered_multiset c_umset {"one", "two", "one", "four"}; +json j_umset(c_umset); // both entries for "one" are used +// maybe ["one", "two", "one", "four"] +``` + +Likewise, any associative key-value containers (`std::map`, `std::multimap`, `std::unordered_map`, `std::unordered_multimap`) whose keys can construct an `std::string` and whose values can be used to construct JSON values (see examples above) can be used to create a JSON object. Note that in case of multimaps only one key is used in the JSON object and the value depends on the internal order of the STL container. + +```cpp +std::map c_map { {"one", 1}, {"two", 2}, {"three", 3} }; +json j_map(c_map); +// {"one": 1, "three": 3, "two": 2 } + +std::unordered_map c_umap { {"one", 1.2}, {"two", 2.3}, {"three", 3.4} }; +json j_umap(c_umap); +// {"one": 1.2, "two": 2.3, "three": 3.4} + +std::multimap c_mmap { {"one", true}, {"two", true}, {"three", false}, {"three", true} }; +json j_mmap(c_mmap); // only one entry for key "three" is used +// maybe {"one": true, "two": true, "three": true} + +std::unordered_multimap c_ummap { {"one", true}, {"two", true}, {"three", false}, {"three", true} }; +json j_ummap(c_ummap); // only one entry for key "three" is used +// maybe {"one": true, "two": true, "three": true} +``` + +### JSON Pointer and JSON Patch + +The library supports **JSON Pointer** ([RFC 6901](https://tools.ietf.org/html/rfc6901)) as alternative means to address structured values. On top of this, **JSON Patch** ([RFC 6902](https://tools.ietf.org/html/rfc6902)) allows to describe differences between two JSON values - effectively allowing patch and diff operations known from Unix. + +```cpp +// a JSON value +json j_original = R"({ + "baz": ["one", "two", "three"], + "foo": "bar" +})"_json; + +// access members with a JSON pointer (RFC 6901) +j_original["/baz/1"_json_pointer]; +// "two" + +// a JSON patch (RFC 6902) +json j_patch = R"([ + { "op": "replace", "path": "/baz", "value": "boo" }, + { "op": "add", "path": "/hello", "value": ["world"] }, + { "op": "remove", "path": "/foo"} +])"_json; + +// apply the patch +json j_result = j_original.patch(j_patch); +// { +// "baz": "boo", +// "hello": ["world"] +// } + +// calculate a JSON patch from two JSON values +json::diff(j_result, j_original); +// [ +// { "op":" replace", "path": "/baz", "value": ["one", "two", "three"] }, +// { "op": "remove","path": "/hello" }, +// { "op": "add", "path": "/foo", "value": "bar" } +// ] +``` + +### JSON Merge Patch + +The library supports **JSON Merge Patch** ([RFC 7386](https://tools.ietf.org/html/rfc7386)) as a patch format. Instead of using JSON Pointer (see above) to specify values to be manipulated, it describes the changes using a syntax that closely mimics the document being modified. + +```cpp +// a JSON value +json j_document = R"({ + "a": "b", + "c": { + "d": "e", + "f": "g" + } +})"_json; + +// a patch +json j_patch = R"({ + "a":"z", + "c": { + "f": null + } +})"_json; + +// apply the patch +j_document.merge_patch(j_patch); +// { +// "a": "z", +// "c": { +// "d": "e" +// } +// } +``` + +### Implicit conversions + +Supported types can be implicitly converted to JSON values. + +It is recommended to **NOT USE** implicit conversions **FROM** a JSON value. +You can find more details about this recommendation [here](https://www.github.com/nlohmann/json/issues/958). +You can switch off implicit conversions by defining `JSON_USE_IMPLICIT_CONVERSIONS` to `0` before including the `json.hpp` header. When using CMake, you can also achieve this by setting the option `JSON_ImplicitConversions` to `OFF`. + +```cpp +// strings +std::string s1 = "Hello, world!"; +json js = s1; +auto s2 = js.get(); +// NOT RECOMMENDED +std::string s3 = js; +std::string s4; +s4 = js; + +// Booleans +bool b1 = true; +json jb = b1; +auto b2 = jb.get(); +// NOT RECOMMENDED +bool b3 = jb; +bool b4; +b4 = jb; + +// numbers +int i = 42; +json jn = i; +auto f = jn.get(); +// NOT RECOMMENDED +double f2 = jb; +double f3; +f3 = jb; + +// etc. +``` + +Note that `char` types are not automatically converted to JSON strings, but to integer numbers. A conversion to a string must be specified explicitly: + +```cpp +char ch = 'A'; // ASCII value 65 +json j_default = ch; // stores integer number 65 +json j_string = std::string(1, ch); // stores string "A" +``` + +### Arbitrary types conversions + +Every type can be serialized in JSON, not just STL containers and scalar types. Usually, you would do something along those lines: + +```cpp +namespace ns { + // a simple struct to model a person + struct person { + std::string name; + std::string address; + int age; + }; +} + +ns::person p = {"Ned Flanders", "744 Evergreen Terrace", 60}; + +// convert to JSON: copy each value into the JSON object +json j; +j["name"] = p.name; +j["address"] = p.address; +j["age"] = p.age; + +// ... + +// convert from JSON: copy each value from the JSON object +ns::person p { + j["name"].get(), + j["address"].get(), + j["age"].get() +}; +``` + +It works, but that's quite a lot of boilerplate... Fortunately, there's a better way: + +```cpp +// create a person +ns::person p {"Ned Flanders", "744 Evergreen Terrace", 60}; + +// conversion: person -> json +json j = p; + +std::cout << j << std::endl; +// {"address":"744 Evergreen Terrace","age":60,"name":"Ned Flanders"} + +// conversion: json -> person +auto p2 = j.get(); + +// that's it +assert(p == p2); +``` + +#### Basic usage + +To make this work with one of your types, you only need to provide two functions: + +```cpp +using nlohmann::json; + +namespace ns { + void to_json(json& j, const person& p) { + j = json{{"name", p.name}, {"address", p.address}, {"age", p.age}}; + } + + void from_json(const json& j, person& p) { + j.at("name").get_to(p.name); + j.at("address").get_to(p.address); + j.at("age").get_to(p.age); + } +} // namespace ns +``` + +That's all! When calling the `json` constructor with your type, your custom `to_json` method will be automatically called. +Likewise, when calling `get()` or `get_to(your_type&)`, the `from_json` method will be called. + +Some important things: + +* Those methods **MUST** be in your type's namespace (which can be the global namespace), or the library will not be able to locate them (in this example, they are in namespace `ns`, where `person` is defined). +* Those methods **MUST** be available (e.g., proper headers must be included) everywhere you use these conversions. Look at [issue 1108](https://github.com/nlohmann/json/issues/1108) for errors that may occur otherwise. +* When using `get()`, `your_type` **MUST** be [DefaultConstructible](https://en.cppreference.com/w/cpp/named_req/DefaultConstructible). (There is a way to bypass this requirement described later.) +* In function `from_json`, use function [`at()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a93403e803947b86f4da2d1fb3345cf2c.html#a93403e803947b86f4da2d1fb3345cf2c) to access the object values rather than `operator[]`. In case a key does not exist, `at` throws an exception that you can handle, whereas `operator[]` exhibits undefined behavior. +* You do not need to add serializers or deserializers for STL types like `std::vector`: the library already implements these. + +#### Simplify your life with macros + +If you just want to serialize/deserialize some structs, the `to_json`/`from_json` functions can be a lot of boilerplate. + +There are two macros to make your life easier as long as you (1) want to use a JSON object as serialization and (2) want to use the member variable names as object keys in that object: + +- `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(name, member1, member2, ...)` is to be defined inside of the namespace of the class/struct to create code for. +- `NLOHMANN_DEFINE_TYPE_INTRUSIVE(name, member1, member2, ...)` is to be defined inside of the class/struct to create code for. This macro can also access private members. + +In both macros, the first parameter is the name of the class/struct, and all remaining parameters name the members. + +##### Examples + +The `to_json`/`from_json` functions for the `person` struct above can be created with: + +```cpp +namespace ns { + NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE(person, name, address, age) +} +``` + +Here is an example with private members, where `NLOHMANN_DEFINE_TYPE_INTRUSIVE` is needed: + +```cpp +namespace ns { + class address { + private: + std::string street; + int housenumber; + int postcode; + + public: + NLOHMANN_DEFINE_TYPE_INTRUSIVE(address, street, housenumber, postcode) + }; +} +``` + +#### How do I convert third-party types? + +This requires a bit more advanced technique. But first, let's see how this conversion mechanism works: + +The library uses **JSON Serializers** to convert types to json. +The default serializer for `nlohmann::json` is `nlohmann::adl_serializer` (ADL means [Argument-Dependent Lookup](https://en.cppreference.com/w/cpp/language/adl)). + +It is implemented like this (simplified): + +```cpp +template +struct adl_serializer { + static void to_json(json& j, const T& value) { + // calls the "to_json" method in T's namespace + } + + static void from_json(const json& j, T& value) { + // same thing, but with the "from_json" method + } +}; +``` + +This serializer works fine when you have control over the type's namespace. However, what about `boost::optional` or `std::filesystem::path` (C++17)? Hijacking the `boost` namespace is pretty bad, and it's illegal to add something other than template specializations to `std`... + +To solve this, you need to add a specialization of `adl_serializer` to the `nlohmann` namespace, here's an example: + +```cpp +// partial specialization (full specialization works too) +namespace nlohmann { + template + struct adl_serializer> { + static void to_json(json& j, const boost::optional& opt) { + if (opt == boost::none) { + j = nullptr; + } else { + j = *opt; // this will call adl_serializer::to_json which will + // find the free function to_json in T's namespace! + } + } + + static void from_json(const json& j, boost::optional& opt) { + if (j.is_null()) { + opt = boost::none; + } else { + opt = j.get(); // same as above, but with + // adl_serializer::from_json + } + } + }; +} +``` + +#### How can I use `get()` for non-default constructible/non-copyable types? + +There is a way, if your type is [MoveConstructible](https://en.cppreference.com/w/cpp/named_req/MoveConstructible). You will need to specialize the `adl_serializer` as well, but with a special `from_json` overload: + +```cpp +struct move_only_type { + move_only_type() = delete; + move_only_type(int ii): i(ii) {} + move_only_type(const move_only_type&) = delete; + move_only_type(move_only_type&&) = default; + + int i; +}; + +namespace nlohmann { + template <> + struct adl_serializer { + // note: the return type is no longer 'void', and the method only takes + // one argument + static move_only_type from_json(const json& j) { + return {j.get()}; + } + + // Here's the catch! You must provide a to_json method! Otherwise you + // will not be able to convert move_only_type to json, since you fully + // specialized adl_serializer on that type + static void to_json(json& j, move_only_type t) { + j = t.i; + } + }; +} +``` + +#### Can I write my own serializer? (Advanced use) + +Yes. You might want to take a look at [`unit-udt.cpp`](https://github.com/nlohmann/json/blob/develop/test/src/unit-udt.cpp) in the test suite, to see a few examples. + +If you write your own serializer, you'll need to do a few things: + +- use a different `basic_json` alias than `nlohmann::json` (the last template parameter of `basic_json` is the `JSONSerializer`) +- use your `basic_json` alias (or a template parameter) in all your `to_json`/`from_json` methods +- use `nlohmann::to_json` and `nlohmann::from_json` when you need ADL + +Here is an example, without simplifications, that only accepts types with a size <= 32, and uses ADL. + +```cpp +// You should use void as a second template argument +// if you don't need compile-time checks on T +template::type> +struct less_than_32_serializer { + template + static void to_json(BasicJsonType& j, T value) { + // we want to use ADL, and call the correct to_json overload + using nlohmann::to_json; // this method is called by adl_serializer, + // this is where the magic happens + to_json(j, value); + } + + template + static void from_json(const BasicJsonType& j, T& value) { + // same thing here + using nlohmann::from_json; + from_json(j, value); + } +}; +``` + +Be **very** careful when reimplementing your serializer, you can stack overflow if you don't pay attention: + +```cpp +template +struct bad_serializer +{ + template + static void to_json(BasicJsonType& j, const T& value) { + // this calls BasicJsonType::json_serializer::to_json(j, value); + // if BasicJsonType::json_serializer == bad_serializer ... oops! + j = value; + } + + template + static void to_json(const BasicJsonType& j, T& value) { + // this calls BasicJsonType::json_serializer::from_json(j, value); + // if BasicJsonType::json_serializer == bad_serializer ... oops! + value = j.template get(); // oops! + } +}; +``` + +### Specializing enum conversion + +By default, enum values are serialized to JSON as integers. In some cases this could result in undesired behavior. If an enum is modified or re-ordered after data has been serialized to JSON, the later de-serialized JSON data may be undefined or a different enum value than was originally intended. + +It is possible to more precisely specify how a given enum is mapped to and from JSON as shown below: + +```cpp +// example enum type declaration +enum TaskState { + TS_STOPPED, + TS_RUNNING, + TS_COMPLETED, + TS_INVALID=-1, +}; + +// map TaskState values to JSON as strings +NLOHMANN_JSON_SERIALIZE_ENUM( TaskState, { + {TS_INVALID, nullptr}, + {TS_STOPPED, "stopped"}, + {TS_RUNNING, "running"}, + {TS_COMPLETED, "completed"}, +}) +``` + +The `NLOHMANN_JSON_SERIALIZE_ENUM()` macro declares a set of `to_json()` / `from_json()` functions for type `TaskState` while avoiding repetition and boilerplate serialization code. + +**Usage:** + +```cpp +// enum to JSON as string +json j = TS_STOPPED; +assert(j == "stopped"); + +// json string to enum +json j3 = "running"; +assert(j3.get() == TS_RUNNING); + +// undefined json value to enum (where the first map entry above is the default) +json jPi = 3.14; +assert(jPi.get() == TS_INVALID ); +``` + +Just as in [Arbitrary Type Conversions](#arbitrary-types-conversions) above, +- `NLOHMANN_JSON_SERIALIZE_ENUM()` MUST be declared in your enum type's namespace (which can be the global namespace), or the library will not be able to locate it and it will default to integer serialization. +- It MUST be available (e.g., proper headers must be included) everywhere you use the conversions. + +Other Important points: +- When using `get()`, undefined JSON values will default to the first pair specified in your map. Select this default pair carefully. +- If an enum or JSON value is specified more than once in your map, the first matching occurrence from the top of the map will be returned when converting to or from JSON. + +### Binary formats (BSON, CBOR, MessagePack, and UBJSON) + +Though JSON is a ubiquitous data format, it is not a very compact format suitable for data exchange, for instance over a network. Hence, the library supports [BSON](http://bsonspec.org) (Binary JSON), [CBOR](https://cbor.io) (Concise Binary Object Representation), [MessagePack](https://msgpack.org), and [UBJSON](http://ubjson.org) (Universal Binary JSON Specification) to efficiently encode JSON values to byte vectors and to decode such vectors. + +```cpp +// create a JSON value +json j = R"({"compact": true, "schema": 0})"_json; + +// serialize to BSON +std::vector v_bson = json::to_bson(j); + +// 0x1B, 0x00, 0x00, 0x00, 0x08, 0x63, 0x6F, 0x6D, 0x70, 0x61, 0x63, 0x74, 0x00, 0x01, 0x10, 0x73, 0x63, 0x68, 0x65, 0x6D, 0x61, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 + +// roundtrip +json j_from_bson = json::from_bson(v_bson); + +// serialize to CBOR +std::vector v_cbor = json::to_cbor(j); + +// 0xA2, 0x67, 0x63, 0x6F, 0x6D, 0x70, 0x61, 0x63, 0x74, 0xF5, 0x66, 0x73, 0x63, 0x68, 0x65, 0x6D, 0x61, 0x00 + +// roundtrip +json j_from_cbor = json::from_cbor(v_cbor); + +// serialize to MessagePack +std::vector v_msgpack = json::to_msgpack(j); + +// 0x82, 0xA7, 0x63, 0x6F, 0x6D, 0x70, 0x61, 0x63, 0x74, 0xC3, 0xA6, 0x73, 0x63, 0x68, 0x65, 0x6D, 0x61, 0x00 + +// roundtrip +json j_from_msgpack = json::from_msgpack(v_msgpack); + +// serialize to UBJSON +std::vector v_ubjson = json::to_ubjson(j); + +// 0x7B, 0x69, 0x07, 0x63, 0x6F, 0x6D, 0x70, 0x61, 0x63, 0x74, 0x54, 0x69, 0x06, 0x73, 0x63, 0x68, 0x65, 0x6D, 0x61, 0x69, 0x00, 0x7D + +// roundtrip +json j_from_ubjson = json::from_ubjson(v_ubjson); +``` + +The library also supports binary types from BSON, CBOR (byte strings), and MessagePack (bin, ext, fixext). They are stored by default as `std::vector` to be processed outside of the library. + +```cpp +// CBOR byte string with payload 0xCAFE +std::vector v = {0x42, 0xCA, 0xFE}; + +// read value +json j = json::from_cbor(v); + +// the JSON value has type binary +j.is_binary(); // true + +// get reference to stored binary value +auto& binary = j.get_binary(); + +// the binary value has no subtype (CBOR has no binary subtypes) +binary.has_subtype(); // false + +// access std::vector member functions +binary.size(); // 2 +binary[0]; // 0xCA +binary[1]; // 0xFE + +// set subtype to 0x10 +binary.set_subtype(0x10); + +// serialize to MessagePack +auto cbor = json::to_msgpack(j); // 0xD5 (fixext2), 0x10, 0xCA, 0xFE +``` + + +## Supported compilers + +Though it's 2020 already, the support for C++11 is still a bit sparse. Currently, the following compilers are known to work: + +- GCC 4.8 - 10.1 (and possibly later) +- Clang 3.4 - 10.0 (and possibly later) +- Apple Clang 9.1 - 12.0 (and possibly later) +- Intel C++ Compiler 17.0.2 (and possibly later) +- Microsoft Visual C++ 2015 / Build Tools 14.0.25123.0 (and possibly later) +- Microsoft Visual C++ 2017 / Build Tools 15.5.180.51428 (and possibly later) +- Microsoft Visual C++ 2019 / Build Tools 16.3.1+1def00d3d (and possibly later) + +I would be happy to learn about other compilers/versions. + +Please note: + +- GCC 4.8 has a bug [57824](https://gcc.gnu.org/bugzilla/show_bug.cgi?id=57824)): multiline raw strings cannot be the arguments to macros. Don't use multiline raw strings directly in macros with this compiler. +- Android defaults to using very old compilers and C++ libraries. To fix this, add the following to your `Application.mk`. This will switch to the LLVM C++ library, the Clang compiler, and enable C++11 and other features disabled by default. + + ``` + APP_STL := c++_shared + NDK_TOOLCHAIN_VERSION := clang3.6 + APP_CPPFLAGS += -frtti -fexceptions + ``` + + The code compiles successfully with [Android NDK](https://developer.android.com/ndk/index.html?hl=ml), Revision 9 - 11 (and possibly later) and [CrystaX's Android NDK](https://www.crystax.net/en/android/ndk) version 10. + +- For GCC running on MinGW or Android SDK, the error `'to_string' is not a member of 'std'` (or similarly, for `strtod` or `strtof`) may occur. Note this is not an issue with the code, but rather with the compiler itself. On Android, see above to build with a newer environment. For MinGW, please refer to [this site](https://tehsausage.com/mingw-to-string) and [this discussion](https://github.com/nlohmann/json/issues/136) for information on how to fix this bug. For Android NDK using `APP_STL := gnustl_static`, please refer to [this discussion](https://github.com/nlohmann/json/issues/219). + +- Unsupported versions of GCC and Clang are rejected by `#error` directives. This can be switched off by defining `JSON_SKIP_UNSUPPORTED_COMPILER_CHECK`. Note that you can expect no support in this case. + +The following compilers are currently used in continuous integration at [Travis](https://travis-ci.org/nlohmann/json), [AppVeyor](https://ci.appveyor.com/project/nlohmann/json), [GitHub Actions](https://github.com/nlohmann/json/actions), and [CircleCI](https://circleci.com/gh/nlohmann/json): + +| Compiler | Operating System | CI Provider | +|-----------------------------------------------------------------|--------------------|----------------| +| Apple Clang 9.1.0 (clang-902.0.39.1); Xcode 9.3 | macOS 10.13.3 | Travis | +| Apple Clang 9.1.0 (clang-902.0.39.2); Xcode 9.4.1 | macOS 10.13.6 | Travis | +| Apple Clang 10.0.0 (clang-1000.11.45.2); Xcode 10.0 | macOS 10.13.6 | Travis | +| Apple Clang 10.0.0 (clang-1000.11.45.5); Xcode 10.1 | macOS 10.13.6 | Travis | +| Apple Clang 10.0.1 (clang-1001.0.46.4); Xcode 10.2.1 | macOS 10.14.4 | Travis | +| Apple Clang 11.0.0 (clang-1100.0.33.12); Xcode 11.2.1 | macOS 10.14.6 | Travis | +| Apple Clang 11.0.3 (clang-1103.0.32.59); Xcode 11.4.1 | macOS 10.15.4 | GitHub Actions | +| Apple Clang 12.0.0 (clang-1200.0.22.7); Xcode 11.4.1 | macOS 10.15.5 | Travis | +| Clang 3.5.0 (3.5.0-4ubuntu2~trusty2) | Ubuntu 14.04.5 LTS | Travis | +| Clang 3.6.2 (3.6.2-svn240577-1~exp1) | Ubuntu 14.04.5 LTS | Travis | +| Clang 3.7.1 (3.7.1-svn253571-1~exp1) | Ubuntu 14.04.5 LTS | Travis | +| Clang 3.8.0 (3.8.0-2ubuntu3~trusty5) | Ubuntu 14.04.5 LTS | Travis | +| Clang 3.9.1 (3.9.1-4ubuntu3~14.04.3) | Ubuntu 14.04.5 LTS | Travis | +| Clang 4.0.1 (4.0.1-svn305264-1~exp1) | Ubuntu 14.04.5 LTS | Travis | +| Clang 5.0.2 (version 5.0.2-svn328729-1~exp1~20180509123505.100) | Ubuntu 14.04.5 LTS | Travis | +| Clang 6.0.1 (6.0.1-svn334776-1~exp1~20190309042707.121) | Ubuntu 14.04.5 LTS | Travis | +| Clang 7.1.0 (7.1.0-svn353565-1~exp1~20190419134007.64) | Ubuntu 14.04.5 LTS | Travis | +| Clang 7.5.0 (Ubuntu 7.5.0-3ubuntu1~18.04) | Ubuntu 18.04.4 LTS | Travis | +| Clang 9.0.0 (x86_64-pc-windows-msvc) | Windows-10.0.17763 | GitHub Actions | +| Clang 10.0.0 (x86_64-pc-windows-msvc) | Windows-10.0.17763 | GitHub Actions | +| GCC 4.8.5 (Ubuntu 4.8.5-4ubuntu8~14.04.2) | Ubuntu 14.04.5 LTS | Travis | +| GCC 4.9.4 (Ubuntu 4.9.4-2ubuntu1~14.04.1) | Ubuntu 14.04.5 LTS | Travis | +| GCC 5.5.0 (Ubuntu 5.5.0-12ubuntu1~14.04) | Ubuntu 14.04.5 LTS | Travis | +| GCC 6.3.0 (Debian 6.3.0-18+deb9u1) | Debian 9 | Circle CI | +| GCC 6.5.0 (Ubuntu 6.5.0-2ubuntu1~14.04.1) | Ubuntu 14.04.5 LTS | Travis | +| GCC 7.3.0 (x86_64-posix-seh-rev0, Built by MinGW-W64 project) | Windows-6.3.9600 | AppVeyor | +| GCC 7.5.0 (Ubuntu 7.5.0-3ubuntu1~14.04.1) | Ubuntu 14.04.5 LTS | Travis | +| GCC 7.5.0 (Ubuntu 7.5.0-3ubuntu1~18.04) | Ubuntu 18.04.4 LTS | GitHub Actions | +| GCC 8.4.0 (Ubuntu 8.4.0-1ubuntu1~14.04) | Ubuntu 14.04.5 LTS | Travis | +| GCC 9.3.0 (Ubuntu 9.3.0-11ubuntu0~14.04) | Ubuntu 14.04.5 LTS | Travis | +| GCC 10.1.0 (Arch Linux latest) | Arch Linux | Circle CI | +| MSVC 19.0.24241.7 (Build Engine version 14.0.25420.1) | Windows-6.3.9600 | AppVeyor | +| MSVC 19.16.27035.0 (15.9.21+g9802d43bc3 for .NET Framework) | Windows-10.0.14393 | AppVeyor | +| MSVC 19.25.28614.0 (Build Engine version 16.5.0+d4cbfca49 for .NET Framework) | Windows-10.0.17763 | AppVeyor | +| MSVC 19.25.28614.0 (Build Engine version 16.5.0+d4cbfca49 for .NET Framework) | Windows-10.0.17763 | GitHub Actions | +| MSVC 19.25.28614.0 (Build Engine version 16.5.0+d4cbfca49 for .NET Framework) with ClangCL 10.0.0 | Windows-10.0.17763 | GitHub Actions | + +## License + + + +The class is licensed under the [MIT License](http://opensource.org/licenses/MIT): + +Copyright © 2013-2019 [Niels Lohmann](http://nlohmann.me) + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +* * * + +The class contains the UTF-8 Decoder from Bjoern Hoehrmann which is licensed under the [MIT License](http://opensource.org/licenses/MIT) (see above). Copyright © 2008-2009 [Björn Hoehrmann](https://bjoern.hoehrmann.de/) + +The class contains a slightly modified version of the Grisu2 algorithm from Florian Loitsch which is licensed under the [MIT License](http://opensource.org/licenses/MIT) (see above). Copyright © 2009 [Florian Loitsch](https://florian.loitsch.com/) + +The class contains a copy of [Hedley](https://nemequ.github.io/hedley/) from Evan Nemerson which is licensed as [CC0-1.0](https://creativecommons.org/publicdomain/zero/1.0/). + +## Contact + +If you have questions regarding the library, I would like to invite you to [open an issue at GitHub](https://github.com/nlohmann/json/issues/new/choose). Please describe your request, problem, or question as detailed as possible, and also mention the version of the library you are using as well as the version of your compiler and operating system. Opening an issue at GitHub allows other users and contributors to this library to collaborate. For instance, I have little experience with MSVC, and most issues in this regard have been solved by a growing community. If you have a look at the [closed issues](https://github.com/nlohmann/json/issues?q=is%3Aissue+is%3Aclosed), you will see that we react quite timely in most cases. + +Only if your request would contain confidential information, please [send me an email](mailto:mail@nlohmann.me). For encrypted messages, please use [this key](https://keybase.io/nlohmann/pgp_keys.asc). + +## Security + +[Commits by Niels Lohmann](https://github.com/nlohmann/json/commits) and [releases](https://github.com/nlohmann/json/releases) are signed with this [PGP Key](https://keybase.io/nlohmann/pgp_keys.asc?fingerprint=797167ae41c0a6d9232e48457f3cea63ae251b69). + +## Thanks + +I deeply appreciate the help of the following people. + + + +- [Teemperor](https://github.com/Teemperor) implemented CMake support and lcov integration, realized escape and Unicode handling in the string parser, and fixed the JSON serialization. +- [elliotgoodrich](https://github.com/elliotgoodrich) fixed an issue with double deletion in the iterator classes. +- [kirkshoop](https://github.com/kirkshoop) made the iterators of the class composable to other libraries. +- [wancw](https://github.com/wanwc) fixed a bug that hindered the class to compile with Clang. +- Tomas Åblad found a bug in the iterator implementation. +- [Joshua C. Randall](https://github.com/jrandall) fixed a bug in the floating-point serialization. +- [Aaron Burghardt](https://github.com/aburgh) implemented code to parse streams incrementally. Furthermore, he greatly improved the parser class by allowing the definition of a filter function to discard undesired elements while parsing. +- [Daniel Kopeček](https://github.com/dkopecek) fixed a bug in the compilation with GCC 5.0. +- [Florian Weber](https://github.com/Florianjw) fixed a bug in and improved the performance of the comparison operators. +- [Eric Cornelius](https://github.com/EricMCornelius) pointed out a bug in the handling with NaN and infinity values. He also improved the performance of the string escaping. +- [易思龙](https://github.com/likebeta) implemented a conversion from anonymous enums. +- [kepkin](https://github.com/kepkin) patiently pushed forward the support for Microsoft Visual studio. +- [gregmarr](https://github.com/gregmarr) simplified the implementation of reverse iterators and helped with numerous hints and improvements. In particular, he pushed forward the implementation of user-defined types. +- [Caio Luppi](https://github.com/caiovlp) fixed a bug in the Unicode handling. +- [dariomt](https://github.com/dariomt) fixed some typos in the examples. +- [Daniel Frey](https://github.com/d-frey) cleaned up some pointers and implemented exception-safe memory allocation. +- [Colin Hirsch](https://github.com/ColinH) took care of a small namespace issue. +- [Huu Nguyen](https://github.com/whoshuu) correct a variable name in the documentation. +- [Silverweed](https://github.com/silverweed) overloaded `parse()` to accept an rvalue reference. +- [dariomt](https://github.com/dariomt) fixed a subtlety in MSVC type support and implemented the `get_ref()` function to get a reference to stored values. +- [ZahlGraf](https://github.com/ZahlGraf) added a workaround that allows compilation using Android NDK. +- [whackashoe](https://github.com/whackashoe) replaced a function that was marked as unsafe by Visual Studio. +- [406345](https://github.com/406345) fixed two small warnings. +- [Glen Fernandes](https://github.com/glenfe) noted a potential portability problem in the `has_mapped_type` function. +- [Corbin Hughes](https://github.com/nibroc) fixed some typos in the contribution guidelines. +- [twelsby](https://github.com/twelsby) fixed the array subscript operator, an issue that failed the MSVC build, and floating-point parsing/dumping. He further added support for unsigned integer numbers and implemented better roundtrip support for parsed numbers. +- [Volker Diels-Grabsch](https://github.com/vog) fixed a link in the README file. +- [msm-](https://github.com/msm-) added support for American Fuzzy Lop. +- [Annihil](https://github.com/Annihil) fixed an example in the README file. +- [Themercee](https://github.com/Themercee) noted a wrong URL in the README file. +- [Lv Zheng](https://github.com/lv-zheng) fixed a namespace issue with `int64_t` and `uint64_t`. +- [abc100m](https://github.com/abc100m) analyzed the issues with GCC 4.8 and proposed a [partial solution](https://github.com/nlohmann/json/pull/212). +- [zewt](https://github.com/zewt) added useful notes to the README file about Android. +- [Róbert Márki](https://github.com/robertmrk) added a fix to use move iterators and improved the integration via CMake. +- [Chris Kitching](https://github.com/ChrisKitching) cleaned up the CMake files. +- [Tom Needham](https://github.com/06needhamt) fixed a subtle bug with MSVC 2015 which was also proposed by [Michael K.](https://github.com/Epidal). +- [Mário Feroldi](https://github.com/thelostt) fixed a small typo. +- [duncanwerner](https://github.com/duncanwerner) found a really embarrassing performance regression in the 2.0.0 release. +- [Damien](https://github.com/dtoma) fixed one of the last conversion warnings. +- [Thomas Braun](https://github.com/t-b) fixed a warning in a test case and adjusted MSVC calls in the CI. +- [Théo DELRIEU](https://github.com/theodelrieu) patiently and constructively oversaw the long way toward [iterator-range parsing](https://github.com/nlohmann/json/issues/290). He also implemented the magic behind the serialization/deserialization of user-defined types and split the single header file into smaller chunks. +- [Stefan](https://github.com/5tefan) fixed a minor issue in the documentation. +- [Vasil Dimov](https://github.com/vasild) fixed the documentation regarding conversions from `std::multiset`. +- [ChristophJud](https://github.com/ChristophJud) overworked the CMake files to ease project inclusion. +- [Vladimir Petrigo](https://github.com/vpetrigo) made a SFINAE hack more readable and added Visual Studio 17 to the build matrix. +- [Denis Andrejew](https://github.com/seeekr) fixed a grammar issue in the README file. +- [Pierre-Antoine Lacaze](https://github.com/palacaze) found a subtle bug in the `dump()` function. +- [TurpentineDistillery](https://github.com/TurpentineDistillery) pointed to [`std::locale::classic()`](https://en.cppreference.com/w/cpp/locale/locale/classic) to avoid too much locale joggling, found some nice performance improvements in the parser, improved the benchmarking code, and realized locale-independent number parsing and printing. +- [cgzones](https://github.com/cgzones) had an idea how to fix the Coverity scan. +- [Jared Grubb](https://github.com/jaredgrubb) silenced a nasty documentation warning. +- [Yixin Zhang](https://github.com/qwename) fixed an integer overflow check. +- [Bosswestfalen](https://github.com/Bosswestfalen) merged two iterator classes into a smaller one. +- [Daniel599](https://github.com/Daniel599) helped to get Travis execute the tests with Clang's sanitizers. +- [Jonathan Lee](https://github.com/vjon) fixed an example in the README file. +- [gnzlbg](https://github.com/gnzlbg) supported the implementation of user-defined types. +- [Alexej Harm](https://github.com/qis) helped to get the user-defined types working with Visual Studio. +- [Jared Grubb](https://github.com/jaredgrubb) supported the implementation of user-defined types. +- [EnricoBilla](https://github.com/EnricoBilla) noted a typo in an example. +- [Martin Hořeňovský](https://github.com/horenmar) found a way for a 2x speedup for the compilation time of the test suite. +- [ukhegg](https://github.com/ukhegg) found proposed an improvement for the examples section. +- [rswanson-ihi](https://github.com/rswanson-ihi) noted a typo in the README. +- [Mihai Stan](https://github.com/stanmihai4) fixed a bug in the comparison with `nullptr`s. +- [Tushar Maheshwari](https://github.com/tusharpm) added [cotire](https://github.com/sakra/cotire) support to speed up the compilation. +- [TedLyngmo](https://github.com/TedLyngmo) noted a typo in the README, removed unnecessary bit arithmetic, and fixed some `-Weffc++` warnings. +- [Krzysztof Woś](https://github.com/krzysztofwos) made exceptions more visible. +- [ftillier](https://github.com/ftillier) fixed a compiler warning. +- [tinloaf](https://github.com/tinloaf) made sure all pushed warnings are properly popped. +- [Fytch](https://github.com/Fytch) found a bug in the documentation. +- [Jay Sistar](https://github.com/Type1J) implemented a Meson build description. +- [Henry Lee](https://github.com/HenryRLee) fixed a warning in ICC and improved the iterator implementation. +- [Vincent Thiery](https://github.com/vthiery) maintains a package for the Conan package manager. +- [Steffen](https://github.com/koemeet) fixed a potential issue with MSVC and `std::min`. +- [Mike Tzou](https://github.com/Chocobo1) fixed some typos. +- [amrcode](https://github.com/amrcode) noted a misleading documentation about comparison of floats. +- [Oleg Endo](https://github.com/olegendo) reduced the memory consumption by replacing `` with ``. +- [dan-42](https://github.com/dan-42) cleaned up the CMake files to simplify including/reusing of the library. +- [Nikita Ofitserov](https://github.com/himikof) allowed for moving values from initializer lists. +- [Greg Hurrell](https://github.com/wincent) fixed a typo. +- [Dmitry Kukovinets](https://github.com/DmitryKuk) fixed a typo. +- [kbthomp1](https://github.com/kbthomp1) fixed an issue related to the Intel OSX compiler. +- [Markus Werle](https://github.com/daixtrose) fixed a typo. +- [WebProdPP](https://github.com/WebProdPP) fixed a subtle error in a precondition check. +- [Alex](https://github.com/leha-bot) noted an error in a code sample. +- [Tom de Geus](https://github.com/tdegeus) reported some warnings with ICC and helped fixing them. +- [Perry Kundert](https://github.com/pjkundert) simplified reading from input streams. +- [Sonu Lohani](https://github.com/sonulohani) fixed a small compilation error. +- [Jamie Seward](https://github.com/jseward) fixed all MSVC warnings. +- [Nate Vargas](https://github.com/eld00d) added a Doxygen tag file. +- [pvleuven](https://github.com/pvleuven) helped fixing a warning in ICC. +- [Pavel](https://github.com/crea7or) helped fixing some warnings in MSVC. +- [Jamie Seward](https://github.com/jseward) avoided unnecessary string copies in `find()` and `count()`. +- [Mitja](https://github.com/Itja) fixed some typos. +- [Jorrit Wronski](https://github.com/jowr) updated the Hunter package links. +- [Matthias Möller](https://github.com/TinyTinni) added a `.natvis` for the MSVC debug view. +- [bogemic](https://github.com/bogemic) fixed some C++17 deprecation warnings. +- [Eren Okka](https://github.com/erengy) fixed some MSVC warnings. +- [abolz](https://github.com/abolz) integrated the Grisu2 algorithm for proper floating-point formatting, allowing more roundtrip checks to succeed. +- [Vadim Evard](https://github.com/Pipeliner) fixed a Markdown issue in the README. +- [zerodefect](https://github.com/zerodefect) fixed a compiler warning. +- [Kert](https://github.com/kaidokert) allowed to template the string type in the serialization and added the possibility to override the exceptional behavior. +- [mark-99](https://github.com/mark-99) helped fixing an ICC error. +- [Patrik Huber](https://github.com/patrikhuber) fixed links in the README file. +- [johnfb](https://github.com/johnfb) found a bug in the implementation of CBOR's indefinite length strings. +- [Paul Fultz II](https://github.com/pfultz2) added a note on the cget package manager. +- [Wilson Lin](https://github.com/wla80) made the integration section of the README more concise. +- [RalfBielig](https://github.com/ralfbielig) detected and fixed a memory leak in the parser callback. +- [agrianius](https://github.com/agrianius) allowed to dump JSON to an alternative string type. +- [Kevin Tonon](https://github.com/ktonon) overworked the C++11 compiler checks in CMake. +- [Axel Huebl](https://github.com/ax3l) simplified a CMake check and added support for the [Spack package manager](https://spack.io). +- [Carlos O'Ryan](https://github.com/coryan) fixed a typo. +- [James Upjohn](https://github.com/jammehcow) fixed a version number in the compilers section. +- [Chuck Atkins](https://github.com/chuckatkins) adjusted the CMake files to the CMake packaging guidelines and provided documentation for the CMake integration. +- [Jan Schöppach](https://github.com/dns13) fixed a typo. +- [martin-mfg](https://github.com/martin-mfg) fixed a typo. +- [Matthias Möller](https://github.com/TinyTinni) removed the dependency from `std::stringstream`. +- [agrianius](https://github.com/agrianius) added code to use alternative string implementations. +- [Daniel599](https://github.com/Daniel599) allowed to use more algorithms with the `items()` function. +- [Julius Rakow](https://github.com/jrakow) fixed the Meson include directory and fixed the links to [cppreference.com](cppreference.com). +- [Sonu Lohani](https://github.com/sonulohani) fixed the compilation with MSVC 2015 in debug mode. +- [grembo](https://github.com/grembo) fixed the test suite and re-enabled several test cases. +- [Hyeon Kim](https://github.com/simnalamburt) introduced the macro `JSON_INTERNAL_CATCH` to control the exception handling inside the library. +- [thyu](https://github.com/thyu) fixed a compiler warning. +- [David Guthrie](https://github.com/LEgregius) fixed a subtle compilation error with Clang 3.4.2. +- [Dennis Fischer](https://github.com/dennisfischer) allowed to call `find_package` without installing the library. +- [Hyeon Kim](https://github.com/simnalamburt) fixed an issue with a double macro definition. +- [Ben Berman](https://github.com/rivertam) made some error messages more understandable. +- [zakalibit](https://github.com/zakalibit) fixed a compilation problem with the Intel C++ compiler. +- [mandreyel](https://github.com/mandreyel) fixed a compilation problem. +- [Kostiantyn Ponomarenko](https://github.com/koponomarenko) added version and license information to the Meson build file. +- [Henry Schreiner](https://github.com/henryiii) added support for GCC 4.8. +- [knilch](https://github.com/knilch0r) made sure the test suite does not stall when run in the wrong directory. +- [Antonio Borondo](https://github.com/antonioborondo) fixed an MSVC 2017 warning. +- [Dan Gendreau](https://github.com/dgendreau) implemented the `NLOHMANN_JSON_SERIALIZE_ENUM` macro to quickly define a enum/JSON mapping. +- [efp](https://github.com/efp) added line and column information to parse errors. +- [julian-becker](https://github.com/julian-becker) added BSON support. +- [Pratik Chowdhury](https://github.com/pratikpc) added support for structured bindings. +- [David Avedissian](https://github.com/davedissian) added support for Clang 5.0.1 (PS4 version). +- [Jonathan Dumaresq](https://github.com/dumarjo) implemented an input adapter to read from `FILE*`. +- [kjpus](https://github.com/kjpus) fixed a link in the documentation. +- [Manvendra Singh](https://github.com/manu-chroma) fixed a typo in the documentation. +- [ziggurat29](https://github.com/ziggurat29) fixed an MSVC warning. +- [Sylvain Corlay](https://github.com/SylvainCorlay) added code to avoid an issue with MSVC. +- [mefyl](https://github.com/mefyl) fixed a bug when JSON was parsed from an input stream. +- [Millian Poquet](https://github.com/mpoquet) allowed to install the library via Meson. +- [Michael Behrns-Miller](https://github.com/moodboom) found an issue with a missing namespace. +- [Nasztanovics Ferenc](https://github.com/naszta) fixed a compilation issue with libc 2.12. +- [Andreas Schwab](https://github.com/andreas-schwab) fixed the endian conversion. +- [Mark-Dunning](https://github.com/Mark-Dunning) fixed a warning in MSVC. +- [Gareth Sylvester-Bradley](https://github.com/garethsb-sony) added `operator/` for JSON Pointers. +- [John-Mark](https://github.com/johnmarkwayve) noted a missing header. +- [Vitaly Zaitsev](https://github.com/xvitaly) fixed compilation with GCC 9.0. +- [Laurent Stacul](https://github.com/stac47) fixed compilation with GCC 9.0. +- [Ivor Wanders](https://github.com/iwanders) helped reducing the CMake requirement to version 3.1. +- [njlr](https://github.com/njlr) updated the Buckaroo instructions. +- [Lion](https://github.com/lieff) fixed a compilation issue with GCC 7 on CentOS. +- [Isaac Nickaein](https://github.com/nickaein) improved the integer serialization performance and implemented the `contains()` function. +- [past-due](https://github.com/past-due) suppressed an unfixable warning. +- [Elvis Oric](https://github.com/elvisoric) improved Meson support. +- [Matěj Plch](https://github.com/Afforix) fixed an example in the README. +- [Mark Beckwith](https://github.com/wythe) fixed a typo. +- [scinart](https://github.com/scinart) fixed bug in the serializer. +- [Patrick Boettcher](https://github.com/pboettch) implemented `push_back()` and `pop_back()` for JSON Pointers. +- [Bruno Oliveira](https://github.com/nicoddemus) added support for Conda. +- [Michele Caini](https://github.com/skypjack) fixed links in the README. +- [Hani](https://github.com/hnkb) documented how to install the library with NuGet. +- [Mark Beckwith](https://github.com/wythe) fixed a typo. +- [yann-morin-1998](https://github.com/yann-morin-1998) helped reducing the CMake requirement to version 3.1. +- [Konstantin Podsvirov](https://github.com/podsvirov) maintains a package for the MSYS2 software distro. +- [remyabel](https://github.com/remyabel) added GNUInstallDirs to the CMake files. +- [Taylor Howard](https://github.com/taylorhoward92) fixed a unit test. +- [Gabe Ron](https://github.com/Macr0Nerd) implemented the `to_string` method. +- [Watal M. Iwasaki](https://github.com/heavywatal) fixed a Clang warning. +- [Viktor Kirilov](https://github.com/onqtam) switched the unit tests from [Catch](https://github.com/philsquared/Catch) to [doctest](https://github.com/onqtam/doctest) +- [Juncheng E](https://github.com/ejcjason) fixed a typo. +- [tete17](https://github.com/tete17) fixed a bug in the `contains` function. +- [Xav83](https://github.com/Xav83) fixed some cppcheck warnings. +- [0xflotus](https://github.com/0xflotus) fixed some typos. +- [Christian Deneke](https://github.com/chris0x44) added a const version of `json_pointer::back`. +- [Julien Hamaide](https://github.com/crazyjul) made the `items()` function work with custom string types. +- [Evan Nemerson](https://github.com/nemequ) updated fixed a bug in Hedley and updated this library accordingly. +- [Florian Pigorsch](https://github.com/flopp) fixed a lot of typos. +- [Camille Bégué](https://github.com/cbegue) fixed an issue in the conversion from `std::pair` and `std::tuple` to `json`. +- [Anthony VH](https://github.com/AnthonyVH) fixed a compile error in an enum deserialization. +- [Yuriy Vountesmery](https://github.com/ua-code-dragon) noted a subtle bug in a preprocessor check. +- [Chen](https://github.com/dota17) fixed numerous issues in the library. +- [Antony Kellermann](https://github.com/aokellermann) added a CI step for GCC 10.1. +- [Alex](https://github.com/gistrec) fixed an MSVC warning. +- [Rainer](https://github.com/rvjr) proposed an improvement in the floating-point serialization in CBOR. +- [Francois Chabot](https://github.com/FrancoisChabot) made performance improvements in the input adapters. +- [Arthur Sonzogni](https://github.com/ArthurSonzogni) documented how the library can be included via `FetchContent`. +- [Rimas Misevičius](https://github.com/rmisev) fixed an error message. +- [Alexander Myasnikov](https://github.com/alexandermyasnikov) fixed some examples and a link in the README. +- [Hubert Chathi](https://github.com/uhoreg) made CMake's version config file architecture-independent. +- [OmnipotentEntity](https://github.com/OmnipotentEntity) implemented the binary values for CBOR, MessagePack, BSON, and UBJSON. +- [ArtemSarmini](https://github.com/ArtemSarmini) fixed a compilation issue with GCC 10 and fixed a leak. +- [Evgenii Sopov](https://github.com/sea-kg) integrated the library to the wsjcpp package manager. +- [Sergey Linev](https://github.com/linev) fixed a compiler warning. +- [Miguel Magalhães](https://github.com/magamig) fixed the year in the copyright. +- [Gareth Sylvester-Bradley](https://github.com/garethsb-sony) fixed a compilation issue with MSVC. +- [Alexander “weej” Jones](https://github.com/alex-weej) fixed an example in the README. +- [Antoine Cœur](https://github.com/Coeur) fixed some typos in the documentation. +- [jothepro](https://github.com/jothepro) updated links to the Hunter package. +- [Dave Lee](https://github.com/kastiglione) fixed link in the README. +- [Joël Lamotte](https://github.com/Klaim) added instruction for using Build2's package manager. +- [Paul Jurczak](https://github.com/pauljurczak) fixed an example in the README. +- [Sonu Lohani](https://github.com/sonulohani) fixed a warning. +- [Carlos Gomes Martinho](https://github.com/gocarlos) updated the Conan package source. +- [Konstantin Podsvirov](https://github.com/podsvirov) fixed the MSYS2 package documentation. +- [Tridacnid](https://github.com/Tridacnid) improved the CMake tests. +- [Michael](https://github.com/MBalszun) fixed MSVC warnings. +- [Quentin Barbarat](https://github.com/quentin-dev) fixed an example in the documentation. +- [XyFreak](https://github.com/XyFreak) fixed a compiler warning. +- [TotalCaesar659](https://github.com/TotalCaesar659) fixed links in the README. +- [Tanuj Garg](https://github.com/tanuj208) improved the fuzzer coverage for UBSAN input. +- [AODQ](https://github.com/AODQ) fixed a compiler warning. +- [jwittbrodt](https://github.com/jwittbrodt) made `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE` inline. +- [pfeatherstone](https://github.com/pfeatherstone) improved the upper bound of arguments of the `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`/`NLOHMANN_DEFINE_TYPE_INTRUSIVE` macros. +- [Jan Procházka](https://github.com/jprochazk) fixed a bug in the CBOR parser for binary and string values. +- [T0b1-iOS](https://github.com/T0b1-iOS) fixed a bug in the new hash implementation. +- [Matthew Bauer](https://github.com/matthewbauer) adjusted the CBOR writer to create tags for binary subtypes. +- [gatopeich](https://github.com/gatopeich) implemented an ordered map container for `nlohmann::ordered_json`. +- [Érico Nogueira Rolim](https://github.com/ericonr) added support for pkg-config. +- [KonanM](https://github.com/KonanM) proposed an implementation for the `NLOHMANN_DEFINE_TYPE_NON_INTRUSIVE`/`NLOHMANN_DEFINE_TYPE_INTRUSIVE` macros. +- [Guillaume Racicot](https://github.com/gracicot) implemented `string_view` support and allowed C++20 support. +- [Alex Reinking](https://github.com/alexreinking) improved CMake support for `FetchContent`. + +Thanks a lot for helping out! Please [let me know](mailto:mail@nlohmann.me) if I forgot someone. + + +## Used third-party tools + +The library itself consists of a single header file licensed under the MIT license. However, it is built, tested, documented, and whatnot using a lot of third-party tools and services. Thanks a lot! + +- [**amalgamate.py - Amalgamate C source and header files**](https://github.com/edlund/amalgamate) to create a single header file +- [**American fuzzy lop**](https://lcamtuf.coredump.cx/afl/) for fuzz testing +- [**AppVeyor**](https://www.appveyor.com) for [continuous integration](https://ci.appveyor.com/project/nlohmann/json) on Windows +- [**Artistic Style**](http://astyle.sourceforge.net) for automatic source code indentation +- [**CircleCI**](https://circleci.com) for [continuous integration](https://circleci.com/gh/nlohmann/json). +- [**Clang**](https://clang.llvm.org) for compilation with code sanitizers +- [**CMake**](https://cmake.org) for build automation +- [**Codacity**](https://www.codacy.com) for further [code analysis](https://www.codacy.com/app/nlohmann/json) +- [**Coveralls**](https://coveralls.io) to measure [code coverage](https://coveralls.io/github/nlohmann/json) +- [**Coverity Scan**](https://scan.coverity.com) for [static analysis](https://scan.coverity.com/projects/nlohmann-json) +- [**cppcheck**](http://cppcheck.sourceforge.net) for static analysis +- [**doctest**](https://github.com/onqtam/doctest) for the unit tests +- [**Doxygen**](https://www.doxygen.nl/index.html) to generate [documentation](https://nlohmann.github.io/json/doxygen/index.html) +- [**git-update-ghpages**](https://github.com/rstacruz/git-update-ghpages) to upload the documentation to gh-pages +- [**GitHub Changelog Generator**](https://github.com/skywinder/github-changelog-generator) to generate the [ChangeLog](https://github.com/nlohmann/json/blob/develop/ChangeLog.md) +- [**Google Benchmark**](https://github.com/google/benchmark) to implement the benchmarks +- [**Hedley**](https://nemequ.github.io/hedley/) to avoid re-inventing several compiler-agnostic feature macros +- [**lcov**](http://ltp.sourceforge.net/coverage/lcov.php) to process coverage information and create a HTML view +- [**libFuzzer**](https://llvm.org/docs/LibFuzzer.html) to implement fuzz testing for OSS-Fuzz +- [**OSS-Fuzz**](https://github.com/google/oss-fuzz) for continuous fuzz testing of the library ([project repository](https://github.com/google/oss-fuzz/tree/master/projects/json)) +- [**Probot**](https://probot.github.io) for automating maintainer tasks such as closing stale issues, requesting missing information, or detecting toxic comments. +- [**send_to_wandbox**](https://github.com/nlohmann/json/blob/develop/doc/scripts/send_to_wandbox.py) to send code examples to [Wandbox](http://melpon.org/wandbox) +- [**Travis**](https://travis-ci.org) for [continuous integration](https://travis-ci.org/nlohmann/json) on Linux and macOS +- [**Valgrind**](https://valgrind.org) to check for correct memory management +- [**Wandbox**](https://wandbox.org) for [online examples](https://wandbox.org/permlink/3lCHrFUZANONKv7a) + + +## Projects using JSON for Modern C++ + +The library is currently used in Apple macOS Sierra and iOS 10. I am not sure what they are using the library for, but I am happy that it runs on so many devices. + + +## Notes + +### Character encoding + +The library supports **Unicode input** as follows: + +- Only **UTF-8** encoded input is supported which is the default encoding for JSON according to [RFC 8259](https://tools.ietf.org/html/rfc8259.html#section-8.1). +- `std::u16string` and `std::u32string` can be parsed, assuming UTF-16 and UTF-32 encoding, respectively. These encodings are not supported when reading from files or other input containers. +- Other encodings such as Latin-1 or ISO 8859-1 are **not** supported and will yield parse or serialization errors. +- [Unicode noncharacters](https://www.unicode.org/faq/private_use.html#nonchar1) will not be replaced by the library. +- Invalid surrogates (e.g., incomplete pairs such as `\uDEAD`) will yield parse errors. +- The strings stored in the library are UTF-8 encoded. When using the default string type (`std::string`), note that its length/size functions return the number of stored bytes rather than the number of characters or glyphs. +- When you store strings with different encodings in the library, calling [`dump()`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a50ec80b02d0f3f51130d4abb5d1cfdc5.html#a50ec80b02d0f3f51130d4abb5d1cfdc5) may throw an exception unless `json::error_handler_t::replace` or `json::error_handler_t::ignore` are used as error handlers. + +### Comments in JSON + +This library does not support comments by default. It does so for three reasons: + +1. Comments are not part of the [JSON specification](https://tools.ietf.org/html/rfc8259). You may argue that `//` or `/* */` are allowed in JavaScript, but JSON is not JavaScript. +2. This was not an oversight: Douglas Crockford [wrote on this](https://plus.google.com/118095276221607585885/posts/RK8qyGVaGSr) in May 2012: + + > I removed comments from JSON because I saw people were using them to hold parsing directives, a practice which would have destroyed interoperability. I know that the lack of comments makes some people sad, but it shouldn't. + + > Suppose you are using JSON to keep configuration files, which you would like to annotate. Go ahead and insert all the comments you like. Then pipe it through JSMin before handing it to your JSON parser. + +3. It is dangerous for interoperability if some libraries would add comment support while others don't. Please check [The Harmful Consequences of the Robustness Principle](https://tools.ietf.org/html/draft-iab-protocol-maintenance-01) on this. + +However, you can pass set parameter `ignore_comments` to true in the `parse` function to ignore `//` or `/* */` comments. Comments will then be treated as whitespace. + +### Order of object keys + +By default, the library does not preserve the **insertion order of object elements**. This is standards-compliant, as the [JSON standard](https://tools.ietf.org/html/rfc8259.html) defines objects as "an unordered collection of zero or more name/value pairs". + +If you do want to preserve the insertion order, you can try the type [`nlohmann::ordered_json`](https://github.com/nlohmann/json/issues/2179). Alternatively, you can use a more sophisticated ordered map like [`tsl::ordered_map`](https://github.com/Tessil/ordered-map) ([integration](https://github.com/nlohmann/json/issues/546#issuecomment-304447518)) or [`nlohmann::fifo_map`](https://github.com/nlohmann/fifo_map) ([integration](https://github.com/nlohmann/json/issues/485#issuecomment-333652309)). + +### Memory Release + +We checked with Valgrind and the Address Sanitizer (ASAN) that there are no memory leaks. + +If you find that a parsing program with this library does not release memory, please consider the following case and it maybe unrelated to this library. + +**Your program is compiled with glibc.** There is a tunable threshold that glibc uses to decide whether to actually return memory to the system or whether to cache it for later reuse. If in your program you make lots of small allocations and those small allocations are not a contiguous block and are presumably below the threshold, then they will not get returned to the OS. +Here is a related issue [#1924](https://github.com/nlohmann/json/issues/1924). + +### Further notes + +- The code contains numerous debug **assertions** which can be switched off by defining the preprocessor macro `NDEBUG`, see the [documentation of `assert`](https://en.cppreference.com/w/cpp/error/assert). In particular, note [`operator[]`](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a233b02b0839ef798942dd46157cc0fe6.html#a233b02b0839ef798942dd46157cc0fe6) implements **unchecked access** for const objects: If the given key is not present, the behavior is undefined (think of a dereferenced null pointer) and yields an [assertion failure](https://github.com/nlohmann/json/issues/289) if assertions are switched on. If you are not sure whether an element in an object exists, use checked access with the [`at()` function](https://nlohmann.github.io/json/classnlohmann_1_1basic__json_a73ae333487310e3302135189ce8ff5d8.html#a73ae333487310e3302135189ce8ff5d8). Furthermore, you can define `JSON_ASSERT(x)` to replace calls to `assert(x)`. +- As the exact type of a number is not defined in the [JSON specification](https://tools.ietf.org/html/rfc8259.html), this library tries to choose the best fitting C++ number type automatically. As a result, the type `double` may be used to store numbers which may yield [**floating-point exceptions**](https://github.com/nlohmann/json/issues/181) in certain rare situations if floating-point exceptions have been unmasked in the calling code. These exceptions are not caused by the library and need to be fixed in the calling code, such as by re-masking the exceptions prior to calling library functions. +- The code can be compiled without C++ **runtime type identification** features; that is, you can use the `-fno-rtti` compiler flag. +- **Exceptions** are used widely within the library. They can, however, be switched off with either using the compiler flag `-fno-exceptions` or by defining the symbol `JSON_NOEXCEPTION`. In this case, exceptions are replaced by `abort()` calls. You can further control this behavior by defining `JSON_THROW_USER` (overriding `throw`), `JSON_TRY_USER` (overriding `try`), and `JSON_CATCH_USER` (overriding `catch`). Note that `JSON_THROW_USER` should leave the current scope (e.g., by throwing or aborting), as continuing after it may yield undefined behavior. + +## Execute unit tests + +To compile and run the tests, you need to execute + +```sh +$ mkdir build +$ cd build +$ cmake .. -DJSON_BuildTests=On +$ cmake --build . +$ ctest --output-on-failure +``` + +Note that during the `ctest` stage, several JSON test files are downloaded from an [external repository](https://github.com/nlohmann/json_test_data). If policies forbid downloading artifacts during testing, you can download the files yourself and pass the directory with the test files via `-DJSON_TestDataDirectory=path` to CMake. Then, no Internet connectivity is required. See [issue #2189](https://github.com/nlohmann/json/issues/2189) for more information. + +In case you have downloaded the library rather than checked out the code via Git, test `cmake_fetch_content_configure`. Please execute `ctest -LE git_required` to skip these tests. See [issue #2189](https://github.com/nlohmann/json/issues/2189) for more information. diff --git a/contrib/nlohmann_json/appveyor.yml b/contrib/nlohmann_json/appveyor.yml new file mode 100644 index 00000000000..5836f88d0e8 --- /dev/null +++ b/contrib/nlohmann_json/appveyor.yml @@ -0,0 +1,147 @@ +version: '{build}' + +environment: + matrix: + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015 + configuration: Debug + platform: x86 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 14 2015 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017 + configuration: Debug + platform: x86 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 15 2017 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019 + configuration: Debug + platform: x86 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 16 2019 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019 + configuration: Debug + platform: x64 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 16 2019 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015 + configuration: Debug + COMPILER: mingw + platform: x86 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Ninja + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015 + configuration: Release + COMPILER: mingw + platform: x86 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Ninja + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015 + configuration: Release + platform: x86 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 14 2015 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015 + configuration: Release + platform: x86 + name: with_win_header + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 14 2015 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017 + configuration: Release + platform: x86 + CXX_FLAGS: "/permissive- /std:c++latest /utf-8" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 15 2017 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019 + configuration: Release + platform: x86 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "-DJSON_ImplicitConversions=OFF" + GENERATOR: Visual Studio 16 2019 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019 + configuration: Release + platform: x64 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 16 2019 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015 + configuration: Release + platform: x64 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 14 2015 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017 + configuration: Release + platform: x64 + CXX_FLAGS: "/permissive- /std:c++latest /Zc:__cplusplus /utf-8 /F4000000" + LINKER_FLAGS: "/STACK:4000000" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 15 2017 + + - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019 + configuration: Release + platform: x64 + CXX_FLAGS: "" + LINKER_FLAGS: "" + CMAKE_OPTIONS: "" + GENERATOR: Visual Studio 16 2019 + +init: + - cmake --version + - msbuild /version + +install: + - if "%COMPILER%"=="mingw" appveyor DownloadFile https://github.com/ninja-build/ninja/releases/download/v1.6.0/ninja-win.zip -FileName ninja.zip + - if "%COMPILER%"=="mingw" 7z x ninja.zip -oC:\projects\deps\ninja > nul + - if "%COMPILER%"=="mingw" set PATH=C:\projects\deps\ninja;%PATH% + - if "%COMPILER%"=="mingw" set PATH=C:\mingw-w64\x86_64-7.3.0-posix-seh-rt_v5-rev0\mingw64\bin;%PATH% + - if "%COMPILER%"=="mingw" g++ --version + - if "%platform%"=="x86" set GENERATOR_PLATFORM=Win32 + +before_build: + # for with_win_header build, inject the inclusion of Windows.h to the single-header library + - ps: if ($env:name -Eq "with_win_header") { $header_path = "single_include\nlohmann\json.hpp" } + - ps: if ($env:name -Eq "with_win_header") { "#include `n" + (Get-Content $header_path | Out-String) | Set-Content $header_path } + - if "%GENERATOR%"=="Ninja" (cmake . -G "%GENERATOR%" -DCMAKE_BUILD_TYPE="%configuration%" -DCMAKE_CXX_FLAGS="%CXX_FLAGS%" -DCMAKE_EXE_LINKER_FLAGS="%LINKER_FLAGS%" -DCMAKE_IGNORE_PATH="C:/Program Files/Git/usr/bin" -DJSON_BuildTests=On "%CMAKE_OPTIONS%") else (cmake . -G "%GENERATOR%" -A "%GENERATOR_PLATFORM%" -DCMAKE_CXX_FLAGS="%CXX_FLAGS%" -DCMAKE_EXE_LINKER_FLAGS="%LINKER_FLAGS%" -DCMAKE_IGNORE_PATH="C:/Program Files/Git/usr/bin" -DJSON_BuildTests=On "%CMAKE_OPTIONS%") + +build_script: + - cmake --build . --config "%configuration%" + +test_script: + - if "%configuration%"=="Release" ctest -C "%configuration%" -V -j + # On Debug builds, skip test-unicode_all + # as it is extremely slow to run and cause + # occasional timeouts on AppVeyor. + # More info: https://github.com/nlohmann/json/pull/1570 + - if "%configuration%"=="Debug" ctest --exclude-regex "test-unicode" -C "%configuration%" -V -j diff --git a/contrib/nlohmann_json/benchmarks/CMakeLists.txt b/contrib/nlohmann_json/benchmarks/CMakeLists.txt new file mode 100644 index 00000000000..86063dbada4 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/CMakeLists.txt @@ -0,0 +1,25 @@ +cmake_minimum_required(VERSION 3.8) +project(JSON_Benchmarks LANGUAGES CXX) + +# set compiler flags +if((CMAKE_CXX_COMPILER_ID MATCHES GNU) OR (CMAKE_CXX_COMPILER_ID MATCHES Clang)) + set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -flto -DNDEBUG -O3") +endif() + +# configure Google Benchmarks +set(BENCHMARK_ENABLE_TESTING OFF CACHE INTERNAL "" FORCE) +add_subdirectory(thirdparty/benchmark) + +# header directories +include_directories(thirdparty) +include_directories(${CMAKE_SOURCE_DIR}/../single_include) + +# download test data +include(${CMAKE_SOURCE_DIR}/../cmake/download_test_data.cmake) + +# benchmark binary +add_executable(json_benchmarks src/benchmarks.cpp) +target_compile_features(json_benchmarks PRIVATE cxx_std_11) +target_link_libraries(json_benchmarks benchmark ${CMAKE_THREAD_LIBS_INIT}) +add_dependencies(json_benchmarks download_test_data) +target_include_directories(json_benchmarks PRIVATE ${CMAKE_BINARY_DIR}/include) diff --git a/contrib/nlohmann_json/benchmarks/src/benchmarks.cpp b/contrib/nlohmann_json/benchmarks/src/benchmarks.cpp new file mode 100644 index 00000000000..4f32a61a212 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/src/benchmarks.cpp @@ -0,0 +1,110 @@ +#include "benchmark/benchmark.h" +#include +#include +#include + +using json = nlohmann::json; + +////////////////////////////////////////////////////////////////////////////// +// parse JSON from file +////////////////////////////////////////////////////////////////////////////// + +static void ParseFile(benchmark::State& state, const char* filename) +{ + while (state.KeepRunning()) + { + state.PauseTiming(); + auto* f = new std::ifstream(filename); + auto* j = new json(); + state.ResumeTiming(); + + *j = json::parse(*f); + + state.PauseTiming(); + delete f; + delete j; + state.ResumeTiming(); + } + + std::ifstream file(filename, std::ios::binary | std::ios::ate); + state.SetBytesProcessed(state.iterations() * file.tellg()); +} +BENCHMARK_CAPTURE(ParseFile, jeopardy, TEST_DATA_DIRECTORY "/jeopardy/jeopardy.json"); +BENCHMARK_CAPTURE(ParseFile, canada, TEST_DATA_DIRECTORY "/nativejson-benchmark/canada.json"); +BENCHMARK_CAPTURE(ParseFile, citm_catalog, TEST_DATA_DIRECTORY "/nativejson-benchmark/citm_catalog.json"); +BENCHMARK_CAPTURE(ParseFile, twitter, TEST_DATA_DIRECTORY "/nativejson-benchmark/twitter.json"); +BENCHMARK_CAPTURE(ParseFile, floats, TEST_DATA_DIRECTORY "/regression/floats.json"); +BENCHMARK_CAPTURE(ParseFile, signed_ints, TEST_DATA_DIRECTORY "/regression/signed_ints.json"); +BENCHMARK_CAPTURE(ParseFile, unsigned_ints, TEST_DATA_DIRECTORY "/regression/unsigned_ints.json"); +BENCHMARK_CAPTURE(ParseFile, small_signed_ints, TEST_DATA_DIRECTORY "/regression/small_signed_ints.json"); + +////////////////////////////////////////////////////////////////////////////// +// parse JSON from string +////////////////////////////////////////////////////////////////////////////// + +static void ParseString(benchmark::State& state, const char* filename) +{ + std::ifstream f(filename); + std::string str((std::istreambuf_iterator(f)), std::istreambuf_iterator()); + + while (state.KeepRunning()) + { + state.PauseTiming(); + auto* j = new json(); + state.ResumeTiming(); + + *j = json::parse(str); + + state.PauseTiming(); + delete j; + state.ResumeTiming(); + } + + state.SetBytesProcessed(state.iterations() * str.size()); +} +BENCHMARK_CAPTURE(ParseString, jeopardy, TEST_DATA_DIRECTORY "/jeopardy/jeopardy.json"); +BENCHMARK_CAPTURE(ParseString, canada, TEST_DATA_DIRECTORY "/nativejson-benchmark/canada.json"); +BENCHMARK_CAPTURE(ParseString, citm_catalog, TEST_DATA_DIRECTORY "/nativejson-benchmark/citm_catalog.json"); +BENCHMARK_CAPTURE(ParseString, twitter, TEST_DATA_DIRECTORY "/nativejson-benchmark/twitter.json"); +BENCHMARK_CAPTURE(ParseString, floats, TEST_DATA_DIRECTORY "/regression/floats.json"); +BENCHMARK_CAPTURE(ParseString, signed_ints, TEST_DATA_DIRECTORY "/regression/signed_ints.json"); +BENCHMARK_CAPTURE(ParseString, unsigned_ints, TEST_DATA_DIRECTORY "/regression/unsigned_ints.json"); +BENCHMARK_CAPTURE(ParseString, small_signed_ints, TEST_DATA_DIRECTORY "/regression/small_signed_ints.json"); + + +////////////////////////////////////////////////////////////////////////////// +// serialize JSON +////////////////////////////////////////////////////////////////////////////// + +static void Dump(benchmark::State& state, const char* filename, int indent) +{ + std::ifstream f(filename); + std::string str((std::istreambuf_iterator(f)), std::istreambuf_iterator()); + json j = json::parse(str); + + while (state.KeepRunning()) + { + j.dump(indent); + } + + state.SetBytesProcessed(state.iterations() * j.dump(indent).size()); +} +BENCHMARK_CAPTURE(Dump, jeopardy / -, TEST_DATA_DIRECTORY "/jeopardy/jeopardy.json", -1); +BENCHMARK_CAPTURE(Dump, jeopardy / 4, TEST_DATA_DIRECTORY "/jeopardy/jeopardy.json", 4); +BENCHMARK_CAPTURE(Dump, canada / -, TEST_DATA_DIRECTORY "/nativejson-benchmark/canada.json", -1); +BENCHMARK_CAPTURE(Dump, canada / 4, TEST_DATA_DIRECTORY "/nativejson-benchmark/canada.json", 4); +BENCHMARK_CAPTURE(Dump, citm_catalog / -, TEST_DATA_DIRECTORY "/nativejson-benchmark/citm_catalog.json", -1); +BENCHMARK_CAPTURE(Dump, citm_catalog / 4, TEST_DATA_DIRECTORY "/nativejson-benchmark/citm_catalog.json", 4); +BENCHMARK_CAPTURE(Dump, twitter / -, TEST_DATA_DIRECTORY "/nativejson-benchmark/twitter.json", -1); +BENCHMARK_CAPTURE(Dump, twitter / 4, TEST_DATA_DIRECTORY "/nativejson-benchmark/twitter.json", 4); +BENCHMARK_CAPTURE(Dump, floats / -, TEST_DATA_DIRECTORY "/regression/floats.json", -1); +BENCHMARK_CAPTURE(Dump, floats / 4, TEST_DATA_DIRECTORY "/regression/floats.json", 4); +BENCHMARK_CAPTURE(Dump, signed_ints / -, TEST_DATA_DIRECTORY "/regression/signed_ints.json", -1); +BENCHMARK_CAPTURE(Dump, signed_ints / 4, TEST_DATA_DIRECTORY "/regression/signed_ints.json", 4); +BENCHMARK_CAPTURE(Dump, unsigned_ints / -, TEST_DATA_DIRECTORY "/regression/unsigned_ints.json", -1); +BENCHMARK_CAPTURE(Dump, unsigned_ints / 4, TEST_DATA_DIRECTORY "/regression/unsigned_ints.json", 4); +BENCHMARK_CAPTURE(Dump, small_signed_ints / -, TEST_DATA_DIRECTORY "/regression/small_signed_ints.json", -1); +BENCHMARK_CAPTURE(Dump, small_signed_ints / 4, TEST_DATA_DIRECTORY "/regression/small_signed_ints.json", 4); + + +BENCHMARK_MAIN(); diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/AUTHORS b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/AUTHORS new file mode 100755 index 00000000000..f8219036d2d --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/AUTHORS @@ -0,0 +1,46 @@ +# This is the official list of benchmark authors for copyright purposes. +# This file is distinct from the CONTRIBUTORS files. +# See the latter for an explanation. +# +# Names should be added to this file as: +# Name or Organization +# The email address is not required for organizations. +# +# Please keep the list sorted. + +Albert Pretorius +Arne Beer +Carto +Christopher Seymour +David Coeurjolly +Deniz Evrenci +Dirac Research +Dominik Czarnota +Eric Fiselier +Eugene Zhuk +Evgeny Safronov +Felix Homann +Google Inc. +International Business Machines Corporation +Ismael Jimenez Martinez +Jern-Kuan Leong +JianXiong Zhou +Joao Paulo Magalhaes +Jussi Knuuttila +Kaito Udagawa +Kishan Kumar +Lei Xu +Matt Clarkson +Maxim Vafin +MongoDB Inc. +Nick Hutchinson +Oleksandr Sochka +Paul Redmond +Radoslav Yovchev +Roman Lebedev +Shuo Chen +Steinar H. Gunderson +Stripe, Inc. +Yixuan Qiu +Yusuke Suzuki +Zbigniew Skowron diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/BUILD.bazel b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/BUILD.bazel new file mode 100755 index 00000000000..6ee69f29072 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/BUILD.bazel @@ -0,0 +1,42 @@ +licenses(["notice"]) + +config_setting( + name = "windows", + values = { + "cpu": "x64_windows", + }, + visibility = [":__subpackages__"], +) + +cc_library( + name = "benchmark", + srcs = glob( + [ + "src/*.cc", + "src/*.h", + ], + exclude = ["src/benchmark_main.cc"], + ), + hdrs = ["include/benchmark/benchmark.h"], + linkopts = select({ + ":windows": ["-DEFAULTLIB:shlwapi.lib"], + "//conditions:default": ["-pthread"], + }), + strip_include_prefix = "include", + visibility = ["//visibility:public"], +) + +cc_library( + name = "benchmark_main", + srcs = ["src/benchmark_main.cc"], + hdrs = ["include/benchmark/benchmark.h"], + strip_include_prefix = "include", + visibility = ["//visibility:public"], + deps = [":benchmark"], +) + +cc_library( + name = "benchmark_internal_headers", + hdrs = glob(["src/*.h"]), + visibility = ["//test:__pkg__"], +) diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CMakeLists.txt b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CMakeLists.txt new file mode 100755 index 00000000000..b1c1d3d5a90 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CMakeLists.txt @@ -0,0 +1,251 @@ +cmake_minimum_required (VERSION 2.8.12) + +project (benchmark) + +foreach(p + CMP0054 # CMake 3.1 + CMP0056 # export EXE_LINKER_FLAGS to try_run + CMP0057 # Support no if() IN_LIST operator + ) + if(POLICY ${p}) + cmake_policy(SET ${p} NEW) + endif() +endforeach() + +option(BENCHMARK_ENABLE_TESTING "Enable testing of the benchmark library." ON) +option(BENCHMARK_ENABLE_EXCEPTIONS "Enable the use of exceptions in the benchmark library." ON) +option(BENCHMARK_ENABLE_LTO "Enable link time optimisation of the benchmark library." OFF) +option(BENCHMARK_USE_LIBCXX "Build and test using libc++ as the standard library." OFF) +option(BENCHMARK_BUILD_32_BITS "Build a 32 bit version of the library." OFF) +option(BENCHMARK_ENABLE_INSTALL "Enable installation of benchmark. (Projects embedding benchmark may want to turn this OFF.)" ON) + +# Allow unmet dependencies to be met using CMake's ExternalProject mechanics, which +# may require downloading the source code. +option(BENCHMARK_DOWNLOAD_DEPENDENCIES "Allow the downloading and in-tree building of unmet dependencies" OFF) + +# This option can be used to disable building and running unit tests which depend on gtest +# in cases where it is not possible to build or find a valid version of gtest. +option(BENCHMARK_ENABLE_GTEST_TESTS "Enable building the unit tests which depend on gtest" ON) + +set(ENABLE_ASSEMBLY_TESTS_DEFAULT OFF) +function(should_enable_assembly_tests) + if(CMAKE_BUILD_TYPE) + string(TOLOWER ${CMAKE_BUILD_TYPE} CMAKE_BUILD_TYPE_LOWER) + if (${CMAKE_BUILD_TYPE_LOWER} MATCHES "coverage") + # FIXME: The --coverage flag needs to be removed when building assembly + # tests for this to work. + return() + endif() + endif() + if (MSVC) + return() + elseif(NOT CMAKE_SYSTEM_PROCESSOR MATCHES "x86_64") + return() + elseif(NOT CMAKE_SIZEOF_VOID_P EQUAL 8) + # FIXME: Make these work on 32 bit builds + return() + elseif(BENCHMARK_BUILD_32_BITS) + # FIXME: Make these work on 32 bit builds + return() + endif() + find_program(LLVM_FILECHECK_EXE FileCheck) + if (LLVM_FILECHECK_EXE) + set(LLVM_FILECHECK_EXE "${LLVM_FILECHECK_EXE}" CACHE PATH "llvm filecheck" FORCE) + message(STATUS "LLVM FileCheck Found: ${LLVM_FILECHECK_EXE}") + else() + message(STATUS "Failed to find LLVM FileCheck") + return() + endif() + set(ENABLE_ASSEMBLY_TESTS_DEFAULT ON PARENT_SCOPE) +endfunction() +should_enable_assembly_tests() + +# This option disables the building and running of the assembly verification tests +option(BENCHMARK_ENABLE_ASSEMBLY_TESTS "Enable building and running the assembly tests" + ${ENABLE_ASSEMBLY_TESTS_DEFAULT}) + +# Make sure we can import out CMake functions +list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake/Modules") +list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake") + + +# Read the git tags to determine the project version +include(GetGitVersion) +get_git_version(GIT_VERSION) + +# Tell the user what versions we are using +string(REGEX MATCH "[0-9]+\\.[0-9]+\\.[0-9]+" VERSION ${GIT_VERSION}) +message("-- Version: ${VERSION}") + +# The version of the libraries +set(GENERIC_LIB_VERSION ${VERSION}) +string(SUBSTRING ${VERSION} 0 1 GENERIC_LIB_SOVERSION) + +# Import our CMake modules +include(CheckCXXCompilerFlag) +include(AddCXXCompilerFlag) +include(CXXFeatureCheck) + +if (BENCHMARK_BUILD_32_BITS) + add_required_cxx_compiler_flag(-m32) +endif() + +if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "MSVC") + # Turn compiler warnings up to 11 + string(REGEX REPLACE "[-/]W[1-4]" "" CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}") + set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /W4") + add_definitions(-D_CRT_SECURE_NO_WARNINGS) + + if (NOT BENCHMARK_ENABLE_EXCEPTIONS) + add_cxx_compiler_flag(-EHs-) + add_cxx_compiler_flag(-EHa-) + endif() + # Link time optimisation + if (BENCHMARK_ENABLE_LTO) + set(CMAKE_CXX_FLAGS_RELEASE "${CMAKE_CXX_FLAGS_RELEASE} /GL") + set(CMAKE_STATIC_LINKER_FLAGS_RELEASE "${CMAKE_STATIC_LINKER_FLAGS_RELEASE} /LTCG") + set(CMAKE_SHARED_LINKER_FLAGS_RELEASE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE} /LTCG") + set(CMAKE_EXE_LINKER_FLAGS_RELEASE "${CMAKE_EXE_LINKER_FLAGS_RELEASE} /LTCG") + + set(CMAKE_CXX_FLAGS_RELWITHDEBINFO "${CMAKE_CXX_FLAGS_RELWITHDEBINFO} /GL") + string(REGEX REPLACE "[-/]INCREMENTAL" "/INCREMENTAL:NO" CMAKE_STATIC_LINKER_FLAGS_RELWITHDEBINFO "${CMAKE_STATIC_LINKER_FLAGS_RELWITHDEBINFO}") + set(CMAKE_STATIC_LINKER_FLAGS_RELWITHDEBINFO "${CMAKE_STATIC_LINKER_FLAGS_RELWITHDEBINFO} /LTCG") + string(REGEX REPLACE "[-/]INCREMENTAL" "/INCREMENTAL:NO" CMAKE_SHARED_LINKER_FLAGS_RELWITHDEBINFO "${CMAKE_SHARED_LINKER_FLAGS_RELWITHDEBINFO}") + set(CMAKE_SHARED_LINKER_FLAGS_RELWITHDEBINFO "${CMAKE_SHARED_LINKER_FLAGS_RELWITHDEBINFO} /LTCG") + string(REGEX REPLACE "[-/]INCREMENTAL" "/INCREMENTAL:NO" CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO "${CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO}") + set(CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO "${CMAKE_EXE_LINKER_FLAGS_RELWITHDEBINFO} /LTCG") + + set(CMAKE_CXX_FLAGS_MINSIZEREL "${CMAKE_CXX_FLAGS_MINSIZEREL} /GL") + set(CMAKE_STATIC_LINKER_FLAGS_MINSIZEREL "${CMAKE_STATIC_LINKER_FLAGS_MINSIZEREL} /LTCG") + set(CMAKE_SHARED_LINKER_FLAGS_MINSIZEREL "${CMAKE_SHARED_LINKER_FLAGS_MINSIZEREL} /LTCG") + set(CMAKE_EXE_LINKER_FLAGS_MINSIZEREL "${CMAKE_EXE_LINKER_FLAGS_MINSIZEREL} /LTCG") + endif() +else() + # Try and enable C++11. Don't use C++14 because it doesn't work in some + # configurations. + add_cxx_compiler_flag(-std=c++11) + if (NOT HAVE_CXX_FLAG_STD_CXX11) + add_cxx_compiler_flag(-std=c++0x) + endif() + + # Turn compiler warnings up to 11 + add_cxx_compiler_flag(-Wall) + + add_cxx_compiler_flag(-Wextra) + add_cxx_compiler_flag(-Wshadow) + add_cxx_compiler_flag(-Werror RELEASE) + add_cxx_compiler_flag(-Werror RELWITHDEBINFO) + add_cxx_compiler_flag(-Werror MINSIZEREL) + add_cxx_compiler_flag(-pedantic) + add_cxx_compiler_flag(-pedantic-errors) + add_cxx_compiler_flag(-Wshorten-64-to-32) + add_cxx_compiler_flag(-Wfloat-equal) + add_cxx_compiler_flag(-fstrict-aliasing) + if (NOT BENCHMARK_ENABLE_EXCEPTIONS) + add_cxx_compiler_flag(-fno-exceptions) + endif() + + if (HAVE_CXX_FLAG_FSTRICT_ALIASING) + if (NOT CMAKE_CXX_COMPILER_ID STREQUAL "Intel") #ICC17u2: Many false positives for Wstrict-aliasing + add_cxx_compiler_flag(-Wstrict-aliasing) + endif() + endif() + # ICC17u2: overloaded virtual function "benchmark::Fixture::SetUp" is only partially overridden + # (because of deprecated overload) + add_cxx_compiler_flag(-wd654) + add_cxx_compiler_flag(-Wthread-safety) + if (HAVE_CXX_FLAG_WTHREAD_SAFETY) + cxx_feature_check(THREAD_SAFETY_ATTRIBUTES) + endif() + + # On most UNIX like platforms g++ and clang++ define _GNU_SOURCE as a + # predefined macro, which turns on all of the wonderful libc extensions. + # However g++ doesn't do this in Cygwin so we have to define it ourselfs + # since we depend on GNU/POSIX/BSD extensions. + if (CYGWIN) + add_definitions(-D_GNU_SOURCE=1) + endif() + + # Link time optimisation + if (BENCHMARK_ENABLE_LTO) + add_cxx_compiler_flag(-flto) + if ("${CMAKE_C_COMPILER_ID}" STREQUAL "GNU") + find_program(GCC_AR gcc-ar) + if (GCC_AR) + set(CMAKE_AR ${GCC_AR}) + endif() + find_program(GCC_RANLIB gcc-ranlib) + if (GCC_RANLIB) + set(CMAKE_RANLIB ${GCC_RANLIB}) + endif() + elseif("${CMAKE_C_COMPILER_ID}" STREQUAL "Clang") + include(llvm-toolchain) + endif() + endif() + + # Coverage build type + set(BENCHMARK_CXX_FLAGS_COVERAGE "${CMAKE_CXX_FLAGS_DEBUG}" + CACHE STRING "Flags used by the C++ compiler during coverage builds." + FORCE) + set(BENCHMARK_EXE_LINKER_FLAGS_COVERAGE "${CMAKE_EXE_LINKER_FLAGS_DEBUG}" + CACHE STRING "Flags used for linking binaries during coverage builds." + FORCE) + set(BENCHMARK_SHARED_LINKER_FLAGS_COVERAGE "${CMAKE_SHARED_LINKER_FLAGS_DEBUG}" + CACHE STRING "Flags used by the shared libraries linker during coverage builds." + FORCE) + mark_as_advanced( + BENCHMARK_CXX_FLAGS_COVERAGE + BENCHMARK_EXE_LINKER_FLAGS_COVERAGE + BENCHMARK_SHARED_LINKER_FLAGS_COVERAGE) + set(CMAKE_BUILD_TYPE "${CMAKE_BUILD_TYPE}" CACHE STRING + "Choose the type of build, options are: None Debug Release RelWithDebInfo MinSizeRel Coverage.") + add_cxx_compiler_flag(--coverage COVERAGE) +endif() + +if (BENCHMARK_USE_LIBCXX) + if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "Clang") + add_cxx_compiler_flag(-stdlib=libc++) + elseif ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "GNU" OR + "${CMAKE_CXX_COMPILER_ID}" STREQUAL "Intel") + add_cxx_compiler_flag(-nostdinc++) + message("libc++ header path must be manually specified using CMAKE_CXX_FLAGS") + # Adding -nodefaultlibs directly to CMAKE__LINKER_FLAGS will break + # configuration checks such as 'find_package(Threads)' + list(APPEND BENCHMARK_CXX_LINKER_FLAGS -nodefaultlibs) + # -lc++ cannot be added directly to CMAKE__LINKER_FLAGS because + # linker flags appear before all linker inputs and -lc++ must appear after. + list(APPEND BENCHMARK_CXX_LIBRARIES c++) + else() + message(FATAL_ERROR "-DBENCHMARK_USE_LIBCXX:BOOL=ON is not supported for compiler") + endif() +endif(BENCHMARK_USE_LIBCXX) + +# C++ feature checks +# Determine the correct regular expression engine to use +cxx_feature_check(STD_REGEX) +cxx_feature_check(GNU_POSIX_REGEX) +cxx_feature_check(POSIX_REGEX) +if(NOT HAVE_STD_REGEX AND NOT HAVE_GNU_POSIX_REGEX AND NOT HAVE_POSIX_REGEX) + message(FATAL_ERROR "Failed to determine the source files for the regular expression backend") +endif() +if (NOT BENCHMARK_ENABLE_EXCEPTIONS AND HAVE_STD_REGEX + AND NOT HAVE_GNU_POSIX_REGEX AND NOT HAVE_POSIX_REGEX) + message(WARNING "Using std::regex with exceptions disabled is not fully supported") +endif() +cxx_feature_check(STEADY_CLOCK) +# Ensure we have pthreads +find_package(Threads REQUIRED) + +# Set up directories +include_directories(${PROJECT_SOURCE_DIR}/include) + +# Build the targets +add_subdirectory(src) + +if (BENCHMARK_ENABLE_TESTING) + enable_testing() + if (BENCHMARK_ENABLE_GTEST_TESTS) + include(HandleGTest) + endif() + add_subdirectory(test) +endif() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTING.md b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTING.md new file mode 100755 index 00000000000..43de4c9d470 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTING.md @@ -0,0 +1,58 @@ +# How to contribute # + +We'd love to accept your patches and contributions to this project. There are +a just a few small guidelines you need to follow. + + +## Contributor License Agreement ## + +Contributions to any Google project must be accompanied by a Contributor +License Agreement. This is not a copyright **assignment**, it simply gives +Google permission to use and redistribute your contributions as part of the +project. + + * If you are an individual writing original source code and you're sure you + own the intellectual property, then you'll need to sign an [individual + CLA][]. + + * If you work for a company that wants to allow you to contribute your work, + then you'll need to sign a [corporate CLA][]. + +You generally only need to submit a CLA once, so if you've already submitted +one (even if it was for a different project), you probably don't need to do it +again. + +[individual CLA]: https://developers.google.com/open-source/cla/individual +[corporate CLA]: https://developers.google.com/open-source/cla/corporate + +Once your CLA is submitted (or if you already submitted one for +another Google project), make a commit adding yourself to the +[AUTHORS][] and [CONTRIBUTORS][] files. This commit can be part +of your first [pull request][]. + +[AUTHORS]: AUTHORS +[CONTRIBUTORS]: CONTRIBUTORS + + +## Submitting a patch ## + + 1. It's generally best to start by opening a new issue describing the bug or + feature you're intending to fix. Even if you think it's relatively minor, + it's helpful to know what people are working on. Mention in the initial + issue that you are planning to work on that bug or feature so that it can + be assigned to you. + + 1. Follow the normal process of [forking][] the project, and setup a new + branch to work in. It's important that each group of changes be done in + separate branches in order to ensure that a pull request only includes the + commits related to that bug or feature. + + 1. Do your best to have [well-formed commit messages][] for each change. + This provides consistency throughout the project, and ensures that commit + messages are able to be formatted properly by various git tools. + + 1. Finally, push the commits to your fork and submit a [pull request][]. + +[forking]: https://help.github.com/articles/fork-a-repo +[well-formed commit messages]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html +[pull request]: https://help.github.com/articles/creating-a-pull-request diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTORS b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTORS new file mode 100755 index 00000000000..1cf04db17e4 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/CONTRIBUTORS @@ -0,0 +1,65 @@ +# People who have agreed to one of the CLAs and can contribute patches. +# The AUTHORS file lists the copyright holders; this file +# lists people. For example, Google employees are listed here +# but not in AUTHORS, because Google holds the copyright. +# +# Names should be added to this file only after verifying that +# the individual or the individual's organization has agreed to +# the appropriate Contributor License Agreement, found here: +# +# https://developers.google.com/open-source/cla/individual +# https://developers.google.com/open-source/cla/corporate +# +# The agreement for individuals can be filled out on the web. +# +# When adding J Random Contributor's name to this file, +# either J's name or J's organization's name should be +# added to the AUTHORS file, depending on whether the +# individual or corporate CLA was used. +# +# Names should be added to this file as: +# Name +# +# Please keep the list sorted. + +Albert Pretorius +Arne Beer +Billy Robert O'Neal III +Chris Kennelly +Christopher Seymour +David Coeurjolly +Deniz Evrenci +Dominic Hamon +Dominik Czarnota +Eric Fiselier +Eugene Zhuk +Evgeny Safronov +Felix Homann +Ismael Jimenez Martinez +Jern-Kuan Leong +JianXiong Zhou +Joao Paulo Magalhaes +John Millikin +Jussi Knuuttila +Kai Wolf +Kishan Kumar +Kaito Udagawa +Lei Xu +Matt Clarkson +Maxim Vafin +Nick Hutchinson +Oleksandr Sochka +Pascal Leroy +Paul Redmond +Pierre Phaneuf +Radoslav Yovchev +Raul Marin +Ray Glover +Robert Guo +Roman Lebedev +Shuo Chen +Tobias Ulvgård +Tom Madams +Yixuan Qiu +Yusuke Suzuki +Zbigniew Skowron diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/LICENSE b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/LICENSE new file mode 100755 index 00000000000..d6456956733 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/README.md b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/README.md new file mode 100755 index 00000000000..0341c31bd74 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/README.md @@ -0,0 +1,950 @@ +# benchmark +[![Build Status](https://travis-ci.org/google/benchmark.svg?branch=master)](https://travis-ci.org/google/benchmark) +[![Build status](https://ci.appveyor.com/api/projects/status/u0qsyp7t1tk7cpxs/branch/master?svg=true)](https://ci.appveyor.com/project/google/benchmark/branch/master) +[![Coverage Status](https://coveralls.io/repos/google/benchmark/badge.svg)](https://coveralls.io/r/google/benchmark) +[![slackin](https://slackin-iqtfqnpzxd.now.sh/badge.svg)](https://slackin-iqtfqnpzxd.now.sh/) + +A library to support the benchmarking of functions, similar to unit-tests. + +Discussion group: https://groups.google.com/d/forum/benchmark-discuss + +IRC channel: https://freenode.net #googlebenchmark + +[Known issues and common problems](#known-issues) + +[Additional Tooling Documentation](docs/tools.md) + +[Assembly Testing Documentation](docs/AssemblyTests.md) + + +## Building + +The basic steps for configuring and building the library look like this: + +```bash +$ git clone https://github.com/google/benchmark.git +# Benchmark requires Google Test as a dependency. Add the source tree as a subdirectory. +$ git clone https://github.com/google/googletest.git benchmark/googletest +$ mkdir build && cd build +$ cmake -G [options] ../benchmark +# Assuming a makefile generator was used +$ make +``` + +Note that Google Benchmark requires Google Test to build and run the tests. This +dependency can be provided two ways: + +* Checkout the Google Test sources into `benchmark/googletest` as above. +* Otherwise, if `-DBENCHMARK_DOWNLOAD_DEPENDENCIES=ON` is specified during + configuration, the library will automatically download and build any required + dependencies. + +If you do not wish to build and run the tests, add `-DBENCHMARK_ENABLE_GTEST_TESTS=OFF` +to `CMAKE_ARGS`. + + +## Installation Guide + +For Ubuntu and Debian Based System + +First make sure you have git and cmake installed (If not please install it) + +``` +sudo apt-get install git +sudo apt-get install cmake +``` + +Now, let's clone the repository and build it + +``` +git clone https://github.com/google/benchmark.git +cd benchmark +git clone https://github.com/google/googletest.git +mkdir build +cd build +cmake .. -DCMAKE_BUILD_TYPE=RELEASE +make +``` + +We need to install the library globally now + +``` +sudo make install +``` + +Now you have google/benchmark installed in your machine +Note: Don't forget to link to pthread library while building + +## Stable and Experimental Library Versions + +The main branch contains the latest stable version of the benchmarking library; +the API of which can be considered largely stable, with source breaking changes +being made only upon the release of a new major version. + +Newer, experimental, features are implemented and tested on the +[`v2` branch](https://github.com/google/benchmark/tree/v2). Users who wish +to use, test, and provide feedback on the new features are encouraged to try +this branch. However, this branch provides no stability guarantees and reserves +the right to change and break the API at any time. + +##Prerequisite knowledge + +Before attempting to understand this framework one should ideally have some familiarity with the structure and format of the Google Test framework, upon which it is based. Documentation for Google Test, including a "Getting Started" (primer) guide, is available here: +https://github.com/google/googletest/blob/master/googletest/docs/Documentation.md + + +## Example usage +### Basic usage +Define a function that executes the code to be measured. + +```c++ +#include + +static void BM_StringCreation(benchmark::State& state) { + for (auto _ : state) + std::string empty_string; +} +// Register the function as a benchmark +BENCHMARK(BM_StringCreation); + +// Define another benchmark +static void BM_StringCopy(benchmark::State& state) { + std::string x = "hello"; + for (auto _ : state) + std::string copy(x); +} +BENCHMARK(BM_StringCopy); + +BENCHMARK_MAIN(); +``` + +Don't forget to inform your linker to add benchmark library e.g. through +`-lbenchmark` compilation flag. Alternatively, you may leave out the +`BENCHMARK_MAIN();` at the end of the source file and link against +`-lbenchmark_main` to get the same default behavior. + +The benchmark library will reporting the timing for the code within the `for(...)` loop. + +### Passing arguments +Sometimes a family of benchmarks can be implemented with just one routine that +takes an extra argument to specify which one of the family of benchmarks to +run. For example, the following code defines a family of benchmarks for +measuring the speed of `memcpy()` calls of different lengths: + +```c++ +static void BM_memcpy(benchmark::State& state) { + char* src = new char[state.range(0)]; + char* dst = new char[state.range(0)]; + memset(src, 'x', state.range(0)); + for (auto _ : state) + memcpy(dst, src, state.range(0)); + state.SetBytesProcessed(int64_t(state.iterations()) * + int64_t(state.range(0))); + delete[] src; + delete[] dst; +} +BENCHMARK(BM_memcpy)->Arg(8)->Arg(64)->Arg(512)->Arg(1<<10)->Arg(8<<10); +``` + +The preceding code is quite repetitive, and can be replaced with the following +short-hand. The following invocation will pick a few appropriate arguments in +the specified range and will generate a benchmark for each such argument. + +```c++ +BENCHMARK(BM_memcpy)->Range(8, 8<<10); +``` + +By default the arguments in the range are generated in multiples of eight and +the command above selects [ 8, 64, 512, 4k, 8k ]. In the following code the +range multiplier is changed to multiples of two. + +```c++ +BENCHMARK(BM_memcpy)->RangeMultiplier(2)->Range(8, 8<<10); +``` +Now arguments generated are [ 8, 16, 32, 64, 128, 256, 512, 1024, 2k, 4k, 8k ]. + +You might have a benchmark that depends on two or more inputs. For example, the +following code defines a family of benchmarks for measuring the speed of set +insertion. + +```c++ +static void BM_SetInsert(benchmark::State& state) { + std::set data; + for (auto _ : state) { + state.PauseTiming(); + data = ConstructRandomSet(state.range(0)); + state.ResumeTiming(); + for (int j = 0; j < state.range(1); ++j) + data.insert(RandomNumber()); + } +} +BENCHMARK(BM_SetInsert) + ->Args({1<<10, 128}) + ->Args({2<<10, 128}) + ->Args({4<<10, 128}) + ->Args({8<<10, 128}) + ->Args({1<<10, 512}) + ->Args({2<<10, 512}) + ->Args({4<<10, 512}) + ->Args({8<<10, 512}); +``` + +The preceding code is quite repetitive, and can be replaced with the following +short-hand. The following macro will pick a few appropriate arguments in the +product of the two specified ranges and will generate a benchmark for each such +pair. + +```c++ +BENCHMARK(BM_SetInsert)->Ranges({{1<<10, 8<<10}, {128, 512}}); +``` + +For more complex patterns of inputs, passing a custom function to `Apply` allows +programmatic specification of an arbitrary set of arguments on which to run the +benchmark. The following example enumerates a dense range on one parameter, +and a sparse range on the second. + +```c++ +static void CustomArguments(benchmark::internal::Benchmark* b) { + for (int i = 0; i <= 10; ++i) + for (int j = 32; j <= 1024*1024; j *= 8) + b->Args({i, j}); +} +BENCHMARK(BM_SetInsert)->Apply(CustomArguments); +``` + +### Calculate asymptotic complexity (Big O) +Asymptotic complexity might be calculated for a family of benchmarks. The +following code will calculate the coefficient for the high-order term in the +running time and the normalized root-mean square error of string comparison. + +```c++ +static void BM_StringCompare(benchmark::State& state) { + std::string s1(state.range(0), '-'); + std::string s2(state.range(0), '-'); + for (auto _ : state) { + benchmark::DoNotOptimize(s1.compare(s2)); + } + state.SetComplexityN(state.range(0)); +} +BENCHMARK(BM_StringCompare) + ->RangeMultiplier(2)->Range(1<<10, 1<<18)->Complexity(benchmark::oN); +``` + +As shown in the following invocation, asymptotic complexity might also be +calculated automatically. + +```c++ +BENCHMARK(BM_StringCompare) + ->RangeMultiplier(2)->Range(1<<10, 1<<18)->Complexity(); +``` + +The following code will specify asymptotic complexity with a lambda function, +that might be used to customize high-order term calculation. + +```c++ +BENCHMARK(BM_StringCompare)->RangeMultiplier(2) + ->Range(1<<10, 1<<18)->Complexity([](int n)->double{return n; }); +``` + +### Templated benchmarks +Templated benchmarks work the same way: This example produces and consumes +messages of size `sizeof(v)` `range_x` times. It also outputs throughput in the +absence of multiprogramming. + +```c++ +template int BM_Sequential(benchmark::State& state) { + Q q; + typename Q::value_type v; + for (auto _ : state) { + for (int i = state.range(0); i--; ) + q.push(v); + for (int e = state.range(0); e--; ) + q.Wait(&v); + } + // actually messages, not bytes: + state.SetBytesProcessed( + static_cast(state.iterations())*state.range(0)); +} +BENCHMARK_TEMPLATE(BM_Sequential, WaitQueue)->Range(1<<0, 1<<10); +``` + +Three macros are provided for adding benchmark templates. + +```c++ +#ifdef BENCHMARK_HAS_CXX11 +#define BENCHMARK_TEMPLATE(func, ...) // Takes any number of parameters. +#else // C++ < C++11 +#define BENCHMARK_TEMPLATE(func, arg1) +#endif +#define BENCHMARK_TEMPLATE1(func, arg1) +#define BENCHMARK_TEMPLATE2(func, arg1, arg2) +``` + +### A Faster KeepRunning loop + +In C++11 mode, a ranged-based for loop should be used in preference to +the `KeepRunning` loop for running the benchmarks. For example: + +```c++ +static void BM_Fast(benchmark::State &state) { + for (auto _ : state) { + FastOperation(); + } +} +BENCHMARK(BM_Fast); +``` + +The reason the ranged-for loop is faster than using `KeepRunning`, is +because `KeepRunning` requires a memory load and store of the iteration count +ever iteration, whereas the ranged-for variant is able to keep the iteration count +in a register. + +For example, an empty inner loop of using the ranged-based for method looks like: + +```asm +# Loop Init + mov rbx, qword ptr [r14 + 104] + call benchmark::State::StartKeepRunning() + test rbx, rbx + je .LoopEnd +.LoopHeader: # =>This Inner Loop Header: Depth=1 + add rbx, -1 + jne .LoopHeader +.LoopEnd: +``` + +Compared to an empty `KeepRunning` loop, which looks like: + +```asm +.LoopHeader: # in Loop: Header=BB0_3 Depth=1 + cmp byte ptr [rbx], 1 + jne .LoopInit +.LoopBody: # =>This Inner Loop Header: Depth=1 + mov rax, qword ptr [rbx + 8] + lea rcx, [rax + 1] + mov qword ptr [rbx + 8], rcx + cmp rax, qword ptr [rbx + 104] + jb .LoopHeader + jmp .LoopEnd +.LoopInit: + mov rdi, rbx + call benchmark::State::StartKeepRunning() + jmp .LoopBody +.LoopEnd: +``` + +Unless C++03 compatibility is required, the ranged-for variant of writing +the benchmark loop should be preferred. + +## Passing arbitrary arguments to a benchmark +In C++11 it is possible to define a benchmark that takes an arbitrary number +of extra arguments. The `BENCHMARK_CAPTURE(func, test_case_name, ...args)` +macro creates a benchmark that invokes `func` with the `benchmark::State` as +the first argument followed by the specified `args...`. +The `test_case_name` is appended to the name of the benchmark and +should describe the values passed. + +```c++ +template +void BM_takes_args(benchmark::State& state, ExtraArgs&&... extra_args) { + [...] +} +// Registers a benchmark named "BM_takes_args/int_string_test" that passes +// the specified values to `extra_args`. +BENCHMARK_CAPTURE(BM_takes_args, int_string_test, 42, std::string("abc")); +``` +Note that elements of `...args` may refer to global variables. Users should +avoid modifying global state inside of a benchmark. + +## Using RegisterBenchmark(name, fn, args...) + +The `RegisterBenchmark(name, func, args...)` function provides an alternative +way to create and register benchmarks. +`RegisterBenchmark(name, func, args...)` creates, registers, and returns a +pointer to a new benchmark with the specified `name` that invokes +`func(st, args...)` where `st` is a `benchmark::State` object. + +Unlike the `BENCHMARK` registration macros, which can only be used at the global +scope, the `RegisterBenchmark` can be called anywhere. This allows for +benchmark tests to be registered programmatically. + +Additionally `RegisterBenchmark` allows any callable object to be registered +as a benchmark. Including capturing lambdas and function objects. + +For Example: +```c++ +auto BM_test = [](benchmark::State& st, auto Inputs) { /* ... */ }; + +int main(int argc, char** argv) { + for (auto& test_input : { /* ... */ }) + benchmark::RegisterBenchmark(test_input.name(), BM_test, test_input); + benchmark::Initialize(&argc, argv); + benchmark::RunSpecifiedBenchmarks(); +} +``` + +### Multithreaded benchmarks +In a multithreaded test (benchmark invoked by multiple threads simultaneously), +it is guaranteed that none of the threads will start until all have reached +the start of the benchmark loop, and all will have finished before any thread +exits the benchmark loop. (This behavior is also provided by the `KeepRunning()` +API) As such, any global setup or teardown can be wrapped in a check against the thread +index: + +```c++ +static void BM_MultiThreaded(benchmark::State& state) { + if (state.thread_index == 0) { + // Setup code here. + } + for (auto _ : state) { + // Run the test as normal. + } + if (state.thread_index == 0) { + // Teardown code here. + } +} +BENCHMARK(BM_MultiThreaded)->Threads(2); +``` + +If the benchmarked code itself uses threads and you want to compare it to +single-threaded code, you may want to use real-time ("wallclock") measurements +for latency comparisons: + +```c++ +BENCHMARK(BM_test)->Range(8, 8<<10)->UseRealTime(); +``` + +Without `UseRealTime`, CPU time is used by default. + + +## Manual timing +For benchmarking something for which neither CPU time nor real-time are +correct or accurate enough, completely manual timing is supported using +the `UseManualTime` function. + +When `UseManualTime` is used, the benchmarked code must call +`SetIterationTime` once per iteration of the benchmark loop to +report the manually measured time. + +An example use case for this is benchmarking GPU execution (e.g. OpenCL +or CUDA kernels, OpenGL or Vulkan or Direct3D draw calls), which cannot +be accurately measured using CPU time or real-time. Instead, they can be +measured accurately using a dedicated API, and these measurement results +can be reported back with `SetIterationTime`. + +```c++ +static void BM_ManualTiming(benchmark::State& state) { + int microseconds = state.range(0); + std::chrono::duration sleep_duration { + static_cast(microseconds) + }; + + for (auto _ : state) { + auto start = std::chrono::high_resolution_clock::now(); + // Simulate some useful workload with a sleep + std::this_thread::sleep_for(sleep_duration); + auto end = std::chrono::high_resolution_clock::now(); + + auto elapsed_seconds = + std::chrono::duration_cast>( + end - start); + + state.SetIterationTime(elapsed_seconds.count()); + } +} +BENCHMARK(BM_ManualTiming)->Range(1, 1<<17)->UseManualTime(); +``` + +### Preventing optimisation +To prevent a value or expression from being optimized away by the compiler +the `benchmark::DoNotOptimize(...)` and `benchmark::ClobberMemory()` +functions can be used. + +```c++ +static void BM_test(benchmark::State& state) { + for (auto _ : state) { + int x = 0; + for (int i=0; i < 64; ++i) { + benchmark::DoNotOptimize(x += i); + } + } +} +``` + +`DoNotOptimize()` forces the *result* of `` to be stored in either +memory or a register. For GNU based compilers it acts as read/write barrier +for global memory. More specifically it forces the compiler to flush pending +writes to memory and reload any other values as necessary. + +Note that `DoNotOptimize()` does not prevent optimizations on `` +in any way. `` may even be removed entirely when the result is already +known. For example: + +```c++ + /* Example 1: `` is removed entirely. */ + int foo(int x) { return x + 42; } + while (...) DoNotOptimize(foo(0)); // Optimized to DoNotOptimize(42); + + /* Example 2: Result of '' is only reused */ + int bar(int) __attribute__((const)); + while (...) DoNotOptimize(bar(0)); // Optimized to: + // int __result__ = bar(0); + // while (...) DoNotOptimize(__result__); +``` + +The second tool for preventing optimizations is `ClobberMemory()`. In essence +`ClobberMemory()` forces the compiler to perform all pending writes to global +memory. Memory managed by block scope objects must be "escaped" using +`DoNotOptimize(...)` before it can be clobbered. In the below example +`ClobberMemory()` prevents the call to `v.push_back(42)` from being optimized +away. + +```c++ +static void BM_vector_push_back(benchmark::State& state) { + for (auto _ : state) { + std::vector v; + v.reserve(1); + benchmark::DoNotOptimize(v.data()); // Allow v.data() to be clobbered. + v.push_back(42); + benchmark::ClobberMemory(); // Force 42 to be written to memory. + } +} +``` + +Note that `ClobberMemory()` is only available for GNU or MSVC based compilers. + +### Set time unit manually +If a benchmark runs a few milliseconds it may be hard to visually compare the +measured times, since the output data is given in nanoseconds per default. In +order to manually set the time unit, you can specify it manually: + +```c++ +BENCHMARK(BM_test)->Unit(benchmark::kMillisecond); +``` + +## Controlling number of iterations +In all cases, the number of iterations for which the benchmark is run is +governed by the amount of time the benchmark takes. Concretely, the number of +iterations is at least one, not more than 1e9, until CPU time is greater than +the minimum time, or the wallclock time is 5x minimum time. The minimum time is +set as a flag `--benchmark_min_time` or per benchmark by calling `MinTime` on +the registered benchmark object. + +## Reporting the mean, median and standard deviation by repeated benchmarks +By default each benchmark is run once and that single result is reported. +However benchmarks are often noisy and a single result may not be representative +of the overall behavior. For this reason it's possible to repeatedly rerun the +benchmark. + +The number of runs of each benchmark is specified globally by the +`--benchmark_repetitions` flag or on a per benchmark basis by calling +`Repetitions` on the registered benchmark object. When a benchmark is run more +than once the mean, median and standard deviation of the runs will be reported. + +Additionally the `--benchmark_report_aggregates_only={true|false}` flag or +`ReportAggregatesOnly(bool)` function can be used to change how repeated tests +are reported. By default the result of each repeated run is reported. When this +option is `true` only the mean, median and standard deviation of the runs is reported. +Calling `ReportAggregatesOnly(bool)` on a registered benchmark object overrides +the value of the flag for that benchmark. + +## User-defined statistics for repeated benchmarks +While having mean, median and standard deviation is nice, this may not be +enough for everyone. For example you may want to know what is the largest +observation, e.g. because you have some real-time constraints. This is easy. +The following code will specify a custom statistic to be calculated, defined +by a lambda function. + +```c++ +void BM_spin_empty(benchmark::State& state) { + for (auto _ : state) { + for (int x = 0; x < state.range(0); ++x) { + benchmark::DoNotOptimize(x); + } + } +} + +BENCHMARK(BM_spin_empty) + ->ComputeStatistics("max", [](const std::vector& v) -> double { + return *(std::max_element(std::begin(v), std::end(v))); + }) + ->Arg(512); +``` + +## Fixtures +Fixture tests are created by +first defining a type that derives from `::benchmark::Fixture` and then +creating/registering the tests using the following macros: + +* `BENCHMARK_F(ClassName, Method)` +* `BENCHMARK_DEFINE_F(ClassName, Method)` +* `BENCHMARK_REGISTER_F(ClassName, Method)` + +For Example: + +```c++ +class MyFixture : public benchmark::Fixture {}; + +BENCHMARK_F(MyFixture, FooTest)(benchmark::State& st) { + for (auto _ : st) { + ... + } +} + +BENCHMARK_DEFINE_F(MyFixture, BarTest)(benchmark::State& st) { + for (auto _ : st) { + ... + } +} +/* BarTest is NOT registered */ +BENCHMARK_REGISTER_F(MyFixture, BarTest)->Threads(2); +/* BarTest is now registered */ +``` + +### Templated fixtures +Also you can create templated fixture by using the following macros: + +* `BENCHMARK_TEMPLATE_F(ClassName, Method, ...)` +* `BENCHMARK_TEMPLATE_DEFINE_F(ClassName, Method, ...)` + +For example: +```c++ +template +class MyFixture : public benchmark::Fixture {}; + +BENCHMARK_TEMPLATE_F(MyFixture, IntTest, int)(benchmark::State& st) { + for (auto _ : st) { + ... + } +} + +BENCHMARK_TEMPLATE_DEFINE_F(MyFixture, DoubleTest, double)(benchmark::State& st) { + for (auto _ : st) { + ... + } +} + +BENCHMARK_REGISTER_F(MyFixture, DoubleTest)->Threads(2); +``` + +## User-defined counters + +You can add your own counters with user-defined names. The example below +will add columns "Foo", "Bar" and "Baz" in its output: + +```c++ +static void UserCountersExample1(benchmark::State& state) { + double numFoos = 0, numBars = 0, numBazs = 0; + for (auto _ : state) { + // ... count Foo,Bar,Baz events + } + state.counters["Foo"] = numFoos; + state.counters["Bar"] = numBars; + state.counters["Baz"] = numBazs; +} +``` + +The `state.counters` object is a `std::map` with `std::string` keys +and `Counter` values. The latter is a `double`-like class, via an implicit +conversion to `double&`. Thus you can use all of the standard arithmetic +assignment operators (`=,+=,-=,*=,/=`) to change the value of each counter. + +In multithreaded benchmarks, each counter is set on the calling thread only. +When the benchmark finishes, the counters from each thread will be summed; +the resulting sum is the value which will be shown for the benchmark. + +The `Counter` constructor accepts two parameters: the value as a `double` +and a bit flag which allows you to show counters as rates and/or as +per-thread averages: + +```c++ + // sets a simple counter + state.counters["Foo"] = numFoos; + + // Set the counter as a rate. It will be presented divided + // by the duration of the benchmark. + state.counters["FooRate"] = Counter(numFoos, benchmark::Counter::kIsRate); + + // Set the counter as a thread-average quantity. It will + // be presented divided by the number of threads. + state.counters["FooAvg"] = Counter(numFoos, benchmark::Counter::kAvgThreads); + + // There's also a combined flag: + state.counters["FooAvgRate"] = Counter(numFoos,benchmark::Counter::kAvgThreadsRate); +``` + +When you're compiling in C++11 mode or later you can use `insert()` with +`std::initializer_list`: + +```c++ + // With C++11, this can be done: + state.counters.insert({{"Foo", numFoos}, {"Bar", numBars}, {"Baz", numBazs}}); + // ... instead of: + state.counters["Foo"] = numFoos; + state.counters["Bar"] = numBars; + state.counters["Baz"] = numBazs; +``` + +### Counter reporting + +When using the console reporter, by default, user counters are are printed at +the end after the table, the same way as ``bytes_processed`` and +``items_processed``. This is best for cases in which there are few counters, +or where there are only a couple of lines per benchmark. Here's an example of +the default output: + +``` +------------------------------------------------------------------------------ +Benchmark Time CPU Iterations UserCounters... +------------------------------------------------------------------------------ +BM_UserCounter/threads:8 2248 ns 10277 ns 68808 Bar=16 Bat=40 Baz=24 Foo=8 +BM_UserCounter/threads:1 9797 ns 9788 ns 71523 Bar=2 Bat=5 Baz=3 Foo=1024m +BM_UserCounter/threads:2 4924 ns 9842 ns 71036 Bar=4 Bat=10 Baz=6 Foo=2 +BM_UserCounter/threads:4 2589 ns 10284 ns 68012 Bar=8 Bat=20 Baz=12 Foo=4 +BM_UserCounter/threads:8 2212 ns 10287 ns 68040 Bar=16 Bat=40 Baz=24 Foo=8 +BM_UserCounter/threads:16 1782 ns 10278 ns 68144 Bar=32 Bat=80 Baz=48 Foo=16 +BM_UserCounter/threads:32 1291 ns 10296 ns 68256 Bar=64 Bat=160 Baz=96 Foo=32 +BM_UserCounter/threads:4 2615 ns 10307 ns 68040 Bar=8 Bat=20 Baz=12 Foo=4 +BM_Factorial 26 ns 26 ns 26608979 40320 +BM_Factorial/real_time 26 ns 26 ns 26587936 40320 +BM_CalculatePiRange/1 16 ns 16 ns 45704255 0 +BM_CalculatePiRange/8 73 ns 73 ns 9520927 3.28374 +BM_CalculatePiRange/64 609 ns 609 ns 1140647 3.15746 +BM_CalculatePiRange/512 4900 ns 4901 ns 142696 3.14355 +``` + +If this doesn't suit you, you can print each counter as a table column by +passing the flag `--benchmark_counters_tabular=true` to the benchmark +application. This is best for cases in which there are a lot of counters, or +a lot of lines per individual benchmark. Note that this will trigger a +reprinting of the table header any time the counter set changes between +individual benchmarks. Here's an example of corresponding output when +`--benchmark_counters_tabular=true` is passed: + +``` +--------------------------------------------------------------------------------------- +Benchmark Time CPU Iterations Bar Bat Baz Foo +--------------------------------------------------------------------------------------- +BM_UserCounter/threads:8 2198 ns 9953 ns 70688 16 40 24 8 +BM_UserCounter/threads:1 9504 ns 9504 ns 73787 2 5 3 1 +BM_UserCounter/threads:2 4775 ns 9550 ns 72606 4 10 6 2 +BM_UserCounter/threads:4 2508 ns 9951 ns 70332 8 20 12 4 +BM_UserCounter/threads:8 2055 ns 9933 ns 70344 16 40 24 8 +BM_UserCounter/threads:16 1610 ns 9946 ns 70720 32 80 48 16 +BM_UserCounter/threads:32 1192 ns 9948 ns 70496 64 160 96 32 +BM_UserCounter/threads:4 2506 ns 9949 ns 70332 8 20 12 4 +-------------------------------------------------------------- +Benchmark Time CPU Iterations +-------------------------------------------------------------- +BM_Factorial 26 ns 26 ns 26392245 40320 +BM_Factorial/real_time 26 ns 26 ns 26494107 40320 +BM_CalculatePiRange/1 15 ns 15 ns 45571597 0 +BM_CalculatePiRange/8 74 ns 74 ns 9450212 3.28374 +BM_CalculatePiRange/64 595 ns 595 ns 1173901 3.15746 +BM_CalculatePiRange/512 4752 ns 4752 ns 147380 3.14355 +BM_CalculatePiRange/4k 37970 ns 37972 ns 18453 3.14184 +BM_CalculatePiRange/32k 303733 ns 303744 ns 2305 3.14162 +BM_CalculatePiRange/256k 2434095 ns 2434186 ns 288 3.1416 +BM_CalculatePiRange/1024k 9721140 ns 9721413 ns 71 3.14159 +BM_CalculatePi/threads:8 2255 ns 9943 ns 70936 +``` +Note above the additional header printed when the benchmark changes from +``BM_UserCounter`` to ``BM_Factorial``. This is because ``BM_Factorial`` does +not have the same counter set as ``BM_UserCounter``. + +## Exiting Benchmarks in Error + +When errors caused by external influences, such as file I/O and network +communication, occur within a benchmark the +`State::SkipWithError(const char* msg)` function can be used to skip that run +of benchmark and report the error. Note that only future iterations of the +`KeepRunning()` are skipped. For the ranged-for version of the benchmark loop +Users must explicitly exit the loop, otherwise all iterations will be performed. +Users may explicitly return to exit the benchmark immediately. + +The `SkipWithError(...)` function may be used at any point within the benchmark, +including before and after the benchmark loop. + +For example: + +```c++ +static void BM_test(benchmark::State& state) { + auto resource = GetResource(); + if (!resource.good()) { + state.SkipWithError("Resource is not good!"); + // KeepRunning() loop will not be entered. + } + for (state.KeepRunning()) { + auto data = resource.read_data(); + if (!resource.good()) { + state.SkipWithError("Failed to read data!"); + break; // Needed to skip the rest of the iteration. + } + do_stuff(data); + } +} + +static void BM_test_ranged_fo(benchmark::State & state) { + state.SkipWithError("test will not be entered"); + for (auto _ : state) { + state.SkipWithError("Failed!"); + break; // REQUIRED to prevent all further iterations. + } +} +``` + +## Running a subset of the benchmarks + +The `--benchmark_filter=` option can be used to only run the benchmarks +which match the specified ``. For example: + +```bash +$ ./run_benchmarks.x --benchmark_filter=BM_memcpy/32 +Run on (1 X 2300 MHz CPU ) +2016-06-25 19:34:24 +Benchmark Time CPU Iterations +---------------------------------------------------- +BM_memcpy/32 11 ns 11 ns 79545455 +BM_memcpy/32k 2181 ns 2185 ns 324074 +BM_memcpy/32 12 ns 12 ns 54687500 +BM_memcpy/32k 1834 ns 1837 ns 357143 +``` + + +## Output Formats +The library supports multiple output formats. Use the +`--benchmark_format=` flag to set the format type. `console` +is the default format. + +The Console format is intended to be a human readable format. By default +the format generates color output. Context is output on stderr and the +tabular data on stdout. Example tabular output looks like: +``` +Benchmark Time(ns) CPU(ns) Iterations +---------------------------------------------------------------------- +BM_SetInsert/1024/1 28928 29349 23853 133.097kB/s 33.2742k items/s +BM_SetInsert/1024/8 32065 32913 21375 949.487kB/s 237.372k items/s +BM_SetInsert/1024/10 33157 33648 21431 1.13369MB/s 290.225k items/s +``` + +The JSON format outputs human readable json split into two top level attributes. +The `context` attribute contains information about the run in general, including +information about the CPU and the date. +The `benchmarks` attribute contains a list of every benchmark run. Example json +output looks like: +```json +{ + "context": { + "date": "2015/03/17-18:40:25", + "num_cpus": 40, + "mhz_per_cpu": 2801, + "cpu_scaling_enabled": false, + "build_type": "debug" + }, + "benchmarks": [ + { + "name": "BM_SetInsert/1024/1", + "iterations": 94877, + "real_time": 29275, + "cpu_time": 29836, + "bytes_per_second": 134066, + "items_per_second": 33516 + }, + { + "name": "BM_SetInsert/1024/8", + "iterations": 21609, + "real_time": 32317, + "cpu_time": 32429, + "bytes_per_second": 986770, + "items_per_second": 246693 + }, + { + "name": "BM_SetInsert/1024/10", + "iterations": 21393, + "real_time": 32724, + "cpu_time": 33355, + "bytes_per_second": 1199226, + "items_per_second": 299807 + } + ] +} +``` + +The CSV format outputs comma-separated values. The `context` is output on stderr +and the CSV itself on stdout. Example CSV output looks like: +``` +name,iterations,real_time,cpu_time,bytes_per_second,items_per_second,label +"BM_SetInsert/1024/1",65465,17890.7,8407.45,475768,118942, +"BM_SetInsert/1024/8",116606,18810.1,9766.64,3.27646e+06,819115, +"BM_SetInsert/1024/10",106365,17238.4,8421.53,4.74973e+06,1.18743e+06, +``` + +## Output Files +The library supports writing the output of the benchmark to a file specified +by `--benchmark_out=`. The format of the output can be specified +using `--benchmark_out_format={json|console|csv}`. Specifying +`--benchmark_out` does not suppress the console output. + +## Debug vs Release +By default, benchmark builds as a debug library. You will see a warning in the output when this is the case. To build it as a release library instead, use: + +``` +cmake -DCMAKE_BUILD_TYPE=Release +``` + +To enable link-time optimisation, use + +``` +cmake -DCMAKE_BUILD_TYPE=Release -DBENCHMARK_ENABLE_LTO=true +``` + +If you are using gcc, you might need to set `GCC_AR` and `GCC_RANLIB` cmake cache variables, if autodetection fails. +If you are using clang, you may need to set `LLVMAR_EXECUTABLE`, `LLVMNM_EXECUTABLE` and `LLVMRANLIB_EXECUTABLE` cmake cache variables. + +## Linking against the library + +When the library is built using GCC it is necessary to link with `-pthread`, +due to how GCC implements `std::thread`. + +For GCC 4.x failing to link to pthreads will lead to runtime exceptions, not linker errors. +See [issue #67](https://github.com/google/benchmark/issues/67) for more details. + +## Compiler Support + +Google Benchmark uses C++11 when building the library. As such we require +a modern C++ toolchain, both compiler and standard library. + +The following minimum versions are strongly recommended build the library: + +* GCC 4.8 +* Clang 3.4 +* Visual Studio 2013 +* Intel 2015 Update 1 + +Anything older *may* work. + +Note: Using the library and its headers in C++03 is supported. C++11 is only +required to build the library. + +## Disable CPU frequency scaling +If you see this error: +``` +***WARNING*** CPU scaling is enabled, the benchmark real time measurements may be noisy and will incur extra overhead. +``` +you might want to disable the CPU frequency scaling while running the benchmark: +```bash +sudo cpupower frequency-set --governor performance +./mybench +sudo cpupower frequency-set --governor powersave +``` + +# Known Issues + +### Windows with CMake + +* Users must manually link `shlwapi.lib`. Failure to do so may result +in unresolved symbols. + +### Solaris + +* Users must explicitly link with kstat library (-lkstat compilation flag). diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/WORKSPACE b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/WORKSPACE new file mode 100755 index 00000000000..54734f1ea55 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/WORKSPACE @@ -0,0 +1,7 @@ +workspace(name = "com_github_google_benchmark") + +http_archive( + name = "com_google_googletest", + urls = ["https://github.com/google/googletest/archive/3f0cf6b62ad1eb50d8736538363d3580dd640c3e.zip"], + strip_prefix = "googletest-3f0cf6b62ad1eb50d8736538363d3580dd640c3e", +) diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/appveyor.yml b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/appveyor.yml new file mode 100755 index 00000000000..e99c6e77f00 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/appveyor.yml @@ -0,0 +1,56 @@ +version: '{build}' + +image: Visual Studio 2017 + +configuration: + - Debug + - Release + +environment: + matrix: + - compiler: msvc-15-seh + generator: "Visual Studio 15 2017" + + - compiler: msvc-15-seh + generator: "Visual Studio 15 2017 Win64" + + - compiler: msvc-14-seh + generator: "Visual Studio 14 2015" + + - compiler: msvc-14-seh + generator: "Visual Studio 14 2015 Win64" + + - compiler: msvc-12-seh + generator: "Visual Studio 12 2013" + + - compiler: msvc-12-seh + generator: "Visual Studio 12 2013 Win64" + + - compiler: gcc-5.3.0-posix + generator: "MinGW Makefiles" + cxx_path: 'C:\mingw-w64\i686-5.3.0-posix-dwarf-rt_v4-rev0\mingw32\bin' + APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015 + +matrix: + fast_finish: true + +install: + # git bash conflicts with MinGW makefiles + - if "%generator%"=="MinGW Makefiles" (set "PATH=%PATH:C:\Program Files\Git\usr\bin;=%") + - if not "%cxx_path%"=="" (set "PATH=%PATH%;%cxx_path%") + +build_script: + - md _build -Force + - cd _build + - echo %configuration% + - cmake -G "%generator%" "-DCMAKE_BUILD_TYPE=%configuration%" -DBENCHMARK_DOWNLOAD_DEPENDENCIES=ON .. + - cmake --build . --config %configuration% + +test_script: + - ctest -c %configuration% --timeout 300 --output-on-failure + +artifacts: + - path: '_build/CMakeFiles/*.log' + name: logs + - path: '_build/Testing/**/*.xml' + name: test_results diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/AddCXXCompilerFlag.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/AddCXXCompilerFlag.cmake new file mode 100755 index 00000000000..d0d20998144 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/AddCXXCompilerFlag.cmake @@ -0,0 +1,74 @@ +# - Adds a compiler flag if it is supported by the compiler +# +# This function checks that the supplied compiler flag is supported and then +# adds it to the corresponding compiler flags +# +# add_cxx_compiler_flag( []) +# +# - Example +# +# include(AddCXXCompilerFlag) +# add_cxx_compiler_flag(-Wall) +# add_cxx_compiler_flag(-no-strict-aliasing RELEASE) +# Requires CMake 2.6+ + +if(__add_cxx_compiler_flag) + return() +endif() +set(__add_cxx_compiler_flag INCLUDED) + +include(CheckCXXCompilerFlag) + +function(mangle_compiler_flag FLAG OUTPUT) + string(TOUPPER "HAVE_CXX_FLAG_${FLAG}" SANITIZED_FLAG) + string(REPLACE "+" "X" SANITIZED_FLAG ${SANITIZED_FLAG}) + string(REGEX REPLACE "[^A-Za-z_0-9]" "_" SANITIZED_FLAG ${SANITIZED_FLAG}) + string(REGEX REPLACE "_+" "_" SANITIZED_FLAG ${SANITIZED_FLAG}) + set(${OUTPUT} "${SANITIZED_FLAG}" PARENT_SCOPE) +endfunction(mangle_compiler_flag) + +function(add_cxx_compiler_flag FLAG) + mangle_compiler_flag("${FLAG}" MANGLED_FLAG) + set(OLD_CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS}") + set(CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS} ${FLAG}") + check_cxx_compiler_flag("${FLAG}" ${MANGLED_FLAG}) + set(CMAKE_REQUIRED_FLAGS "${OLD_CMAKE_REQUIRED_FLAGS}") + if(${MANGLED_FLAG}) + set(VARIANT ${ARGV1}) + if(ARGV1) + string(TOUPPER "_${VARIANT}" VARIANT) + endif() + set(CMAKE_CXX_FLAGS${VARIANT} "${CMAKE_CXX_FLAGS${VARIANT}} ${BENCHMARK_CXX_FLAGS${VARIANT}} ${FLAG}" PARENT_SCOPE) + endif() +endfunction() + +function(add_required_cxx_compiler_flag FLAG) + mangle_compiler_flag("${FLAG}" MANGLED_FLAG) + set(OLD_CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS}") + set(CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS} ${FLAG}") + check_cxx_compiler_flag("${FLAG}" ${MANGLED_FLAG}) + set(CMAKE_REQUIRED_FLAGS "${OLD_CMAKE_REQUIRED_FLAGS}") + if(${MANGLED_FLAG}) + set(VARIANT ${ARGV1}) + if(ARGV1) + string(TOUPPER "_${VARIANT}" VARIANT) + endif() + set(CMAKE_CXX_FLAGS${VARIANT} "${CMAKE_CXX_FLAGS${VARIANT}} ${FLAG}" PARENT_SCOPE) + set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} ${FLAG}" PARENT_SCOPE) + set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} ${FLAG}" PARENT_SCOPE) + set(CMAKE_MODULE_LINKER_FLAGS "${CMAKE_MODULE_LINKER_FLAGS} ${FLAG}" PARENT_SCOPE) + set(CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS} ${FLAG}" PARENT_SCOPE) + else() + message(FATAL_ERROR "Required flag '${FLAG}' is not supported by the compiler") + endif() +endfunction() + +function(check_cxx_warning_flag FLAG) + mangle_compiler_flag("${FLAG}" MANGLED_FLAG) + set(OLD_CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS}") + # Add -Werror to ensure the compiler generates an error if the warning flag + # doesn't exist. + set(CMAKE_REQUIRED_FLAGS "${CMAKE_REQUIRED_FLAGS} -Werror ${FLAG}") + check_cxx_compiler_flag("${FLAG}" ${MANGLED_FLAG}) + set(CMAKE_REQUIRED_FLAGS "${OLD_CMAKE_REQUIRED_FLAGS}") +endfunction() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/CXXFeatureCheck.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/CXXFeatureCheck.cmake new file mode 100755 index 00000000000..c4c4d660f1e --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/CXXFeatureCheck.cmake @@ -0,0 +1,64 @@ +# - Compile and run code to check for C++ features +# +# This functions compiles a source file under the `cmake` folder +# and adds the corresponding `HAVE_[FILENAME]` flag to the CMake +# environment +# +# cxx_feature_check( []) +# +# - Example +# +# include(CXXFeatureCheck) +# cxx_feature_check(STD_REGEX) +# Requires CMake 2.8.12+ + +if(__cxx_feature_check) + return() +endif() +set(__cxx_feature_check INCLUDED) + +function(cxx_feature_check FILE) + string(TOLOWER ${FILE} FILE) + string(TOUPPER ${FILE} VAR) + string(TOUPPER "HAVE_${VAR}" FEATURE) + if (DEFINED HAVE_${VAR}) + set(HAVE_${VAR} 1 PARENT_SCOPE) + add_definitions(-DHAVE_${VAR}) + return() + endif() + + if (NOT DEFINED COMPILE_${FEATURE}) + message("-- Performing Test ${FEATURE}") + if(CMAKE_CROSSCOMPILING) + try_compile(COMPILE_${FEATURE} + ${CMAKE_BINARY_DIR} ${CMAKE_CURRENT_SOURCE_DIR}/cmake/${FILE}.cpp + CMAKE_FLAGS ${BENCHMARK_CXX_LINKER_FLAGS} + LINK_LIBRARIES ${BENCHMARK_CXX_LIBRARIES}) + if(COMPILE_${FEATURE}) + message(WARNING + "If you see build failures due to cross compilation, try setting HAVE_${VAR} to 0") + set(RUN_${FEATURE} 0) + else() + set(RUN_${FEATURE} 1) + endif() + else() + message("-- Performing Test ${FEATURE}") + try_run(RUN_${FEATURE} COMPILE_${FEATURE} + ${CMAKE_BINARY_DIR} ${CMAKE_CURRENT_SOURCE_DIR}/cmake/${FILE}.cpp + CMAKE_FLAGS ${BENCHMARK_CXX_LINKER_FLAGS} + LINK_LIBRARIES ${BENCHMARK_CXX_LIBRARIES}) + endif() + endif() + + if(RUN_${FEATURE} EQUAL 0) + message("-- Performing Test ${FEATURE} -- success") + set(HAVE_${VAR} 1 PARENT_SCOPE) + add_definitions(-DHAVE_${VAR}) + else() + if(NOT COMPILE_${FEATURE}) + message("-- Performing Test ${FEATURE} -- failed to compile") + else() + message("-- Performing Test ${FEATURE} -- compiled but failed to run") + endif() + endif() +endfunction() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Config.cmake.in b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Config.cmake.in new file mode 100755 index 00000000000..6e9256eea8a --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Config.cmake.in @@ -0,0 +1 @@ +include("${CMAKE_CURRENT_LIST_DIR}/@targets_export_name@.cmake") diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/GetGitVersion.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/GetGitVersion.cmake new file mode 100755 index 00000000000..88cebe3a1ca --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/GetGitVersion.cmake @@ -0,0 +1,54 @@ +# - Returns a version string from Git tags +# +# This function inspects the annotated git tags for the project and returns a string +# into a CMake variable +# +# get_git_version() +# +# - Example +# +# include(GetGitVersion) +# get_git_version(GIT_VERSION) +# +# Requires CMake 2.8.11+ +find_package(Git) + +if(__get_git_version) + return() +endif() +set(__get_git_version INCLUDED) + +function(get_git_version var) + if(GIT_EXECUTABLE) + execute_process(COMMAND ${GIT_EXECUTABLE} describe --match "v[0-9]*.[0-9]*.[0-9]*" --abbrev=8 + WORKING_DIRECTORY ${PROJECT_SOURCE_DIR} + RESULT_VARIABLE status + OUTPUT_VARIABLE GIT_VERSION + ERROR_QUIET) + if(${status}) + set(GIT_VERSION "v0.0.0") + else() + string(STRIP ${GIT_VERSION} GIT_VERSION) + string(REGEX REPLACE "-[0-9]+-g" "-" GIT_VERSION ${GIT_VERSION}) + endif() + + # Work out if the repository is dirty + execute_process(COMMAND ${GIT_EXECUTABLE} update-index -q --refresh + WORKING_DIRECTORY ${PROJECT_SOURCE_DIR} + OUTPUT_QUIET + ERROR_QUIET) + execute_process(COMMAND ${GIT_EXECUTABLE} diff-index --name-only HEAD -- + WORKING_DIRECTORY ${PROJECT_SOURCE_DIR} + OUTPUT_VARIABLE GIT_DIFF_INDEX + ERROR_QUIET) + string(COMPARE NOTEQUAL "${GIT_DIFF_INDEX}" "" GIT_DIRTY) + if (${GIT_DIRTY}) + set(GIT_VERSION "${GIT_VERSION}-dirty") + endif() + else() + set(GIT_VERSION "v0.0.0") + endif() + + message("-- git Version: ${GIT_VERSION}") + set(${var} ${GIT_VERSION} PARENT_SCOPE) +endfunction() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/HandleGTest.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/HandleGTest.cmake new file mode 100755 index 00000000000..7ce1a633d65 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/HandleGTest.cmake @@ -0,0 +1,113 @@ + +include(split_list) + +macro(build_external_gtest) + include(ExternalProject) + set(GTEST_FLAGS "") + if (BENCHMARK_USE_LIBCXX) + if ("${CMAKE_CXX_COMPILER_ID}" STREQUAL "Clang") + list(APPEND GTEST_FLAGS -stdlib=libc++) + else() + message(WARNING "Unsupported compiler (${CMAKE_CXX_COMPILER}) when using libc++") + endif() + endif() + if (BENCHMARK_BUILD_32_BITS) + list(APPEND GTEST_FLAGS -m32) + endif() + if (NOT "${CMAKE_CXX_FLAGS}" STREQUAL "") + list(APPEND GTEST_FLAGS ${CMAKE_CXX_FLAGS}) + endif() + string(TOUPPER "${CMAKE_BUILD_TYPE}" GTEST_BUILD_TYPE) + if ("${GTEST_BUILD_TYPE}" STREQUAL "COVERAGE") + set(GTEST_BUILD_TYPE "DEBUG") + endif() + # FIXME: Since 10/Feb/2017 the googletest trunk has had a bug where + # -Werror=unused-function fires during the build on OS X. This is a temporary + # workaround to keep our travis bots from failing. It should be removed + # once gtest is fixed. + if (NOT "${CMAKE_CXX_COMPILER_ID}" STREQUAL "MSVC") + list(APPEND GTEST_FLAGS "-Wno-unused-function") + endif() + split_list(GTEST_FLAGS) + set(EXCLUDE_FROM_ALL_OPT "") + set(EXCLUDE_FROM_ALL_VALUE "") + if (${CMAKE_VERSION} VERSION_GREATER "3.0.99") + set(EXCLUDE_FROM_ALL_OPT "EXCLUDE_FROM_ALL") + set(EXCLUDE_FROM_ALL_VALUE "ON") + endif() + ExternalProject_Add(googletest + ${EXCLUDE_FROM_ALL_OPT} ${EXCLUDE_FROM_ALL_VALUE} + GIT_REPOSITORY https://github.com/google/googletest.git + GIT_TAG master + PREFIX "${CMAKE_BINARY_DIR}/googletest" + INSTALL_DIR "${CMAKE_BINARY_DIR}/googletest" + CMAKE_CACHE_ARGS + -DCMAKE_BUILD_TYPE:STRING=${GTEST_BUILD_TYPE} + -DCMAKE_C_COMPILER:STRING=${CMAKE_C_COMPILER} + -DCMAKE_CXX_COMPILER:STRING=${CMAKE_CXX_COMPILER} + -DCMAKE_INSTALL_PREFIX:PATH= + -DCMAKE_INSTALL_LIBDIR:PATH=/lib + -DCMAKE_CXX_FLAGS:STRING=${GTEST_FLAGS} + -Dgtest_force_shared_crt:BOOL=ON + ) + + ExternalProject_Get_Property(googletest install_dir) + set(GTEST_INCLUDE_DIRS ${install_dir}/include) + file(MAKE_DIRECTORY ${GTEST_INCLUDE_DIRS}) + + set(LIB_SUFFIX "${CMAKE_STATIC_LIBRARY_SUFFIX}") + set(LIB_PREFIX "${CMAKE_STATIC_LIBRARY_PREFIX}") + if("${GTEST_BUILD_TYPE}" STREQUAL "DEBUG") + set(LIB_SUFFIX "d${CMAKE_STATIC_LIBRARY_SUFFIX}") + endif() + + # Use gmock_main instead of gtest_main because it initializes gtest as well. + # Note: The libraries are listed in reverse order of their dependancies. + foreach(LIB gtest gmock gmock_main) + add_library(${LIB} UNKNOWN IMPORTED) + set_target_properties(${LIB} PROPERTIES + IMPORTED_LOCATION ${install_dir}/lib/${LIB_PREFIX}${LIB}${LIB_SUFFIX} + INTERFACE_INCLUDE_DIRECTORIES ${GTEST_INCLUDE_DIRS} + INTERFACE_LINK_LIBRARIES "${GTEST_BOTH_LIBRARIES}" + ) + add_dependencies(${LIB} googletest) + list(APPEND GTEST_BOTH_LIBRARIES ${LIB}) + endforeach() +endmacro(build_external_gtest) + +if (BENCHMARK_ENABLE_GTEST_TESTS) + if (IS_DIRECTORY ${CMAKE_SOURCE_DIR}/googletest) + set(GTEST_ROOT "${CMAKE_SOURCE_DIR}/googletest") + set(INSTALL_GTEST OFF CACHE INTERNAL "") + set(INSTALL_GMOCK OFF CACHE INTERNAL "") + add_subdirectory(${CMAKE_SOURCE_DIR}/googletest) + set(GTEST_BOTH_LIBRARIES gtest gmock gmock_main) + foreach(HEADER test mock) + # CMake 2.8 and older don't respect INTERFACE_INCLUDE_DIRECTORIES, so we + # have to add the paths ourselves. + set(HFILE g${HEADER}/g${HEADER}.h) + set(HPATH ${GTEST_ROOT}/google${HEADER}/include) + find_path(HEADER_PATH_${HEADER} ${HFILE} + NO_DEFAULT_PATHS + HINTS ${HPATH} + ) + if (NOT HEADER_PATH_${HEADER}) + message(FATAL_ERROR "Failed to find header ${HFILE} in ${HPATH}") + endif() + list(APPEND GTEST_INCLUDE_DIRS ${HEADER_PATH_${HEADER}}) + endforeach() + elseif(BENCHMARK_DOWNLOAD_DEPENDENCIES) + build_external_gtest() + else() + find_package(GTest REQUIRED) + find_path(GMOCK_INCLUDE_DIRS gmock/gmock.h + HINTS ${GTEST_INCLUDE_DIRS}) + if (NOT GMOCK_INCLUDE_DIRS) + message(FATAL_ERROR "Failed to find header gmock/gmock.h with hint ${GTEST_INCLUDE_DIRS}") + endif() + set(GTEST_INCLUDE_DIRS ${GTEST_INCLUDE_DIRS} ${GMOCK_INCLUDE_DIRS}) + # FIXME: We don't currently require the gmock library to build the tests, + # and it's likely we won't find it, so we don't try. As long as we've + # found the gmock/gmock.h header and gtest_main that should be good enough. + endif() +endif() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMAr.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMAr.cmake new file mode 100755 index 00000000000..23469813cfa --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMAr.cmake @@ -0,0 +1,16 @@ +include(FeatureSummary) + +find_program(LLVMAR_EXECUTABLE + NAMES llvm-ar + DOC "The llvm-ar executable" + ) + +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(LLVMAr + DEFAULT_MSG + LLVMAR_EXECUTABLE) + +SET_PACKAGE_PROPERTIES(LLVMAr PROPERTIES + URL https://llvm.org/docs/CommandGuide/llvm-ar.html + DESCRIPTION "create, modify, and extract from archives" +) diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMNm.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMNm.cmake new file mode 100755 index 00000000000..e56430a04f6 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMNm.cmake @@ -0,0 +1,16 @@ +include(FeatureSummary) + +find_program(LLVMNM_EXECUTABLE + NAMES llvm-nm + DOC "The llvm-nm executable" + ) + +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(LLVMNm + DEFAULT_MSG + LLVMNM_EXECUTABLE) + +SET_PACKAGE_PROPERTIES(LLVMNm PROPERTIES + URL https://llvm.org/docs/CommandGuide/llvm-nm.html + DESCRIPTION "list LLVM bitcode and object file’s symbol table" +) diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMRanLib.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMRanLib.cmake new file mode 100755 index 00000000000..7b53e1a7905 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/Modules/FindLLVMRanLib.cmake @@ -0,0 +1,15 @@ +include(FeatureSummary) + +find_program(LLVMRANLIB_EXECUTABLE + NAMES llvm-ranlib + DOC "The llvm-ranlib executable" + ) + +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(LLVMRanLib + DEFAULT_MSG + LLVMRANLIB_EXECUTABLE) + +SET_PACKAGE_PROPERTIES(LLVMRanLib PROPERTIES + DESCRIPTION "generate index for LLVM archive" +) diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/benchmark.pc.in b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/benchmark.pc.in new file mode 100755 index 00000000000..1e84bff68d8 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/benchmark.pc.in @@ -0,0 +1,11 @@ +prefix=@CMAKE_INSTALL_PREFIX@ +exec_prefix=${prefix} +libdir=${prefix}/lib +includedir=${prefix}/include + +Name: @PROJECT_NAME@ +Description: Google microbenchmark framework +Version: @VERSION@ + +Libs: -L${libdir} -lbenchmark +Cflags: -I${includedir} diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/gnu_posix_regex.cpp b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/gnu_posix_regex.cpp new file mode 100755 index 00000000000..b5b91cdab7c --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/gnu_posix_regex.cpp @@ -0,0 +1,12 @@ +#include +#include +int main() { + std::string str = "test0159"; + regex_t re; + int ec = regcomp(&re, "^[a-z]+[0-9]+$", REG_EXTENDED | REG_NOSUB); + if (ec != 0) { + return ec; + } + return regexec(&re, str.c_str(), 0, nullptr, 0) ? -1 : 0; +} + diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/llvm-toolchain.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/llvm-toolchain.cmake new file mode 100755 index 00000000000..fc119e52fd2 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/llvm-toolchain.cmake @@ -0,0 +1,8 @@ +find_package(LLVMAr REQUIRED) +set(CMAKE_AR "${LLVMAR_EXECUTABLE}" CACHE FILEPATH "" FORCE) + +find_package(LLVMNm REQUIRED) +set(CMAKE_NM "${LLVMNM_EXECUTABLE}" CACHE FILEPATH "" FORCE) + +find_package(LLVMRanLib REQUIRED) +set(CMAKE_RANLIB "${LLVMRANLIB_EXECUTABLE}" CACHE FILEPATH "" FORCE) diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/posix_regex.cpp b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/posix_regex.cpp new file mode 100755 index 00000000000..466dc62560a --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/posix_regex.cpp @@ -0,0 +1,14 @@ +#include +#include +int main() { + std::string str = "test0159"; + regex_t re; + int ec = regcomp(&re, "^[a-z]+[0-9]+$", REG_EXTENDED | REG_NOSUB); + if (ec != 0) { + return ec; + } + int ret = regexec(&re, str.c_str(), 0, nullptr, 0) ? -1 : 0; + regfree(&re); + return ret; +} + diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/split_list.cmake b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/split_list.cmake new file mode 100755 index 00000000000..67aed3fdc85 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/split_list.cmake @@ -0,0 +1,3 @@ +macro(split_list listname) + string(REPLACE ";" " " ${listname} "${${listname}}") +endmacro() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/std_regex.cpp b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/std_regex.cpp new file mode 100755 index 00000000000..696f2a26bce --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/std_regex.cpp @@ -0,0 +1,10 @@ +#include +#include +int main() { + const std::string str = "test0159"; + std::regex re; + re = std::regex("^[a-z]+[0-9]+$", + std::regex_constants::extended | std::regex_constants::nosubs); + return std::regex_search(str, re) ? 0 : -1; +} + diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/steady_clock.cpp b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/steady_clock.cpp new file mode 100755 index 00000000000..66d50d17e9e --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/steady_clock.cpp @@ -0,0 +1,7 @@ +#include + +int main() { + typedef std::chrono::steady_clock Clock; + Clock::time_point tp = Clock::now(); + ((void)tp); +} diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/thread_safety_attributes.cpp b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/thread_safety_attributes.cpp new file mode 100755 index 00000000000..46161babdb1 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/cmake/thread_safety_attributes.cpp @@ -0,0 +1,4 @@ +#define HAVE_THREAD_SAFETY_ATTRIBUTES +#include "../src/mutex.h" + +int main() {} diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/AssemblyTests.md b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/AssemblyTests.md new file mode 100755 index 00000000000..1fbdc269b53 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/AssemblyTests.md @@ -0,0 +1,147 @@ +# Assembly Tests + +The Benchmark library provides a number of functions whose primary +purpose in to affect assembly generation, including `DoNotOptimize` +and `ClobberMemory`. In addition there are other functions, +such as `KeepRunning`, for which generating good assembly is paramount. + +For these functions it's important to have tests that verify the +correctness and quality of the implementation. This requires testing +the code generated by the compiler. + +This document describes how the Benchmark library tests compiler output, +as well as how to properly write new tests. + + +## Anatomy of a Test + +Writing a test has two steps: + +* Write the code you want to generate assembly for. +* Add `// CHECK` lines to match against the verified assembly. + +Example: +```c++ + +// CHECK-LABEL: test_add: +extern "C" int test_add() { + extern int ExternInt; + return ExternInt + 1; + + // CHECK: movl ExternInt(%rip), %eax + // CHECK: addl %eax + // CHECK: ret +} + +``` + +#### LLVM Filecheck + +[LLVM's Filecheck](https://llvm.org/docs/CommandGuide/FileCheck.html) +is used to test the generated assembly against the `// CHECK` lines +specified in the tests source file. Please see the documentation +linked above for information on how to write `CHECK` directives. + +#### Tips and Tricks: + +* Tests should match the minimal amount of output required to establish +correctness. `CHECK` directives don't have to match on the exact next line +after the previous match, so tests should omit checks for unimportant +bits of assembly. ([`CHECK-NEXT`](https://llvm.org/docs/CommandGuide/FileCheck.html#the-check-next-directive) +can be used to ensure a match occurs exactly after the previous match). + +* The tests are compiled with `-O3 -g0`. So we're only testing the +optimized output. + +* The assembly output is further cleaned up using `tools/strip_asm.py`. +This removes comments, assembler directives, and unused labels before +the test is run. + +* The generated and stripped assembly file for a test is output under +`/test/.s` + +* Filecheck supports using [`CHECK` prefixes](https://llvm.org/docs/CommandGuide/FileCheck.html#cmdoption-check-prefixes) +to specify lines that should only match in certain situations. +The Benchmark tests use `CHECK-CLANG` and `CHECK-GNU` for lines that +are only expected to match Clang or GCC's output respectively. Normal +`CHECK` lines match against all compilers. (Note: `CHECK-NOT` and +`CHECK-LABEL` are NOT prefixes. They are versions of non-prefixed +`CHECK` lines) + +* Use `extern "C"` to disable name mangling for specific functions. This +makes them easier to name in the `CHECK` lines. + + +## Problems Writing Portable Tests + +Writing tests which check the code generated by a compiler are +inherently non-portable. Different compilers and even different compiler +versions may generate entirely different code. The Benchmark tests +must tolerate this. + +LLVM Filecheck provides a number of mechanisms to help write +"more portable" tests; including [matching using regular expressions](https://llvm.org/docs/CommandGuide/FileCheck.html#filecheck-pattern-matching-syntax), +allowing the creation of [named variables](https://llvm.org/docs/CommandGuide/FileCheck.html#filecheck-variables) +for later matching, and [checking non-sequential matches](https://llvm.org/docs/CommandGuide/FileCheck.html#the-check-dag-directive). + +#### Capturing Variables + +For example, say GCC stores a variable in a register but Clang stores +it in memory. To write a test that tolerates both cases we "capture" +the destination of the store, and then use the captured expression +to write the remainder of the test. + +```c++ +// CHECK-LABEL: test_div_no_op_into_shr: +extern "C" void test_div_no_op_into_shr(int value) { + int divisor = 2; + benchmark::DoNotOptimize(divisor); // hide the value from the optimizer + return value / divisor; + + // CHECK: movl $2, [[DEST:.*]] + // CHECK: idivl [[DEST]] + // CHECK: ret +} +``` + +#### Using Regular Expressions to Match Differing Output + +Often tests require testing assembly lines which may subtly differ +between compilers or compiler versions. A common example of this +is matching stack frame addresses. In this case regular expressions +can be used to match the differing bits of output. For example: + +```c++ +int ExternInt; +struct Point { int x, y, z; }; + +// CHECK-LABEL: test_store_point: +extern "C" void test_store_point() { + Point p{ExternInt, ExternInt, ExternInt}; + benchmark::DoNotOptimize(p); + + // CHECK: movl ExternInt(%rip), %eax + // CHECK: movl %eax, -{{[0-9]+}}(%rsp) + // CHECK: movl %eax, -{{[0-9]+}}(%rsp) + // CHECK: movl %eax, -{{[0-9]+}}(%rsp) + // CHECK: ret +} +``` + +## Current Requirements and Limitations + +The tests require Filecheck to be installed along the `PATH` of the +build machine. Otherwise the tests will be disabled. + +Additionally, as mentioned in the previous section, codegen tests are +inherently non-portable. Currently the tests are limited to: + +* x86_64 targets. +* Compiled with GCC or Clang + +Further work could be done, at least on a limited basis, to extend the +tests to other architectures and compilers (using `CHECK` prefixes). + +Furthermore, the tests fail for builds which specify additional flags +that modify code generation, including `--coverage` or `-fsanitize=`. + diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/tools.md b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/tools.md new file mode 100755 index 00000000000..70500bd3223 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/docs/tools.md @@ -0,0 +1,242 @@ +# Benchmark Tools + +## compare_bench.py + +The `compare_bench.py` utility which can be used to compare the result of benchmarks. +The program is invoked like: + +``` bash +$ compare_bench.py [benchmark options]... +``` + +Where `` and `` either specify a benchmark executable file, or a JSON output file. The type of the input file is automatically detected. If a benchmark executable is specified then the benchmark is run to obtain the results. Otherwise the results are simply loaded from the output file. + +`[benchmark options]` will be passed to the benchmarks invocations. They can be anything that binary accepts, be it either normal `--benchmark_*` parameters, or some custom parameters your binary takes. + +The sample output using the JSON test files under `Inputs/` gives: + +``` bash +$ ./compare_bench.py ./gbench/Inputs/test1_run1.json ./gbench/Inputs/test1_run2.json +Comparing ./gbench/Inputs/test1_run1.json to ./gbench/Inputs/test1_run2.json +Benchmark Time CPU Time Old Time New CPU Old CPU New +------------------------------------------------------------------------------------------------------------- +BM_SameTimes +0.0000 +0.0000 10 10 10 10 +BM_2xFaster -0.5000 -0.5000 50 25 50 25 +BM_2xSlower +1.0000 +1.0000 50 100 50 100 +BM_1PercentFaster -0.0100 -0.0100 100 99 100 99 +BM_1PercentSlower +0.0100 +0.0100 100 101 100 101 +BM_10PercentFaster -0.1000 -0.1000 100 90 100 90 +BM_10PercentSlower +0.1000 +0.1000 100 110 100 110 +BM_100xSlower +99.0000 +99.0000 100 10000 100 10000 +BM_100xFaster -0.9900 -0.9900 10000 100 10000 100 +BM_10PercentCPUToTime +0.1000 -0.1000 100 110 100 90 +BM_ThirdFaster -0.3333 -0.3334 100 67 100 67 +BM_BadTimeUnit -0.9000 +0.2000 0 0 0 1 +``` + +As you can note, the values in `Time` and `CPU` columns are calculated as `(new - old) / |old|`. + +When a benchmark executable is run, the raw output from the benchmark is printed in real time to stdout. The sample output using `benchmark/basic_test` for both arguments looks like: + +``` +./compare_bench.py test/basic_test test/basic_test --benchmark_filter=BM_empty.* +RUNNING: test/basic_test --benchmark_filter=BM_empty.* --benchmark_out=/tmp/tmpN7LF3a +Run on (8 X 4000 MHz CPU s) +2017-11-07 23:28:36 +--------------------------------------------------------------------- +Benchmark Time CPU Iterations +--------------------------------------------------------------------- +BM_empty 4 ns 4 ns 170178757 +BM_empty/threads:8 1 ns 7 ns 103868920 +BM_empty_stop_start 0 ns 0 ns 1000000000 +BM_empty_stop_start/threads:8 0 ns 0 ns 1403031720 +RUNNING: /test/basic_test --benchmark_filter=BM_empty.* --benchmark_out=/tmp/tmplvrIp8 +Run on (8 X 4000 MHz CPU s) +2017-11-07 23:28:38 +--------------------------------------------------------------------- +Benchmark Time CPU Iterations +--------------------------------------------------------------------- +BM_empty 4 ns 4 ns 169534855 +BM_empty/threads:8 1 ns 7 ns 104188776 +BM_empty_stop_start 0 ns 0 ns 1000000000 +BM_empty_stop_start/threads:8 0 ns 0 ns 1404159424 +Comparing ../build/test/basic_test to ../build/test/basic_test +Benchmark Time CPU Time Old Time New CPU Old CPU New +--------------------------------------------------------------------------------------------------------------------- +BM_empty -0.0048 -0.0049 4 4 4 4 +BM_empty/threads:8 -0.0123 -0.0054 1 1 7 7 +BM_empty_stop_start -0.0000 -0.0000 0 0 0 0 +BM_empty_stop_start/threads:8 -0.0029 +0.0001 0 0 0 0 + +``` + +As you can note, the values in `Time` and `CPU` columns are calculated as `(new - old) / |old|`. +Obviously this example doesn't give any useful output, but it's intended to show the output format when 'compare_bench.py' needs to run benchmarks. + +## compare.py + +The `compare.py` can be used to compare the result of benchmarks. +There are three modes of operation: + +1. Just compare two benchmarks, what `compare_bench.py` did. +The program is invoked like: + +``` bash +$ compare.py benchmarks [benchmark options]... +``` +Where `` and `` either specify a benchmark executable file, or a JSON output file. The type of the input file is automatically detected. If a benchmark executable is specified then the benchmark is run to obtain the results. Otherwise the results are simply loaded from the output file. + +`[benchmark options]` will be passed to the benchmarks invocations. They can be anything that binary accepts, be it either normal `--benchmark_*` parameters, or some custom parameters your binary takes. + +Example output: +``` +$ ./compare.py benchmarks ./a.out ./a.out +RUNNING: ./a.out --benchmark_out=/tmp/tmprBT5nW +Run on (8 X 4000 MHz CPU s) +2017-11-07 21:16:44 +------------------------------------------------------ +Benchmark Time CPU Iterations +------------------------------------------------------ +BM_memcpy/8 36 ns 36 ns 19101577 211.669MB/s +BM_memcpy/64 76 ns 76 ns 9412571 800.199MB/s +BM_memcpy/512 84 ns 84 ns 8249070 5.64771GB/s +BM_memcpy/1024 116 ns 116 ns 6181763 8.19505GB/s +BM_memcpy/8192 643 ns 643 ns 1062855 11.8636GB/s +BM_copy/8 222 ns 222 ns 3137987 34.3772MB/s +BM_copy/64 1608 ns 1608 ns 432758 37.9501MB/s +BM_copy/512 12589 ns 12589 ns 54806 38.7867MB/s +BM_copy/1024 25169 ns 25169 ns 27713 38.8003MB/s +BM_copy/8192 201165 ns 201112 ns 3486 38.8466MB/s +RUNNING: ./a.out --benchmark_out=/tmp/tmpt1wwG_ +Run on (8 X 4000 MHz CPU s) +2017-11-07 21:16:53 +------------------------------------------------------ +Benchmark Time CPU Iterations +------------------------------------------------------ +BM_memcpy/8 36 ns 36 ns 19397903 211.255MB/s +BM_memcpy/64 73 ns 73 ns 9691174 839.635MB/s +BM_memcpy/512 85 ns 85 ns 8312329 5.60101GB/s +BM_memcpy/1024 118 ns 118 ns 6438774 8.11608GB/s +BM_memcpy/8192 656 ns 656 ns 1068644 11.6277GB/s +BM_copy/8 223 ns 223 ns 3146977 34.2338MB/s +BM_copy/64 1611 ns 1611 ns 435340 37.8751MB/s +BM_copy/512 12622 ns 12622 ns 54818 38.6844MB/s +BM_copy/1024 25257 ns 25239 ns 27779 38.6927MB/s +BM_copy/8192 205013 ns 205010 ns 3479 38.108MB/s +Comparing ./a.out to ./a.out +Benchmark Time CPU Time Old Time New CPU Old CPU New +------------------------------------------------------------------------------------------------------ +BM_memcpy/8 +0.0020 +0.0020 36 36 36 36 +BM_memcpy/64 -0.0468 -0.0470 76 73 76 73 +BM_memcpy/512 +0.0081 +0.0083 84 85 84 85 +BM_memcpy/1024 +0.0098 +0.0097 116 118 116 118 +BM_memcpy/8192 +0.0200 +0.0203 643 656 643 656 +BM_copy/8 +0.0046 +0.0042 222 223 222 223 +BM_copy/64 +0.0020 +0.0020 1608 1611 1608 1611 +BM_copy/512 +0.0027 +0.0026 12589 12622 12589 12622 +BM_copy/1024 +0.0035 +0.0028 25169 25257 25169 25239 +BM_copy/8192 +0.0191 +0.0194 201165 205013 201112 205010 +``` + +What it does is for the every benchmark from the first run it looks for the benchmark with exactly the same name in the second run, and then compares the results. If the names differ, the benchmark is omitted from the diff. +As you can note, the values in `Time` and `CPU` columns are calculated as `(new - old) / |old|`. + +2. Compare two different filters of one benchmark +The program is invoked like: + +``` bash +$ compare.py filters [benchmark options]... +``` +Where `` either specify a benchmark executable file, or a JSON output file. The type of the input file is automatically detected. If a benchmark executable is specified then the benchmark is run to obtain the results. Otherwise the results are simply loaded from the output file. + +Where `` and `` are the same regex filters that you would pass to the `[--benchmark_filter=]` parameter of the benchmark binary. + +`[benchmark options]` will be passed to the benchmarks invocations. They can be anything that binary accepts, be it either normal `--benchmark_*` parameters, or some custom parameters your binary takes. + +Example output: +``` +$ ./compare.py filters ./a.out BM_memcpy BM_copy +RUNNING: ./a.out --benchmark_filter=BM_memcpy --benchmark_out=/tmp/tmpBWKk0k +Run on (8 X 4000 MHz CPU s) +2017-11-07 21:37:28 +------------------------------------------------------ +Benchmark Time CPU Iterations +------------------------------------------------------ +BM_memcpy/8 36 ns 36 ns 17891491 211.215MB/s +BM_memcpy/64 74 ns 74 ns 9400999 825.646MB/s +BM_memcpy/512 87 ns 87 ns 8027453 5.46126GB/s +BM_memcpy/1024 111 ns 111 ns 6116853 8.5648GB/s +BM_memcpy/8192 657 ns 656 ns 1064679 11.6247GB/s +RUNNING: ./a.out --benchmark_filter=BM_copy --benchmark_out=/tmp/tmpAvWcOM +Run on (8 X 4000 MHz CPU s) +2017-11-07 21:37:33 +---------------------------------------------------- +Benchmark Time CPU Iterations +---------------------------------------------------- +BM_copy/8 227 ns 227 ns 3038700 33.6264MB/s +BM_copy/64 1640 ns 1640 ns 426893 37.2154MB/s +BM_copy/512 12804 ns 12801 ns 55417 38.1444MB/s +BM_copy/1024 25409 ns 25407 ns 27516 38.4365MB/s +BM_copy/8192 202986 ns 202990 ns 3454 38.4871MB/s +Comparing BM_memcpy to BM_copy (from ./a.out) +Benchmark Time CPU Time Old Time New CPU Old CPU New +-------------------------------------------------------------------------------------------------------------------- +[BM_memcpy vs. BM_copy]/8 +5.2829 +5.2812 36 227 36 227 +[BM_memcpy vs. BM_copy]/64 +21.1719 +21.1856 74 1640 74 1640 +[BM_memcpy vs. BM_copy]/512 +145.6487 +145.6097 87 12804 87 12801 +[BM_memcpy vs. BM_copy]/1024 +227.1860 +227.1776 111 25409 111 25407 +[BM_memcpy vs. BM_copy]/8192 +308.1664 +308.2898 657 202986 656 202990 +``` + +As you can see, it applies filter to the benchmarks, both when running the benchmark, and before doing the diff. And to make the diff work, the matches are replaced with some common string. Thus, you can compare two different benchmark families within one benchmark binary. +As you can note, the values in `Time` and `CPU` columns are calculated as `(new - old) / |old|`. + +3. Compare filter one from benchmark one to filter two from benchmark two: +The program is invoked like: + +``` bash +$ compare.py filters [benchmark options]... +``` + +Where `` and `` either specify a benchmark executable file, or a JSON output file. The type of the input file is automatically detected. If a benchmark executable is specified then the benchmark is run to obtain the results. Otherwise the results are simply loaded from the output file. + +Where `` and `` are the same regex filters that you would pass to the `[--benchmark_filter=]` parameter of the benchmark binary. + +`[benchmark options]` will be passed to the benchmarks invocations. They can be anything that binary accepts, be it either normal `--benchmark_*` parameters, or some custom parameters your binary takes. + +Example output: +``` +$ ./compare.py benchmarksfiltered ./a.out BM_memcpy ./a.out BM_copy +RUNNING: ./a.out --benchmark_filter=BM_memcpy --benchmark_out=/tmp/tmp_FvbYg +Run on (8 X 4000 MHz CPU s) +2017-11-07 21:38:27 +------------------------------------------------------ +Benchmark Time CPU Iterations +------------------------------------------------------ +BM_memcpy/8 37 ns 37 ns 18953482 204.118MB/s +BM_memcpy/64 74 ns 74 ns 9206578 828.245MB/s +BM_memcpy/512 91 ns 91 ns 8086195 5.25476GB/s +BM_memcpy/1024 120 ns 120 ns 5804513 7.95662GB/s +BM_memcpy/8192 664 ns 664 ns 1028363 11.4948GB/s +RUNNING: ./a.out --benchmark_filter=BM_copy --benchmark_out=/tmp/tmpDfL5iE +Run on (8 X 4000 MHz CPU s) +2017-11-07 21:38:32 +---------------------------------------------------- +Benchmark Time CPU Iterations +---------------------------------------------------- +BM_copy/8 230 ns 230 ns 2985909 33.1161MB/s +BM_copy/64 1654 ns 1653 ns 419408 36.9137MB/s +BM_copy/512 13122 ns 13120 ns 53403 37.2156MB/s +BM_copy/1024 26679 ns 26666 ns 26575 36.6218MB/s +BM_copy/8192 215068 ns 215053 ns 3221 36.3283MB/s +Comparing BM_memcpy (from ./a.out) to BM_copy (from ./a.out) +Benchmark Time CPU Time Old Time New CPU Old CPU New +-------------------------------------------------------------------------------------------------------------------- +[BM_memcpy vs. BM_copy]/8 +5.1649 +5.1637 37 230 37 230 +[BM_memcpy vs. BM_copy]/64 +21.4352 +21.4374 74 1654 74 1653 +[BM_memcpy vs. BM_copy]/512 +143.6022 +143.5865 91 13122 91 13120 +[BM_memcpy vs. BM_copy]/1024 +221.5903 +221.4790 120 26679 120 26666 +[BM_memcpy vs. BM_copy]/8192 +322.9059 +323.0096 664 215068 664 215053 +``` +This is a mix of the previous two modes, two (potentially different) benchmark binaries are run, and a different filter is applied to each one. +As you can note, the values in `Time` and `CPU` columns are calculated as `(new - old) / |old|`. diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/include/benchmark/benchmark.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/include/benchmark/benchmark.h new file mode 100755 index 00000000000..23dd3d09b1f --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/include/benchmark/benchmark.h @@ -0,0 +1,1456 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Support for registering benchmarks for functions. + +/* Example usage: +// Define a function that executes the code to be measured a +// specified number of times: +static void BM_StringCreation(benchmark::State& state) { + for (auto _ : state) + std::string empty_string; +} + +// Register the function as a benchmark +BENCHMARK(BM_StringCreation); + +// Define another benchmark +static void BM_StringCopy(benchmark::State& state) { + std::string x = "hello"; + for (auto _ : state) + std::string copy(x); +} +BENCHMARK(BM_StringCopy); + +// Augment the main() program to invoke benchmarks if specified +// via the --benchmarks command line flag. E.g., +// my_unittest --benchmark_filter=all +// my_unittest --benchmark_filter=BM_StringCreation +// my_unittest --benchmark_filter=String +// my_unittest --benchmark_filter='Copy|Creation' +int main(int argc, char** argv) { + benchmark::Initialize(&argc, argv); + benchmark::RunSpecifiedBenchmarks(); + return 0; +} + +// Sometimes a family of microbenchmarks can be implemented with +// just one routine that takes an extra argument to specify which +// one of the family of benchmarks to run. For example, the following +// code defines a family of microbenchmarks for measuring the speed +// of memcpy() calls of different lengths: + +static void BM_memcpy(benchmark::State& state) { + char* src = new char[state.range(0)]; char* dst = new char[state.range(0)]; + memset(src, 'x', state.range(0)); + for (auto _ : state) + memcpy(dst, src, state.range(0)); + state.SetBytesProcessed(int64_t(state.iterations()) * + int64_t(state.range(0))); + delete[] src; delete[] dst; +} +BENCHMARK(BM_memcpy)->Arg(8)->Arg(64)->Arg(512)->Arg(1<<10)->Arg(8<<10); + +// The preceding code is quite repetitive, and can be replaced with the +// following short-hand. The following invocation will pick a few +// appropriate arguments in the specified range and will generate a +// microbenchmark for each such argument. +BENCHMARK(BM_memcpy)->Range(8, 8<<10); + +// You might have a microbenchmark that depends on two inputs. For +// example, the following code defines a family of microbenchmarks for +// measuring the speed of set insertion. +static void BM_SetInsert(benchmark::State& state) { + set data; + for (auto _ : state) { + state.PauseTiming(); + data = ConstructRandomSet(state.range(0)); + state.ResumeTiming(); + for (int j = 0; j < state.range(1); ++j) + data.insert(RandomNumber()); + } +} +BENCHMARK(BM_SetInsert) + ->Args({1<<10, 128}) + ->Args({2<<10, 128}) + ->Args({4<<10, 128}) + ->Args({8<<10, 128}) + ->Args({1<<10, 512}) + ->Args({2<<10, 512}) + ->Args({4<<10, 512}) + ->Args({8<<10, 512}); + +// The preceding code is quite repetitive, and can be replaced with +// the following short-hand. The following macro will pick a few +// appropriate arguments in the product of the two specified ranges +// and will generate a microbenchmark for each such pair. +BENCHMARK(BM_SetInsert)->Ranges({{1<<10, 8<<10}, {128, 512}}); + +// For more complex patterns of inputs, passing a custom function +// to Apply allows programmatic specification of an +// arbitrary set of arguments to run the microbenchmark on. +// The following example enumerates a dense range on +// one parameter, and a sparse range on the second. +static void CustomArguments(benchmark::internal::Benchmark* b) { + for (int i = 0; i <= 10; ++i) + for (int j = 32; j <= 1024*1024; j *= 8) + b->Args({i, j}); +} +BENCHMARK(BM_SetInsert)->Apply(CustomArguments); + +// Templated microbenchmarks work the same way: +// Produce then consume 'size' messages 'iters' times +// Measures throughput in the absence of multiprogramming. +template int BM_Sequential(benchmark::State& state) { + Q q; + typename Q::value_type v; + for (auto _ : state) { + for (int i = state.range(0); i--; ) + q.push(v); + for (int e = state.range(0); e--; ) + q.Wait(&v); + } + // actually messages, not bytes: + state.SetBytesProcessed( + static_cast(state.iterations())*state.range(0)); +} +BENCHMARK_TEMPLATE(BM_Sequential, WaitQueue)->Range(1<<0, 1<<10); + +Use `Benchmark::MinTime(double t)` to set the minimum time used to run the +benchmark. This option overrides the `benchmark_min_time` flag. + +void BM_test(benchmark::State& state) { + ... body ... +} +BENCHMARK(BM_test)->MinTime(2.0); // Run for at least 2 seconds. + +In a multithreaded test, it is guaranteed that none of the threads will start +until all have reached the loop start, and all will have finished before any +thread exits the loop body. As such, any global setup or teardown you want to +do can be wrapped in a check against the thread index: + +static void BM_MultiThreaded(benchmark::State& state) { + if (state.thread_index == 0) { + // Setup code here. + } + for (auto _ : state) { + // Run the test as normal. + } + if (state.thread_index == 0) { + // Teardown code here. + } +} +BENCHMARK(BM_MultiThreaded)->Threads(4); + + +If a benchmark runs a few milliseconds it may be hard to visually compare the +measured times, since the output data is given in nanoseconds per default. In +order to manually set the time unit, you can specify it manually: + +BENCHMARK(BM_test)->Unit(benchmark::kMillisecond); +*/ + +#ifndef BENCHMARK_BENCHMARK_H_ +#define BENCHMARK_BENCHMARK_H_ + + +// The _MSVC_LANG check should detect Visual Studio 2015 Update 3 and newer. +#if __cplusplus >= 201103L || (defined(_MSVC_LANG) && _MSVC_LANG >= 201103L) +#define BENCHMARK_HAS_CXX11 +#endif + +#include + +#include +#include +#include +#include +#include +#include +#include +#include + +#if defined(BENCHMARK_HAS_CXX11) +#include +#include +#include +#endif + +#if defined(_MSC_VER) +#include // for _ReadWriteBarrier +#endif + +#ifndef BENCHMARK_HAS_CXX11 +#define BENCHMARK_DISALLOW_COPY_AND_ASSIGN(TypeName) \ + TypeName(const TypeName&); \ + TypeName& operator=(const TypeName&) +#else +#define BENCHMARK_DISALLOW_COPY_AND_ASSIGN(TypeName) \ + TypeName(const TypeName&) = delete; \ + TypeName& operator=(const TypeName&) = delete +#endif + +#if defined(__GNUC__) +#define BENCHMARK_UNUSED __attribute__((unused)) +#define BENCHMARK_ALWAYS_INLINE __attribute__((always_inline)) +#define BENCHMARK_NOEXCEPT noexcept +#define BENCHMARK_NOEXCEPT_OP(x) noexcept(x) +#elif defined(_MSC_VER) && !defined(__clang__) +#define BENCHMARK_UNUSED +#define BENCHMARK_ALWAYS_INLINE __forceinline +#if _MSC_VER >= 1900 +#define BENCHMARK_NOEXCEPT noexcept +#define BENCHMARK_NOEXCEPT_OP(x) noexcept(x) +#else +#define BENCHMARK_NOEXCEPT +#define BENCHMARK_NOEXCEPT_OP(x) +#endif +#define __func__ __FUNCTION__ +#else +#define BENCHMARK_UNUSED +#define BENCHMARK_ALWAYS_INLINE +#define BENCHMARK_NOEXCEPT +#define BENCHMARK_NOEXCEPT_OP(x) +#endif + +#define BENCHMARK_INTERNAL_TOSTRING2(x) #x +#define BENCHMARK_INTERNAL_TOSTRING(x) BENCHMARK_INTERNAL_TOSTRING2(x) + +#if defined(__GNUC__) +#define BENCHMARK_BUILTIN_EXPECT(x, y) __builtin_expect(x, y) +#define BENCHMARK_DEPRECATED_MSG(msg) __attribute__((deprecated(msg))) +#else +#define BENCHMARK_BUILTIN_EXPECT(x, y) x +#define BENCHMARK_DEPRECATED_MSG(msg) +#define BENCHMARK_WARNING_MSG(msg) __pragma(message(__FILE__ "(" BENCHMARK_INTERNAL_TOSTRING(__LINE__) ") : warning note: " msg)) +#endif + +#if defined(__GNUC__) && !defined(__clang__) +#define BENCHMARK_GCC_VERSION (__GNUC__ * 100 + __GNUC_MINOR__) +#endif + +namespace benchmark { +class BenchmarkReporter; + +void Initialize(int* argc, char** argv); + +// Report to stdout all arguments in 'argv' as unrecognized except the first. +// Returns true there is at least on unrecognized argument (i.e. 'argc' > 1). +bool ReportUnrecognizedArguments(int argc, char** argv); + +// Generate a list of benchmarks matching the specified --benchmark_filter flag +// and if --benchmark_list_tests is specified return after printing the name +// of each matching benchmark. Otherwise run each matching benchmark and +// report the results. +// +// The second and third overload use the specified 'console_reporter' and +// 'file_reporter' respectively. 'file_reporter' will write to the file +// specified +// by '--benchmark_output'. If '--benchmark_output' is not given the +// 'file_reporter' is ignored. +// +// RETURNS: The number of matching benchmarks. +size_t RunSpecifiedBenchmarks(); +size_t RunSpecifiedBenchmarks(BenchmarkReporter* console_reporter); +size_t RunSpecifiedBenchmarks(BenchmarkReporter* console_reporter, + BenchmarkReporter* file_reporter); + +// If this routine is called, peak memory allocation past this point in the +// benchmark is reported at the end of the benchmark report line. (It is +// computed by running the benchmark once with a single iteration and a memory +// tracer.) +// TODO(dominic) +// void MemoryUsage(); + +namespace internal { +class Benchmark; +class BenchmarkImp; +class BenchmarkFamilies; + +void UseCharPointer(char const volatile*); + +// Take ownership of the pointer and register the benchmark. Return the +// registered benchmark. +Benchmark* RegisterBenchmarkInternal(Benchmark*); + +// Ensure that the standard streams are properly initialized in every TU. +int InitializeStreams(); +BENCHMARK_UNUSED static int stream_init_anchor = InitializeStreams(); + +} // namespace internal + + +#if (!defined(__GNUC__) && !defined(__clang__)) || defined(__pnacl__) || \ + defined(__EMSCRIPTEN__) +# define BENCHMARK_HAS_NO_INLINE_ASSEMBLY +#endif + + +// The DoNotOptimize(...) function can be used to prevent a value or +// expression from being optimized away by the compiler. This function is +// intended to add little to no overhead. +// See: https://youtu.be/nXaxk27zwlk?t=2441 +#ifndef BENCHMARK_HAS_NO_INLINE_ASSEMBLY +template +inline BENCHMARK_ALWAYS_INLINE +void DoNotOptimize(Tp const& value) { + asm volatile("" : : "r,m"(value) : "memory"); +} + +template +inline BENCHMARK_ALWAYS_INLINE void DoNotOptimize(Tp& value) { +#if defined(__clang__) + asm volatile("" : "+r,m"(value) : : "memory"); +#else + asm volatile("" : "+m,r"(value) : : "memory"); +#endif +} + +// Force the compiler to flush pending writes to global memory. Acts as an +// effective read/write barrier +inline BENCHMARK_ALWAYS_INLINE void ClobberMemory() { + asm volatile("" : : : "memory"); +} +#elif defined(_MSC_VER) +template +inline BENCHMARK_ALWAYS_INLINE void DoNotOptimize(Tp const& value) { + internal::UseCharPointer(&reinterpret_cast(value)); + _ReadWriteBarrier(); +} + +inline BENCHMARK_ALWAYS_INLINE void ClobberMemory() { + _ReadWriteBarrier(); +} +#else +template +inline BENCHMARK_ALWAYS_INLINE void DoNotOptimize(Tp const& value) { + internal::UseCharPointer(&reinterpret_cast(value)); +} +// FIXME Add ClobberMemory() for non-gnu and non-msvc compilers +#endif + + + +// This class is used for user-defined counters. +class Counter { +public: + + enum Flags { + kDefaults = 0, + // Mark the counter as a rate. It will be presented divided + // by the duration of the benchmark. + kIsRate = 1, + // Mark the counter as a thread-average quantity. It will be + // presented divided by the number of threads. + kAvgThreads = 2, + // Mark the counter as a thread-average rate. See above. + kAvgThreadsRate = kIsRate|kAvgThreads + }; + + double value; + Flags flags; + + BENCHMARK_ALWAYS_INLINE + Counter(double v = 0., Flags f = kDefaults) : value(v), flags(f) {} + + BENCHMARK_ALWAYS_INLINE operator double const& () const { return value; } + BENCHMARK_ALWAYS_INLINE operator double & () { return value; } + +}; + +// This is the container for the user-defined counters. +typedef std::map UserCounters; + + +// TimeUnit is passed to a benchmark in order to specify the order of magnitude +// for the measured time. +enum TimeUnit { kNanosecond, kMicrosecond, kMillisecond }; + +// BigO is passed to a benchmark in order to specify the asymptotic +// computational +// complexity for the benchmark. In case oAuto is selected, complexity will be +// calculated automatically to the best fit. +enum BigO { oNone, o1, oN, oNSquared, oNCubed, oLogN, oNLogN, oAuto, oLambda }; + +// BigOFunc is passed to a benchmark in order to specify the asymptotic +// computational complexity for the benchmark. +typedef double(BigOFunc)(int64_t); + +// StatisticsFunc is passed to a benchmark in order to compute some descriptive +// statistics over all the measurements of some type +typedef double(StatisticsFunc)(const std::vector&); + +struct Statistics { + std::string name_; + StatisticsFunc* compute_; + + Statistics(std::string name, StatisticsFunc* compute) + : name_(name), compute_(compute) {} +}; + +namespace internal { +class ThreadTimer; +class ThreadManager; + +enum ReportMode +#if defined(BENCHMARK_HAS_CXX11) + : unsigned +#else +#endif + { + RM_Unspecified, // The mode has not been manually specified + RM_Default, // The mode is user-specified as default. + RM_ReportAggregatesOnly +}; +} // namespace internal + +// State is passed to a running Benchmark and contains state for the +// benchmark to use. +class State { + public: + struct StateIterator; + friend struct StateIterator; + + // Returns iterators used to run each iteration of a benchmark using a + // C++11 ranged-based for loop. These functions should not be called directly. + // + // REQUIRES: The benchmark has not started running yet. Neither begin nor end + // have been called previously. + // + // NOTE: KeepRunning may not be used after calling either of these functions. + BENCHMARK_ALWAYS_INLINE StateIterator begin(); + BENCHMARK_ALWAYS_INLINE StateIterator end(); + + // Returns true if the benchmark should continue through another iteration. + // NOTE: A benchmark may not return from the test until KeepRunning() has + // returned false. + bool KeepRunning(); + + // Returns true iff the benchmark should run n more iterations. + // REQUIRES: 'n' > 0. + // NOTE: A benchmark must not return from the test until KeepRunningBatch() + // has returned false. + // NOTE: KeepRunningBatch() may overshoot by up to 'n' iterations. + // + // Intended usage: + // while (state.KeepRunningBatch(1000)) { + // // process 1000 elements + // } + bool KeepRunningBatch(size_t n); + + // REQUIRES: timer is running and 'SkipWithError(...)' has not been called + // by the current thread. + // Stop the benchmark timer. If not called, the timer will be + // automatically stopped after the last iteration of the benchmark loop. + // + // For threaded benchmarks the PauseTiming() function only pauses the timing + // for the current thread. + // + // NOTE: The "real time" measurement is per-thread. If different threads + // report different measurements the largest one is reported. + // + // NOTE: PauseTiming()/ResumeTiming() are relatively + // heavyweight, and so their use should generally be avoided + // within each benchmark iteration, if possible. + void PauseTiming(); + + // REQUIRES: timer is not running and 'SkipWithError(...)' has not been called + // by the current thread. + // Start the benchmark timer. The timer is NOT running on entrance to the + // benchmark function. It begins running after control flow enters the + // benchmark loop. + // + // NOTE: PauseTiming()/ResumeTiming() are relatively + // heavyweight, and so their use should generally be avoided + // within each benchmark iteration, if possible. + void ResumeTiming(); + + // REQUIRES: 'SkipWithError(...)' has not been called previously by the + // current thread. + // Report the benchmark as resulting in an error with the specified 'msg'. + // After this call the user may explicitly 'return' from the benchmark. + // + // If the ranged-for style of benchmark loop is used, the user must explicitly + // break from the loop, otherwise all future iterations will be run. + // If the 'KeepRunning()' loop is used the current thread will automatically + // exit the loop at the end of the current iteration. + // + // For threaded benchmarks only the current thread stops executing and future + // calls to `KeepRunning()` will block until all threads have completed + // the `KeepRunning()` loop. If multiple threads report an error only the + // first error message is used. + // + // NOTE: Calling 'SkipWithError(...)' does not cause the benchmark to exit + // the current scope immediately. If the function is called from within + // the 'KeepRunning()' loop the current iteration will finish. It is the users + // responsibility to exit the scope as needed. + void SkipWithError(const char* msg); + + // REQUIRES: called exactly once per iteration of the benchmarking loop. + // Set the manually measured time for this benchmark iteration, which + // is used instead of automatically measured time if UseManualTime() was + // specified. + // + // For threaded benchmarks the final value will be set to the largest + // reported values. + void SetIterationTime(double seconds); + + // Set the number of bytes processed by the current benchmark + // execution. This routine is typically called once at the end of a + // throughput oriented benchmark. If this routine is called with a + // value > 0, the report is printed in MB/sec instead of nanoseconds + // per iteration. + // + // REQUIRES: a benchmark has exited its benchmarking loop. + BENCHMARK_ALWAYS_INLINE + void SetBytesProcessed(int64_t bytes) { bytes_processed_ = bytes; } + + BENCHMARK_ALWAYS_INLINE + int64_t bytes_processed() const { return bytes_processed_; } + + // If this routine is called with complexity_n > 0 and complexity report is + // requested for the + // family benchmark, then current benchmark will be part of the computation + // and complexity_n will + // represent the length of N. + BENCHMARK_ALWAYS_INLINE + void SetComplexityN(int64_t complexity_n) { complexity_n_ = complexity_n; } + + BENCHMARK_ALWAYS_INLINE + int64_t complexity_length_n() { return complexity_n_; } + + // If this routine is called with items > 0, then an items/s + // label is printed on the benchmark report line for the currently + // executing benchmark. It is typically called at the end of a processing + // benchmark where a processing items/second output is desired. + // + // REQUIRES: a benchmark has exited its benchmarking loop. + BENCHMARK_ALWAYS_INLINE + void SetItemsProcessed(int64_t items) { items_processed_ = items; } + + BENCHMARK_ALWAYS_INLINE + int64_t items_processed() const { return items_processed_; } + + // If this routine is called, the specified label is printed at the + // end of the benchmark report line for the currently executing + // benchmark. Example: + // static void BM_Compress(benchmark::State& state) { + // ... + // double compress = input_size / output_size; + // state.SetLabel(StrFormat("compress:%.1f%%", 100.0*compression)); + // } + // Produces output that looks like: + // BM_Compress 50 50 14115038 compress:27.3% + // + // REQUIRES: a benchmark has exited its benchmarking loop. + void SetLabel(const char* label); + + void BENCHMARK_ALWAYS_INLINE SetLabel(const std::string& str) { + this->SetLabel(str.c_str()); + } + + // Range arguments for this run. CHECKs if the argument has been set. + BENCHMARK_ALWAYS_INLINE + int64_t range(std::size_t pos = 0) const { + assert(range_.size() > pos); + return range_[pos]; + } + + BENCHMARK_DEPRECATED_MSG("use 'range(0)' instead") + int64_t range_x() const { return range(0); } + + BENCHMARK_DEPRECATED_MSG("use 'range(1)' instead") + int64_t range_y() const { return range(1); } + + BENCHMARK_ALWAYS_INLINE + size_t iterations() const { + if (BENCHMARK_BUILTIN_EXPECT(!started_, false)) { + return 0; + } + return max_iterations - total_iterations_ + batch_leftover_; + } + +private: // items we expect on the first cache line (ie 64 bytes of the struct) + + // When total_iterations_ is 0, KeepRunning() and friends will return false. + // May be larger than max_iterations. + size_t total_iterations_; + + // When using KeepRunningBatch(), batch_leftover_ holds the number of + // iterations beyond max_iters that were run. Used to track + // completed_iterations_ accurately. + size_t batch_leftover_; + +public: + const size_t max_iterations; + +private: + bool started_; + bool finished_; + bool error_occurred_; + +private: // items we don't need on the first cache line + std::vector range_; + + int64_t bytes_processed_; + int64_t items_processed_; + + int64_t complexity_n_; + + public: + // Container for user-defined counters. + UserCounters counters; + // Index of the executing thread. Values from [0, threads). + const int thread_index; + // Number of threads concurrently executing the benchmark. + const int threads; + + + // TODO(EricWF) make me private + State(size_t max_iters, const std::vector& ranges, int thread_i, + int n_threads, internal::ThreadTimer* timer, + internal::ThreadManager* manager); + + private: + void StartKeepRunning(); + // Implementation of KeepRunning() and KeepRunningBatch(). + // is_batch must be true unless n is 1. + bool KeepRunningInternal(size_t n, bool is_batch); + void FinishKeepRunning(); + internal::ThreadTimer* timer_; + internal::ThreadManager* manager_; + BENCHMARK_DISALLOW_COPY_AND_ASSIGN(State); +}; + +inline BENCHMARK_ALWAYS_INLINE +bool State::KeepRunning() { + return KeepRunningInternal(1, /*is_batch=*/ false); +} + +inline BENCHMARK_ALWAYS_INLINE +bool State::KeepRunningBatch(size_t n) { + return KeepRunningInternal(n, /*is_batch=*/ true); +} + +inline BENCHMARK_ALWAYS_INLINE +bool State::KeepRunningInternal(size_t n, bool is_batch) { + // total_iterations_ is set to 0 by the constructor, and always set to a + // nonzero value by StartKepRunning(). + assert(n > 0); + // n must be 1 unless is_batch is true. + assert(is_batch || n == 1); + if (BENCHMARK_BUILTIN_EXPECT(total_iterations_ >= n, true)) { + total_iterations_ -= n; + return true; + } + if (!started_) { + StartKeepRunning(); + if (!error_occurred_ && total_iterations_ >= n) { + total_iterations_-= n; + return true; + } + } + // For non-batch runs, total_iterations_ must be 0 by now. + if (is_batch && total_iterations_ != 0) { + batch_leftover_ = n - total_iterations_; + total_iterations_ = 0; + return true; + } + FinishKeepRunning(); + return false; +} + +struct State::StateIterator { + struct BENCHMARK_UNUSED Value {}; + typedef std::forward_iterator_tag iterator_category; + typedef Value value_type; + typedef Value reference; + typedef Value pointer; + typedef std::ptrdiff_t difference_type; + + private: + friend class State; + BENCHMARK_ALWAYS_INLINE + StateIterator() : cached_(0), parent_() {} + + BENCHMARK_ALWAYS_INLINE + explicit StateIterator(State* st) + : cached_(st->error_occurred_ ? 0 : st->max_iterations), parent_(st) {} + + public: + BENCHMARK_ALWAYS_INLINE + Value operator*() const { return Value(); } + + BENCHMARK_ALWAYS_INLINE + StateIterator& operator++() { + assert(cached_ > 0); + --cached_; + return *this; + } + + BENCHMARK_ALWAYS_INLINE + bool operator!=(StateIterator const&) const { + if (BENCHMARK_BUILTIN_EXPECT(cached_ != 0, true)) return true; + parent_->FinishKeepRunning(); + return false; + } + + private: + size_t cached_; + State* const parent_; +}; + +inline BENCHMARK_ALWAYS_INLINE State::StateIterator State::begin() { + return StateIterator(this); +} +inline BENCHMARK_ALWAYS_INLINE State::StateIterator State::end() { + StartKeepRunning(); + return StateIterator(); +} + +namespace internal { + +typedef void(Function)(State&); + +// ------------------------------------------------------ +// Benchmark registration object. The BENCHMARK() macro expands +// into an internal::Benchmark* object. Various methods can +// be called on this object to change the properties of the benchmark. +// Each method returns "this" so that multiple method calls can +// chained into one expression. +class Benchmark { + public: + virtual ~Benchmark(); + + // Note: the following methods all return "this" so that multiple + // method calls can be chained together in one expression. + + // Run this benchmark once with "x" as the extra argument passed + // to the function. + // REQUIRES: The function passed to the constructor must accept an arg1. + Benchmark* Arg(int64_t x); + + // Run this benchmark with the given time unit for the generated output report + Benchmark* Unit(TimeUnit unit); + + // Run this benchmark once for a number of values picked from the + // range [start..limit]. (start and limit are always picked.) + // REQUIRES: The function passed to the constructor must accept an arg1. + Benchmark* Range(int64_t start, int64_t limit); + + // Run this benchmark once for all values in the range [start..limit] with + // specific step + // REQUIRES: The function passed to the constructor must accept an arg1. + Benchmark* DenseRange(int64_t start, int64_t limit, int step = 1); + + // Run this benchmark once with "args" as the extra arguments passed + // to the function. + // REQUIRES: The function passed to the constructor must accept arg1, arg2 ... + Benchmark* Args(const std::vector& args); + + // Equivalent to Args({x, y}) + // NOTE: This is a legacy C++03 interface provided for compatibility only. + // New code should use 'Args'. + Benchmark* ArgPair(int64_t x, int64_t y) { + std::vector args; + args.push_back(x); + args.push_back(y); + return Args(args); + } + + // Run this benchmark once for a number of values picked from the + // ranges [start..limit]. (starts and limits are always picked.) + // REQUIRES: The function passed to the constructor must accept arg1, arg2 ... + Benchmark* Ranges(const std::vector >& ranges); + + // Equivalent to ArgNames({name}) + Benchmark* ArgName(const std::string& name); + + // Set the argument names to display in the benchmark name. If not called, + // only argument values will be shown. + Benchmark* ArgNames(const std::vector& names); + + // Equivalent to Ranges({{lo1, hi1}, {lo2, hi2}}). + // NOTE: This is a legacy C++03 interface provided for compatibility only. + // New code should use 'Ranges'. + Benchmark* RangePair(int64_t lo1, int64_t hi1, int64_t lo2, int64_t hi2) { + std::vector > ranges; + ranges.push_back(std::make_pair(lo1, hi1)); + ranges.push_back(std::make_pair(lo2, hi2)); + return Ranges(ranges); + } + + // Pass this benchmark object to *func, which can customize + // the benchmark by calling various methods like Arg, Args, + // Threads, etc. + Benchmark* Apply(void (*func)(Benchmark* benchmark)); + + // Set the range multiplier for non-dense range. If not called, the range + // multiplier kRangeMultiplier will be used. + Benchmark* RangeMultiplier(int multiplier); + + // Set the minimum amount of time to use when running this benchmark. This + // option overrides the `benchmark_min_time` flag. + // REQUIRES: `t > 0` and `Iterations` has not been called on this benchmark. + Benchmark* MinTime(double t); + + // Specify the amount of iterations that should be run by this benchmark. + // REQUIRES: 'n > 0' and `MinTime` has not been called on this benchmark. + // + // NOTE: This function should only be used when *exact* iteration control is + // needed and never to control or limit how long a benchmark runs, where + // `--benchmark_min_time=N` or `MinTime(...)` should be used instead. + Benchmark* Iterations(size_t n); + + // Specify the amount of times to repeat this benchmark. This option overrides + // the `benchmark_repetitions` flag. + // REQUIRES: `n > 0` + Benchmark* Repetitions(int n); + + // Specify if each repetition of the benchmark should be reported separately + // or if only the final statistics should be reported. If the benchmark + // is not repeated then the single result is always reported. + Benchmark* ReportAggregatesOnly(bool value = true); + + // If a particular benchmark is I/O bound, runs multiple threads internally or + // if for some reason CPU timings are not representative, call this method. If + // called, the elapsed time will be used to control how many iterations are + // run, and in the printing of items/second or MB/seconds values. If not + // called, the cpu time used by the benchmark will be used. + Benchmark* UseRealTime(); + + // If a benchmark must measure time manually (e.g. if GPU execution time is + // being + // measured), call this method. If called, each benchmark iteration should + // call + // SetIterationTime(seconds) to report the measured time, which will be used + // to control how many iterations are run, and in the printing of items/second + // or MB/second values. + Benchmark* UseManualTime(); + + // Set the asymptotic computational complexity for the benchmark. If called + // the asymptotic computational complexity will be shown on the output. + Benchmark* Complexity(BigO complexity = benchmark::oAuto); + + // Set the asymptotic computational complexity for the benchmark. If called + // the asymptotic computational complexity will be shown on the output. + Benchmark* Complexity(BigOFunc* complexity); + + // Add this statistics to be computed over all the values of benchmark run + Benchmark* ComputeStatistics(std::string name, StatisticsFunc* statistics); + + // Support for running multiple copies of the same benchmark concurrently + // in multiple threads. This may be useful when measuring the scaling + // of some piece of code. + + // Run one instance of this benchmark concurrently in t threads. + Benchmark* Threads(int t); + + // Pick a set of values T from [min_threads,max_threads]. + // min_threads and max_threads are always included in T. Run this + // benchmark once for each value in T. The benchmark run for a + // particular value t consists of t threads running the benchmark + // function concurrently. For example, consider: + // BENCHMARK(Foo)->ThreadRange(1,16); + // This will run the following benchmarks: + // Foo in 1 thread + // Foo in 2 threads + // Foo in 4 threads + // Foo in 8 threads + // Foo in 16 threads + Benchmark* ThreadRange(int min_threads, int max_threads); + + // For each value n in the range, run this benchmark once using n threads. + // min_threads and max_threads are always included in the range. + // stride specifies the increment. E.g. DenseThreadRange(1, 8, 3) starts + // a benchmark with 1, 4, 7 and 8 threads. + Benchmark* DenseThreadRange(int min_threads, int max_threads, int stride = 1); + + // Equivalent to ThreadRange(NumCPUs(), NumCPUs()) + Benchmark* ThreadPerCpu(); + + virtual void Run(State& state) = 0; + + // Used inside the benchmark implementation + struct Instance; + + protected: + explicit Benchmark(const char* name); + Benchmark(Benchmark const&); + void SetName(const char* name); + + int ArgsCnt() const; + + private: + friend class BenchmarkFamilies; + + std::string name_; + ReportMode report_mode_; + std::vector arg_names_; // Args for all benchmark runs + std::vector > args_; // Args for all benchmark runs + TimeUnit time_unit_; + int range_multiplier_; + double min_time_; + size_t iterations_; + int repetitions_; + bool use_real_time_; + bool use_manual_time_; + BigO complexity_; + BigOFunc* complexity_lambda_; + std::vector statistics_; + std::vector thread_counts_; + + Benchmark& operator=(Benchmark const&); +}; + +} // namespace internal + +// Create and register a benchmark with the specified 'name' that invokes +// the specified functor 'fn'. +// +// RETURNS: A pointer to the registered benchmark. +internal::Benchmark* RegisterBenchmark(const char* name, + internal::Function* fn); + +#if defined(BENCHMARK_HAS_CXX11) +template +internal::Benchmark* RegisterBenchmark(const char* name, Lambda&& fn); +#endif + +// Remove all registered benchmarks. All pointers to previously registered +// benchmarks are invalidated. +void ClearRegisteredBenchmarks(); + +namespace internal { +// The class used to hold all Benchmarks created from static function. +// (ie those created using the BENCHMARK(...) macros. +class FunctionBenchmark : public Benchmark { + public: + FunctionBenchmark(const char* name, Function* func) + : Benchmark(name), func_(func) {} + + virtual void Run(State& st); + + private: + Function* func_; +}; + +#ifdef BENCHMARK_HAS_CXX11 +template +class LambdaBenchmark : public Benchmark { + public: + virtual void Run(State& st) { lambda_(st); } + + private: + template + LambdaBenchmark(const char* name, OLambda&& lam) + : Benchmark(name), lambda_(std::forward(lam)) {} + + LambdaBenchmark(LambdaBenchmark const&) = delete; + + private: + template + friend Benchmark* ::benchmark::RegisterBenchmark(const char*, Lam&&); + + Lambda lambda_; +}; +#endif + +} // namespace internal + +inline internal::Benchmark* RegisterBenchmark(const char* name, + internal::Function* fn) { + return internal::RegisterBenchmarkInternal( + ::new internal::FunctionBenchmark(name, fn)); +} + +#ifdef BENCHMARK_HAS_CXX11 +template +internal::Benchmark* RegisterBenchmark(const char* name, Lambda&& fn) { + using BenchType = + internal::LambdaBenchmark::type>; + return internal::RegisterBenchmarkInternal( + ::new BenchType(name, std::forward(fn))); +} +#endif + +#if defined(BENCHMARK_HAS_CXX11) && \ + (!defined(BENCHMARK_GCC_VERSION) || BENCHMARK_GCC_VERSION >= 409) +template +internal::Benchmark* RegisterBenchmark(const char* name, Lambda&& fn, + Args&&... args) { + return benchmark::RegisterBenchmark( + name, [=](benchmark::State& st) { fn(st, args...); }); +} +#else +#define BENCHMARK_HAS_NO_VARIADIC_REGISTER_BENCHMARK +#endif + +// The base class for all fixture tests. +class Fixture : public internal::Benchmark { + public: + Fixture() : internal::Benchmark("") {} + + virtual void Run(State& st) { + this->SetUp(st); + this->BenchmarkCase(st); + this->TearDown(st); + } + + // These will be deprecated ... + virtual void SetUp(const State&) {} + virtual void TearDown(const State&) {} + // ... In favor of these. + virtual void SetUp(State& st) { SetUp(const_cast(st)); } + virtual void TearDown(State& st) { TearDown(const_cast(st)); } + + protected: + virtual void BenchmarkCase(State&) = 0; +}; + +} // namespace benchmark + +// ------------------------------------------------------ +// Macro to register benchmarks + +// Check that __COUNTER__ is defined and that __COUNTER__ increases by 1 +// every time it is expanded. X + 1 == X + 0 is used in case X is defined to be +// empty. If X is empty the expression becomes (+1 == +0). +#if defined(__COUNTER__) && (__COUNTER__ + 1 == __COUNTER__ + 0) +#define BENCHMARK_PRIVATE_UNIQUE_ID __COUNTER__ +#else +#define BENCHMARK_PRIVATE_UNIQUE_ID __LINE__ +#endif + +// Helpers for generating unique variable names +#define BENCHMARK_PRIVATE_NAME(n) \ + BENCHMARK_PRIVATE_CONCAT(_benchmark_, BENCHMARK_PRIVATE_UNIQUE_ID, n) +#define BENCHMARK_PRIVATE_CONCAT(a, b, c) BENCHMARK_PRIVATE_CONCAT2(a, b, c) +#define BENCHMARK_PRIVATE_CONCAT2(a, b, c) a##b##c + +#define BENCHMARK_PRIVATE_DECLARE(n) \ + static ::benchmark::internal::Benchmark* BENCHMARK_PRIVATE_NAME(n) \ + BENCHMARK_UNUSED + +#define BENCHMARK(n) \ + BENCHMARK_PRIVATE_DECLARE(n) = \ + (::benchmark::internal::RegisterBenchmarkInternal( \ + new ::benchmark::internal::FunctionBenchmark(#n, n))) + +// Old-style macros +#define BENCHMARK_WITH_ARG(n, a) BENCHMARK(n)->Arg((a)) +#define BENCHMARK_WITH_ARG2(n, a1, a2) BENCHMARK(n)->Args({(a1), (a2)}) +#define BENCHMARK_WITH_UNIT(n, t) BENCHMARK(n)->Unit((t)) +#define BENCHMARK_RANGE(n, lo, hi) BENCHMARK(n)->Range((lo), (hi)) +#define BENCHMARK_RANGE2(n, l1, h1, l2, h2) \ + BENCHMARK(n)->RangePair({{(l1), (h1)}, {(l2), (h2)}}) + +#ifdef BENCHMARK_HAS_CXX11 + +// Register a benchmark which invokes the function specified by `func` +// with the additional arguments specified by `...`. +// +// For example: +// +// template ` +// void BM_takes_args(benchmark::State& state, ExtraArgs&&... extra_args) { +// [...] +//} +// /* Registers a benchmark named "BM_takes_args/int_string_test` */ +// BENCHMARK_CAPTURE(BM_takes_args, int_string_test, 42, std::string("abc")); +#define BENCHMARK_CAPTURE(func, test_case_name, ...) \ + BENCHMARK_PRIVATE_DECLARE(func) = \ + (::benchmark::internal::RegisterBenchmarkInternal( \ + new ::benchmark::internal::FunctionBenchmark( \ + #func "/" #test_case_name, \ + [](::benchmark::State& st) { func(st, __VA_ARGS__); }))) + +#endif // BENCHMARK_HAS_CXX11 + +// This will register a benchmark for a templatized function. For example: +// +// template +// void BM_Foo(int iters); +// +// BENCHMARK_TEMPLATE(BM_Foo, 1); +// +// will register BM_Foo<1> as a benchmark. +#define BENCHMARK_TEMPLATE1(n, a) \ + BENCHMARK_PRIVATE_DECLARE(n) = \ + (::benchmark::internal::RegisterBenchmarkInternal( \ + new ::benchmark::internal::FunctionBenchmark(#n "<" #a ">", n))) + +#define BENCHMARK_TEMPLATE2(n, a, b) \ + BENCHMARK_PRIVATE_DECLARE(n) = \ + (::benchmark::internal::RegisterBenchmarkInternal( \ + new ::benchmark::internal::FunctionBenchmark(#n "<" #a "," #b ">", \ + n))) + +#ifdef BENCHMARK_HAS_CXX11 +#define BENCHMARK_TEMPLATE(n, ...) \ + BENCHMARK_PRIVATE_DECLARE(n) = \ + (::benchmark::internal::RegisterBenchmarkInternal( \ + new ::benchmark::internal::FunctionBenchmark( \ + #n "<" #__VA_ARGS__ ">", n<__VA_ARGS__>))) +#else +#define BENCHMARK_TEMPLATE(n, a) BENCHMARK_TEMPLATE1(n, a) +#endif + +#define BENCHMARK_PRIVATE_DECLARE_F(BaseClass, Method) \ + class BaseClass##_##Method##_Benchmark : public BaseClass { \ + public: \ + BaseClass##_##Method##_Benchmark() : BaseClass() { \ + this->SetName(#BaseClass "/" #Method); \ + } \ + \ + protected: \ + virtual void BenchmarkCase(::benchmark::State&); \ + }; + +#define BENCHMARK_TEMPLATE1_PRIVATE_DECLARE_F(BaseClass, Method, a) \ + class BaseClass##_##Method##_Benchmark : public BaseClass { \ + public: \ + BaseClass##_##Method##_Benchmark() : BaseClass() { \ + this->SetName(#BaseClass"<" #a ">/" #Method); \ + } \ + \ + protected: \ + virtual void BenchmarkCase(::benchmark::State&); \ + }; + +#define BENCHMARK_TEMPLATE2_PRIVATE_DECLARE_F(BaseClass, Method, a, b) \ + class BaseClass##_##Method##_Benchmark : public BaseClass { \ + public: \ + BaseClass##_##Method##_Benchmark() : BaseClass() { \ + this->SetName(#BaseClass"<" #a "," #b ">/" #Method); \ + } \ + \ + protected: \ + virtual void BenchmarkCase(::benchmark::State&); \ + }; + +#ifdef BENCHMARK_HAS_CXX11 +#define BENCHMARK_TEMPLATE_PRIVATE_DECLARE_F(BaseClass, Method, ...) \ + class BaseClass##_##Method##_Benchmark : public BaseClass<__VA_ARGS__> { \ + public: \ + BaseClass##_##Method##_Benchmark() : BaseClass<__VA_ARGS__>() { \ + this->SetName(#BaseClass"<" #__VA_ARGS__ ">/" #Method); \ + } \ + \ + protected: \ + virtual void BenchmarkCase(::benchmark::State&); \ + }; +#else +#define BENCHMARK_TEMPLATE_PRIVATE_DECLARE_F(n, a) BENCHMARK_TEMPLATE1_PRIVATE_DECLARE_F(n, a) +#endif + +#define BENCHMARK_DEFINE_F(BaseClass, Method) \ + BENCHMARK_PRIVATE_DECLARE_F(BaseClass, Method) \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase + +#define BENCHMARK_TEMPLATE1_DEFINE_F(BaseClass, Method, a) \ + BENCHMARK_TEMPLATE1_PRIVATE_DECLARE_F(BaseClass, Method, a) \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase + +#define BENCHMARK_TEMPLATE2_DEFINE_F(BaseClass, Method, a, b) \ + BENCHMARK_TEMPLATE2_PRIVATE_DECLARE_F(BaseClass, Method, a, b) \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase + +#ifdef BENCHMARK_HAS_CXX11 +#define BENCHMARK_TEMPLATE_DEFINE_F(BaseClass, Method, ...) \ + BENCHMARK_TEMPLATE_PRIVATE_DECLARE_F(BaseClass, Method, __VA_ARGS__) \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase +#else +#define BENCHMARK_TEMPLATE_DEFINE_F(BaseClass, Method, a) BENCHMARK_TEMPLATE1_DEFINE_F(BaseClass, Method, a) +#endif + +#define BENCHMARK_REGISTER_F(BaseClass, Method) \ + BENCHMARK_PRIVATE_REGISTER_F(BaseClass##_##Method##_Benchmark) + +#define BENCHMARK_PRIVATE_REGISTER_F(TestName) \ + BENCHMARK_PRIVATE_DECLARE(TestName) = \ + (::benchmark::internal::RegisterBenchmarkInternal(new TestName())) + +// This macro will define and register a benchmark within a fixture class. +#define BENCHMARK_F(BaseClass, Method) \ + BENCHMARK_PRIVATE_DECLARE_F(BaseClass, Method) \ + BENCHMARK_REGISTER_F(BaseClass, Method); \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase + +#define BENCHMARK_TEMPLATE1_F(BaseClass, Method, a) \ + BENCHMARK_TEMPLATE1_PRIVATE_DECLARE_F(BaseClass, Method, a) \ + BENCHMARK_REGISTER_F(BaseClass, Method); \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase + +#define BENCHMARK_TEMPLATE2_F(BaseClass, Method, a, b) \ + BENCHMARK_TEMPLATE2_PRIVATE_DECLARE_F(BaseClass, Method, a, b) \ + BENCHMARK_REGISTER_F(BaseClass, Method); \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase + +#ifdef BENCHMARK_HAS_CXX11 +#define BENCHMARK_TEMPLATE_F(BaseClass, Method, ...) \ + BENCHMARK_TEMPLATE_PRIVATE_DECLARE_F(BaseClass, Method, __VA_ARGS__) \ + BENCHMARK_REGISTER_F(BaseClass, Method); \ + void BaseClass##_##Method##_Benchmark::BenchmarkCase +#else +#define BENCHMARK_TEMPLATE_F(BaseClass, Method, a) BENCHMARK_TEMPLATE1_F(BaseClass, Method, a) +#endif + +// Helper macro to create a main routine in a test that runs the benchmarks +#define BENCHMARK_MAIN() \ + int main(int argc, char** argv) { \ + ::benchmark::Initialize(&argc, argv); \ + if (::benchmark::ReportUnrecognizedArguments(argc, argv)) return 1; \ + ::benchmark::RunSpecifiedBenchmarks(); \ + } \ + int main(int, char**) + + +// ------------------------------------------------------ +// Benchmark Reporters + +namespace benchmark { + +struct CPUInfo { + struct CacheInfo { + std::string type; + int level; + int size; + int num_sharing; + }; + + int num_cpus; + double cycles_per_second; + std::vector caches; + bool scaling_enabled; + + static const CPUInfo& Get(); + + private: + CPUInfo(); + BENCHMARK_DISALLOW_COPY_AND_ASSIGN(CPUInfo); +}; + +// Interface for custom benchmark result printers. +// By default, benchmark reports are printed to stdout. However an application +// can control the destination of the reports by calling +// RunSpecifiedBenchmarks and passing it a custom reporter object. +// The reporter object must implement the following interface. +class BenchmarkReporter { + public: + struct Context { + CPUInfo const& cpu_info; + // The number of chars in the longest benchmark name. + size_t name_field_width; + static const char *executable_name; + Context(); + }; + + struct Run { + Run() + : error_occurred(false), + iterations(1), + time_unit(kNanosecond), + real_accumulated_time(0), + cpu_accumulated_time(0), + bytes_per_second(0), + items_per_second(0), + max_heapbytes_used(0), + complexity(oNone), + complexity_lambda(), + complexity_n(0), + report_big_o(false), + report_rms(false), + counters() {} + + std::string benchmark_name; + std::string report_label; // Empty if not set by benchmark. + bool error_occurred; + std::string error_message; + + int64_t iterations; + TimeUnit time_unit; + double real_accumulated_time; + double cpu_accumulated_time; + + // Return a value representing the real time per iteration in the unit + // specified by 'time_unit'. + // NOTE: If 'iterations' is zero the returned value represents the + // accumulated time. + double GetAdjustedRealTime() const; + + // Return a value representing the cpu time per iteration in the unit + // specified by 'time_unit'. + // NOTE: If 'iterations' is zero the returned value represents the + // accumulated time. + double GetAdjustedCPUTime() const; + + // Zero if not set by benchmark. + double bytes_per_second; + double items_per_second; + + // This is set to 0.0 if memory tracing is not enabled. + double max_heapbytes_used; + + // Keep track of arguments to compute asymptotic complexity + BigO complexity; + BigOFunc* complexity_lambda; + int64_t complexity_n; + + // what statistics to compute from the measurements + const std::vector* statistics; + + // Inform print function whether the current run is a complexity report + bool report_big_o; + bool report_rms; + + UserCounters counters; + }; + + // Construct a BenchmarkReporter with the output stream set to 'std::cout' + // and the error stream set to 'std::cerr' + BenchmarkReporter(); + + // Called once for every suite of benchmarks run. + // The parameter "context" contains information that the + // reporter may wish to use when generating its report, for example the + // platform under which the benchmarks are running. The benchmark run is + // never started if this function returns false, allowing the reporter + // to skip runs based on the context information. + virtual bool ReportContext(const Context& context) = 0; + + // Called once for each group of benchmark runs, gives information about + // cpu-time and heap memory usage during the benchmark run. If the group + // of runs contained more than two entries then 'report' contains additional + // elements representing the mean and standard deviation of those runs. + // Additionally if this group of runs was the last in a family of benchmarks + // 'reports' contains additional entries representing the asymptotic + // complexity and RMS of that benchmark family. + virtual void ReportRuns(const std::vector& report) = 0; + + // Called once and only once after ever group of benchmarks is run and + // reported. + virtual void Finalize() {} + + // REQUIRES: The object referenced by 'out' is valid for the lifetime + // of the reporter. + void SetOutputStream(std::ostream* out) { + assert(out); + output_stream_ = out; + } + + // REQUIRES: The object referenced by 'err' is valid for the lifetime + // of the reporter. + void SetErrorStream(std::ostream* err) { + assert(err); + error_stream_ = err; + } + + std::ostream& GetOutputStream() const { return *output_stream_; } + + std::ostream& GetErrorStream() const { return *error_stream_; } + + virtual ~BenchmarkReporter(); + + // Write a human readable string to 'out' representing the specified + // 'context'. + // REQUIRES: 'out' is non-null. + static void PrintBasicContext(std::ostream* out, Context const& context); + + private: + std::ostream* output_stream_; + std::ostream* error_stream_; +}; + +// Simple reporter that outputs benchmark data to the console. This is the +// default reporter used by RunSpecifiedBenchmarks(). +class ConsoleReporter : public BenchmarkReporter { +public: + enum OutputOptions { + OO_None = 0, + OO_Color = 1, + OO_Tabular = 2, + OO_ColorTabular = OO_Color|OO_Tabular, + OO_Defaults = OO_ColorTabular + }; + explicit ConsoleReporter(OutputOptions opts_ = OO_Defaults) + : output_options_(opts_), name_field_width_(0), + prev_counters_(), printed_header_(false) {} + + virtual bool ReportContext(const Context& context); + virtual void ReportRuns(const std::vector& reports); + + protected: + virtual void PrintRunData(const Run& report); + virtual void PrintHeader(const Run& report); + + OutputOptions output_options_; + size_t name_field_width_; + UserCounters prev_counters_; + bool printed_header_; +}; + +class JSONReporter : public BenchmarkReporter { + public: + JSONReporter() : first_report_(true) {} + virtual bool ReportContext(const Context& context); + virtual void ReportRuns(const std::vector& reports); + virtual void Finalize(); + + private: + void PrintRunData(const Run& report); + + bool first_report_; +}; + +class CSVReporter : public BenchmarkReporter { + public: + CSVReporter() : printed_header_(false) {} + virtual bool ReportContext(const Context& context); + virtual void ReportRuns(const std::vector& reports); + + private: + void PrintRunData(const Run& report); + + bool printed_header_; + std::set< std::string > user_counter_names_; +}; + +inline const char* GetTimeUnitString(TimeUnit unit) { + switch (unit) { + case kMillisecond: + return "ms"; + case kMicrosecond: + return "us"; + case kNanosecond: + default: + return "ns"; + } +} + +inline double GetTimeUnitMultiplier(TimeUnit unit) { + switch (unit) { + case kMillisecond: + return 1e3; + case kMicrosecond: + return 1e6; + case kNanosecond: + default: + return 1e9; + } +} + +} // namespace benchmark + +#endif // BENCHMARK_BENCHMARK_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/mingw.py b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/mingw.py new file mode 100755 index 00000000000..706ad559db9 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/mingw.py @@ -0,0 +1,320 @@ +#! /usr/bin/env python +# encoding: utf-8 + +import argparse +import errno +import logging +import os +import platform +import re +import sys +import subprocess +import tempfile + +try: + import winreg +except ImportError: + import _winreg as winreg +try: + import urllib.request as request +except ImportError: + import urllib as request +try: + import urllib.parse as parse +except ImportError: + import urlparse as parse + +class EmptyLogger(object): + ''' + Provides an implementation that performs no logging + ''' + def debug(self, *k, **kw): + pass + def info(self, *k, **kw): + pass + def warn(self, *k, **kw): + pass + def error(self, *k, **kw): + pass + def critical(self, *k, **kw): + pass + def setLevel(self, *k, **kw): + pass + +urls = ( + 'http://downloads.sourceforge.net/project/mingw-w64/Toolchains%20' + 'targetting%20Win32/Personal%20Builds/mingw-builds/installer/' + 'repository.txt', + 'http://downloads.sourceforge.net/project/mingwbuilds/host-windows/' + 'repository.txt' +) +''' +A list of mingw-build repositories +''' + +def repository(urls = urls, log = EmptyLogger()): + ''' + Downloads and parse mingw-build repository files and parses them + ''' + log.info('getting mingw-builds repository') + versions = {} + re_sourceforge = re.compile(r'http://sourceforge.net/projects/([^/]+)/files') + re_sub = r'http://downloads.sourceforge.net/project/\1' + for url in urls: + log.debug(' - requesting: %s', url) + socket = request.urlopen(url) + repo = socket.read() + if not isinstance(repo, str): + repo = repo.decode(); + socket.close() + for entry in repo.split('\n')[:-1]: + value = entry.split('|') + version = tuple([int(n) for n in value[0].strip().split('.')]) + version = versions.setdefault(version, {}) + arch = value[1].strip() + if arch == 'x32': + arch = 'i686' + elif arch == 'x64': + arch = 'x86_64' + arch = version.setdefault(arch, {}) + threading = arch.setdefault(value[2].strip(), {}) + exceptions = threading.setdefault(value[3].strip(), {}) + revision = exceptions.setdefault(int(value[4].strip()[3:]), + re_sourceforge.sub(re_sub, value[5].strip())) + return versions + +def find_in_path(file, path=None): + ''' + Attempts to find an executable in the path + ''' + if platform.system() == 'Windows': + file += '.exe' + if path is None: + path = os.environ.get('PATH', '') + if type(path) is type(''): + path = path.split(os.pathsep) + return list(filter(os.path.exists, + map(lambda dir, file=file: os.path.join(dir, file), path))) + +def find_7zip(log = EmptyLogger()): + ''' + Attempts to find 7zip for unpacking the mingw-build archives + ''' + log.info('finding 7zip') + path = find_in_path('7z') + if not path: + key = winreg.OpenKey(winreg.HKEY_LOCAL_MACHINE, r'SOFTWARE\7-Zip') + path, _ = winreg.QueryValueEx(key, 'Path') + path = [os.path.join(path, '7z.exe')] + log.debug('found \'%s\'', path[0]) + return path[0] + +find_7zip() + +def unpack(archive, location, log = EmptyLogger()): + ''' + Unpacks a mingw-builds archive + ''' + sevenzip = find_7zip(log) + log.info('unpacking %s', os.path.basename(archive)) + cmd = [sevenzip, 'x', archive, '-o' + location, '-y'] + log.debug(' - %r', cmd) + with open(os.devnull, 'w') as devnull: + subprocess.check_call(cmd, stdout = devnull) + +def download(url, location, log = EmptyLogger()): + ''' + Downloads and unpacks a mingw-builds archive + ''' + log.info('downloading MinGW') + log.debug(' - url: %s', url) + log.debug(' - location: %s', location) + + re_content = re.compile(r'attachment;[ \t]*filename=(")?([^"]*)(")?[\r\n]*') + + stream = request.urlopen(url) + try: + content = stream.getheader('Content-Disposition') or '' + except AttributeError: + content = stream.headers.getheader('Content-Disposition') or '' + matches = re_content.match(content) + if matches: + filename = matches.group(2) + else: + parsed = parse.urlparse(stream.geturl()) + filename = os.path.basename(parsed.path) + + try: + os.makedirs(location) + except OSError as e: + if e.errno == errno.EEXIST and os.path.isdir(location): + pass + else: + raise + + archive = os.path.join(location, filename) + with open(archive, 'wb') as out: + while True: + buf = stream.read(1024) + if not buf: + break + out.write(buf) + unpack(archive, location, log = log) + os.remove(archive) + + possible = os.path.join(location, 'mingw64') + if not os.path.exists(possible): + possible = os.path.join(location, 'mingw32') + if not os.path.exists(possible): + raise ValueError('Failed to find unpacked MinGW: ' + possible) + return possible + +def root(location = None, arch = None, version = None, threading = None, + exceptions = None, revision = None, log = EmptyLogger()): + ''' + Returns the root folder of a specific version of the mingw-builds variant + of gcc. Will download the compiler if needed + ''' + + # Get the repository if we don't have all the information + if not (arch and version and threading and exceptions and revision): + versions = repository(log = log) + + # Determine some defaults + version = version or max(versions.keys()) + if not arch: + arch = platform.machine().lower() + if arch == 'x86': + arch = 'i686' + elif arch == 'amd64': + arch = 'x86_64' + if not threading: + keys = versions[version][arch].keys() + if 'posix' in keys: + threading = 'posix' + elif 'win32' in keys: + threading = 'win32' + else: + threading = keys[0] + if not exceptions: + keys = versions[version][arch][threading].keys() + if 'seh' in keys: + exceptions = 'seh' + elif 'sjlj' in keys: + exceptions = 'sjlj' + else: + exceptions = keys[0] + if revision == None: + revision = max(versions[version][arch][threading][exceptions].keys()) + if not location: + location = os.path.join(tempfile.gettempdir(), 'mingw-builds') + + # Get the download url + url = versions[version][arch][threading][exceptions][revision] + + # Tell the user whatzzup + log.info('finding MinGW %s', '.'.join(str(v) for v in version)) + log.debug(' - arch: %s', arch) + log.debug(' - threading: %s', threading) + log.debug(' - exceptions: %s', exceptions) + log.debug(' - revision: %s', revision) + log.debug(' - url: %s', url) + + # Store each specific revision differently + slug = '{version}-{arch}-{threading}-{exceptions}-rev{revision}' + slug = slug.format( + version = '.'.join(str(v) for v in version), + arch = arch, + threading = threading, + exceptions = exceptions, + revision = revision + ) + if arch == 'x86_64': + root_dir = os.path.join(location, slug, 'mingw64') + elif arch == 'i686': + root_dir = os.path.join(location, slug, 'mingw32') + else: + raise ValueError('Unknown MinGW arch: ' + arch) + + # Download if needed + if not os.path.exists(root_dir): + downloaded = download(url, os.path.join(location, slug), log = log) + if downloaded != root_dir: + raise ValueError('The location of mingw did not match\n%s\n%s' + % (downloaded, root_dir)) + + return root_dir + +def str2ver(string): + ''' + Converts a version string into a tuple + ''' + try: + version = tuple(int(v) for v in string.split('.')) + if len(version) is not 3: + raise ValueError() + except ValueError: + raise argparse.ArgumentTypeError( + 'please provide a three digit version string') + return version + +def main(): + ''' + Invoked when the script is run directly by the python interpreter + ''' + parser = argparse.ArgumentParser( + description = 'Downloads a specific version of MinGW', + formatter_class = argparse.ArgumentDefaultsHelpFormatter + ) + parser.add_argument('--location', + help = 'the location to download the compiler to', + default = os.path.join(tempfile.gettempdir(), 'mingw-builds')) + parser.add_argument('--arch', required = True, choices = ['i686', 'x86_64'], + help = 'the target MinGW architecture string') + parser.add_argument('--version', type = str2ver, + help = 'the version of GCC to download') + parser.add_argument('--threading', choices = ['posix', 'win32'], + help = 'the threading type of the compiler') + parser.add_argument('--exceptions', choices = ['sjlj', 'seh', 'dwarf'], + help = 'the method to throw exceptions') + parser.add_argument('--revision', type=int, + help = 'the revision of the MinGW release') + group = parser.add_mutually_exclusive_group() + group.add_argument('-v', '--verbose', action='store_true', + help='increase the script output verbosity') + group.add_argument('-q', '--quiet', action='store_true', + help='only print errors and warning') + args = parser.parse_args() + + # Create the logger + logger = logging.getLogger('mingw') + handler = logging.StreamHandler() + formatter = logging.Formatter('%(message)s') + handler.setFormatter(formatter) + logger.addHandler(handler) + logger.setLevel(logging.INFO) + if args.quiet: + logger.setLevel(logging.WARN) + if args.verbose: + logger.setLevel(logging.DEBUG) + + # Get MinGW + root_dir = root(location = args.location, arch = args.arch, + version = args.version, threading = args.threading, + exceptions = args.exceptions, revision = args.revision, + log = logger) + + sys.stdout.write('%s\n' % os.path.join(root_dir, 'bin')) + +if __name__ == '__main__': + try: + main() + except IOError as e: + sys.stderr.write('IO error: %s\n' % e) + sys.exit(1) + except OSError as e: + sys.stderr.write('OS error: %s\n' % e) + sys.exit(1) + except KeyboardInterrupt as e: + sys.stderr.write('Killed\n') + sys.exit(1) diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/releasing.md b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/releasing.md new file mode 100755 index 00000000000..f0cd7010e3a --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/releasing.md @@ -0,0 +1,16 @@ +# How to release + +* Make sure you're on master and synced to HEAD +* Ensure the project builds and tests run (sanity check only, obviously) + * `parallel -j0 exec ::: test/*_test` can help ensure everything at least + passes +* Prepare release notes + * `git log $(git describe --abbrev=0 --tags)..HEAD` gives you the list of + commits between the last annotated tag and HEAD + * Pick the most interesting. +* Create a release through github's interface + * Note this will create a lightweight tag. + * Update this to an annotated tag: + * `git pull --tags` + * `git tag -a -f ` + * `git push --force origin` diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/CMakeLists.txt b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/CMakeLists.txt new file mode 100755 index 00000000000..701804ba0e0 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/CMakeLists.txt @@ -0,0 +1,105 @@ +# Allow the source files to find headers in src/ +include_directories(${PROJECT_SOURCE_DIR}/src) + +if (DEFINED BENCHMARK_CXX_LINKER_FLAGS) + list(APPEND CMAKE_SHARED_LINKER_FLAGS ${BENCHMARK_CXX_LINKER_FLAGS}) + list(APPEND CMAKE_MODULE_LINKER_FLAGS ${BENCHMARK_CXX_LINKER_FLAGS}) +endif() + +file(GLOB + SOURCE_FILES + *.cc + ${PROJECT_SOURCE_DIR}/include/benchmark/*.h + ${CMAKE_CURRENT_SOURCE_DIR}/*.h) +list(FILTER SOURCE_FILES EXCLUDE REGEX "benchmark_main\\.cc") + +add_library(benchmark ${SOURCE_FILES}) +set_target_properties(benchmark PROPERTIES + OUTPUT_NAME "benchmark" + VERSION ${GENERIC_LIB_VERSION} + SOVERSION ${GENERIC_LIB_SOVERSION} +) +target_include_directories(benchmark PUBLIC + $ + ) + +# Link threads. +target_link_libraries(benchmark ${BENCHMARK_CXX_LIBRARIES} ${CMAKE_THREAD_LIBS_INIT}) +find_library(LIBRT rt) +if(LIBRT) + target_link_libraries(benchmark ${LIBRT}) +endif() + +# We need extra libraries on Windows +if(${CMAKE_SYSTEM_NAME} MATCHES "Windows") + target_link_libraries(benchmark Shlwapi) +endif() + +# We need extra libraries on Solaris +if(${CMAKE_SYSTEM_NAME} MATCHES "SunOS") + target_link_libraries(benchmark kstat) +endif() + +# Benchmark main library +add_library(benchmark_main "benchmark_main.cc") +set_target_properties(benchmark_main PROPERTIES + OUTPUT_NAME "benchmark_main" + VERSION ${GENERIC_LIB_VERSION} + SOVERSION ${GENERIC_LIB_SOVERSION} +) +target_include_directories(benchmark PUBLIC + $ + ) +target_link_libraries(benchmark_main benchmark) + +set(include_install_dir "include") +set(lib_install_dir "lib/") +set(bin_install_dir "bin/") +set(config_install_dir "lib/cmake/${PROJECT_NAME}") +set(pkgconfig_install_dir "lib/pkgconfig") + +set(generated_dir "${CMAKE_CURRENT_BINARY_DIR}/generated") + +set(version_config "${generated_dir}/${PROJECT_NAME}ConfigVersion.cmake") +set(project_config "${generated_dir}/${PROJECT_NAME}Config.cmake") +set(pkg_config "${generated_dir}/${PROJECT_NAME}.pc") +set(targets_export_name "${PROJECT_NAME}Targets") + +set(namespace "${PROJECT_NAME}::") + +include(CMakePackageConfigHelpers) +write_basic_package_version_file( + "${version_config}" VERSION ${GIT_VERSION} COMPATIBILITY SameMajorVersion +) + +configure_file("${PROJECT_SOURCE_DIR}/cmake/Config.cmake.in" "${project_config}" @ONLY) +configure_file("${PROJECT_SOURCE_DIR}/cmake/benchmark.pc.in" "${pkg_config}" @ONLY) + +if (BENCHMARK_ENABLE_INSTALL) + # Install target (will install the library to specified CMAKE_INSTALL_PREFIX variable) + install( + TARGETS benchmark benchmark_main + EXPORT ${targets_export_name} + ARCHIVE DESTINATION ${lib_install_dir} + LIBRARY DESTINATION ${lib_install_dir} + RUNTIME DESTINATION ${bin_install_dir} + INCLUDES DESTINATION ${include_install_dir}) + + install( + DIRECTORY "${PROJECT_SOURCE_DIR}/include/benchmark" + DESTINATION ${include_install_dir} + FILES_MATCHING PATTERN "*.*h") + + install( + FILES "${project_config}" "${version_config}" + DESTINATION "${config_install_dir}") + + install( + FILES "${pkg_config}" + DESTINATION "${pkgconfig_install_dir}") + + install( + EXPORT "${targets_export_name}" + NAMESPACE "${namespace}" + DESTINATION "${config_install_dir}") +endif() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/arraysize.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/arraysize.h new file mode 100755 index 00000000000..51a50f2dff2 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/arraysize.h @@ -0,0 +1,33 @@ +#ifndef BENCHMARK_ARRAYSIZE_H_ +#define BENCHMARK_ARRAYSIZE_H_ + +#include "internal_macros.h" + +namespace benchmark { +namespace internal { +// The arraysize(arr) macro returns the # of elements in an array arr. +// The expression is a compile-time constant, and therefore can be +// used in defining new arrays, for example. If you use arraysize on +// a pointer by mistake, you will get a compile-time error. +// + +// This template function declaration is used in defining arraysize. +// Note that the function doesn't need an implementation, as we only +// use its type. +template +char (&ArraySizeHelper(T (&array)[N]))[N]; + +// That gcc wants both of these prototypes seems mysterious. VC, for +// its part, can't decide which to use (another mystery). Matching of +// template overloads: the final frontier. +#ifndef COMPILER_MSVC +template +char (&ArraySizeHelper(const T (&array)[N]))[N]; +#endif + +#define arraysize(array) (sizeof(::benchmark::internal::ArraySizeHelper(array))) + +} // end namespace internal +} // end namespace benchmark + +#endif // BENCHMARK_ARRAYSIZE_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark.cc new file mode 100755 index 00000000000..82b15ac7090 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark.cc @@ -0,0 +1,630 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" +#include "benchmark_api_internal.h" +#include "internal_macros.h" + +#ifndef BENCHMARK_OS_WINDOWS +#ifndef BENCHMARK_OS_FUCHSIA +#include +#endif +#include +#include +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "check.h" +#include "colorprint.h" +#include "commandlineflags.h" +#include "complexity.h" +#include "counter.h" +#include "internal_macros.h" +#include "log.h" +#include "mutex.h" +#include "re.h" +#include "statistics.h" +#include "string_util.h" +#include "thread_manager.h" +#include "thread_timer.h" + +DEFINE_bool(benchmark_list_tests, false, + "Print a list of benchmarks. This option overrides all other " + "options."); + +DEFINE_string(benchmark_filter, ".", + "A regular expression that specifies the set of benchmarks " + "to execute. If this flag is empty, no benchmarks are run. " + "If this flag is the string \"all\", all benchmarks linked " + "into the process are run."); + +DEFINE_double(benchmark_min_time, 0.5, + "Minimum number of seconds we should run benchmark before " + "results are considered significant. For cpu-time based " + "tests, this is the lower bound on the total cpu time " + "used by all threads that make up the test. For real-time " + "based tests, this is the lower bound on the elapsed time " + "of the benchmark execution, regardless of number of " + "threads."); + +DEFINE_int32(benchmark_repetitions, 1, + "The number of runs of each benchmark. If greater than 1, the " + "mean and standard deviation of the runs will be reported."); + +DEFINE_bool(benchmark_report_aggregates_only, false, + "Report the result of each benchmark repetitions. When 'true' is " + "specified only the mean, standard deviation, and other statistics " + "are reported for repeated benchmarks."); + +DEFINE_string(benchmark_format, "console", + "The format to use for console output. Valid values are " + "'console', 'json', or 'csv'."); + +DEFINE_string(benchmark_out_format, "json", + "The format to use for file output. Valid values are " + "'console', 'json', or 'csv'."); + +DEFINE_string(benchmark_out, "", "The file to write additional output to"); + +DEFINE_string(benchmark_color, "auto", + "Whether to use colors in the output. Valid values: " + "'true'/'yes'/1, 'false'/'no'/0, and 'auto'. 'auto' means to use " + "colors if the output is being sent to a terminal and the TERM " + "environment variable is set to a terminal type that supports " + "colors."); + +DEFINE_bool(benchmark_counters_tabular, false, + "Whether to use tabular format when printing user counters to " + "the console. Valid values: 'true'/'yes'/1, 'false'/'no'/0." + "Defaults to false."); + +DEFINE_int32(v, 0, "The level of verbose logging to output"); + +namespace benchmark { + +namespace { +static const size_t kMaxIterations = 1000000000; +} // end namespace + +namespace internal { + +void UseCharPointer(char const volatile*) {} + +namespace { + +BenchmarkReporter::Run CreateRunReport( + const benchmark::internal::Benchmark::Instance& b, + const internal::ThreadManager::Result& results, + double seconds) { + // Create report about this benchmark run. + BenchmarkReporter::Run report; + + report.benchmark_name = b.name; + report.error_occurred = results.has_error_; + report.error_message = results.error_message_; + report.report_label = results.report_label_; + // This is the total iterations across all threads. + report.iterations = results.iterations; + report.time_unit = b.time_unit; + + if (!report.error_occurred) { + double bytes_per_second = 0; + if (results.bytes_processed > 0 && seconds > 0.0) { + bytes_per_second = (results.bytes_processed / seconds); + } + double items_per_second = 0; + if (results.items_processed > 0 && seconds > 0.0) { + items_per_second = (results.items_processed / seconds); + } + + if (b.use_manual_time) { + report.real_accumulated_time = results.manual_time_used; + } else { + report.real_accumulated_time = results.real_time_used; + } + report.cpu_accumulated_time = results.cpu_time_used; + report.bytes_per_second = bytes_per_second; + report.items_per_second = items_per_second; + report.complexity_n = results.complexity_n; + report.complexity = b.complexity; + report.complexity_lambda = b.complexity_lambda; + report.statistics = b.statistics; + report.counters = results.counters; + internal::Finish(&report.counters, seconds, b.threads); + } + return report; +} + +// Execute one thread of benchmark b for the specified number of iterations. +// Adds the stats collected for the thread into *total. +void RunInThread(const benchmark::internal::Benchmark::Instance* b, + size_t iters, int thread_id, + internal::ThreadManager* manager) { + internal::ThreadTimer timer; + State st(iters, b->arg, thread_id, b->threads, &timer, manager); + b->benchmark->Run(st); + CHECK(st.iterations() >= st.max_iterations) + << "Benchmark returned before State::KeepRunning() returned false!"; + { + MutexLock l(manager->GetBenchmarkMutex()); + internal::ThreadManager::Result& results = manager->results; + results.iterations += st.iterations(); + results.cpu_time_used += timer.cpu_time_used(); + results.real_time_used += timer.real_time_used(); + results.manual_time_used += timer.manual_time_used(); + results.bytes_processed += st.bytes_processed(); + results.items_processed += st.items_processed(); + results.complexity_n += st.complexity_length_n(); + internal::Increment(&results.counters, st.counters); + } + manager->NotifyThreadComplete(); +} + +std::vector RunBenchmark( + const benchmark::internal::Benchmark::Instance& b, + std::vector* complexity_reports) { + std::vector reports; // return value + + const bool has_explicit_iteration_count = b.iterations != 0; + size_t iters = has_explicit_iteration_count ? b.iterations : 1; + std::unique_ptr manager; + std::vector pool(b.threads - 1); + const int repeats = + b.repetitions != 0 ? b.repetitions : FLAGS_benchmark_repetitions; + const bool report_aggregates_only = + repeats != 1 && + (b.report_mode == internal::RM_Unspecified + ? FLAGS_benchmark_report_aggregates_only + : b.report_mode == internal::RM_ReportAggregatesOnly); + for (int repetition_num = 0; repetition_num < repeats; repetition_num++) { + for (;;) { + // Try benchmark + VLOG(2) << "Running " << b.name << " for " << iters << "\n"; + + manager.reset(new internal::ThreadManager(b.threads)); + for (std::size_t ti = 0; ti < pool.size(); ++ti) { + pool[ti] = std::thread(&RunInThread, &b, iters, + static_cast(ti + 1), manager.get()); + } + RunInThread(&b, iters, 0, manager.get()); + manager->WaitForAllThreads(); + for (std::thread& thread : pool) thread.join(); + internal::ThreadManager::Result results; + { + MutexLock l(manager->GetBenchmarkMutex()); + results = manager->results; + } + manager.reset(); + // Adjust real/manual time stats since they were reported per thread. + results.real_time_used /= b.threads; + results.manual_time_used /= b.threads; + + VLOG(2) << "Ran in " << results.cpu_time_used << "/" + << results.real_time_used << "\n"; + + // Base decisions off of real time if requested by this benchmark. + double seconds = results.cpu_time_used; + if (b.use_manual_time) { + seconds = results.manual_time_used; + } else if (b.use_real_time) { + seconds = results.real_time_used; + } + + const double min_time = + !IsZero(b.min_time) ? b.min_time : FLAGS_benchmark_min_time; + + // Determine if this run should be reported; Either it has + // run for a sufficient amount of time or because an error was reported. + const bool should_report = repetition_num > 0 + || has_explicit_iteration_count // An exact iteration count was requested + || results.has_error_ + || iters >= kMaxIterations // No chance to try again, we hit the limit. + || seconds >= min_time // the elapsed time is large enough + // CPU time is specified but the elapsed real time greatly exceeds the + // minimum time. Note that user provided timers are except from this + // sanity check. + || ((results.real_time_used >= 5 * min_time) && !b.use_manual_time); + + if (should_report) { + BenchmarkReporter::Run report = CreateRunReport(b, results, seconds); + if (!report.error_occurred && b.complexity != oNone) + complexity_reports->push_back(report); + reports.push_back(report); + break; + } + + // See how much iterations should be increased by + // Note: Avoid division by zero with max(seconds, 1ns). + double multiplier = min_time * 1.4 / std::max(seconds, 1e-9); + // If our last run was at least 10% of FLAGS_benchmark_min_time then we + // use the multiplier directly. Otherwise we use at most 10 times + // expansion. + // NOTE: When the last run was at least 10% of the min time the max + // expansion should be 14x. + bool is_significant = (seconds / min_time) > 0.1; + multiplier = is_significant ? multiplier : std::min(10.0, multiplier); + if (multiplier <= 1.0) multiplier = 2.0; + double next_iters = std::max(multiplier * iters, iters + 1.0); + if (next_iters > kMaxIterations) { + next_iters = kMaxIterations; + } + VLOG(3) << "Next iters: " << next_iters << ", " << multiplier << "\n"; + iters = static_cast(next_iters + 0.5); + } + } + // Calculate additional statistics + auto stat_reports = ComputeStats(reports); + if ((b.complexity != oNone) && b.last_benchmark_instance) { + auto additional_run_stats = ComputeBigO(*complexity_reports); + stat_reports.insert(stat_reports.end(), additional_run_stats.begin(), + additional_run_stats.end()); + complexity_reports->clear(); + } + + if (report_aggregates_only) reports.clear(); + reports.insert(reports.end(), stat_reports.begin(), stat_reports.end()); + return reports; +} + +} // namespace +} // namespace internal + +State::State(size_t max_iters, const std::vector& ranges, int thread_i, + int n_threads, internal::ThreadTimer* timer, + internal::ThreadManager* manager) + : total_iterations_(0), + batch_leftover_(0), + max_iterations(max_iters), + started_(false), + finished_(false), + error_occurred_(false), + range_(ranges), + bytes_processed_(0), + items_processed_(0), + complexity_n_(0), + counters(), + thread_index(thread_i), + threads(n_threads), + timer_(timer), + manager_(manager) { + CHECK(max_iterations != 0) << "At least one iteration must be run"; + CHECK_LT(thread_index, threads) << "thread_index must be less than threads"; + + // Note: The use of offsetof below is technically undefined until C++17 + // because State is not a standard layout type. However, all compilers + // currently provide well-defined behavior as an extension (which is + // demonstrated since constexpr evaluation must diagnose all undefined + // behavior). However, GCC and Clang also warn about this use of offsetof, + // which must be suppressed. +#ifdef __GNUC__ +#pragma GCC diagnostic push +#pragma GCC diagnostic ignored "-Winvalid-offsetof" +#endif + // Offset tests to ensure commonly accessed data is on the first cache line. + const int cache_line_size = 64; + static_assert(offsetof(State, error_occurred_) <= + (cache_line_size - sizeof(error_occurred_)), ""); +#ifdef __GNUC__ +#pragma GCC diagnostic pop +#endif +} + +void State::PauseTiming() { + // Add in time accumulated so far + CHECK(started_ && !finished_ && !error_occurred_); + timer_->StopTimer(); +} + +void State::ResumeTiming() { + CHECK(started_ && !finished_ && !error_occurred_); + timer_->StartTimer(); +} + +void State::SkipWithError(const char* msg) { + CHECK(msg); + error_occurred_ = true; + { + MutexLock l(manager_->GetBenchmarkMutex()); + if (manager_->results.has_error_ == false) { + manager_->results.error_message_ = msg; + manager_->results.has_error_ = true; + } + } + total_iterations_ = 0; + if (timer_->running()) timer_->StopTimer(); +} + +void State::SetIterationTime(double seconds) { + timer_->SetIterationTime(seconds); +} + +void State::SetLabel(const char* label) { + MutexLock l(manager_->GetBenchmarkMutex()); + manager_->results.report_label_ = label; +} + +void State::StartKeepRunning() { + CHECK(!started_ && !finished_); + started_ = true; + total_iterations_ = error_occurred_ ? 0 : max_iterations; + manager_->StartStopBarrier(); + if (!error_occurred_) ResumeTiming(); +} + +void State::FinishKeepRunning() { + CHECK(started_ && (!finished_ || error_occurred_)); + if (!error_occurred_) { + PauseTiming(); + } + // Total iterations has now wrapped around past 0. Fix this. + total_iterations_ = 0; + finished_ = true; + manager_->StartStopBarrier(); +} + +namespace internal { +namespace { + +void RunBenchmarks(const std::vector& benchmarks, + BenchmarkReporter* console_reporter, + BenchmarkReporter* file_reporter) { + // Note the file_reporter can be null. + CHECK(console_reporter != nullptr); + + // Determine the width of the name field using a minimum width of 10. + bool has_repetitions = FLAGS_benchmark_repetitions > 1; + size_t name_field_width = 10; + size_t stat_field_width = 0; + for (const Benchmark::Instance& benchmark : benchmarks) { + name_field_width = + std::max(name_field_width, benchmark.name.size()); + has_repetitions |= benchmark.repetitions > 1; + + for(const auto& Stat : *benchmark.statistics) + stat_field_width = std::max(stat_field_width, Stat.name_.size()); + } + if (has_repetitions) name_field_width += 1 + stat_field_width; + + // Print header here + BenchmarkReporter::Context context; + context.name_field_width = name_field_width; + + // Keep track of running times of all instances of current benchmark + std::vector complexity_reports; + + // We flush streams after invoking reporter methods that write to them. This + // ensures users get timely updates even when streams are not line-buffered. + auto flushStreams = [](BenchmarkReporter* reporter) { + if (!reporter) return; + std::flush(reporter->GetOutputStream()); + std::flush(reporter->GetErrorStream()); + }; + + if (console_reporter->ReportContext(context) && + (!file_reporter || file_reporter->ReportContext(context))) { + flushStreams(console_reporter); + flushStreams(file_reporter); + for (const auto& benchmark : benchmarks) { + std::vector reports = + RunBenchmark(benchmark, &complexity_reports); + console_reporter->ReportRuns(reports); + if (file_reporter) file_reporter->ReportRuns(reports); + flushStreams(console_reporter); + flushStreams(file_reporter); + } + } + console_reporter->Finalize(); + if (file_reporter) file_reporter->Finalize(); + flushStreams(console_reporter); + flushStreams(file_reporter); +} + +std::unique_ptr CreateReporter( + std::string const& name, ConsoleReporter::OutputOptions output_opts) { + typedef std::unique_ptr PtrType; + if (name == "console") { + return PtrType(new ConsoleReporter(output_opts)); + } else if (name == "json") { + return PtrType(new JSONReporter); + } else if (name == "csv") { + return PtrType(new CSVReporter); + } else { + std::cerr << "Unexpected format: '" << name << "'\n"; + std::exit(1); + } +} + +} // end namespace + +bool IsZero(double n) { + return std::abs(n) < std::numeric_limits::epsilon(); +} + +ConsoleReporter::OutputOptions GetOutputOptions(bool force_no_color) { + int output_opts = ConsoleReporter::OO_Defaults; + if ((FLAGS_benchmark_color == "auto" && IsColorTerminal()) || + IsTruthyFlagValue(FLAGS_benchmark_color)) { + output_opts |= ConsoleReporter::OO_Color; + } else { + output_opts &= ~ConsoleReporter::OO_Color; + } + if(force_no_color) { + output_opts &= ~ConsoleReporter::OO_Color; + } + if(FLAGS_benchmark_counters_tabular) { + output_opts |= ConsoleReporter::OO_Tabular; + } else { + output_opts &= ~ConsoleReporter::OO_Tabular; + } + return static_cast< ConsoleReporter::OutputOptions >(output_opts); +} + +} // end namespace internal + +size_t RunSpecifiedBenchmarks() { + return RunSpecifiedBenchmarks(nullptr, nullptr); +} + +size_t RunSpecifiedBenchmarks(BenchmarkReporter* console_reporter) { + return RunSpecifiedBenchmarks(console_reporter, nullptr); +} + +size_t RunSpecifiedBenchmarks(BenchmarkReporter* console_reporter, + BenchmarkReporter* file_reporter) { + std::string spec = FLAGS_benchmark_filter; + if (spec.empty() || spec == "all") + spec = "."; // Regexp that matches all benchmarks + + // Setup the reporters + std::ofstream output_file; + std::unique_ptr default_console_reporter; + std::unique_ptr default_file_reporter; + if (!console_reporter) { + default_console_reporter = internal::CreateReporter( + FLAGS_benchmark_format, internal::GetOutputOptions()); + console_reporter = default_console_reporter.get(); + } + auto& Out = console_reporter->GetOutputStream(); + auto& Err = console_reporter->GetErrorStream(); + + std::string const& fname = FLAGS_benchmark_out; + if (fname.empty() && file_reporter) { + Err << "A custom file reporter was provided but " + "--benchmark_out= was not specified." + << std::endl; + std::exit(1); + } + if (!fname.empty()) { + output_file.open(fname); + if (!output_file.is_open()) { + Err << "invalid file name: '" << fname << std::endl; + std::exit(1); + } + if (!file_reporter) { + default_file_reporter = internal::CreateReporter( + FLAGS_benchmark_out_format, ConsoleReporter::OO_None); + file_reporter = default_file_reporter.get(); + } + file_reporter->SetOutputStream(&output_file); + file_reporter->SetErrorStream(&output_file); + } + + std::vector benchmarks; + if (!FindBenchmarksInternal(spec, &benchmarks, &Err)) return 0; + + if (benchmarks.empty()) { + Err << "Failed to match any benchmarks against regex: " << spec << "\n"; + return 0; + } + + if (FLAGS_benchmark_list_tests) { + for (auto const& benchmark : benchmarks) Out << benchmark.name << "\n"; + } else { + internal::RunBenchmarks(benchmarks, console_reporter, file_reporter); + } + + return benchmarks.size(); +} + +namespace internal { + +void PrintUsageAndExit() { + fprintf(stdout, + "benchmark" + " [--benchmark_list_tests={true|false}]\n" + " [--benchmark_filter=]\n" + " [--benchmark_min_time=]\n" + " [--benchmark_repetitions=]\n" + " [--benchmark_report_aggregates_only={true|false}\n" + " [--benchmark_format=]\n" + " [--benchmark_out=]\n" + " [--benchmark_out_format=]\n" + " [--benchmark_color={auto|true|false}]\n" + " [--benchmark_counters_tabular={true|false}]\n" + " [--v=]\n"); + exit(0); +} + +void ParseCommandLineFlags(int* argc, char** argv) { + using namespace benchmark; + BenchmarkReporter::Context::executable_name = argv[0]; + for (int i = 1; i < *argc; ++i) { + if (ParseBoolFlag(argv[i], "benchmark_list_tests", + &FLAGS_benchmark_list_tests) || + ParseStringFlag(argv[i], "benchmark_filter", &FLAGS_benchmark_filter) || + ParseDoubleFlag(argv[i], "benchmark_min_time", + &FLAGS_benchmark_min_time) || + ParseInt32Flag(argv[i], "benchmark_repetitions", + &FLAGS_benchmark_repetitions) || + ParseBoolFlag(argv[i], "benchmark_report_aggregates_only", + &FLAGS_benchmark_report_aggregates_only) || + ParseStringFlag(argv[i], "benchmark_format", &FLAGS_benchmark_format) || + ParseStringFlag(argv[i], "benchmark_out", &FLAGS_benchmark_out) || + ParseStringFlag(argv[i], "benchmark_out_format", + &FLAGS_benchmark_out_format) || + ParseStringFlag(argv[i], "benchmark_color", &FLAGS_benchmark_color) || + // "color_print" is the deprecated name for "benchmark_color". + // TODO: Remove this. + ParseStringFlag(argv[i], "color_print", &FLAGS_benchmark_color) || + ParseBoolFlag(argv[i], "benchmark_counters_tabular", + &FLAGS_benchmark_counters_tabular) || + ParseInt32Flag(argv[i], "v", &FLAGS_v)) { + for (int j = i; j != *argc - 1; ++j) argv[j] = argv[j + 1]; + + --(*argc); + --i; + } else if (IsFlag(argv[i], "help")) { + PrintUsageAndExit(); + } + } + for (auto const* flag : + {&FLAGS_benchmark_format, &FLAGS_benchmark_out_format}) + if (*flag != "console" && *flag != "json" && *flag != "csv") { + PrintUsageAndExit(); + } + if (FLAGS_benchmark_color.empty()) { + PrintUsageAndExit(); + } +} + +int InitializeStreams() { + static std::ios_base::Init init; + return 0; +} + +} // end namespace internal + +void Initialize(int* argc, char** argv) { + internal::ParseCommandLineFlags(argc, argv); + internal::LogLevel() = FLAGS_v; +} + +bool ReportUnrecognizedArguments(int argc, char** argv) { + for (int i = 1; i < argc; ++i) { + fprintf(stderr, "%s: error: unrecognized command-line flag: %s\n", argv[0], argv[i]); + } + return argc > 1; +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_api_internal.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_api_internal.h new file mode 100755 index 00000000000..dd7a3ffe8cb --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_api_internal.h @@ -0,0 +1,47 @@ +#ifndef BENCHMARK_API_INTERNAL_H +#define BENCHMARK_API_INTERNAL_H + +#include "benchmark/benchmark.h" + +#include +#include +#include +#include +#include + +namespace benchmark { +namespace internal { + +// Information kept per benchmark we may want to run +struct Benchmark::Instance { + std::string name; + Benchmark* benchmark; + ReportMode report_mode; + std::vector arg; + TimeUnit time_unit; + int range_multiplier; + bool use_real_time; + bool use_manual_time; + BigO complexity; + BigOFunc* complexity_lambda; + UserCounters counters; + const std::vector* statistics; + bool last_benchmark_instance; + int repetitions; + double min_time; + size_t iterations; + int threads; // Number of concurrent threads to us +}; + +bool FindBenchmarksInternal(const std::string& re, + std::vector* benchmarks, + std::ostream* Err); + +bool IsZero(double n); + +ConsoleReporter::OutputOptions GetOutputOptions(bool force_no_color = false); + +} // end namespace internal +} // end namespace benchmark + +#endif // BENCHMARK_API_INTERNAL_H diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_main.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_main.cc new file mode 100755 index 00000000000..b3b24783149 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_main.cc @@ -0,0 +1,17 @@ +// Copyright 2018 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" + +BENCHMARK_MAIN(); diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.cc new file mode 100755 index 00000000000..dc6f9356853 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.cc @@ -0,0 +1,461 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark_register.h" + +#ifndef BENCHMARK_OS_WINDOWS +#ifndef BENCHMARK_OS_FUCHSIA +#include +#endif +#include +#include +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "benchmark/benchmark.h" +#include "benchmark_api_internal.h" +#include "check.h" +#include "commandlineflags.h" +#include "complexity.h" +#include "internal_macros.h" +#include "log.h" +#include "mutex.h" +#include "re.h" +#include "statistics.h" +#include "string_util.h" +#include "timers.h" + +namespace benchmark { + +namespace { +// For non-dense Range, intermediate values are powers of kRangeMultiplier. +static const int kRangeMultiplier = 8; +// The size of a benchmark family determines is the number of inputs to repeat +// the benchmark on. If this is "large" then warn the user during configuration. +static const size_t kMaxFamilySize = 100; +} // end namespace + +namespace internal { + +//=============================================================================// +// BenchmarkFamilies +//=============================================================================// + +// Class for managing registered benchmarks. Note that each registered +// benchmark identifies a family of related benchmarks to run. +class BenchmarkFamilies { + public: + static BenchmarkFamilies* GetInstance(); + + // Registers a benchmark family and returns the index assigned to it. + size_t AddBenchmark(std::unique_ptr family); + + // Clear all registered benchmark families. + void ClearBenchmarks(); + + // Extract the list of benchmark instances that match the specified + // regular expression. + bool FindBenchmarks(std::string re, + std::vector* benchmarks, + std::ostream* Err); + + private: + BenchmarkFamilies() {} + + std::vector> families_; + Mutex mutex_; +}; + +BenchmarkFamilies* BenchmarkFamilies::GetInstance() { + static BenchmarkFamilies instance; + return &instance; +} + +size_t BenchmarkFamilies::AddBenchmark(std::unique_ptr family) { + MutexLock l(mutex_); + size_t index = families_.size(); + families_.push_back(std::move(family)); + return index; +} + +void BenchmarkFamilies::ClearBenchmarks() { + MutexLock l(mutex_); + families_.clear(); + families_.shrink_to_fit(); +} + +bool BenchmarkFamilies::FindBenchmarks( + std::string spec, std::vector* benchmarks, + std::ostream* ErrStream) { + CHECK(ErrStream); + auto& Err = *ErrStream; + // Make regular expression out of command-line flag + std::string error_msg; + Regex re; + bool isNegativeFilter = false; + if(spec[0] == '-') { + spec.replace(0, 1, ""); + isNegativeFilter = true; + } + if (!re.Init(spec, &error_msg)) { + Err << "Could not compile benchmark re: " << error_msg << std::endl; + return false; + } + + // Special list of thread counts to use when none are specified + const std::vector one_thread = {1}; + + MutexLock l(mutex_); + for (std::unique_ptr& family : families_) { + // Family was deleted or benchmark doesn't match + if (!family) continue; + + if (family->ArgsCnt() == -1) { + family->Args({}); + } + const std::vector* thread_counts = + (family->thread_counts_.empty() + ? &one_thread + : &static_cast&>(family->thread_counts_)); + const size_t family_size = family->args_.size() * thread_counts->size(); + // The benchmark will be run at least 'family_size' different inputs. + // If 'family_size' is very large warn the user. + if (family_size > kMaxFamilySize) { + Err << "The number of inputs is very large. " << family->name_ + << " will be repeated at least " << family_size << " times.\n"; + } + // reserve in the special case the regex ".", since we know the final + // family size. + if (spec == ".") benchmarks->reserve(family_size); + + for (auto const& args : family->args_) { + for (int num_threads : *thread_counts) { + Benchmark::Instance instance; + instance.name = family->name_; + instance.benchmark = family.get(); + instance.report_mode = family->report_mode_; + instance.arg = args; + instance.time_unit = family->time_unit_; + instance.range_multiplier = family->range_multiplier_; + instance.min_time = family->min_time_; + instance.iterations = family->iterations_; + instance.repetitions = family->repetitions_; + instance.use_real_time = family->use_real_time_; + instance.use_manual_time = family->use_manual_time_; + instance.complexity = family->complexity_; + instance.complexity_lambda = family->complexity_lambda_; + instance.statistics = &family->statistics_; + instance.threads = num_threads; + + // Add arguments to instance name + size_t arg_i = 0; + for (auto const& arg : args) { + instance.name += "/"; + + if (arg_i < family->arg_names_.size()) { + const auto& arg_name = family->arg_names_[arg_i]; + if (!arg_name.empty()) { + instance.name += + StrFormat("%s:", family->arg_names_[arg_i].c_str()); + } + } + + instance.name += StrFormat("%d", arg); + ++arg_i; + } + + if (!IsZero(family->min_time_)) + instance.name += StrFormat("/min_time:%0.3f", family->min_time_); + if (family->iterations_ != 0) + instance.name += StrFormat("/iterations:%d", family->iterations_); + if (family->repetitions_ != 0) + instance.name += StrFormat("/repeats:%d", family->repetitions_); + + if (family->use_manual_time_) { + instance.name += "/manual_time"; + } else if (family->use_real_time_) { + instance.name += "/real_time"; + } + + // Add the number of threads used to the name + if (!family->thread_counts_.empty()) { + instance.name += StrFormat("/threads:%d", instance.threads); + } + + if ((re.Match(instance.name) && !isNegativeFilter) || + (!re.Match(instance.name) && isNegativeFilter)) { + instance.last_benchmark_instance = (&args == &family->args_.back()); + benchmarks->push_back(std::move(instance)); + } + } + } + } + return true; +} + +Benchmark* RegisterBenchmarkInternal(Benchmark* bench) { + std::unique_ptr bench_ptr(bench); + BenchmarkFamilies* families = BenchmarkFamilies::GetInstance(); + families->AddBenchmark(std::move(bench_ptr)); + return bench; +} + +// FIXME: This function is a hack so that benchmark.cc can access +// `BenchmarkFamilies` +bool FindBenchmarksInternal(const std::string& re, + std::vector* benchmarks, + std::ostream* Err) { + return BenchmarkFamilies::GetInstance()->FindBenchmarks(re, benchmarks, Err); +} + +//=============================================================================// +// Benchmark +//=============================================================================// + +Benchmark::Benchmark(const char* name) + : name_(name), + report_mode_(RM_Unspecified), + time_unit_(kNanosecond), + range_multiplier_(kRangeMultiplier), + min_time_(0), + iterations_(0), + repetitions_(0), + use_real_time_(false), + use_manual_time_(false), + complexity_(oNone), + complexity_lambda_(nullptr) { + ComputeStatistics("mean", StatisticsMean); + ComputeStatistics("median", StatisticsMedian); + ComputeStatistics("stddev", StatisticsStdDev); +} + +Benchmark::~Benchmark() {} + +Benchmark* Benchmark::Arg(int64_t x) { + CHECK(ArgsCnt() == -1 || ArgsCnt() == 1); + args_.push_back({x}); + return this; +} + +Benchmark* Benchmark::Unit(TimeUnit unit) { + time_unit_ = unit; + return this; +} + +Benchmark* Benchmark::Range(int64_t start, int64_t limit) { + CHECK(ArgsCnt() == -1 || ArgsCnt() == 1); + std::vector arglist; + AddRange(&arglist, start, limit, range_multiplier_); + + for (int64_t i : arglist) { + args_.push_back({i}); + } + return this; +} + +Benchmark* Benchmark::Ranges( + const std::vector>& ranges) { + CHECK(ArgsCnt() == -1 || ArgsCnt() == static_cast(ranges.size())); + std::vector> arglists(ranges.size()); + std::size_t total = 1; + for (std::size_t i = 0; i < ranges.size(); i++) { + AddRange(&arglists[i], ranges[i].first, ranges[i].second, + range_multiplier_); + total *= arglists[i].size(); + } + + std::vector ctr(arglists.size(), 0); + + for (std::size_t i = 0; i < total; i++) { + std::vector tmp; + tmp.reserve(arglists.size()); + + for (std::size_t j = 0; j < arglists.size(); j++) { + tmp.push_back(arglists[j].at(ctr[j])); + } + + args_.push_back(std::move(tmp)); + + for (std::size_t j = 0; j < arglists.size(); j++) { + if (ctr[j] + 1 < arglists[j].size()) { + ++ctr[j]; + break; + } + ctr[j] = 0; + } + } + return this; +} + +Benchmark* Benchmark::ArgName(const std::string& name) { + CHECK(ArgsCnt() == -1 || ArgsCnt() == 1); + arg_names_ = {name}; + return this; +} + +Benchmark* Benchmark::ArgNames(const std::vector& names) { + CHECK(ArgsCnt() == -1 || ArgsCnt() == static_cast(names.size())); + arg_names_ = names; + return this; +} + +Benchmark* Benchmark::DenseRange(int64_t start, int64_t limit, int step) { + CHECK(ArgsCnt() == -1 || ArgsCnt() == 1); + CHECK_GE(start, 0); + CHECK_LE(start, limit); + for (int64_t arg = start; arg <= limit; arg += step) { + args_.push_back({arg}); + } + return this; +} + +Benchmark* Benchmark::Args(const std::vector& args) { + CHECK(ArgsCnt() == -1 || ArgsCnt() == static_cast(args.size())); + args_.push_back(args); + return this; +} + +Benchmark* Benchmark::Apply(void (*custom_arguments)(Benchmark* benchmark)) { + custom_arguments(this); + return this; +} + +Benchmark* Benchmark::RangeMultiplier(int multiplier) { + CHECK(multiplier > 1); + range_multiplier_ = multiplier; + return this; +} + +Benchmark* Benchmark::MinTime(double t) { + CHECK(t > 0.0); + CHECK(iterations_ == 0); + min_time_ = t; + return this; +} + +Benchmark* Benchmark::Iterations(size_t n) { + CHECK(n > 0); + CHECK(IsZero(min_time_)); + iterations_ = n; + return this; +} + +Benchmark* Benchmark::Repetitions(int n) { + CHECK(n > 0); + repetitions_ = n; + return this; +} + +Benchmark* Benchmark::ReportAggregatesOnly(bool value) { + report_mode_ = value ? RM_ReportAggregatesOnly : RM_Default; + return this; +} + +Benchmark* Benchmark::UseRealTime() { + CHECK(!use_manual_time_) + << "Cannot set UseRealTime and UseManualTime simultaneously."; + use_real_time_ = true; + return this; +} + +Benchmark* Benchmark::UseManualTime() { + CHECK(!use_real_time_) + << "Cannot set UseRealTime and UseManualTime simultaneously."; + use_manual_time_ = true; + return this; +} + +Benchmark* Benchmark::Complexity(BigO complexity) { + complexity_ = complexity; + return this; +} + +Benchmark* Benchmark::Complexity(BigOFunc* complexity) { + complexity_lambda_ = complexity; + complexity_ = oLambda; + return this; +} + +Benchmark* Benchmark::ComputeStatistics(std::string name, + StatisticsFunc* statistics) { + statistics_.emplace_back(name, statistics); + return this; +} + +Benchmark* Benchmark::Threads(int t) { + CHECK_GT(t, 0); + thread_counts_.push_back(t); + return this; +} + +Benchmark* Benchmark::ThreadRange(int min_threads, int max_threads) { + CHECK_GT(min_threads, 0); + CHECK_GE(max_threads, min_threads); + + AddRange(&thread_counts_, min_threads, max_threads, 2); + return this; +} + +Benchmark* Benchmark::DenseThreadRange(int min_threads, int max_threads, + int stride) { + CHECK_GT(min_threads, 0); + CHECK_GE(max_threads, min_threads); + CHECK_GE(stride, 1); + + for (auto i = min_threads; i < max_threads; i += stride) { + thread_counts_.push_back(i); + } + thread_counts_.push_back(max_threads); + return this; +} + +Benchmark* Benchmark::ThreadPerCpu() { + thread_counts_.push_back(CPUInfo::Get().num_cpus); + return this; +} + +void Benchmark::SetName(const char* name) { name_ = name; } + +int Benchmark::ArgsCnt() const { + if (args_.empty()) { + if (arg_names_.empty()) return -1; + return static_cast(arg_names_.size()); + } + return static_cast(args_.front().size()); +} + +//=============================================================================// +// FunctionBenchmark +//=============================================================================// + +void FunctionBenchmark::Run(State& st) { func_(st); } + +} // end namespace internal + +void ClearRegisteredBenchmarks() { + internal::BenchmarkFamilies::GetInstance()->ClearBenchmarks(); +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.h new file mode 100755 index 00000000000..0705e219f2f --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/benchmark_register.h @@ -0,0 +1,33 @@ +#ifndef BENCHMARK_REGISTER_H +#define BENCHMARK_REGISTER_H + +#include + +#include "check.h" + +template +void AddRange(std::vector* dst, T lo, T hi, int mult) { + CHECK_GE(lo, 0); + CHECK_GE(hi, lo); + CHECK_GE(mult, 2); + + // Add "lo" + dst->push_back(lo); + + static const T kmax = std::numeric_limits::max(); + + // Now space out the benchmarks in multiples of "mult" + for (T i = 1; i < kmax / mult; i *= mult) { + if (i >= hi) break; + if (i > lo) { + dst->push_back(i); + } + } + + // Add "hi" (if different from "lo") + if (hi != lo) { + dst->push_back(hi); + } +} + +#endif // BENCHMARK_REGISTER_H diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/check.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/check.h new file mode 100755 index 00000000000..73bead2fb55 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/check.h @@ -0,0 +1,79 @@ +#ifndef CHECK_H_ +#define CHECK_H_ + +#include +#include +#include + +#include "internal_macros.h" +#include "log.h" + +namespace benchmark { +namespace internal { + +typedef void(AbortHandlerT)(); + +inline AbortHandlerT*& GetAbortHandler() { + static AbortHandlerT* handler = &std::abort; + return handler; +} + +BENCHMARK_NORETURN inline void CallAbortHandler() { + GetAbortHandler()(); + std::abort(); // fallback to enforce noreturn +} + +// CheckHandler is the class constructed by failing CHECK macros. CheckHandler +// will log information about the failures and abort when it is destructed. +class CheckHandler { + public: + CheckHandler(const char* check, const char* file, const char* func, int line) + : log_(GetErrorLogInstance()) { + log_ << file << ":" << line << ": " << func << ": Check `" << check + << "' failed. "; + } + + LogType& GetLog() { return log_; } + + BENCHMARK_NORETURN ~CheckHandler() BENCHMARK_NOEXCEPT_OP(false) { + log_ << std::endl; + CallAbortHandler(); + } + + CheckHandler& operator=(const CheckHandler&) = delete; + CheckHandler(const CheckHandler&) = delete; + CheckHandler() = delete; + + private: + LogType& log_; +}; + +} // end namespace internal +} // end namespace benchmark + +// The CHECK macro returns a std::ostream object that can have extra information +// written to it. +#ifndef NDEBUG +#define CHECK(b) \ + (b ? ::benchmark::internal::GetNullLogInstance() \ + : ::benchmark::internal::CheckHandler(#b, __FILE__, __func__, __LINE__) \ + .GetLog()) +#else +#define CHECK(b) ::benchmark::internal::GetNullLogInstance() +#endif + +#define CHECK_EQ(a, b) CHECK((a) == (b)) +#define CHECK_NE(a, b) CHECK((a) != (b)) +#define CHECK_GE(a, b) CHECK((a) >= (b)) +#define CHECK_LE(a, b) CHECK((a) <= (b)) +#define CHECK_GT(a, b) CHECK((a) > (b)) +#define CHECK_LT(a, b) CHECK((a) < (b)) + +#define CHECK_FLOAT_EQ(a, b, eps) CHECK(std::fabs((a) - (b)) < (eps)) +#define CHECK_FLOAT_NE(a, b, eps) CHECK(std::fabs((a) - (b)) >= (eps)) +#define CHECK_FLOAT_GE(a, b, eps) CHECK((a) - (b) > -(eps)) +#define CHECK_FLOAT_LE(a, b, eps) CHECK((b) - (a) > -(eps)) +#define CHECK_FLOAT_GT(a, b, eps) CHECK((a) - (b) > (eps)) +#define CHECK_FLOAT_LT(a, b, eps) CHECK((b) - (a) > (eps)) + +#endif // CHECK_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.cc new file mode 100755 index 00000000000..2dec4a8b28b --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.cc @@ -0,0 +1,188 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "colorprint.h" + +#include +#include +#include +#include +#include +#include + +#include "check.h" +#include "internal_macros.h" + +#ifdef BENCHMARK_OS_WINDOWS +#include +#include +#else +#include +#endif // BENCHMARK_OS_WINDOWS + +namespace benchmark { +namespace { +#ifdef BENCHMARK_OS_WINDOWS +typedef WORD PlatformColorCode; +#else +typedef const char* PlatformColorCode; +#endif + +PlatformColorCode GetPlatformColorCode(LogColor color) { +#ifdef BENCHMARK_OS_WINDOWS + switch (color) { + case COLOR_RED: + return FOREGROUND_RED; + case COLOR_GREEN: + return FOREGROUND_GREEN; + case COLOR_YELLOW: + return FOREGROUND_RED | FOREGROUND_GREEN; + case COLOR_BLUE: + return FOREGROUND_BLUE; + case COLOR_MAGENTA: + return FOREGROUND_BLUE | FOREGROUND_RED; + case COLOR_CYAN: + return FOREGROUND_BLUE | FOREGROUND_GREEN; + case COLOR_WHITE: // fall through to default + default: + return 0; + } +#else + switch (color) { + case COLOR_RED: + return "1"; + case COLOR_GREEN: + return "2"; + case COLOR_YELLOW: + return "3"; + case COLOR_BLUE: + return "4"; + case COLOR_MAGENTA: + return "5"; + case COLOR_CYAN: + return "6"; + case COLOR_WHITE: + return "7"; + default: + return nullptr; + }; +#endif +} + +} // end namespace + +std::string FormatString(const char* msg, va_list args) { + // we might need a second shot at this, so pre-emptivly make a copy + va_list args_cp; + va_copy(args_cp, args); + + std::size_t size = 256; + char local_buff[256]; + auto ret = vsnprintf(local_buff, size, msg, args_cp); + + va_end(args_cp); + + // currently there is no error handling for failure, so this is hack. + CHECK(ret >= 0); + + if (ret == 0) // handle empty expansion + return {}; + else if (static_cast(ret) < size) + return local_buff; + else { + // we did not provide a long enough buffer on our first attempt. + size = (size_t)ret + 1; // + 1 for the null byte + std::unique_ptr buff(new char[size]); + ret = vsnprintf(buff.get(), size, msg, args); + CHECK(ret > 0 && ((size_t)ret) < size); + return buff.get(); + } +} + +std::string FormatString(const char* msg, ...) { + va_list args; + va_start(args, msg); + auto tmp = FormatString(msg, args); + va_end(args); + return tmp; +} + +void ColorPrintf(std::ostream& out, LogColor color, const char* fmt, ...) { + va_list args; + va_start(args, fmt); + ColorPrintf(out, color, fmt, args); + va_end(args); +} + +void ColorPrintf(std::ostream& out, LogColor color, const char* fmt, + va_list args) { +#ifdef BENCHMARK_OS_WINDOWS + ((void)out); // suppress unused warning + + const HANDLE stdout_handle = GetStdHandle(STD_OUTPUT_HANDLE); + + // Gets the current text color. + CONSOLE_SCREEN_BUFFER_INFO buffer_info; + GetConsoleScreenBufferInfo(stdout_handle, &buffer_info); + const WORD old_color_attrs = buffer_info.wAttributes; + + // We need to flush the stream buffers into the console before each + // SetConsoleTextAttribute call lest it affect the text that is already + // printed but has not yet reached the console. + fflush(stdout); + SetConsoleTextAttribute(stdout_handle, + GetPlatformColorCode(color) | FOREGROUND_INTENSITY); + vprintf(fmt, args); + + fflush(stdout); + // Restores the text color. + SetConsoleTextAttribute(stdout_handle, old_color_attrs); +#else + const char* color_code = GetPlatformColorCode(color); + if (color_code) out << FormatString("\033[0;3%sm", color_code); + out << FormatString(fmt, args) << "\033[m"; +#endif +} + +bool IsColorTerminal() { +#if BENCHMARK_OS_WINDOWS + // On Windows the TERM variable is usually not set, but the + // console there does support colors. + return 0 != _isatty(_fileno(stdout)); +#else + // On non-Windows platforms, we rely on the TERM variable. This list of + // supported TERM values is copied from Google Test: + // . + const char* const SUPPORTED_TERM_VALUES[] = { + "xterm", "xterm-color", "xterm-256color", + "screen", "screen-256color", "tmux", + "tmux-256color", "rxvt-unicode", "rxvt-unicode-256color", + "linux", "cygwin", + }; + + const char* const term = getenv("TERM"); + + bool term_supports_color = false; + for (const char* candidate : SUPPORTED_TERM_VALUES) { + if (term && 0 == strcmp(term, candidate)) { + term_supports_color = true; + break; + } + } + + return 0 != isatty(fileno(stdout)) && term_supports_color; +#endif // BENCHMARK_OS_WINDOWS +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.h new file mode 100755 index 00000000000..9f6fab9b342 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/colorprint.h @@ -0,0 +1,33 @@ +#ifndef BENCHMARK_COLORPRINT_H_ +#define BENCHMARK_COLORPRINT_H_ + +#include +#include +#include + +namespace benchmark { +enum LogColor { + COLOR_DEFAULT, + COLOR_RED, + COLOR_GREEN, + COLOR_YELLOW, + COLOR_BLUE, + COLOR_MAGENTA, + COLOR_CYAN, + COLOR_WHITE +}; + +std::string FormatString(const char* msg, va_list args); +std::string FormatString(const char* msg, ...); + +void ColorPrintf(std::ostream& out, LogColor color, const char* fmt, + va_list args); +void ColorPrintf(std::ostream& out, LogColor color, const char* fmt, ...); + +// Returns true if stdout appears to be a terminal that supports colored +// output, false otherwise. +bool IsColorTerminal(); + +} // end namespace benchmark + +#endif // BENCHMARK_COLORPRINT_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.cc new file mode 100755 index 00000000000..2fc92517a32 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.cc @@ -0,0 +1,218 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "commandlineflags.h" + +#include +#include +#include +#include +#include + +namespace benchmark { +// Parses 'str' for a 32-bit signed integer. If successful, writes +// the result to *value and returns true; otherwise leaves *value +// unchanged and returns false. +bool ParseInt32(const std::string& src_text, const char* str, int32_t* value) { + // Parses the environment variable as a decimal integer. + char* end = nullptr; + const long long_value = strtol(str, &end, 10); // NOLINT + + // Has strtol() consumed all characters in the string? + if (*end != '\0') { + // No - an invalid character was encountered. + std::cerr << src_text << " is expected to be a 32-bit integer, " + << "but actually has value \"" << str << "\".\n"; + return false; + } + + // Is the parsed value in the range of an Int32? + const int32_t result = static_cast(long_value); + if (long_value == std::numeric_limits::max() || + long_value == std::numeric_limits::min() || + // The parsed value overflows as a long. (strtol() returns + // LONG_MAX or LONG_MIN when the input overflows.) + result != long_value + // The parsed value overflows as an Int32. + ) { + std::cerr << src_text << " is expected to be a 32-bit integer, " + << "but actually has value \"" << str << "\", " + << "which overflows.\n"; + return false; + } + + *value = result; + return true; +} + +// Parses 'str' for a double. If successful, writes the result to *value and +// returns true; otherwise leaves *value unchanged and returns false. +bool ParseDouble(const std::string& src_text, const char* str, double* value) { + // Parses the environment variable as a decimal integer. + char* end = nullptr; + const double double_value = strtod(str, &end); // NOLINT + + // Has strtol() consumed all characters in the string? + if (*end != '\0') { + // No - an invalid character was encountered. + std::cerr << src_text << " is expected to be a double, " + << "but actually has value \"" << str << "\".\n"; + return false; + } + + *value = double_value; + return true; +} + +// Returns the name of the environment variable corresponding to the +// given flag. For example, FlagToEnvVar("foo") will return +// "BENCHMARK_FOO" in the open-source version. +static std::string FlagToEnvVar(const char* flag) { + const std::string flag_str(flag); + + std::string env_var; + for (size_t i = 0; i != flag_str.length(); ++i) + env_var += static_cast(::toupper(flag_str.c_str()[i])); + + return "BENCHMARK_" + env_var; +} + +// Reads and returns the Boolean environment variable corresponding to +// the given flag; if it's not set, returns default_value. +// +// The value is considered true iff it's not "0". +bool BoolFromEnv(const char* flag, bool default_value) { + const std::string env_var = FlagToEnvVar(flag); + const char* const string_value = getenv(env_var.c_str()); + return string_value == nullptr ? default_value + : strcmp(string_value, "0") != 0; +} + +// Reads and returns a 32-bit integer stored in the environment +// variable corresponding to the given flag; if it isn't set or +// doesn't represent a valid 32-bit integer, returns default_value. +int32_t Int32FromEnv(const char* flag, int32_t default_value) { + const std::string env_var = FlagToEnvVar(flag); + const char* const string_value = getenv(env_var.c_str()); + if (string_value == nullptr) { + // The environment variable is not set. + return default_value; + } + + int32_t result = default_value; + if (!ParseInt32(std::string("Environment variable ") + env_var, string_value, + &result)) { + std::cout << "The default value " << default_value << " is used.\n"; + return default_value; + } + + return result; +} + +// Reads and returns the string environment variable corresponding to +// the given flag; if it's not set, returns default_value. +const char* StringFromEnv(const char* flag, const char* default_value) { + const std::string env_var = FlagToEnvVar(flag); + const char* const value = getenv(env_var.c_str()); + return value == nullptr ? default_value : value; +} + +// Parses a string as a command line flag. The string should have +// the format "--flag=value". When def_optional is true, the "=value" +// part can be omitted. +// +// Returns the value of the flag, or nullptr if the parsing failed. +const char* ParseFlagValue(const char* str, const char* flag, + bool def_optional) { + // str and flag must not be nullptr. + if (str == nullptr || flag == nullptr) return nullptr; + + // The flag must start with "--". + const std::string flag_str = std::string("--") + std::string(flag); + const size_t flag_len = flag_str.length(); + if (strncmp(str, flag_str.c_str(), flag_len) != 0) return nullptr; + + // Skips the flag name. + const char* flag_end = str + flag_len; + + // When def_optional is true, it's OK to not have a "=value" part. + if (def_optional && (flag_end[0] == '\0')) return flag_end; + + // If def_optional is true and there are more characters after the + // flag name, or if def_optional is false, there must be a '=' after + // the flag name. + if (flag_end[0] != '=') return nullptr; + + // Returns the string after "=". + return flag_end + 1; +} + +bool ParseBoolFlag(const char* str, const char* flag, bool* value) { + // Gets the value of the flag as a string. + const char* const value_str = ParseFlagValue(str, flag, true); + + // Aborts if the parsing failed. + if (value_str == nullptr) return false; + + // Converts the string value to a bool. + *value = IsTruthyFlagValue(value_str); + return true; +} + +bool ParseInt32Flag(const char* str, const char* flag, int32_t* value) { + // Gets the value of the flag as a string. + const char* const value_str = ParseFlagValue(str, flag, false); + + // Aborts if the parsing failed. + if (value_str == nullptr) return false; + + // Sets *value to the value of the flag. + return ParseInt32(std::string("The value of flag --") + flag, value_str, + value); +} + +bool ParseDoubleFlag(const char* str, const char* flag, double* value) { + // Gets the value of the flag as a string. + const char* const value_str = ParseFlagValue(str, flag, false); + + // Aborts if the parsing failed. + if (value_str == nullptr) return false; + + // Sets *value to the value of the flag. + return ParseDouble(std::string("The value of flag --") + flag, value_str, + value); +} + +bool ParseStringFlag(const char* str, const char* flag, std::string* value) { + // Gets the value of the flag as a string. + const char* const value_str = ParseFlagValue(str, flag, false); + + // Aborts if the parsing failed. + if (value_str == nullptr) return false; + + *value = value_str; + return true; +} + +bool IsFlag(const char* str, const char* flag) { + return (ParseFlagValue(str, flag, true) != nullptr); +} + +bool IsTruthyFlagValue(const std::string& value) { + if (value.empty()) return true; + char ch = value[0]; + return isalnum(ch) && + !(ch == '0' || ch == 'f' || ch == 'F' || ch == 'n' || ch == 'N'); +} +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.h new file mode 100755 index 00000000000..945c9a9fc4a --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/commandlineflags.h @@ -0,0 +1,79 @@ +#ifndef BENCHMARK_COMMANDLINEFLAGS_H_ +#define BENCHMARK_COMMANDLINEFLAGS_H_ + +#include +#include + +// Macro for referencing flags. +#define FLAG(name) FLAGS_##name + +// Macros for declaring flags. +#define DECLARE_bool(name) extern bool FLAG(name) +#define DECLARE_int32(name) extern int32_t FLAG(name) +#define DECLARE_int64(name) extern int64_t FLAG(name) +#define DECLARE_double(name) extern double FLAG(name) +#define DECLARE_string(name) extern std::string FLAG(name) + +// Macros for defining flags. +#define DEFINE_bool(name, default_val, doc) bool FLAG(name) = (default_val) +#define DEFINE_int32(name, default_val, doc) int32_t FLAG(name) = (default_val) +#define DEFINE_int64(name, default_val, doc) int64_t FLAG(name) = (default_val) +#define DEFINE_double(name, default_val, doc) double FLAG(name) = (default_val) +#define DEFINE_string(name, default_val, doc) \ + std::string FLAG(name) = (default_val) + +namespace benchmark { +// Parses 'str' for a 32-bit signed integer. If successful, writes the result +// to *value and returns true; otherwise leaves *value unchanged and returns +// false. +bool ParseInt32(const std::string& src_text, const char* str, int32_t* value); + +// Parses a bool/Int32/string from the environment variable +// corresponding to the given Google Test flag. +bool BoolFromEnv(const char* flag, bool default_val); +int32_t Int32FromEnv(const char* flag, int32_t default_val); +double DoubleFromEnv(const char* flag, double default_val); +const char* StringFromEnv(const char* flag, const char* default_val); + +// Parses a string for a bool flag, in the form of either +// "--flag=value" or "--flag". +// +// In the former case, the value is taken as true if it passes IsTruthyValue(). +// +// In the latter case, the value is taken as true. +// +// On success, stores the value of the flag in *value, and returns +// true. On failure, returns false without changing *value. +bool ParseBoolFlag(const char* str, const char* flag, bool* value); + +// Parses a string for an Int32 flag, in the form of +// "--flag=value". +// +// On success, stores the value of the flag in *value, and returns +// true. On failure, returns false without changing *value. +bool ParseInt32Flag(const char* str, const char* flag, int32_t* value); + +// Parses a string for a Double flag, in the form of +// "--flag=value". +// +// On success, stores the value of the flag in *value, and returns +// true. On failure, returns false without changing *value. +bool ParseDoubleFlag(const char* str, const char* flag, double* value); + +// Parses a string for a string flag, in the form of +// "--flag=value". +// +// On success, stores the value of the flag in *value, and returns +// true. On failure, returns false without changing *value. +bool ParseStringFlag(const char* str, const char* flag, std::string* value); + +// Returns true if the string matches the flag. +bool IsFlag(const char* str, const char* flag); + +// Returns true unless value starts with one of: '0', 'f', 'F', 'n' or 'N', or +// some non-alphanumeric character. As a special case, also returns true if +// value is the empty string. +bool IsTruthyFlagValue(const std::string& value); +} // end namespace benchmark + +#endif // BENCHMARK_COMMANDLINEFLAGS_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.cc new file mode 100755 index 00000000000..97bf6e09b30 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.cc @@ -0,0 +1,220 @@ +// Copyright 2016 Ismael Jimenez Martinez. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Source project : https://github.com/ismaelJimenez/cpp.leastsq +// Adapted to be used with google benchmark + +#include "benchmark/benchmark.h" + +#include +#include +#include "check.h" +#include "complexity.h" + +namespace benchmark { + +// Internal function to calculate the different scalability forms +BigOFunc* FittingCurve(BigO complexity) { + switch (complexity) { + case oN: + return [](int64_t n) -> double { return static_cast(n); }; + case oNSquared: + return [](int64_t n) -> double { return std::pow(n, 2); }; + case oNCubed: + return [](int64_t n) -> double { return std::pow(n, 3); }; + case oLogN: + return [](int64_t n) { return log2(n); }; + case oNLogN: + return [](int64_t n) { return n * log2(n); }; + case o1: + default: + return [](int64_t) { return 1.0; }; + } +} + +// Function to return an string for the calculated complexity +std::string GetBigOString(BigO complexity) { + switch (complexity) { + case oN: + return "N"; + case oNSquared: + return "N^2"; + case oNCubed: + return "N^3"; + case oLogN: + return "lgN"; + case oNLogN: + return "NlgN"; + case o1: + return "(1)"; + default: + return "f(N)"; + } +} + +// Find the coefficient for the high-order term in the running time, by +// minimizing the sum of squares of relative error, for the fitting curve +// given by the lambda expression. +// - n : Vector containing the size of the benchmark tests. +// - time : Vector containing the times for the benchmark tests. +// - fitting_curve : lambda expression (e.g. [](int64_t n) {return n; };). + +// For a deeper explanation on the algorithm logic, look the README file at +// http://github.com/ismaelJimenez/Minimal-Cpp-Least-Squared-Fit + +LeastSq MinimalLeastSq(const std::vector& n, + const std::vector& time, + BigOFunc* fitting_curve) { + double sigma_gn = 0.0; + double sigma_gn_squared = 0.0; + double sigma_time = 0.0; + double sigma_time_gn = 0.0; + + // Calculate least square fitting parameter + for (size_t i = 0; i < n.size(); ++i) { + double gn_i = fitting_curve(n[i]); + sigma_gn += gn_i; + sigma_gn_squared += gn_i * gn_i; + sigma_time += time[i]; + sigma_time_gn += time[i] * gn_i; + } + + LeastSq result; + result.complexity = oLambda; + + // Calculate complexity. + result.coef = sigma_time_gn / sigma_gn_squared; + + // Calculate RMS + double rms = 0.0; + for (size_t i = 0; i < n.size(); ++i) { + double fit = result.coef * fitting_curve(n[i]); + rms += pow((time[i] - fit), 2); + } + + // Normalized RMS by the mean of the observed values + double mean = sigma_time / n.size(); + result.rms = sqrt(rms / n.size()) / mean; + + return result; +} + +// Find the coefficient for the high-order term in the running time, by +// minimizing the sum of squares of relative error. +// - n : Vector containing the size of the benchmark tests. +// - time : Vector containing the times for the benchmark tests. +// - complexity : If different than oAuto, the fitting curve will stick to +// this one. If it is oAuto, it will be calculated the best +// fitting curve. +LeastSq MinimalLeastSq(const std::vector& n, + const std::vector& time, const BigO complexity) { + CHECK_EQ(n.size(), time.size()); + CHECK_GE(n.size(), 2); // Do not compute fitting curve is less than two + // benchmark runs are given + CHECK_NE(complexity, oNone); + + LeastSq best_fit; + + if (complexity == oAuto) { + std::vector fit_curves = {oLogN, oN, oNLogN, oNSquared, oNCubed}; + + // Take o1 as default best fitting curve + best_fit = MinimalLeastSq(n, time, FittingCurve(o1)); + best_fit.complexity = o1; + + // Compute all possible fitting curves and stick to the best one + for (const auto& fit : fit_curves) { + LeastSq current_fit = MinimalLeastSq(n, time, FittingCurve(fit)); + if (current_fit.rms < best_fit.rms) { + best_fit = current_fit; + best_fit.complexity = fit; + } + } + } else { + best_fit = MinimalLeastSq(n, time, FittingCurve(complexity)); + best_fit.complexity = complexity; + } + + return best_fit; +} + +std::vector ComputeBigO( + const std::vector& reports) { + typedef BenchmarkReporter::Run Run; + std::vector results; + + if (reports.size() < 2) return results; + + // Accumulators. + std::vector n; + std::vector real_time; + std::vector cpu_time; + + // Populate the accumulators. + for (const Run& run : reports) { + CHECK_GT(run.complexity_n, 0) << "Did you forget to call SetComplexityN?"; + n.push_back(run.complexity_n); + real_time.push_back(run.real_accumulated_time / run.iterations); + cpu_time.push_back(run.cpu_accumulated_time / run.iterations); + } + + LeastSq result_cpu; + LeastSq result_real; + + if (reports[0].complexity == oLambda) { + result_cpu = MinimalLeastSq(n, cpu_time, reports[0].complexity_lambda); + result_real = MinimalLeastSq(n, real_time, reports[0].complexity_lambda); + } else { + result_cpu = MinimalLeastSq(n, cpu_time, reports[0].complexity); + result_real = MinimalLeastSq(n, real_time, result_cpu.complexity); + } + std::string benchmark_name = + reports[0].benchmark_name.substr(0, reports[0].benchmark_name.find('/')); + + // Get the data from the accumulator to BenchmarkReporter::Run's. + Run big_o; + big_o.benchmark_name = benchmark_name + "_BigO"; + big_o.iterations = 0; + big_o.real_accumulated_time = result_real.coef; + big_o.cpu_accumulated_time = result_cpu.coef; + big_o.report_big_o = true; + big_o.complexity = result_cpu.complexity; + + // All the time results are reported after being multiplied by the + // time unit multiplier. But since RMS is a relative quantity it + // should not be multiplied at all. So, here, we _divide_ it by the + // multiplier so that when it is multiplied later the result is the + // correct one. + double multiplier = GetTimeUnitMultiplier(reports[0].time_unit); + + // Only add label to mean/stddev if it is same for all runs + Run rms; + big_o.report_label = reports[0].report_label; + rms.benchmark_name = benchmark_name + "_RMS"; + rms.report_label = big_o.report_label; + rms.iterations = 0; + rms.real_accumulated_time = result_real.rms / multiplier; + rms.cpu_accumulated_time = result_cpu.rms / multiplier; + rms.report_rms = true; + rms.complexity = result_cpu.complexity; + // don't forget to keep the time unit, or we won't be able to + // recover the correct value. + rms.time_unit = reports[0].time_unit; + + results.push_back(big_o); + results.push_back(rms); + return results; +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.h new file mode 100755 index 00000000000..df29b48d29b --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/complexity.h @@ -0,0 +1,55 @@ +// Copyright 2016 Ismael Jimenez Martinez. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Source project : https://github.com/ismaelJimenez/cpp.leastsq +// Adapted to be used with google benchmark + +#ifndef COMPLEXITY_H_ +#define COMPLEXITY_H_ + +#include +#include + +#include "benchmark/benchmark.h" + +namespace benchmark { + +// Return a vector containing the bigO and RMS information for the specified +// list of reports. If 'reports.size() < 2' an empty vector is returned. +std::vector ComputeBigO( + const std::vector& reports); + +// This data structure will contain the result returned by MinimalLeastSq +// - coef : Estimated coeficient for the high-order term as +// interpolated from data. +// - rms : Normalized Root Mean Squared Error. +// - complexity : Scalability form (e.g. oN, oNLogN). In case a scalability +// form has been provided to MinimalLeastSq this will return +// the same value. In case BigO::oAuto has been selected, this +// parameter will return the best fitting curve detected. + +struct LeastSq { + LeastSq() : coef(0.0), rms(0.0), complexity(oNone) {} + + double coef; + double rms; + BigO complexity; +}; + +// Function to return an string for the calculated complexity +std::string GetBigOString(BigO complexity); + +} // end namespace benchmark + +#endif // COMPLEXITY_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/console_reporter.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/console_reporter.cc new file mode 100755 index 00000000000..48920ca7829 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/console_reporter.cc @@ -0,0 +1,182 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" +#include "complexity.h" +#include "counter.h" + +#include +#include +#include +#include +#include +#include +#include + +#include "check.h" +#include "colorprint.h" +#include "commandlineflags.h" +#include "internal_macros.h" +#include "string_util.h" +#include "timers.h" + +namespace benchmark { + +bool ConsoleReporter::ReportContext(const Context& context) { + name_field_width_ = context.name_field_width; + printed_header_ = false; + prev_counters_.clear(); + + PrintBasicContext(&GetErrorStream(), context); + +#ifdef BENCHMARK_OS_WINDOWS + if ((output_options_ & OO_Color) && &std::cout != &GetOutputStream()) { + GetErrorStream() + << "Color printing is only supported for stdout on windows." + " Disabling color printing\n"; + output_options_ = static_cast< OutputOptions >(output_options_ & ~OO_Color); + } +#endif + + return true; +} + +void ConsoleReporter::PrintHeader(const Run& run) { + std::string str = FormatString("%-*s %13s %13s %10s", static_cast(name_field_width_), + "Benchmark", "Time", "CPU", "Iterations"); + if(!run.counters.empty()) { + if(output_options_ & OO_Tabular) { + for(auto const& c : run.counters) { + str += FormatString(" %10s", c.first.c_str()); + } + } else { + str += " UserCounters..."; + } + } + str += "\n"; + std::string line = std::string(str.length(), '-'); + GetOutputStream() << line << "\n" << str << line << "\n"; +} + +void ConsoleReporter::ReportRuns(const std::vector& reports) { + for (const auto& run : reports) { + // print the header: + // --- if none was printed yet + bool print_header = !printed_header_; + // --- or if the format is tabular and this run + // has different fields from the prev header + print_header |= (output_options_ & OO_Tabular) && + (!internal::SameNames(run.counters, prev_counters_)); + if (print_header) { + printed_header_ = true; + prev_counters_ = run.counters; + PrintHeader(run); + } + // As an alternative to printing the headers like this, we could sort + // the benchmarks by header and then print. But this would require + // waiting for the full results before printing, or printing twice. + PrintRunData(run); + } +} + +static void IgnoreColorPrint(std::ostream& out, LogColor, const char* fmt, + ...) { + va_list args; + va_start(args, fmt); + out << FormatString(fmt, args); + va_end(args); +} + +void ConsoleReporter::PrintRunData(const Run& result) { + typedef void(PrinterFn)(std::ostream&, LogColor, const char*, ...); + auto& Out = GetOutputStream(); + PrinterFn* printer = (output_options_ & OO_Color) ? + (PrinterFn*)ColorPrintf : IgnoreColorPrint; + auto name_color = + (result.report_big_o || result.report_rms) ? COLOR_BLUE : COLOR_GREEN; + printer(Out, name_color, "%-*s ", name_field_width_, + result.benchmark_name.c_str()); + + if (result.error_occurred) { + printer(Out, COLOR_RED, "ERROR OCCURRED: \'%s\'", + result.error_message.c_str()); + printer(Out, COLOR_DEFAULT, "\n"); + return; + } + // Format bytes per second + std::string rate; + if (result.bytes_per_second > 0) { + rate = StrCat(" ", HumanReadableNumber(result.bytes_per_second), "B/s"); + } + + // Format items per second + std::string items; + if (result.items_per_second > 0) { + items = + StrCat(" ", HumanReadableNumber(result.items_per_second), " items/s"); + } + + const double real_time = result.GetAdjustedRealTime(); + const double cpu_time = result.GetAdjustedCPUTime(); + + if (result.report_big_o) { + std::string big_o = GetBigOString(result.complexity); + printer(Out, COLOR_YELLOW, "%10.2f %s %10.2f %s ", real_time, big_o.c_str(), + cpu_time, big_o.c_str()); + } else if (result.report_rms) { + printer(Out, COLOR_YELLOW, "%10.0f %% %10.0f %% ", real_time * 100, + cpu_time * 100); + } else { + const char* timeLabel = GetTimeUnitString(result.time_unit); + printer(Out, COLOR_YELLOW, "%10.0f %s %10.0f %s ", real_time, timeLabel, + cpu_time, timeLabel); + } + + if (!result.report_big_o && !result.report_rms) { + printer(Out, COLOR_CYAN, "%10lld", result.iterations); + } + + for (auto& c : result.counters) { + const std::size_t cNameLen = std::max(std::string::size_type(10), + c.first.length()); + auto const& s = HumanReadableNumber(c.second.value, 1000); + if (output_options_ & OO_Tabular) { + if (c.second.flags & Counter::kIsRate) { + printer(Out, COLOR_DEFAULT, " %*s/s", cNameLen - 2, s.c_str()); + } else { + printer(Out, COLOR_DEFAULT, " %*s", cNameLen, s.c_str()); + } + } else { + const char* unit = (c.second.flags & Counter::kIsRate) ? "/s" : ""; + printer(Out, COLOR_DEFAULT, " %s=%s%s", c.first.c_str(), s.c_str(), + unit); + } + } + + if (!rate.empty()) { + printer(Out, COLOR_DEFAULT, " %*s", 13, rate.c_str()); + } + + if (!items.empty()) { + printer(Out, COLOR_DEFAULT, " %*s", 18, items.c_str()); + } + + if (!result.report_label.empty()) { + printer(Out, COLOR_DEFAULT, " %s", result.report_label.c_str()); + } + + printer(Out, COLOR_DEFAULT, "\n"); +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.cc new file mode 100755 index 00000000000..ed1aa044ee7 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.cc @@ -0,0 +1,68 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "counter.h" + +namespace benchmark { +namespace internal { + +double Finish(Counter const& c, double cpu_time, double num_threads) { + double v = c.value; + if (c.flags & Counter::kIsRate) { + v /= cpu_time; + } + if (c.flags & Counter::kAvgThreads) { + v /= num_threads; + } + return v; +} + +void Finish(UserCounters *l, double cpu_time, double num_threads) { + for (auto &c : *l) { + c.second.value = Finish(c.second, cpu_time, num_threads); + } +} + +void Increment(UserCounters *l, UserCounters const& r) { + // add counters present in both or just in *l + for (auto &c : *l) { + auto it = r.find(c.first); + if (it != r.end()) { + c.second.value = c.second + it->second; + } + } + // add counters present in r, but not in *l + for (auto const &tc : r) { + auto it = l->find(tc.first); + if (it == l->end()) { + (*l)[tc.first] = tc.second; + } + } +} + +bool SameNames(UserCounters const& l, UserCounters const& r) { + if (&l == &r) return true; + if (l.size() != r.size()) { + return false; + } + for (auto const& c : l) { + if (r.find(c.first) == r.end()) { + return false; + } + } + return true; +} + +} // end namespace internal +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.h new file mode 100755 index 00000000000..dd6865a31d7 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/counter.h @@ -0,0 +1,26 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" + +namespace benchmark { + +// these counter-related functions are hidden to reduce API surface. +namespace internal { +void Finish(UserCounters *l, double time, double num_threads); +void Increment(UserCounters *l, UserCounters const& r); +bool SameNames(UserCounters const& l, UserCounters const& r); +} // end namespace internal + +} //end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/csv_reporter.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/csv_reporter.cc new file mode 100755 index 00000000000..35510645b08 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/csv_reporter.cc @@ -0,0 +1,149 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" +#include "complexity.h" + +#include +#include +#include +#include +#include +#include + +#include "string_util.h" +#include "timers.h" +#include "check.h" + +// File format reference: http://edoceo.com/utilitas/csv-file-format. + +namespace benchmark { + +namespace { +std::vector elements = { + "name", "iterations", "real_time", "cpu_time", + "time_unit", "bytes_per_second", "items_per_second", "label", + "error_occurred", "error_message"}; +} // namespace + +bool CSVReporter::ReportContext(const Context& context) { + PrintBasicContext(&GetErrorStream(), context); + return true; +} + +void CSVReporter::ReportRuns(const std::vector & reports) { + std::ostream& Out = GetOutputStream(); + + if (!printed_header_) { + // save the names of all the user counters + for (const auto& run : reports) { + for (const auto& cnt : run.counters) { + user_counter_names_.insert(cnt.first); + } + } + + // print the header + for (auto B = elements.begin(); B != elements.end();) { + Out << *B++; + if (B != elements.end()) Out << ","; + } + for (auto B = user_counter_names_.begin(); B != user_counter_names_.end();) { + Out << ",\"" << *B++ << "\""; + } + Out << "\n"; + + printed_header_ = true; + } else { + // check that all the current counters are saved in the name set + for (const auto& run : reports) { + for (const auto& cnt : run.counters) { + CHECK(user_counter_names_.find(cnt.first) != user_counter_names_.end()) + << "All counters must be present in each run. " + << "Counter named \"" << cnt.first + << "\" was not in a run after being added to the header"; + } + } + } + + // print results for each run + for (const auto& run : reports) { + PrintRunData(run); + } + +} + +void CSVReporter::PrintRunData(const Run & run) { + std::ostream& Out = GetOutputStream(); + + // Field with embedded double-quote characters must be doubled and the field + // delimited with double-quotes. + std::string name = run.benchmark_name; + ReplaceAll(&name, "\"", "\"\""); + Out << '"' << name << "\","; + if (run.error_occurred) { + Out << std::string(elements.size() - 3, ','); + Out << "true,"; + std::string msg = run.error_message; + ReplaceAll(&msg, "\"", "\"\""); + Out << '"' << msg << "\"\n"; + return; + } + + // Do not print iteration on bigO and RMS report + if (!run.report_big_o && !run.report_rms) { + Out << run.iterations; + } + Out << ","; + + Out << run.GetAdjustedRealTime() << ","; + Out << run.GetAdjustedCPUTime() << ","; + + // Do not print timeLabel on bigO and RMS report + if (run.report_big_o) { + Out << GetBigOString(run.complexity); + } else if (!run.report_rms) { + Out << GetTimeUnitString(run.time_unit); + } + Out << ","; + + if (run.bytes_per_second > 0.0) { + Out << run.bytes_per_second; + } + Out << ","; + if (run.items_per_second > 0.0) { + Out << run.items_per_second; + } + Out << ","; + if (!run.report_label.empty()) { + // Field with embedded double-quote characters must be doubled and the field + // delimited with double-quotes. + std::string label = run.report_label; + ReplaceAll(&label, "\"", "\"\""); + Out << "\"" << label << "\""; + } + Out << ",,"; // for error_occurred and error_message + + // Print user counters + for (const auto &ucn : user_counter_names_) { + auto it = run.counters.find(ucn); + if(it == run.counters.end()) { + Out << ","; + } else { + Out << "," << it->second; + } + } + Out << '\n'; +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/cycleclock.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/cycleclock.h new file mode 100755 index 00000000000..3b376ac57d5 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/cycleclock.h @@ -0,0 +1,177 @@ +// ---------------------------------------------------------------------- +// CycleClock +// A CycleClock tells you the current time in Cycles. The "time" +// is actually time since power-on. This is like time() but doesn't +// involve a system call and is much more precise. +// +// NOTE: Not all cpu/platform/kernel combinations guarantee that this +// clock increments at a constant rate or is synchronized across all logical +// cpus in a system. +// +// If you need the above guarantees, please consider using a different +// API. There are efforts to provide an interface which provides a millisecond +// granularity and implemented as a memory read. A memory read is generally +// cheaper than the CycleClock for many architectures. +// +// Also, in some out of order CPU implementations, the CycleClock is not +// serializing. So if you're trying to count at cycles granularity, your +// data might be inaccurate due to out of order instruction execution. +// ---------------------------------------------------------------------- + +#ifndef BENCHMARK_CYCLECLOCK_H_ +#define BENCHMARK_CYCLECLOCK_H_ + +#include + +#include "benchmark/benchmark.h" +#include "internal_macros.h" + +#if defined(BENCHMARK_OS_MACOSX) +#include +#endif +// For MSVC, we want to use '_asm rdtsc' when possible (since it works +// with even ancient MSVC compilers), and when not possible the +// __rdtsc intrinsic, declared in . Unfortunately, in some +// environments, and have conflicting +// declarations of some other intrinsics, breaking compilation. +// Therefore, we simply declare __rdtsc ourselves. See also +// http://connect.microsoft.com/VisualStudio/feedback/details/262047 +#if defined(COMPILER_MSVC) && !defined(_M_IX86) +extern "C" uint64_t __rdtsc(); +#pragma intrinsic(__rdtsc) +#endif + +#ifndef BENCHMARK_OS_WINDOWS +#include +#include +#endif + +#ifdef BENCHMARK_OS_EMSCRIPTEN +#include +#endif + +namespace benchmark { +// NOTE: only i386 and x86_64 have been well tested. +// PPC, sparc, alpha, and ia64 are based on +// http://peter.kuscsik.com/wordpress/?p=14 +// with modifications by m3b. See also +// https://setisvn.ssl.berkeley.edu/svn/lib/fftw-3.0.1/kernel/cycle.h +namespace cycleclock { +// This should return the number of cycles since power-on. Thread-safe. +inline BENCHMARK_ALWAYS_INLINE int64_t Now() { +#if defined(BENCHMARK_OS_MACOSX) + // this goes at the top because we need ALL Macs, regardless of + // architecture, to return the number of "mach time units" that + // have passed since startup. See sysinfo.cc where + // InitializeSystemInfo() sets the supposed cpu clock frequency of + // macs to the number of mach time units per second, not actual + // CPU clock frequency (which can change in the face of CPU + // frequency scaling). Also note that when the Mac sleeps, this + // counter pauses; it does not continue counting, nor does it + // reset to zero. + return mach_absolute_time(); +#elif defined(BENCHMARK_OS_EMSCRIPTEN) + // this goes above x86-specific code because old versions of Emscripten + // define __x86_64__, although they have nothing to do with it. + return static_cast(emscripten_get_now() * 1e+6); +#elif defined(__i386__) + int64_t ret; + __asm__ volatile("rdtsc" : "=A"(ret)); + return ret; +#elif defined(__x86_64__) || defined(__amd64__) + uint64_t low, high; + __asm__ volatile("rdtsc" : "=a"(low), "=d"(high)); + return (high << 32) | low; +#elif defined(__powerpc__) || defined(__ppc__) + // This returns a time-base, which is not always precisely a cycle-count. + int64_t tbl, tbu0, tbu1; + asm("mftbu %0" : "=r"(tbu0)); + asm("mftb %0" : "=r"(tbl)); + asm("mftbu %0" : "=r"(tbu1)); + tbl &= -static_cast(tbu0 == tbu1); + // high 32 bits in tbu1; low 32 bits in tbl (tbu0 is garbage) + return (tbu1 << 32) | tbl; +#elif defined(__sparc__) + int64_t tick; + asm(".byte 0x83, 0x41, 0x00, 0x00"); + asm("mov %%g1, %0" : "=r"(tick)); + return tick; +#elif defined(__ia64__) + int64_t itc; + asm("mov %0 = ar.itc" : "=r"(itc)); + return itc; +#elif defined(COMPILER_MSVC) && defined(_M_IX86) + // Older MSVC compilers (like 7.x) don't seem to support the + // __rdtsc intrinsic properly, so I prefer to use _asm instead + // when I know it will work. Otherwise, I'll use __rdtsc and hope + // the code is being compiled with a non-ancient compiler. + _asm rdtsc +#elif defined(COMPILER_MSVC) + return __rdtsc(); +#elif defined(BENCHMARK_OS_NACL) + // Native Client validator on x86/x86-64 allows RDTSC instructions, + // and this case is handled above. Native Client validator on ARM + // rejects MRC instructions (used in the ARM-specific sequence below), + // so we handle it here. Portable Native Client compiles to + // architecture-agnostic bytecode, which doesn't provide any + // cycle counter access mnemonics. + + // Native Client does not provide any API to access cycle counter. + // Use clock_gettime(CLOCK_MONOTONIC, ...) instead of gettimeofday + // because is provides nanosecond resolution (which is noticable at + // least for PNaCl modules running on x86 Mac & Linux). + // Initialize to always return 0 if clock_gettime fails. + struct timespec ts = { 0, 0 }; + clock_gettime(CLOCK_MONOTONIC, &ts); + return static_cast(ts.tv_sec) * 1000000000 + ts.tv_nsec; +#elif defined(__aarch64__) + // System timer of ARMv8 runs at a different frequency than the CPU's. + // The frequency is fixed, typically in the range 1-50MHz. It can be + // read at CNTFRQ special register. We assume the OS has set up + // the virtual timer properly. + int64_t virtual_timer_value; + asm volatile("mrs %0, cntvct_el0" : "=r"(virtual_timer_value)); + return virtual_timer_value; +#elif defined(__ARM_ARCH) + // V6 is the earliest arch that has a standard cyclecount + // Native Client validator doesn't allow MRC instructions. +#if (__ARM_ARCH >= 6) + uint32_t pmccntr; + uint32_t pmuseren; + uint32_t pmcntenset; + // Read the user mode perf monitor counter access permissions. + asm volatile("mrc p15, 0, %0, c9, c14, 0" : "=r"(pmuseren)); + if (pmuseren & 1) { // Allows reading perfmon counters for user mode code. + asm volatile("mrc p15, 0, %0, c9, c12, 1" : "=r"(pmcntenset)); + if (pmcntenset & 0x80000000ul) { // Is it counting? + asm volatile("mrc p15, 0, %0, c9, c13, 0" : "=r"(pmccntr)); + // The counter is set up to count every 64th cycle + return static_cast(pmccntr) * 64; // Should optimize to << 6 + } + } +#endif + struct timeval tv; + gettimeofday(&tv, nullptr); + return static_cast(tv.tv_sec) * 1000000 + tv.tv_usec; +#elif defined(__mips__) + // mips apparently only allows rdtsc for superusers, so we fall + // back to gettimeofday. It's possible clock_gettime would be better. + struct timeval tv; + gettimeofday(&tv, nullptr); + return static_cast(tv.tv_sec) * 1000000 + tv.tv_usec; +#elif defined(__s390__) // Covers both s390 and s390x. + // Return the CPU clock. + uint64_t tsc; + asm("stck %0" : "=Q" (tsc) : : "cc"); + return tsc; +#else +// The soft failover to a generic implementation is automatic only for ARM. +// For other platforms the developer is expected to make an attempt to create +// a fast implementation and use generic version if nothing better is available. +#error You need to define CycleTimer for your OS and CPU +#endif +} +} // end namespace cycleclock +} // end namespace benchmark + +#endif // BENCHMARK_CYCLECLOCK_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/internal_macros.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/internal_macros.h new file mode 100755 index 00000000000..edb8a5c0a35 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/internal_macros.h @@ -0,0 +1,89 @@ +#ifndef BENCHMARK_INTERNAL_MACROS_H_ +#define BENCHMARK_INTERNAL_MACROS_H_ + +#include "benchmark/benchmark.h" + +#ifndef __has_feature +#define __has_feature(x) 0 +#endif +#ifndef __has_builtin +#define __has_builtin(x) 0 +#endif + +#if defined(__clang__) + #if !defined(COMPILER_CLANG) + #define COMPILER_CLANG + #endif +#elif defined(_MSC_VER) + #if !defined(COMPILER_MSVC) + #define COMPILER_MSVC + #endif +#elif defined(__GNUC__) + #if !defined(COMPILER_GCC) + #define COMPILER_GCC + #endif +#endif + +#if __has_feature(cxx_attributes) + #define BENCHMARK_NORETURN [[noreturn]] +#elif defined(__GNUC__) + #define BENCHMARK_NORETURN __attribute__((noreturn)) +#elif defined(COMPILER_MSVC) + #define BENCHMARK_NORETURN __declspec(noreturn) +#else + #define BENCHMARK_NORETURN +#endif + +#if defined(__CYGWIN__) + #define BENCHMARK_OS_CYGWIN 1 +#elif defined(_WIN32) + #define BENCHMARK_OS_WINDOWS 1 +#elif defined(__APPLE__) + #define BENCHMARK_OS_APPLE 1 + #include "TargetConditionals.h" + #if defined(TARGET_OS_MAC) + #define BENCHMARK_OS_MACOSX 1 + #if defined(TARGET_OS_IPHONE) + #define BENCHMARK_OS_IOS 1 + #endif + #endif +#elif defined(__FreeBSD__) + #define BENCHMARK_OS_FREEBSD 1 +#elif defined(__NetBSD__) + #define BENCHMARK_OS_NETBSD 1 +#elif defined(__OpenBSD__) + #define BENCHMARK_OS_OPENBSD 1 +#elif defined(__linux__) + #define BENCHMARK_OS_LINUX 1 +#elif defined(__native_client__) + #define BENCHMARK_OS_NACL 1 +#elif defined(__EMSCRIPTEN__) + #define BENCHMARK_OS_EMSCRIPTEN 1 +#elif defined(__rtems__) + #define BENCHMARK_OS_RTEMS 1 +#elif defined(__Fuchsia__) +#define BENCHMARK_OS_FUCHSIA 1 +#elif defined (__SVR4) && defined (__sun) +#define BENCHMARK_OS_SOLARIS 1 +#endif + +#if !__has_feature(cxx_exceptions) && !defined(__cpp_exceptions) \ + && !defined(__EXCEPTIONS) + #define BENCHMARK_HAS_NO_EXCEPTIONS +#endif + +#if defined(COMPILER_CLANG) || defined(COMPILER_GCC) + #define BENCHMARK_MAYBE_UNUSED __attribute__((unused)) +#else + #define BENCHMARK_MAYBE_UNUSED +#endif + +#if defined(COMPILER_GCC) || __has_builtin(__builtin_unreachable) + #define BENCHMARK_UNREACHABLE() __builtin_unreachable() +#elif defined(COMPILER_MSVC) + #define BENCHMARK_UNREACHABLE() __assume(false) +#else + #define BENCHMARK_UNREACHABLE() ((void)0) +#endif + +#endif // BENCHMARK_INTERNAL_MACROS_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/json_reporter.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/json_reporter.cc new file mode 100755 index 00000000000..685d6b097dc --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/json_reporter.cc @@ -0,0 +1,205 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" +#include "complexity.h" + +#include +#include +#include +#include +#include +#include +#include // for setprecision +#include + +#include "string_util.h" +#include "timers.h" + +namespace benchmark { + +namespace { + +std::string FormatKV(std::string const& key, std::string const& value) { + return StrFormat("\"%s\": \"%s\"", key.c_str(), value.c_str()); +} + +std::string FormatKV(std::string const& key, const char* value) { + return StrFormat("\"%s\": \"%s\"", key.c_str(), value); +} + +std::string FormatKV(std::string const& key, bool value) { + return StrFormat("\"%s\": %s", key.c_str(), value ? "true" : "false"); +} + +std::string FormatKV(std::string const& key, int64_t value) { + std::stringstream ss; + ss << '"' << key << "\": " << value; + return ss.str(); +} + +std::string FormatKV(std::string const& key, double value) { + std::stringstream ss; + ss << '"' << key << "\": "; + + const auto max_digits10 = std::numeric_limits::max_digits10; + const auto max_fractional_digits10 = max_digits10 - 1; + + ss << std::scientific << std::setprecision(max_fractional_digits10) << value; + return ss.str(); +} + +int64_t RoundDouble(double v) { return static_cast(v + 0.5); } + +} // end namespace + +bool JSONReporter::ReportContext(const Context& context) { + std::ostream& out = GetOutputStream(); + + out << "{\n"; + std::string inner_indent(2, ' '); + + // Open context block and print context information. + out << inner_indent << "\"context\": {\n"; + std::string indent(4, ' '); + + std::string walltime_value = LocalDateTimeString(); + out << indent << FormatKV("date", walltime_value) << ",\n"; + + if (Context::executable_name) { + out << indent << FormatKV("executable", Context::executable_name) << ",\n"; + } + + CPUInfo const& info = context.cpu_info; + out << indent << FormatKV("num_cpus", static_cast(info.num_cpus)) + << ",\n"; + out << indent + << FormatKV("mhz_per_cpu", + RoundDouble(info.cycles_per_second / 1000000.0)) + << ",\n"; + out << indent << FormatKV("cpu_scaling_enabled", info.scaling_enabled) + << ",\n"; + + out << indent << "\"caches\": [\n"; + indent = std::string(6, ' '); + std::string cache_indent(8, ' '); + for (size_t i = 0; i < info.caches.size(); ++i) { + auto& CI = info.caches[i]; + out << indent << "{\n"; + out << cache_indent << FormatKV("type", CI.type) << ",\n"; + out << cache_indent << FormatKV("level", static_cast(CI.level)) + << ",\n"; + out << cache_indent + << FormatKV("size", static_cast(CI.size) * 1000u) << ",\n"; + out << cache_indent + << FormatKV("num_sharing", static_cast(CI.num_sharing)) + << "\n"; + out << indent << "}"; + if (i != info.caches.size() - 1) out << ","; + out << "\n"; + } + indent = std::string(4, ' '); + out << indent << "],\n"; + +#if defined(NDEBUG) + const char build_type[] = "release"; +#else + const char build_type[] = "debug"; +#endif + out << indent << FormatKV("library_build_type", build_type) << "\n"; + // Close context block and open the list of benchmarks. + out << inner_indent << "},\n"; + out << inner_indent << "\"benchmarks\": [\n"; + return true; +} + +void JSONReporter::ReportRuns(std::vector const& reports) { + if (reports.empty()) { + return; + } + std::string indent(4, ' '); + std::ostream& out = GetOutputStream(); + if (!first_report_) { + out << ",\n"; + } + first_report_ = false; + + for (auto it = reports.begin(); it != reports.end(); ++it) { + out << indent << "{\n"; + PrintRunData(*it); + out << indent << '}'; + auto it_cp = it; + if (++it_cp != reports.end()) { + out << ",\n"; + } + } +} + +void JSONReporter::Finalize() { + // Close the list of benchmarks and the top level object. + GetOutputStream() << "\n ]\n}\n"; +} + +void JSONReporter::PrintRunData(Run const& run) { + std::string indent(6, ' '); + std::ostream& out = GetOutputStream(); + out << indent << FormatKV("name", run.benchmark_name) << ",\n"; + if (run.error_occurred) { + out << indent << FormatKV("error_occurred", run.error_occurred) << ",\n"; + out << indent << FormatKV("error_message", run.error_message) << ",\n"; + } + if (!run.report_big_o && !run.report_rms) { + out << indent << FormatKV("iterations", run.iterations) << ",\n"; + out << indent + << FormatKV("real_time", run.GetAdjustedRealTime()) + << ",\n"; + out << indent + << FormatKV("cpu_time", run.GetAdjustedCPUTime()); + out << ",\n" + << indent << FormatKV("time_unit", GetTimeUnitString(run.time_unit)); + } else if (run.report_big_o) { + out << indent + << FormatKV("cpu_coefficient", run.GetAdjustedCPUTime()) + << ",\n"; + out << indent + << FormatKV("real_coefficient", run.GetAdjustedRealTime()) + << ",\n"; + out << indent << FormatKV("big_o", GetBigOString(run.complexity)) << ",\n"; + out << indent << FormatKV("time_unit", GetTimeUnitString(run.time_unit)); + } else if (run.report_rms) { + out << indent + << FormatKV("rms", run.GetAdjustedCPUTime()); + } + if (run.bytes_per_second > 0.0) { + out << ",\n" + << indent + << FormatKV("bytes_per_second", run.bytes_per_second); + } + if (run.items_per_second > 0.0) { + out << ",\n" + << indent + << FormatKV("items_per_second", run.items_per_second); + } + for(auto &c : run.counters) { + out << ",\n" + << indent + << FormatKV(c.first, c.second); + } + if (!run.report_label.empty()) { + out << ",\n" << indent << FormatKV("label", run.report_label); + } + out << '\n'; +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/log.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/log.h new file mode 100755 index 00000000000..d06e1031db1 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/log.h @@ -0,0 +1,73 @@ +#ifndef BENCHMARK_LOG_H_ +#define BENCHMARK_LOG_H_ + +#include +#include + +#include "benchmark/benchmark.h" + +namespace benchmark { +namespace internal { + +typedef std::basic_ostream&(EndLType)(std::basic_ostream&); + +class LogType { + friend LogType& GetNullLogInstance(); + friend LogType& GetErrorLogInstance(); + + // FIXME: Add locking to output. + template + friend LogType& operator<<(LogType&, Tp const&); + friend LogType& operator<<(LogType&, EndLType*); + + private: + LogType(std::ostream* out) : out_(out) {} + std::ostream* out_; + BENCHMARK_DISALLOW_COPY_AND_ASSIGN(LogType); +}; + +template +LogType& operator<<(LogType& log, Tp const& value) { + if (log.out_) { + *log.out_ << value; + } + return log; +} + +inline LogType& operator<<(LogType& log, EndLType* m) { + if (log.out_) { + *log.out_ << m; + } + return log; +} + +inline int& LogLevel() { + static int log_level = 0; + return log_level; +} + +inline LogType& GetNullLogInstance() { + static LogType log(nullptr); + return log; +} + +inline LogType& GetErrorLogInstance() { + static LogType log(&std::clog); + return log; +} + +inline LogType& GetLogInstanceForLevel(int level) { + if (level <= LogLevel()) { + return GetErrorLogInstance(); + } + return GetNullLogInstance(); +} + +} // end namespace internal +} // end namespace benchmark + +#define VLOG(x) \ + (::benchmark::internal::GetLogInstanceForLevel(x) << "-- LOG(" << x << "):" \ + " ") + +#endif diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/mutex.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/mutex.h new file mode 100755 index 00000000000..5f461d05a0c --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/mutex.h @@ -0,0 +1,155 @@ +#ifndef BENCHMARK_MUTEX_H_ +#define BENCHMARK_MUTEX_H_ + +#include +#include + +#include "check.h" + +// Enable thread safety attributes only with clang. +// The attributes can be safely erased when compiling with other compilers. +#if defined(HAVE_THREAD_SAFETY_ATTRIBUTES) +#define THREAD_ANNOTATION_ATTRIBUTE__(x) __attribute__((x)) +#else +#define THREAD_ANNOTATION_ATTRIBUTE__(x) // no-op +#endif + +#define CAPABILITY(x) THREAD_ANNOTATION_ATTRIBUTE__(capability(x)) + +#define SCOPED_CAPABILITY THREAD_ANNOTATION_ATTRIBUTE__(scoped_lockable) + +#define GUARDED_BY(x) THREAD_ANNOTATION_ATTRIBUTE__(guarded_by(x)) + +#define PT_GUARDED_BY(x) THREAD_ANNOTATION_ATTRIBUTE__(pt_guarded_by(x)) + +#define ACQUIRED_BEFORE(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(acquired_before(__VA_ARGS__)) + +#define ACQUIRED_AFTER(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(acquired_after(__VA_ARGS__)) + +#define REQUIRES(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(requires_capability(__VA_ARGS__)) + +#define REQUIRES_SHARED(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(requires_shared_capability(__VA_ARGS__)) + +#define ACQUIRE(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(acquire_capability(__VA_ARGS__)) + +#define ACQUIRE_SHARED(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(acquire_shared_capability(__VA_ARGS__)) + +#define RELEASE(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(release_capability(__VA_ARGS__)) + +#define RELEASE_SHARED(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(release_shared_capability(__VA_ARGS__)) + +#define TRY_ACQUIRE(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(try_acquire_capability(__VA_ARGS__)) + +#define TRY_ACQUIRE_SHARED(...) \ + THREAD_ANNOTATION_ATTRIBUTE__(try_acquire_shared_capability(__VA_ARGS__)) + +#define EXCLUDES(...) THREAD_ANNOTATION_ATTRIBUTE__(locks_excluded(__VA_ARGS__)) + +#define ASSERT_CAPABILITY(x) THREAD_ANNOTATION_ATTRIBUTE__(assert_capability(x)) + +#define ASSERT_SHARED_CAPABILITY(x) \ + THREAD_ANNOTATION_ATTRIBUTE__(assert_shared_capability(x)) + +#define RETURN_CAPABILITY(x) THREAD_ANNOTATION_ATTRIBUTE__(lock_returned(x)) + +#define NO_THREAD_SAFETY_ANALYSIS \ + THREAD_ANNOTATION_ATTRIBUTE__(no_thread_safety_analysis) + +namespace benchmark { + +typedef std::condition_variable Condition; + +// NOTE: Wrappers for std::mutex and std::unique_lock are provided so that +// we can annotate them with thread safety attributes and use the +// -Wthread-safety warning with clang. The standard library types cannot be +// used directly because they do not provided the required annotations. +class CAPABILITY("mutex") Mutex { + public: + Mutex() {} + + void lock() ACQUIRE() { mut_.lock(); } + void unlock() RELEASE() { mut_.unlock(); } + std::mutex& native_handle() { return mut_; } + + private: + std::mutex mut_; +}; + +class SCOPED_CAPABILITY MutexLock { + typedef std::unique_lock MutexLockImp; + + public: + MutexLock(Mutex& m) ACQUIRE(m) : ml_(m.native_handle()) {} + ~MutexLock() RELEASE() {} + MutexLockImp& native_handle() { return ml_; } + + private: + MutexLockImp ml_; +}; + +class Barrier { + public: + Barrier(int num_threads) : running_threads_(num_threads) {} + + // Called by each thread + bool wait() EXCLUDES(lock_) { + bool last_thread = false; + { + MutexLock ml(lock_); + last_thread = createBarrier(ml); + } + if (last_thread) phase_condition_.notify_all(); + return last_thread; + } + + void removeThread() EXCLUDES(lock_) { + MutexLock ml(lock_); + --running_threads_; + if (entered_ != 0) phase_condition_.notify_all(); + } + + private: + Mutex lock_; + Condition phase_condition_; + int running_threads_; + + // State for barrier management + int phase_number_ = 0; + int entered_ = 0; // Number of threads that have entered this barrier + + // Enter the barrier and wait until all other threads have also + // entered the barrier. Returns iff this is the last thread to + // enter the barrier. + bool createBarrier(MutexLock& ml) REQUIRES(lock_) { + CHECK_LT(entered_, running_threads_); + entered_++; + if (entered_ < running_threads_) { + // Wait for all threads to enter + int phase_number_cp = phase_number_; + auto cb = [this, phase_number_cp]() { + return this->phase_number_ > phase_number_cp || + entered_ == running_threads_; // A thread has aborted in error + }; + phase_condition_.wait(ml.native_handle(), cb); + if (phase_number_ > phase_number_cp) return false; + // else (running_threads_ == entered_) and we are the last thread. + } + // Last thread has reached the barrier + phase_number_++; + entered_ = 0; + return true; + } +}; + +} // end namespace benchmark + +#endif // BENCHMARK_MUTEX_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/re.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/re.h new file mode 100755 index 00000000000..924d2f0ba7e --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/re.h @@ -0,0 +1,152 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef BENCHMARK_RE_H_ +#define BENCHMARK_RE_H_ + +#include "internal_macros.h" + +#if !defined(HAVE_STD_REGEX) && \ + !defined(HAVE_GNU_POSIX_REGEX) && \ + !defined(HAVE_POSIX_REGEX) + // No explicit regex selection; detect based on builtin hints. + #if defined(BENCHMARK_OS_LINUX) || defined(BENCHMARK_OS_APPLE) + #define HAVE_POSIX_REGEX 1 + #elif __cplusplus >= 199711L + #define HAVE_STD_REGEX 1 + #endif +#endif + +// Prefer C regex libraries when compiling w/o exceptions so that we can +// correctly report errors. +#if defined(BENCHMARK_HAS_NO_EXCEPTIONS) && \ + defined(BENCHMARK_HAVE_STD_REGEX) && \ + (defined(HAVE_GNU_POSIX_REGEX) || defined(HAVE_POSIX_REGEX)) + #undef HAVE_STD_REGEX +#endif + +#if defined(HAVE_STD_REGEX) + #include +#elif defined(HAVE_GNU_POSIX_REGEX) + #include +#elif defined(HAVE_POSIX_REGEX) + #include +#else +#error No regular expression backend was found! +#endif +#include + +#include "check.h" + +namespace benchmark { + +// A wrapper around the POSIX regular expression API that provides automatic +// cleanup +class Regex { + public: + Regex() : init_(false) {} + + ~Regex(); + + // Compile a regular expression matcher from spec. Returns true on success. + // + // On failure (and if error is not nullptr), error is populated with a human + // readable error message if an error occurs. + bool Init(const std::string& spec, std::string* error); + + // Returns whether str matches the compiled regular expression. + bool Match(const std::string& str); + + private: + bool init_; +// Underlying regular expression object +#if defined(HAVE_STD_REGEX) + std::regex re_; +#elif defined(HAVE_POSIX_REGEX) || defined(HAVE_GNU_POSIX_REGEX) + regex_t re_; +#else + #error No regular expression backend implementation available +#endif +}; + +#if defined(HAVE_STD_REGEX) + +inline bool Regex::Init(const std::string& spec, std::string* error) { +#ifdef BENCHMARK_HAS_NO_EXCEPTIONS + ((void)error); // suppress unused warning +#else + try { +#endif + re_ = std::regex(spec, std::regex_constants::extended); + init_ = true; +#ifndef BENCHMARK_HAS_NO_EXCEPTIONS + } catch (const std::regex_error& e) { + if (error) { + *error = e.what(); + } + } +#endif + return init_; +} + +inline Regex::~Regex() {} + +inline bool Regex::Match(const std::string& str) { + if (!init_) { + return false; + } + return std::regex_search(str, re_); +} + +#else +inline bool Regex::Init(const std::string& spec, std::string* error) { + int ec = regcomp(&re_, spec.c_str(), REG_EXTENDED | REG_NOSUB); + if (ec != 0) { + if (error) { + size_t needed = regerror(ec, &re_, nullptr, 0); + char* errbuf = new char[needed]; + regerror(ec, &re_, errbuf, needed); + + // regerror returns the number of bytes necessary to null terminate + // the string, so we move that when assigning to error. + CHECK_NE(needed, 0); + error->assign(errbuf, needed - 1); + + delete[] errbuf; + } + + return false; + } + + init_ = true; + return true; +} + +inline Regex::~Regex() { + if (init_) { + regfree(&re_); + } +} + +inline bool Regex::Match(const std::string& str) { + if (!init_) { + return false; + } + return regexec(&re_, str.c_str(), 0, nullptr, 0) == 0; +} +#endif + +} // end namespace benchmark + +#endif // BENCHMARK_RE_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/reporter.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/reporter.cc new file mode 100755 index 00000000000..4b40aaec8b9 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/reporter.cc @@ -0,0 +1,87 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" +#include "timers.h" + +#include + +#include +#include +#include + +#include "check.h" + +namespace benchmark { + +BenchmarkReporter::BenchmarkReporter() + : output_stream_(&std::cout), error_stream_(&std::cerr) {} + +BenchmarkReporter::~BenchmarkReporter() {} + +void BenchmarkReporter::PrintBasicContext(std::ostream *out, + Context const &context) { + CHECK(out) << "cannot be null"; + auto &Out = *out; + + Out << LocalDateTimeString() << "\n"; + + if (context.executable_name) + Out << "Running " << context.executable_name << "\n"; + + const CPUInfo &info = context.cpu_info; + Out << "Run on (" << info.num_cpus << " X " + << (info.cycles_per_second / 1000000.0) << " MHz CPU " + << ((info.num_cpus > 1) ? "s" : "") << ")\n"; + if (info.caches.size() != 0) { + Out << "CPU Caches:\n"; + for (auto &CInfo : info.caches) { + Out << " L" << CInfo.level << " " << CInfo.type << " " + << (CInfo.size / 1000) << "K"; + if (CInfo.num_sharing != 0) + Out << " (x" << (info.num_cpus / CInfo.num_sharing) << ")"; + Out << "\n"; + } + } + + if (info.scaling_enabled) { + Out << "***WARNING*** CPU scaling is enabled, the benchmark " + "real time measurements may be noisy and will incur extra " + "overhead.\n"; + } + +#ifndef NDEBUG + Out << "***WARNING*** Library was built as DEBUG. Timings may be " + "affected.\n"; +#endif +} + +// No initializer because it's already initialized to NULL. +const char* BenchmarkReporter::Context::executable_name; + +BenchmarkReporter::Context::Context() : cpu_info(CPUInfo::Get()) {} + +double BenchmarkReporter::Run::GetAdjustedRealTime() const { + double new_time = real_accumulated_time * GetTimeUnitMultiplier(time_unit); + if (iterations != 0) new_time /= static_cast(iterations); + return new_time; +} + +double BenchmarkReporter::Run::GetAdjustedCPUTime() const { + double new_time = cpu_accumulated_time * GetTimeUnitMultiplier(time_unit); + if (iterations != 0) new_time /= static_cast(iterations); + return new_time; +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.cc new file mode 100755 index 00000000000..54aa04a4224 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.cc @@ -0,0 +1,51 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "sleep.h" + +#include +#include +#include + +#include "internal_macros.h" + +#ifdef BENCHMARK_OS_WINDOWS +#include +#endif + +namespace benchmark { +#ifdef BENCHMARK_OS_WINDOWS +// Window's Sleep takes milliseconds argument. +void SleepForMilliseconds(int milliseconds) { Sleep(milliseconds); } +void SleepForSeconds(double seconds) { + SleepForMilliseconds(static_cast(kNumMillisPerSecond * seconds)); +} +#else // BENCHMARK_OS_WINDOWS +void SleepForMicroseconds(int microseconds) { + struct timespec sleep_time; + sleep_time.tv_sec = microseconds / kNumMicrosPerSecond; + sleep_time.tv_nsec = (microseconds % kNumMicrosPerSecond) * kNumNanosPerMicro; + while (nanosleep(&sleep_time, &sleep_time) != 0 && errno == EINTR) + ; // Ignore signals and wait for the full interval to elapse. +} + +void SleepForMilliseconds(int milliseconds) { + SleepForMicroseconds(milliseconds * kNumMicrosPerMilli); +} + +void SleepForSeconds(double seconds) { + SleepForMicroseconds(static_cast(seconds * kNumMicrosPerSecond)); +} +#endif // BENCHMARK_OS_WINDOWS +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.h new file mode 100755 index 00000000000..f98551afe28 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sleep.h @@ -0,0 +1,15 @@ +#ifndef BENCHMARK_SLEEP_H_ +#define BENCHMARK_SLEEP_H_ + +namespace benchmark { +const int kNumMillisPerSecond = 1000; +const int kNumMicrosPerMilli = 1000; +const int kNumMicrosPerSecond = kNumMillisPerSecond * 1000; +const int kNumNanosPerMicro = 1000; +const int kNumNanosPerSecond = kNumNanosPerMicro * kNumMicrosPerSecond; + +void SleepForMilliseconds(int milliseconds); +void SleepForSeconds(double seconds); +} // end namespace benchmark + +#endif // BENCHMARK_SLEEP_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.cc new file mode 100755 index 00000000000..1c91e1015ab --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.cc @@ -0,0 +1,178 @@ +// Copyright 2016 Ismael Jimenez Martinez. All rights reserved. +// Copyright 2017 Roman Lebedev. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "benchmark/benchmark.h" + +#include +#include +#include +#include +#include +#include "check.h" +#include "statistics.h" + +namespace benchmark { + +auto StatisticsSum = [](const std::vector& v) { + return std::accumulate(v.begin(), v.end(), 0.0); +}; + +double StatisticsMean(const std::vector& v) { + if (v.empty()) return 0.0; + return StatisticsSum(v) * (1.0 / v.size()); +} + +double StatisticsMedian(const std::vector& v) { + if (v.size() < 3) return StatisticsMean(v); + std::vector copy(v); + + auto center = copy.begin() + v.size() / 2; + std::nth_element(copy.begin(), center, copy.end()); + + // did we have an odd number of samples? + // if yes, then center is the median + // it no, then we are looking for the average between center and the value before + if(v.size() % 2 == 1) + return *center; + auto center2 = copy.begin() + v.size() / 2 - 1; + std::nth_element(copy.begin(), center2, copy.end()); + return (*center + *center2) / 2.0; +} + +// Return the sum of the squares of this sample set +auto SumSquares = [](const std::vector& v) { + return std::inner_product(v.begin(), v.end(), v.begin(), 0.0); +}; + +auto Sqr = [](const double dat) { return dat * dat; }; +auto Sqrt = [](const double dat) { + // Avoid NaN due to imprecision in the calculations + if (dat < 0.0) return 0.0; + return std::sqrt(dat); +}; + +double StatisticsStdDev(const std::vector& v) { + const auto mean = StatisticsMean(v); + if (v.empty()) return mean; + + // Sample standard deviation is undefined for n = 1 + if (v.size() == 1) + return 0.0; + + const double avg_squares = SumSquares(v) * (1.0 / v.size()); + return Sqrt(v.size() / (v.size() - 1.0) * (avg_squares - Sqr(mean))); +} + +std::vector ComputeStats( + const std::vector& reports) { + typedef BenchmarkReporter::Run Run; + std::vector results; + + auto error_count = + std::count_if(reports.begin(), reports.end(), + [](Run const& run) { return run.error_occurred; }); + + if (reports.size() - error_count < 2) { + // We don't report aggregated data if there was a single run. + return results; + } + + // Accumulators. + std::vector real_accumulated_time_stat; + std::vector cpu_accumulated_time_stat; + std::vector bytes_per_second_stat; + std::vector items_per_second_stat; + + real_accumulated_time_stat.reserve(reports.size()); + cpu_accumulated_time_stat.reserve(reports.size()); + bytes_per_second_stat.reserve(reports.size()); + items_per_second_stat.reserve(reports.size()); + + // All repetitions should be run with the same number of iterations so we + // can take this information from the first benchmark. + int64_t const run_iterations = reports.front().iterations; + // create stats for user counters + struct CounterStat { + Counter c; + std::vector s; + }; + std::map< std::string, CounterStat > counter_stats; + for(Run const& r : reports) { + for(auto const& cnt : r.counters) { + auto it = counter_stats.find(cnt.first); + if(it == counter_stats.end()) { + counter_stats.insert({cnt.first, {cnt.second, std::vector{}}}); + it = counter_stats.find(cnt.first); + it->second.s.reserve(reports.size()); + } else { + CHECK_EQ(counter_stats[cnt.first].c.flags, cnt.second.flags); + } + } + } + + // Populate the accumulators. + for (Run const& run : reports) { + CHECK_EQ(reports[0].benchmark_name, run.benchmark_name); + CHECK_EQ(run_iterations, run.iterations); + if (run.error_occurred) continue; + real_accumulated_time_stat.emplace_back(run.real_accumulated_time); + cpu_accumulated_time_stat.emplace_back(run.cpu_accumulated_time); + items_per_second_stat.emplace_back(run.items_per_second); + bytes_per_second_stat.emplace_back(run.bytes_per_second); + // user counters + for(auto const& cnt : run.counters) { + auto it = counter_stats.find(cnt.first); + CHECK_NE(it, counter_stats.end()); + it->second.s.emplace_back(cnt.second); + } + } + + // Only add label if it is same for all runs + std::string report_label = reports[0].report_label; + for (std::size_t i = 1; i < reports.size(); i++) { + if (reports[i].report_label != report_label) { + report_label = ""; + break; + } + } + + for(const auto& Stat : *reports[0].statistics) { + // Get the data from the accumulator to BenchmarkReporter::Run's. + Run data; + data.benchmark_name = reports[0].benchmark_name + "_" + Stat.name_; + data.report_label = report_label; + data.iterations = run_iterations; + + data.real_accumulated_time = Stat.compute_(real_accumulated_time_stat); + data.cpu_accumulated_time = Stat.compute_(cpu_accumulated_time_stat); + data.bytes_per_second = Stat.compute_(bytes_per_second_stat); + data.items_per_second = Stat.compute_(items_per_second_stat); + + data.time_unit = reports[0].time_unit; + + // user counters + for(auto const& kv : counter_stats) { + const auto uc_stat = Stat.compute_(kv.second.s); + auto c = Counter(uc_stat, counter_stats[kv.first].c.flags); + data.counters[kv.first] = c; + } + + results.push_back(data); + } + + return results; +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.h new file mode 100755 index 00000000000..7eccc85536a --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/statistics.h @@ -0,0 +1,37 @@ +// Copyright 2016 Ismael Jimenez Martinez. All rights reserved. +// Copyright 2017 Roman Lebedev. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#ifndef STATISTICS_H_ +#define STATISTICS_H_ + +#include + +#include "benchmark/benchmark.h" + +namespace benchmark { + +// Return a vector containing the mean, median and standard devation information +// (and any user-specified info) for the specified list of reports. If 'reports' +// contains less than two non-errored runs an empty vector is returned +std::vector ComputeStats( + const std::vector& reports); + +double StatisticsMean(const std::vector& v); +double StatisticsMedian(const std::vector& v); +double StatisticsStdDev(const std::vector& v); + +} // end namespace benchmark + +#endif // STATISTICS_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.cc new file mode 100755 index 00000000000..ebc3acebd2a --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.cc @@ -0,0 +1,172 @@ +#include "string_util.h" + +#include +#include +#include +#include +#include +#include + +#include "arraysize.h" + +namespace benchmark { +namespace { + +// kilo, Mega, Giga, Tera, Peta, Exa, Zetta, Yotta. +const char kBigSIUnits[] = "kMGTPEZY"; +// Kibi, Mebi, Gibi, Tebi, Pebi, Exbi, Zebi, Yobi. +const char kBigIECUnits[] = "KMGTPEZY"; +// milli, micro, nano, pico, femto, atto, zepto, yocto. +const char kSmallSIUnits[] = "munpfazy"; + +// We require that all three arrays have the same size. +static_assert(arraysize(kBigSIUnits) == arraysize(kBigIECUnits), + "SI and IEC unit arrays must be the same size"); +static_assert(arraysize(kSmallSIUnits) == arraysize(kBigSIUnits), + "Small SI and Big SI unit arrays must be the same size"); + +static const int64_t kUnitsSize = arraysize(kBigSIUnits); + +void ToExponentAndMantissa(double val, double thresh, int precision, + double one_k, std::string* mantissa, + int64_t* exponent) { + std::stringstream mantissa_stream; + + if (val < 0) { + mantissa_stream << "-"; + val = -val; + } + + // Adjust threshold so that it never excludes things which can't be rendered + // in 'precision' digits. + const double adjusted_threshold = + std::max(thresh, 1.0 / std::pow(10.0, precision)); + const double big_threshold = adjusted_threshold * one_k; + const double small_threshold = adjusted_threshold; + // Values in ]simple_threshold,small_threshold[ will be printed as-is + const double simple_threshold = 0.01; + + if (val > big_threshold) { + // Positive powers + double scaled = val; + for (size_t i = 0; i < arraysize(kBigSIUnits); ++i) { + scaled /= one_k; + if (scaled <= big_threshold) { + mantissa_stream << scaled; + *exponent = i + 1; + *mantissa = mantissa_stream.str(); + return; + } + } + mantissa_stream << val; + *exponent = 0; + } else if (val < small_threshold) { + // Negative powers + if (val < simple_threshold) { + double scaled = val; + for (size_t i = 0; i < arraysize(kSmallSIUnits); ++i) { + scaled *= one_k; + if (scaled >= small_threshold) { + mantissa_stream << scaled; + *exponent = -static_cast(i + 1); + *mantissa = mantissa_stream.str(); + return; + } + } + } + mantissa_stream << val; + *exponent = 0; + } else { + mantissa_stream << val; + *exponent = 0; + } + *mantissa = mantissa_stream.str(); +} + +std::string ExponentToPrefix(int64_t exponent, bool iec) { + if (exponent == 0) return ""; + + const int64_t index = (exponent > 0 ? exponent - 1 : -exponent - 1); + if (index >= kUnitsSize) return ""; + + const char* array = + (exponent > 0 ? (iec ? kBigIECUnits : kBigSIUnits) : kSmallSIUnits); + if (iec) + return array[index] + std::string("i"); + else + return std::string(1, array[index]); +} + +std::string ToBinaryStringFullySpecified(double value, double threshold, + int precision, double one_k = 1024.0) { + std::string mantissa; + int64_t exponent; + ToExponentAndMantissa(value, threshold, precision, one_k, &mantissa, + &exponent); + return mantissa + ExponentToPrefix(exponent, false); +} + +} // end namespace + +void AppendHumanReadable(int n, std::string* str) { + std::stringstream ss; + // Round down to the nearest SI prefix. + ss << ToBinaryStringFullySpecified(n, 1.0, 0); + *str += ss.str(); +} + +std::string HumanReadableNumber(double n, double one_k) { + // 1.1 means that figures up to 1.1k should be shown with the next unit down; + // this softens edge effects. + // 1 means that we should show one decimal place of precision. + return ToBinaryStringFullySpecified(n, 1.1, 1, one_k); +} + +std::string StrFormatImp(const char* msg, va_list args) { + // we might need a second shot at this, so pre-emptivly make a copy + va_list args_cp; + va_copy(args_cp, args); + + // TODO(ericwf): use std::array for first attempt to avoid one memory + // allocation guess what the size might be + std::array local_buff; + std::size_t size = local_buff.size(); + // 2015-10-08: vsnprintf is used instead of snd::vsnprintf due to a limitation + // in the android-ndk + auto ret = vsnprintf(local_buff.data(), size, msg, args_cp); + + va_end(args_cp); + + // handle empty expansion + if (ret == 0) return std::string{}; + if (static_cast(ret) < size) + return std::string(local_buff.data()); + + // we did not provide a long enough buffer on our first attempt. + // add 1 to size to account for null-byte in size cast to prevent overflow + size = static_cast(ret) + 1; + auto buff_ptr = std::unique_ptr(new char[size]); + // 2015-10-08: vsnprintf is used instead of snd::vsnprintf due to a limitation + // in the android-ndk + ret = vsnprintf(buff_ptr.get(), size, msg, args); + return std::string(buff_ptr.get()); +} + +std::string StrFormat(const char* format, ...) { + va_list args; + va_start(args, format); + std::string tmp = StrFormatImp(format, args); + va_end(args); + return tmp; +} + +void ReplaceAll(std::string* str, const std::string& from, + const std::string& to) { + std::size_t start = 0; + while ((start = str->find(from, start)) != std::string::npos) { + str->replace(start, from.length(), to); + start += to.length(); + } +} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.h new file mode 100755 index 00000000000..e70e7698724 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/string_util.h @@ -0,0 +1,40 @@ +#ifndef BENCHMARK_STRING_UTIL_H_ +#define BENCHMARK_STRING_UTIL_H_ + +#include +#include +#include +#include "internal_macros.h" + +namespace benchmark { + +void AppendHumanReadable(int n, std::string* str); + +std::string HumanReadableNumber(double n, double one_k = 1024.0); + +std::string StrFormat(const char* format, ...); + +inline std::ostream& StrCatImp(std::ostream& out) BENCHMARK_NOEXCEPT { + return out; +} + +template +inline std::ostream& StrCatImp(std::ostream& out, First&& f, + Rest&&... rest) { + out << std::forward(f); + return StrCatImp(out, std::forward(rest)...); +} + +template +inline std::string StrCat(Args&&... args) { + std::ostringstream ss; + StrCatImp(ss, std::forward(args)...); + return ss.str(); +} + +void ReplaceAll(std::string* str, const std::string& from, + const std::string& to); + +} // end namespace benchmark + +#endif // BENCHMARK_STRING_UTIL_H_ diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sysinfo.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sysinfo.cc new file mode 100755 index 00000000000..d19d0ef4c1e --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/sysinfo.cc @@ -0,0 +1,587 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "internal_macros.h" + +#ifdef BENCHMARK_OS_WINDOWS +#include +#undef StrCat // Don't let StrCat in string_util.h be renamed to lstrcatA +#include +#include +#else +#include +#ifndef BENCHMARK_OS_FUCHSIA +#include +#endif +#include +#include // this header must be included before 'sys/sysctl.h' to avoid compilation error on FreeBSD +#include +#if defined BENCHMARK_OS_FREEBSD || defined BENCHMARK_OS_MACOSX || \ + defined BENCHMARK_OS_NETBSD || defined BENCHMARK_OS_OPENBSD +#define BENCHMARK_HAS_SYSCTL +#include +#endif +#endif +#if defined(BENCHMARK_OS_SOLARIS) +#include +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "check.h" +#include "cycleclock.h" +#include "internal_macros.h" +#include "log.h" +#include "sleep.h" +#include "string_util.h" + +namespace benchmark { +namespace { + +void PrintImp(std::ostream& out) { out << std::endl; } + +template +void PrintImp(std::ostream& out, First&& f, Rest&&... rest) { + out << std::forward(f); + PrintImp(out, std::forward(rest)...); +} + +template +BENCHMARK_NORETURN void PrintErrorAndDie(Args&&... args) { + PrintImp(std::cerr, std::forward(args)...); + std::exit(EXIT_FAILURE); +} + +#ifdef BENCHMARK_HAS_SYSCTL + +/// ValueUnion - A type used to correctly alias the byte-for-byte output of +/// `sysctl` with the result type it's to be interpreted as. +struct ValueUnion { + union DataT { + uint32_t uint32_value; + uint64_t uint64_value; + // For correct aliasing of union members from bytes. + char bytes[8]; + }; + using DataPtr = std::unique_ptr; + + // The size of the data union member + its trailing array size. + size_t Size; + DataPtr Buff; + + public: + ValueUnion() : Size(0), Buff(nullptr, &std::free) {} + + explicit ValueUnion(size_t BuffSize) + : Size(sizeof(DataT) + BuffSize), + Buff(::new (std::malloc(Size)) DataT(), &std::free) {} + + ValueUnion(ValueUnion&& other) = default; + + explicit operator bool() const { return bool(Buff); } + + char* data() const { return Buff->bytes; } + + std::string GetAsString() const { return std::string(data()); } + + int64_t GetAsInteger() const { + if (Size == sizeof(Buff->uint32_value)) + return static_cast(Buff->uint32_value); + else if (Size == sizeof(Buff->uint64_value)) + return static_cast(Buff->uint64_value); + BENCHMARK_UNREACHABLE(); + } + + uint64_t GetAsUnsigned() const { + if (Size == sizeof(Buff->uint32_value)) + return Buff->uint32_value; + else if (Size == sizeof(Buff->uint64_value)) + return Buff->uint64_value; + BENCHMARK_UNREACHABLE(); + } + + template + std::array GetAsArray() { + const int ArrSize = sizeof(T) * N; + CHECK_LE(ArrSize, Size); + std::array Arr; + std::memcpy(Arr.data(), data(), ArrSize); + return Arr; + } +}; + +ValueUnion GetSysctlImp(std::string const& Name) { +#if defined BENCHMARK_OS_OPENBSD + int mib[2]; + + mib[0] = CTL_HW; + if ((Name == "hw.ncpu") || (Name == "hw.cpuspeed")){ + ValueUnion buff(sizeof(int)); + + if (Name == "hw.ncpu") { + mib[1] = HW_NCPU; + } else { + mib[1] = HW_CPUSPEED; + } + + if (sysctl(mib, 2, buff.data(), &buff.Size, nullptr, 0) == -1) { + return ValueUnion(); + } + return buff; + } + return ValueUnion(); +#else + size_t CurBuffSize = 0; + if (sysctlbyname(Name.c_str(), nullptr, &CurBuffSize, nullptr, 0) == -1) + return ValueUnion(); + + ValueUnion buff(CurBuffSize); + if (sysctlbyname(Name.c_str(), buff.data(), &buff.Size, nullptr, 0) == 0) + return buff; + return ValueUnion(); +#endif +} + +BENCHMARK_MAYBE_UNUSED +bool GetSysctl(std::string const& Name, std::string* Out) { + Out->clear(); + auto Buff = GetSysctlImp(Name); + if (!Buff) return false; + Out->assign(Buff.data()); + return true; +} + +template ::value>::type> +bool GetSysctl(std::string const& Name, Tp* Out) { + *Out = 0; + auto Buff = GetSysctlImp(Name); + if (!Buff) return false; + *Out = static_cast(Buff.GetAsUnsigned()); + return true; +} + +template +bool GetSysctl(std::string const& Name, std::array* Out) { + auto Buff = GetSysctlImp(Name); + if (!Buff) return false; + *Out = Buff.GetAsArray(); + return true; +} +#endif + +template +bool ReadFromFile(std::string const& fname, ArgT* arg) { + *arg = ArgT(); + std::ifstream f(fname.c_str()); + if (!f.is_open()) return false; + f >> *arg; + return f.good(); +} + +bool CpuScalingEnabled(int num_cpus) { + // We don't have a valid CPU count, so don't even bother. + if (num_cpus <= 0) return false; +#ifndef BENCHMARK_OS_WINDOWS + // On Linux, the CPUfreq subsystem exposes CPU information as files on the + // local file system. If reading the exported files fails, then we may not be + // running on Linux, so we silently ignore all the read errors. + std::string res; + for (int cpu = 0; cpu < num_cpus; ++cpu) { + std::string governor_file = + StrCat("/sys/devices/system/cpu/cpu", cpu, "/cpufreq/scaling_governor"); + if (ReadFromFile(governor_file, &res) && res != "performance") return true; + } +#endif + return false; +} + +int CountSetBitsInCPUMap(std::string Val) { + auto CountBits = [](std::string Part) { + using CPUMask = std::bitset; + Part = "0x" + Part; + CPUMask Mask(std::stoul(Part, nullptr, 16)); + return static_cast(Mask.count()); + }; + size_t Pos; + int total = 0; + while ((Pos = Val.find(',')) != std::string::npos) { + total += CountBits(Val.substr(0, Pos)); + Val = Val.substr(Pos + 1); + } + if (!Val.empty()) { + total += CountBits(Val); + } + return total; +} + +BENCHMARK_MAYBE_UNUSED +std::vector GetCacheSizesFromKVFS() { + std::vector res; + std::string dir = "/sys/devices/system/cpu/cpu0/cache/"; + int Idx = 0; + while (true) { + CPUInfo::CacheInfo info; + std::string FPath = StrCat(dir, "index", Idx++, "/"); + std::ifstream f(StrCat(FPath, "size").c_str()); + if (!f.is_open()) break; + std::string suffix; + f >> info.size; + if (f.fail()) + PrintErrorAndDie("Failed while reading file '", FPath, "size'"); + if (f.good()) { + f >> suffix; + if (f.bad()) + PrintErrorAndDie( + "Invalid cache size format: failed to read size suffix"); + else if (f && suffix != "K") + PrintErrorAndDie("Invalid cache size format: Expected bytes ", suffix); + else if (suffix == "K") + info.size *= 1000; + } + if (!ReadFromFile(StrCat(FPath, "type"), &info.type)) + PrintErrorAndDie("Failed to read from file ", FPath, "type"); + if (!ReadFromFile(StrCat(FPath, "level"), &info.level)) + PrintErrorAndDie("Failed to read from file ", FPath, "level"); + std::string map_str; + if (!ReadFromFile(StrCat(FPath, "shared_cpu_map"), &map_str)) + PrintErrorAndDie("Failed to read from file ", FPath, "shared_cpu_map"); + info.num_sharing = CountSetBitsInCPUMap(map_str); + res.push_back(info); + } + + return res; +} + +#ifdef BENCHMARK_OS_MACOSX +std::vector GetCacheSizesMacOSX() { + std::vector res; + std::array CacheCounts{{0, 0, 0, 0}}; + GetSysctl("hw.cacheconfig", &CacheCounts); + + struct { + std::string name; + std::string type; + int level; + size_t num_sharing; + } Cases[] = {{"hw.l1dcachesize", "Data", 1, CacheCounts[1]}, + {"hw.l1icachesize", "Instruction", 1, CacheCounts[1]}, + {"hw.l2cachesize", "Unified", 2, CacheCounts[2]}, + {"hw.l3cachesize", "Unified", 3, CacheCounts[3]}}; + for (auto& C : Cases) { + int val; + if (!GetSysctl(C.name, &val)) continue; + CPUInfo::CacheInfo info; + info.type = C.type; + info.level = C.level; + info.size = val; + info.num_sharing = static_cast(C.num_sharing); + res.push_back(std::move(info)); + } + return res; +} +#elif defined(BENCHMARK_OS_WINDOWS) +std::vector GetCacheSizesWindows() { + std::vector res; + DWORD buffer_size = 0; + using PInfo = SYSTEM_LOGICAL_PROCESSOR_INFORMATION; + using CInfo = CACHE_DESCRIPTOR; + + using UPtr = std::unique_ptr; + GetLogicalProcessorInformation(nullptr, &buffer_size); + UPtr buff((PInfo*)malloc(buffer_size), &std::free); + if (!GetLogicalProcessorInformation(buff.get(), &buffer_size)) + PrintErrorAndDie("Failed during call to GetLogicalProcessorInformation: ", + GetLastError()); + + PInfo* it = buff.get(); + PInfo* end = buff.get() + (buffer_size / sizeof(PInfo)); + + for (; it != end; ++it) { + if (it->Relationship != RelationCache) continue; + using BitSet = std::bitset; + BitSet B(it->ProcessorMask); + // To prevent duplicates, only consider caches where CPU 0 is specified + if (!B.test(0)) continue; + CInfo* Cache = &it->Cache; + CPUInfo::CacheInfo C; + C.num_sharing = static_cast(B.count()); + C.level = Cache->Level; + C.size = Cache->Size; + switch (Cache->Type) { + case CacheUnified: + C.type = "Unified"; + break; + case CacheInstruction: + C.type = "Instruction"; + break; + case CacheData: + C.type = "Data"; + break; + case CacheTrace: + C.type = "Trace"; + break; + default: + C.type = "Unknown"; + break; + } + res.push_back(C); + } + return res; +} +#endif + +std::vector GetCacheSizes() { +#ifdef BENCHMARK_OS_MACOSX + return GetCacheSizesMacOSX(); +#elif defined(BENCHMARK_OS_WINDOWS) + return GetCacheSizesWindows(); +#else + return GetCacheSizesFromKVFS(); +#endif +} + +int GetNumCPUs() { +#ifdef BENCHMARK_HAS_SYSCTL + int NumCPU = -1; + if (GetSysctl("hw.ncpu", &NumCPU)) return NumCPU; + fprintf(stderr, "Err: %s\n", strerror(errno)); + std::exit(EXIT_FAILURE); +#elif defined(BENCHMARK_OS_WINDOWS) + SYSTEM_INFO sysinfo; + // Use memset as opposed to = {} to avoid GCC missing initializer false + // positives. + std::memset(&sysinfo, 0, sizeof(SYSTEM_INFO)); + GetSystemInfo(&sysinfo); + return sysinfo.dwNumberOfProcessors; // number of logical + // processors in the current + // group +#elif defined(BENCHMARK_OS_SOLARIS) + // Returns -1 in case of a failure. + int NumCPU = sysconf(_SC_NPROCESSORS_ONLN); + if (NumCPU < 0) { + fprintf(stderr, + "sysconf(_SC_NPROCESSORS_ONLN) failed with error: %s\n", + strerror(errno)); + } + return NumCPU; +#else + int NumCPUs = 0; + int MaxID = -1; + std::ifstream f("/proc/cpuinfo"); + if (!f.is_open()) { + std::cerr << "failed to open /proc/cpuinfo\n"; + return -1; + } + const std::string Key = "processor"; + std::string ln; + while (std::getline(f, ln)) { + if (ln.empty()) continue; + size_t SplitIdx = ln.find(':'); + std::string value; + if (SplitIdx != std::string::npos) value = ln.substr(SplitIdx + 1); + if (ln.size() >= Key.size() && ln.compare(0, Key.size(), Key) == 0) { + NumCPUs++; + if (!value.empty()) { + int CurID = std::stoi(value); + MaxID = std::max(CurID, MaxID); + } + } + } + if (f.bad()) { + std::cerr << "Failure reading /proc/cpuinfo\n"; + return -1; + } + if (!f.eof()) { + std::cerr << "Failed to read to end of /proc/cpuinfo\n"; + return -1; + } + f.close(); + + if ((MaxID + 1) != NumCPUs) { + fprintf(stderr, + "CPU ID assignments in /proc/cpuinfo seem messed up." + " This is usually caused by a bad BIOS.\n"); + } + return NumCPUs; +#endif + BENCHMARK_UNREACHABLE(); +} + +double GetCPUCyclesPerSecond() { +#if defined BENCHMARK_OS_LINUX || defined BENCHMARK_OS_CYGWIN + long freq; + + // If the kernel is exporting the tsc frequency use that. There are issues + // where cpuinfo_max_freq cannot be relied on because the BIOS may be + // exporintg an invalid p-state (on x86) or p-states may be used to put the + // processor in a new mode (turbo mode). Essentially, those frequencies + // cannot always be relied upon. The same reasons apply to /proc/cpuinfo as + // well. + if (ReadFromFile("/sys/devices/system/cpu/cpu0/tsc_freq_khz", &freq) + // If CPU scaling is in effect, we want to use the *maximum* frequency, + // not whatever CPU speed some random processor happens to be using now. + || ReadFromFile("/sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_max_freq", + &freq)) { + // The value is in kHz (as the file name suggests). For example, on a + // 2GHz warpstation, the file contains the value "2000000". + return freq * 1000.0; + } + + const double error_value = -1; + double bogo_clock = error_value; + + std::ifstream f("/proc/cpuinfo"); + if (!f.is_open()) { + std::cerr << "failed to open /proc/cpuinfo\n"; + return error_value; + } + + auto startsWithKey = [](std::string const& Value, std::string const& Key) { + if (Key.size() > Value.size()) return false; + auto Cmp = [&](char X, char Y) { + return std::tolower(X) == std::tolower(Y); + }; + return std::equal(Key.begin(), Key.end(), Value.begin(), Cmp); + }; + + std::string ln; + while (std::getline(f, ln)) { + if (ln.empty()) continue; + size_t SplitIdx = ln.find(':'); + std::string value; + if (SplitIdx != std::string::npos) value = ln.substr(SplitIdx + 1); + // When parsing the "cpu MHz" and "bogomips" (fallback) entries, we only + // accept positive values. Some environments (virtual machines) report zero, + // which would cause infinite looping in WallTime_Init. + if (startsWithKey(ln, "cpu MHz")) { + if (!value.empty()) { + double cycles_per_second = std::stod(value) * 1000000.0; + if (cycles_per_second > 0) return cycles_per_second; + } + } else if (startsWithKey(ln, "bogomips")) { + if (!value.empty()) { + bogo_clock = std::stod(value) * 1000000.0; + if (bogo_clock < 0.0) bogo_clock = error_value; + } + } + } + if (f.bad()) { + std::cerr << "Failure reading /proc/cpuinfo\n"; + return error_value; + } + if (!f.eof()) { + std::cerr << "Failed to read to end of /proc/cpuinfo\n"; + return error_value; + } + f.close(); + // If we found the bogomips clock, but nothing better, we'll use it (but + // we're not happy about it); otherwise, fallback to the rough estimation + // below. + if (bogo_clock >= 0.0) return bogo_clock; + +#elif defined BENCHMARK_HAS_SYSCTL + constexpr auto* FreqStr = +#if defined(BENCHMARK_OS_FREEBSD) || defined(BENCHMARK_OS_NETBSD) + "machdep.tsc_freq"; +#elif defined BENCHMARK_OS_OPENBSD + "hw.cpuspeed"; +#else + "hw.cpufrequency"; +#endif + unsigned long long hz = 0; +#if defined BENCHMARK_OS_OPENBSD + if (GetSysctl(FreqStr, &hz)) return hz * 1000000; +#else + if (GetSysctl(FreqStr, &hz)) return hz; +#endif + fprintf(stderr, "Unable to determine clock rate from sysctl: %s: %s\n", + FreqStr, strerror(errno)); + +#elif defined BENCHMARK_OS_WINDOWS + // In NT, read MHz from the registry. If we fail to do so or we're in win9x + // then make a crude estimate. + DWORD data, data_size = sizeof(data); + if (IsWindowsXPOrGreater() && + SUCCEEDED( + SHGetValueA(HKEY_LOCAL_MACHINE, + "HARDWARE\\DESCRIPTION\\System\\CentralProcessor\\0", + "~MHz", nullptr, &data, &data_size))) + return static_cast((int64_t)data * + (int64_t)(1000 * 1000)); // was mhz +#elif defined (BENCHMARK_OS_SOLARIS) + kstat_ctl_t *kc = kstat_open(); + if (!kc) { + std::cerr << "failed to open /dev/kstat\n"; + return -1; + } + kstat_t *ksp = kstat_lookup(kc, (char*)"cpu_info", -1, (char*)"cpu_info0"); + if (!ksp) { + std::cerr << "failed to lookup in /dev/kstat\n"; + return -1; + } + if (kstat_read(kc, ksp, NULL) < 0) { + std::cerr << "failed to read from /dev/kstat\n"; + return -1; + } + kstat_named_t *knp = + (kstat_named_t*)kstat_data_lookup(ksp, (char*)"current_clock_Hz"); + if (!knp) { + std::cerr << "failed to lookup data in /dev/kstat\n"; + return -1; + } + if (knp->data_type != KSTAT_DATA_UINT64) { + std::cerr << "current_clock_Hz is of unexpected data type: " + << knp->data_type << "\n"; + return -1; + } + double clock_hz = knp->value.ui64; + kstat_close(kc); + return clock_hz; +#endif + // If we've fallen through, attempt to roughly estimate the CPU clock rate. + const int estimate_time_ms = 1000; + const auto start_ticks = cycleclock::Now(); + SleepForMilliseconds(estimate_time_ms); + return static_cast(cycleclock::Now() - start_ticks); +} + +} // end namespace + +const CPUInfo& CPUInfo::Get() { + static const CPUInfo* info = new CPUInfo(); + return *info; +} + +CPUInfo::CPUInfo() + : num_cpus(GetNumCPUs()), + cycles_per_second(GetCPUCyclesPerSecond()), + caches(GetCacheSizes()), + scaling_enabled(CpuScalingEnabled(num_cpus)) {} + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_manager.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_manager.h new file mode 100755 index 00000000000..82b4d72b62f --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_manager.h @@ -0,0 +1,66 @@ +#ifndef BENCHMARK_THREAD_MANAGER_H +#define BENCHMARK_THREAD_MANAGER_H + +#include + +#include "benchmark/benchmark.h" +#include "mutex.h" + +namespace benchmark { +namespace internal { + +class ThreadManager { + public: + ThreadManager(int num_threads) + : alive_threads_(num_threads), start_stop_barrier_(num_threads) {} + + Mutex& GetBenchmarkMutex() const RETURN_CAPABILITY(benchmark_mutex_) { + return benchmark_mutex_; + } + + bool StartStopBarrier() EXCLUDES(end_cond_mutex_) { + return start_stop_barrier_.wait(); + } + + void NotifyThreadComplete() EXCLUDES(end_cond_mutex_) { + start_stop_barrier_.removeThread(); + if (--alive_threads_ == 0) { + MutexLock lock(end_cond_mutex_); + end_condition_.notify_all(); + } + } + + void WaitForAllThreads() EXCLUDES(end_cond_mutex_) { + MutexLock lock(end_cond_mutex_); + end_condition_.wait(lock.native_handle(), + [this]() { return alive_threads_ == 0; }); + } + + public: + struct Result { + int64_t iterations = 0; + double real_time_used = 0; + double cpu_time_used = 0; + double manual_time_used = 0; + int64_t bytes_processed = 0; + int64_t items_processed = 0; + int64_t complexity_n = 0; + std::string report_label_; + std::string error_message_; + bool has_error_ = false; + UserCounters counters; + }; + GUARDED_BY(GetBenchmarkMutex()) Result results; + + private: + mutable Mutex benchmark_mutex_; + std::atomic alive_threads_; + Barrier start_stop_barrier_; + Mutex end_cond_mutex_; + Condition end_condition_; +}; + +} // namespace internal +} // namespace benchmark + +#endif // BENCHMARK_THREAD_MANAGER_H diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_timer.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_timer.h new file mode 100755 index 00000000000..eaf108e017d --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/thread_timer.h @@ -0,0 +1,69 @@ +#ifndef BENCHMARK_THREAD_TIMER_H +#define BENCHMARK_THREAD_TIMER_H + +#include "check.h" +#include "timers.h" + +namespace benchmark { +namespace internal { + +class ThreadTimer { + public: + ThreadTimer() = default; + + // Called by each thread + void StartTimer() { + running_ = true; + start_real_time_ = ChronoClockNow(); + start_cpu_time_ = ThreadCPUUsage(); + } + + // Called by each thread + void StopTimer() { + CHECK(running_); + running_ = false; + real_time_used_ += ChronoClockNow() - start_real_time_; + // Floating point error can result in the subtraction producing a negative + // time. Guard against that. + cpu_time_used_ += std::max(ThreadCPUUsage() - start_cpu_time_, 0); + } + + // Called by each thread + void SetIterationTime(double seconds) { manual_time_used_ += seconds; } + + bool running() const { return running_; } + + // REQUIRES: timer is not running + double real_time_used() { + CHECK(!running_); + return real_time_used_; + } + + // REQUIRES: timer is not running + double cpu_time_used() { + CHECK(!running_); + return cpu_time_used_; + } + + // REQUIRES: timer is not running + double manual_time_used() { + CHECK(!running_); + return manual_time_used_; + } + + private: + bool running_ = false; // Is the timer running + double start_real_time_ = 0; // If running_ + double start_cpu_time_ = 0; // If running_ + + // Accumulated time so far (does not contain current slice if running_) + double real_time_used_ = 0; + double cpu_time_used_ = 0; + // Manually set iteration time. User sets this with SetIterationTime(seconds). + double manual_time_used_ = 0; +}; + +} // namespace internal +} // namespace benchmark + +#endif // BENCHMARK_THREAD_TIMER_H diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.cc b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.cc new file mode 100755 index 00000000000..2010e2450b4 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.cc @@ -0,0 +1,217 @@ +// Copyright 2015 Google Inc. All rights reserved. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +#include "timers.h" +#include "internal_macros.h" + +#ifdef BENCHMARK_OS_WINDOWS +#include +#undef StrCat // Don't let StrCat in string_util.h be renamed to lstrcatA +#include +#include +#else +#include +#ifndef BENCHMARK_OS_FUCHSIA +#include +#endif +#include +#include // this header must be included before 'sys/sysctl.h' to avoid compilation error on FreeBSD +#include +#if defined BENCHMARK_OS_FREEBSD || defined BENCHMARK_OS_MACOSX +#include +#endif +#if defined(BENCHMARK_OS_MACOSX) +#include +#include +#include +#endif +#endif + +#ifdef BENCHMARK_OS_EMSCRIPTEN +#include +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "check.h" +#include "log.h" +#include "sleep.h" +#include "string_util.h" + +namespace benchmark { + +// Suppress unused warnings on helper functions. +#if defined(__GNUC__) +#pragma GCC diagnostic ignored "-Wunused-function" +#endif + +namespace { +#if defined(BENCHMARK_OS_WINDOWS) +double MakeTime(FILETIME const& kernel_time, FILETIME const& user_time) { + ULARGE_INTEGER kernel; + ULARGE_INTEGER user; + kernel.HighPart = kernel_time.dwHighDateTime; + kernel.LowPart = kernel_time.dwLowDateTime; + user.HighPart = user_time.dwHighDateTime; + user.LowPart = user_time.dwLowDateTime; + return (static_cast(kernel.QuadPart) + + static_cast(user.QuadPart)) * + 1e-7; +} +#elif !defined(BENCHMARK_OS_FUCHSIA) +double MakeTime(struct rusage const& ru) { + return (static_cast(ru.ru_utime.tv_sec) + + static_cast(ru.ru_utime.tv_usec) * 1e-6 + + static_cast(ru.ru_stime.tv_sec) + + static_cast(ru.ru_stime.tv_usec) * 1e-6); +} +#endif +#if defined(BENCHMARK_OS_MACOSX) +double MakeTime(thread_basic_info_data_t const& info) { + return (static_cast(info.user_time.seconds) + + static_cast(info.user_time.microseconds) * 1e-6 + + static_cast(info.system_time.seconds) + + static_cast(info.system_time.microseconds) * 1e-6); +} +#endif +#if defined(CLOCK_PROCESS_CPUTIME_ID) || defined(CLOCK_THREAD_CPUTIME_ID) +double MakeTime(struct timespec const& ts) { + return ts.tv_sec + (static_cast(ts.tv_nsec) * 1e-9); +} +#endif + +BENCHMARK_NORETURN static void DiagnoseAndExit(const char* msg) { + std::cerr << "ERROR: " << msg << std::endl; + std::exit(EXIT_FAILURE); +} + +} // end namespace + +double ProcessCPUUsage() { +#if defined(BENCHMARK_OS_WINDOWS) + HANDLE proc = GetCurrentProcess(); + FILETIME creation_time; + FILETIME exit_time; + FILETIME kernel_time; + FILETIME user_time; + if (GetProcessTimes(proc, &creation_time, &exit_time, &kernel_time, + &user_time)) + return MakeTime(kernel_time, user_time); + DiagnoseAndExit("GetProccessTimes() failed"); +#elif defined(BENCHMARK_OS_EMSCRIPTEN) + // clock_gettime(CLOCK_PROCESS_CPUTIME_ID, ...) returns 0 on Emscripten. + // Use Emscripten-specific API. Reported CPU time would be exactly the + // same as total time, but this is ok because there aren't long-latency + // syncronous system calls in Emscripten. + return emscripten_get_now() * 1e-3; +#elif defined(CLOCK_PROCESS_CPUTIME_ID) && !defined(BENCHMARK_OS_MACOSX) + // FIXME We want to use clock_gettime, but its not available in MacOS 10.11. See + // https://github.com/google/benchmark/pull/292 + struct timespec spec; + if (clock_gettime(CLOCK_PROCESS_CPUTIME_ID, &spec) == 0) + return MakeTime(spec); + DiagnoseAndExit("clock_gettime(CLOCK_PROCESS_CPUTIME_ID, ...) failed"); +#else + struct rusage ru; + if (getrusage(RUSAGE_SELF, &ru) == 0) return MakeTime(ru); + DiagnoseAndExit("getrusage(RUSAGE_SELF, ...) failed"); +#endif +} + +double ThreadCPUUsage() { +#if defined(BENCHMARK_OS_WINDOWS) + HANDLE this_thread = GetCurrentThread(); + FILETIME creation_time; + FILETIME exit_time; + FILETIME kernel_time; + FILETIME user_time; + GetThreadTimes(this_thread, &creation_time, &exit_time, &kernel_time, + &user_time); + return MakeTime(kernel_time, user_time); +#elif defined(BENCHMARK_OS_MACOSX) + // FIXME We want to use clock_gettime, but its not available in MacOS 10.11. See + // https://github.com/google/benchmark/pull/292 + mach_msg_type_number_t count = THREAD_BASIC_INFO_COUNT; + thread_basic_info_data_t info; + mach_port_t thread = pthread_mach_thread_np(pthread_self()); + if (thread_info(thread, THREAD_BASIC_INFO, (thread_info_t)&info, &count) == + KERN_SUCCESS) { + return MakeTime(info); + } + DiagnoseAndExit("ThreadCPUUsage() failed when evaluating thread_info"); +#elif defined(BENCHMARK_OS_EMSCRIPTEN) + // Emscripten doesn't support traditional threads + return ProcessCPUUsage(); +#elif defined(BENCHMARK_OS_RTEMS) + // RTEMS doesn't support CLOCK_THREAD_CPUTIME_ID. See + // https://github.com/RTEMS/rtems/blob/master/cpukit/posix/src/clockgettime.c + return ProcessCPUUsage(); +#elif defined(BENCHMARK_OS_SOLARIS) + struct rusage ru; + if (getrusage(RUSAGE_LWP, &ru) == 0) return MakeTime(ru); + DiagnoseAndExit("getrusage(RUSAGE_LWP, ...) failed"); +#elif defined(CLOCK_THREAD_CPUTIME_ID) + struct timespec ts; + if (clock_gettime(CLOCK_THREAD_CPUTIME_ID, &ts) == 0) return MakeTime(ts); + DiagnoseAndExit("clock_gettime(CLOCK_THREAD_CPUTIME_ID, ...) failed"); +#else +#error Per-thread timing is not available on your system. +#endif +} + +namespace { + +std::string DateTimeString(bool local) { + typedef std::chrono::system_clock Clock; + std::time_t now = Clock::to_time_t(Clock::now()); + const std::size_t kStorageSize = 128; + char storage[kStorageSize]; + std::size_t written; + + if (local) { +#if defined(BENCHMARK_OS_WINDOWS) + written = + std::strftime(storage, sizeof(storage), "%x %X", ::localtime(&now)); +#else + std::tm timeinfo; + ::localtime_r(&now, &timeinfo); + written = std::strftime(storage, sizeof(storage), "%F %T", &timeinfo); +#endif + } else { +#if defined(BENCHMARK_OS_WINDOWS) + written = std::strftime(storage, sizeof(storage), "%x %X", ::gmtime(&now)); +#else + std::tm timeinfo; + ::gmtime_r(&now, &timeinfo); + written = std::strftime(storage, sizeof(storage), "%F %T", &timeinfo); +#endif + } + CHECK(written < kStorageSize); + ((void)written); // prevent unused variable in optimized mode. + return std::string(storage); +} + +} // end namespace + +std::string LocalDateTimeString() { return DateTimeString(true); } + +} // end namespace benchmark diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.h b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.h new file mode 100755 index 00000000000..65606ccd93d --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/src/timers.h @@ -0,0 +1,48 @@ +#ifndef BENCHMARK_TIMERS_H +#define BENCHMARK_TIMERS_H + +#include +#include + +namespace benchmark { + +// Return the CPU usage of the current process +double ProcessCPUUsage(); + +// Return the CPU usage of the children of the current process +double ChildrenCPUUsage(); + +// Return the CPU usage of the current thread +double ThreadCPUUsage(); + +#if defined(HAVE_STEADY_CLOCK) +template +struct ChooseSteadyClock { + typedef std::chrono::high_resolution_clock type; +}; + +template <> +struct ChooseSteadyClock { + typedef std::chrono::steady_clock type; +}; +#endif + +struct ChooseClockType { +#if defined(HAVE_STEADY_CLOCK) + typedef ChooseSteadyClock<>::type type; +#else + typedef std::chrono::high_resolution_clock type; +#endif +}; + +inline double ChronoClockNow() { + typedef ChooseClockType::type ClockType; + using FpSeconds = std::chrono::duration; + return FpSeconds(ClockType::now().time_since_epoch()).count(); +} + +std::string LocalDateTimeString(); + +} // end namespace benchmark + +#endif // BENCHMARK_TIMERS_H diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare.py b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare.py new file mode 100755 index 00000000000..f0a4455f5fb --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare.py @@ -0,0 +1,316 @@ +#!/usr/bin/env python + +""" +compare.py - versatile benchmark output compare tool +""" + +import argparse +from argparse import ArgumentParser +import sys +import gbench +from gbench import util, report +from gbench.util import * + + +def check_inputs(in1, in2, flags): + """ + Perform checking on the user provided inputs and diagnose any abnormalities + """ + in1_kind, in1_err = classify_input_file(in1) + in2_kind, in2_err = classify_input_file(in2) + output_file = find_benchmark_flag('--benchmark_out=', flags) + output_type = find_benchmark_flag('--benchmark_out_format=', flags) + if in1_kind == IT_Executable and in2_kind == IT_Executable and output_file: + print(("WARNING: '--benchmark_out=%s' will be passed to both " + "benchmarks causing it to be overwritten") % output_file) + if in1_kind == IT_JSON and in2_kind == IT_JSON and len(flags) > 0: + print("WARNING: passing optional flags has no effect since both " + "inputs are JSON") + if output_type is not None and output_type != 'json': + print(("ERROR: passing '--benchmark_out_format=%s' to 'compare.py`" + " is not supported.") % output_type) + sys.exit(1) + + +def create_parser(): + parser = ArgumentParser( + description='versatile benchmark output compare tool') + subparsers = parser.add_subparsers( + help='This tool has multiple modes of operation:', + dest='mode') + + parser_a = subparsers.add_parser( + 'benchmarks', + help='The most simple use-case, compare all the output of these two benchmarks') + baseline = parser_a.add_argument_group( + 'baseline', 'The benchmark baseline') + baseline.add_argument( + 'test_baseline', + metavar='test_baseline', + type=argparse.FileType('r'), + nargs=1, + help='A benchmark executable or JSON output file') + contender = parser_a.add_argument_group( + 'contender', 'The benchmark that will be compared against the baseline') + contender.add_argument( + 'test_contender', + metavar='test_contender', + type=argparse.FileType('r'), + nargs=1, + help='A benchmark executable or JSON output file') + parser_a.add_argument( + 'benchmark_options', + metavar='benchmark_options', + nargs=argparse.REMAINDER, + help='Arguments to pass when running benchmark executables') + + parser_b = subparsers.add_parser( + 'filters', help='Compare filter one with the filter two of benchmark') + baseline = parser_b.add_argument_group( + 'baseline', 'The benchmark baseline') + baseline.add_argument( + 'test', + metavar='test', + type=argparse.FileType('r'), + nargs=1, + help='A benchmark executable or JSON output file') + baseline.add_argument( + 'filter_baseline', + metavar='filter_baseline', + type=str, + nargs=1, + help='The first filter, that will be used as baseline') + contender = parser_b.add_argument_group( + 'contender', 'The benchmark that will be compared against the baseline') + contender.add_argument( + 'filter_contender', + metavar='filter_contender', + type=str, + nargs=1, + help='The second filter, that will be compared against the baseline') + parser_b.add_argument( + 'benchmark_options', + metavar='benchmark_options', + nargs=argparse.REMAINDER, + help='Arguments to pass when running benchmark executables') + + parser_c = subparsers.add_parser( + 'benchmarksfiltered', + help='Compare filter one of first benchmark with filter two of the second benchmark') + baseline = parser_c.add_argument_group( + 'baseline', 'The benchmark baseline') + baseline.add_argument( + 'test_baseline', + metavar='test_baseline', + type=argparse.FileType('r'), + nargs=1, + help='A benchmark executable or JSON output file') + baseline.add_argument( + 'filter_baseline', + metavar='filter_baseline', + type=str, + nargs=1, + help='The first filter, that will be used as baseline') + contender = parser_c.add_argument_group( + 'contender', 'The benchmark that will be compared against the baseline') + contender.add_argument( + 'test_contender', + metavar='test_contender', + type=argparse.FileType('r'), + nargs=1, + help='The second benchmark executable or JSON output file, that will be compared against the baseline') + contender.add_argument( + 'filter_contender', + metavar='filter_contender', + type=str, + nargs=1, + help='The second filter, that will be compared against the baseline') + parser_c.add_argument( + 'benchmark_options', + metavar='benchmark_options', + nargs=argparse.REMAINDER, + help='Arguments to pass when running benchmark executables') + + return parser + + +def main(): + # Parse the command line flags + parser = create_parser() + args, unknown_args = parser.parse_known_args() + if args.mode is None: + parser.print_help() + exit(1) + assert not unknown_args + benchmark_options = args.benchmark_options + + if args.mode == 'benchmarks': + test_baseline = args.test_baseline[0].name + test_contender = args.test_contender[0].name + filter_baseline = '' + filter_contender = '' + + # NOTE: if test_baseline == test_contender, you are analyzing the stdev + + description = 'Comparing %s to %s' % (test_baseline, test_contender) + elif args.mode == 'filters': + test_baseline = args.test[0].name + test_contender = args.test[0].name + filter_baseline = args.filter_baseline[0] + filter_contender = args.filter_contender[0] + + # NOTE: if filter_baseline == filter_contender, you are analyzing the + # stdev + + description = 'Comparing %s to %s (from %s)' % ( + filter_baseline, filter_contender, args.test[0].name) + elif args.mode == 'benchmarksfiltered': + test_baseline = args.test_baseline[0].name + test_contender = args.test_contender[0].name + filter_baseline = args.filter_baseline[0] + filter_contender = args.filter_contender[0] + + # NOTE: if test_baseline == test_contender and + # filter_baseline == filter_contender, you are analyzing the stdev + + description = 'Comparing %s (from %s) to %s (from %s)' % ( + filter_baseline, test_baseline, filter_contender, test_contender) + else: + # should never happen + print("Unrecognized mode of operation: '%s'" % args.mode) + parser.print_help() + exit(1) + + check_inputs(test_baseline, test_contender, benchmark_options) + + options_baseline = [] + options_contender = [] + + if filter_baseline and filter_contender: + options_baseline = ['--benchmark_filter=%s' % filter_baseline] + options_contender = ['--benchmark_filter=%s' % filter_contender] + + # Run the benchmarks and report the results + json1 = json1_orig = gbench.util.run_or_load_benchmark( + test_baseline, benchmark_options + options_baseline) + json2 = json2_orig = gbench.util.run_or_load_benchmark( + test_contender, benchmark_options + options_contender) + + # Now, filter the benchmarks so that the difference report can work + if filter_baseline and filter_contender: + replacement = '[%s vs. %s]' % (filter_baseline, filter_contender) + json1 = gbench.report.filter_benchmark( + json1_orig, filter_baseline, replacement) + json2 = gbench.report.filter_benchmark( + json2_orig, filter_contender, replacement) + + # Diff and output + output_lines = gbench.report.generate_difference_report(json1, json2) + print(description) + for ln in output_lines: + print(ln) + + +import unittest + + +class TestParser(unittest.TestCase): + def setUp(self): + self.parser = create_parser() + testInputs = os.path.join( + os.path.dirname( + os.path.realpath(__file__)), + 'gbench', + 'Inputs') + self.testInput0 = os.path.join(testInputs, 'test1_run1.json') + self.testInput1 = os.path.join(testInputs, 'test1_run2.json') + + def test_benchmarks_basic(self): + parsed = self.parser.parse_args( + ['benchmarks', self.testInput0, self.testInput1]) + self.assertEqual(parsed.mode, 'benchmarks') + self.assertEqual(parsed.test_baseline[0].name, self.testInput0) + self.assertEqual(parsed.test_contender[0].name, self.testInput1) + self.assertFalse(parsed.benchmark_options) + + def test_benchmarks_with_remainder(self): + parsed = self.parser.parse_args( + ['benchmarks', self.testInput0, self.testInput1, 'd']) + self.assertEqual(parsed.mode, 'benchmarks') + self.assertEqual(parsed.test_baseline[0].name, self.testInput0) + self.assertEqual(parsed.test_contender[0].name, self.testInput1) + self.assertEqual(parsed.benchmark_options, ['d']) + + def test_benchmarks_with_remainder_after_doubleminus(self): + parsed = self.parser.parse_args( + ['benchmarks', self.testInput0, self.testInput1, '--', 'e']) + self.assertEqual(parsed.mode, 'benchmarks') + self.assertEqual(parsed.test_baseline[0].name, self.testInput0) + self.assertEqual(parsed.test_contender[0].name, self.testInput1) + self.assertEqual(parsed.benchmark_options, ['e']) + + def test_filters_basic(self): + parsed = self.parser.parse_args( + ['filters', self.testInput0, 'c', 'd']) + self.assertEqual(parsed.mode, 'filters') + self.assertEqual(parsed.test[0].name, self.testInput0) + self.assertEqual(parsed.filter_baseline[0], 'c') + self.assertEqual(parsed.filter_contender[0], 'd') + self.assertFalse(parsed.benchmark_options) + + def test_filters_with_remainder(self): + parsed = self.parser.parse_args( + ['filters', self.testInput0, 'c', 'd', 'e']) + self.assertEqual(parsed.mode, 'filters') + self.assertEqual(parsed.test[0].name, self.testInput0) + self.assertEqual(parsed.filter_baseline[0], 'c') + self.assertEqual(parsed.filter_contender[0], 'd') + self.assertEqual(parsed.benchmark_options, ['e']) + + def test_filters_with_remainder_after_doubleminus(self): + parsed = self.parser.parse_args( + ['filters', self.testInput0, 'c', 'd', '--', 'f']) + self.assertEqual(parsed.mode, 'filters') + self.assertEqual(parsed.test[0].name, self.testInput0) + self.assertEqual(parsed.filter_baseline[0], 'c') + self.assertEqual(parsed.filter_contender[0], 'd') + self.assertEqual(parsed.benchmark_options, ['f']) + + def test_benchmarksfiltered_basic(self): + parsed = self.parser.parse_args( + ['benchmarksfiltered', self.testInput0, 'c', self.testInput1, 'e']) + self.assertEqual(parsed.mode, 'benchmarksfiltered') + self.assertEqual(parsed.test_baseline[0].name, self.testInput0) + self.assertEqual(parsed.filter_baseline[0], 'c') + self.assertEqual(parsed.test_contender[0].name, self.testInput1) + self.assertEqual(parsed.filter_contender[0], 'e') + self.assertFalse(parsed.benchmark_options) + + def test_benchmarksfiltered_with_remainder(self): + parsed = self.parser.parse_args( + ['benchmarksfiltered', self.testInput0, 'c', self.testInput1, 'e', 'f']) + self.assertEqual(parsed.mode, 'benchmarksfiltered') + self.assertEqual(parsed.test_baseline[0].name, self.testInput0) + self.assertEqual(parsed.filter_baseline[0], 'c') + self.assertEqual(parsed.test_contender[0].name, self.testInput1) + self.assertEqual(parsed.filter_contender[0], 'e') + self.assertEqual(parsed.benchmark_options[0], 'f') + + def test_benchmarksfiltered_with_remainder_after_doubleminus(self): + parsed = self.parser.parse_args( + ['benchmarksfiltered', self.testInput0, 'c', self.testInput1, 'e', '--', 'g']) + self.assertEqual(parsed.mode, 'benchmarksfiltered') + self.assertEqual(parsed.test_baseline[0].name, self.testInput0) + self.assertEqual(parsed.filter_baseline[0], 'c') + self.assertEqual(parsed.test_contender[0].name, self.testInput1) + self.assertEqual(parsed.filter_contender[0], 'e') + self.assertEqual(parsed.benchmark_options[0], 'g') + + +if __name__ == '__main__': + # unittest.main() + main() + +# vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 +# kate: tab-width: 4; replace-tabs on; indent-width 4; tab-indents: off; +# kate: indent-mode python; remove-trailing-spaces modified; diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare_bench.py b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare_bench.py new file mode 100755 index 00000000000..7bbf0d01574 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/compare_bench.py @@ -0,0 +1,67 @@ +#!/usr/bin/env python +""" +compare_bench.py - Compare two benchmarks or their results and report the + difference. +""" +import argparse +from argparse import ArgumentParser +import sys +import gbench +from gbench import util, report +from gbench.util import * + +def check_inputs(in1, in2, flags): + """ + Perform checking on the user provided inputs and diagnose any abnormalities + """ + in1_kind, in1_err = classify_input_file(in1) + in2_kind, in2_err = classify_input_file(in2) + output_file = find_benchmark_flag('--benchmark_out=', flags) + output_type = find_benchmark_flag('--benchmark_out_format=', flags) + if in1_kind == IT_Executable and in2_kind == IT_Executable and output_file: + print(("WARNING: '--benchmark_out=%s' will be passed to both " + "benchmarks causing it to be overwritten") % output_file) + if in1_kind == IT_JSON and in2_kind == IT_JSON and len(flags) > 0: + print("WARNING: passing --benchmark flags has no effect since both " + "inputs are JSON") + if output_type is not None and output_type != 'json': + print(("ERROR: passing '--benchmark_out_format=%s' to 'compare_bench.py`" + " is not supported.") % output_type) + sys.exit(1) + + +def main(): + parser = ArgumentParser( + description='compare the results of two benchmarks') + parser.add_argument( + 'test1', metavar='test1', type=str, nargs=1, + help='A benchmark executable or JSON output file') + parser.add_argument( + 'test2', metavar='test2', type=str, nargs=1, + help='A benchmark executable or JSON output file') + parser.add_argument( + 'benchmark_options', metavar='benchmark_options', nargs=argparse.REMAINDER, + help='Arguments to pass when running benchmark executables' + ) + args, unknown_args = parser.parse_known_args() + # Parse the command line flags + test1 = args.test1[0] + test2 = args.test2[0] + if unknown_args: + # should never happen + print("Unrecognized positional argument arguments: '%s'" + % unknown_args) + exit(1) + benchmark_options = args.benchmark_options + check_inputs(test1, test2, benchmark_options) + # Run the benchmarks and report the results + json1 = gbench.util.run_or_load_benchmark(test1, benchmark_options) + json2 = gbench.util.run_or_load_benchmark(test2, benchmark_options) + output_lines = gbench.report.generate_difference_report(json1, json2) + print('Comparing %s to %s' % (test1, test2)) + for ln in output_lines: + print(ln) + + +if __name__ == '__main__': + main() diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run1.json b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run1.json new file mode 100755 index 00000000000..d7ec6a9c8f6 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run1.json @@ -0,0 +1,102 @@ +{ + "context": { + "date": "2016-08-02 17:44:46", + "num_cpus": 4, + "mhz_per_cpu": 4228, + "cpu_scaling_enabled": false, + "library_build_type": "release" + }, + "benchmarks": [ + { + "name": "BM_SameTimes", + "iterations": 1000, + "real_time": 10, + "cpu_time": 10, + "time_unit": "ns" + }, + { + "name": "BM_2xFaster", + "iterations": 1000, + "real_time": 50, + "cpu_time": 50, + "time_unit": "ns" + }, + { + "name": "BM_2xSlower", + "iterations": 1000, + "real_time": 50, + "cpu_time": 50, + "time_unit": "ns" + }, + { + "name": "BM_1PercentFaster", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_1PercentSlower", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_10PercentFaster", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_10PercentSlower", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_100xSlower", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_100xFaster", + "iterations": 1000, + "real_time": 10000, + "cpu_time": 10000, + "time_unit": "ns" + }, + { + "name": "BM_10PercentCPUToTime", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_ThirdFaster", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_BadTimeUnit", + "iterations": 1000, + "real_time": 0.4, + "cpu_time": 0.5, + "time_unit": "s" + }, + { + "name": "BM_DifferentTimeUnit", + "iterations": 1, + "real_time": 1, + "cpu_time": 1, + "time_unit": "s" + } + ] +} diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run2.json b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run2.json new file mode 100755 index 00000000000..59a5ffaca4d --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test1_run2.json @@ -0,0 +1,102 @@ +{ + "context": { + "date": "2016-08-02 17:44:46", + "num_cpus": 4, + "mhz_per_cpu": 4228, + "cpu_scaling_enabled": false, + "library_build_type": "release" + }, + "benchmarks": [ + { + "name": "BM_SameTimes", + "iterations": 1000, + "real_time": 10, + "cpu_time": 10, + "time_unit": "ns" + }, + { + "name": "BM_2xFaster", + "iterations": 1000, + "real_time": 25, + "cpu_time": 25, + "time_unit": "ns" + }, + { + "name": "BM_2xSlower", + "iterations": 20833333, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_1PercentFaster", + "iterations": 1000, + "real_time": 98.9999999, + "cpu_time": 98.9999999, + "time_unit": "ns" + }, + { + "name": "BM_1PercentSlower", + "iterations": 1000, + "real_time": 100.9999999, + "cpu_time": 100.9999999, + "time_unit": "ns" + }, + { + "name": "BM_10PercentFaster", + "iterations": 1000, + "real_time": 90, + "cpu_time": 90, + "time_unit": "ns" + }, + { + "name": "BM_10PercentSlower", + "iterations": 1000, + "real_time": 110, + "cpu_time": 110, + "time_unit": "ns" + }, + { + "name": "BM_100xSlower", + "iterations": 1000, + "real_time": 1.0000e+04, + "cpu_time": 1.0000e+04, + "time_unit": "ns" + }, + { + "name": "BM_100xFaster", + "iterations": 1000, + "real_time": 100, + "cpu_time": 100, + "time_unit": "ns" + }, + { + "name": "BM_10PercentCPUToTime", + "iterations": 1000, + "real_time": 110, + "cpu_time": 90, + "time_unit": "ns" + }, + { + "name": "BM_ThirdFaster", + "iterations": 1000, + "real_time": 66.665, + "cpu_time": 66.664, + "time_unit": "ns" + }, + { + "name": "BM_BadTimeUnit", + "iterations": 1000, + "real_time": 0.04, + "cpu_time": 0.6, + "time_unit": "s" + }, + { + "name": "BM_DifferentTimeUnit", + "iterations": 1, + "real_time": 1, + "cpu_time": 1, + "time_unit": "ns" + } + ] +} diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test2_run.json b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test2_run.json new file mode 100755 index 00000000000..15bc6980304 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/Inputs/test2_run.json @@ -0,0 +1,81 @@ +{ + "context": { + "date": "2016-08-02 17:44:46", + "num_cpus": 4, + "mhz_per_cpu": 4228, + "cpu_scaling_enabled": false, + "library_build_type": "release" + }, + "benchmarks": [ + { + "name": "BM_Hi", + "iterations": 1234, + "real_time": 42, + "cpu_time": 24, + "time_unit": "ms" + }, + { + "name": "BM_Zero", + "iterations": 1000, + "real_time": 10, + "cpu_time": 10, + "time_unit": "ns" + }, + { + "name": "BM_Zero/4", + "iterations": 4000, + "real_time": 40, + "cpu_time": 40, + "time_unit": "ns" + }, + { + "name": "Prefix/BM_Zero", + "iterations": 2000, + "real_time": 20, + "cpu_time": 20, + "time_unit": "ns" + }, + { + "name": "Prefix/BM_Zero/3", + "iterations": 3000, + "real_time": 30, + "cpu_time": 30, + "time_unit": "ns" + }, + { + "name": "BM_One", + "iterations": 5000, + "real_time": 5, + "cpu_time": 5, + "time_unit": "ns" + }, + { + "name": "BM_One/4", + "iterations": 2000, + "real_time": 20, + "cpu_time": 20, + "time_unit": "ns" + }, + { + "name": "Prefix/BM_One", + "iterations": 1000, + "real_time": 10, + "cpu_time": 10, + "time_unit": "ns" + }, + { + "name": "Prefix/BM_One/3", + "iterations": 1500, + "real_time": 15, + "cpu_time": 15, + "time_unit": "ns" + }, + { + "name": "BM_Bye", + "iterations": 5321, + "real_time": 11, + "cpu_time": 63, + "time_unit": "ns" + } + ] +} diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/__init__.py b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/__init__.py new file mode 100755 index 00000000000..fce1a1acfbb --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/__init__.py @@ -0,0 +1,8 @@ +"""Google Benchmark tooling""" + +__author__ = 'Eric Fiselier' +__email__ = 'eric@efcs.ca' +__versioninfo__ = (0, 5, 0) +__version__ = '.'.join(str(v) for v in __versioninfo__) + 'dev' + +__all__ = [] diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/report.py b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/report.py new file mode 100755 index 00000000000..0c090981a83 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/report.py @@ -0,0 +1,208 @@ +"""report.py - Utilities for reporting statistics about benchmark results +""" +import os +import re +import copy + +class BenchmarkColor(object): + def __init__(self, name, code): + self.name = name + self.code = code + + def __repr__(self): + return '%s%r' % (self.__class__.__name__, + (self.name, self.code)) + + def __format__(self, format): + return self.code + +# Benchmark Colors Enumeration +BC_NONE = BenchmarkColor('NONE', '') +BC_MAGENTA = BenchmarkColor('MAGENTA', '\033[95m') +BC_CYAN = BenchmarkColor('CYAN', '\033[96m') +BC_OKBLUE = BenchmarkColor('OKBLUE', '\033[94m') +BC_HEADER = BenchmarkColor('HEADER', '\033[92m') +BC_WARNING = BenchmarkColor('WARNING', '\033[93m') +BC_WHITE = BenchmarkColor('WHITE', '\033[97m') +BC_FAIL = BenchmarkColor('FAIL', '\033[91m') +BC_ENDC = BenchmarkColor('ENDC', '\033[0m') +BC_BOLD = BenchmarkColor('BOLD', '\033[1m') +BC_UNDERLINE = BenchmarkColor('UNDERLINE', '\033[4m') + +def color_format(use_color, fmt_str, *args, **kwargs): + """ + Return the result of 'fmt_str.format(*args, **kwargs)' after transforming + 'args' and 'kwargs' according to the value of 'use_color'. If 'use_color' + is False then all color codes in 'args' and 'kwargs' are replaced with + the empty string. + """ + assert use_color is True or use_color is False + if not use_color: + args = [arg if not isinstance(arg, BenchmarkColor) else BC_NONE + for arg in args] + kwargs = {key: arg if not isinstance(arg, BenchmarkColor) else BC_NONE + for key, arg in kwargs.items()} + return fmt_str.format(*args, **kwargs) + + +def find_longest_name(benchmark_list): + """ + Return the length of the longest benchmark name in a given list of + benchmark JSON objects + """ + longest_name = 1 + for bc in benchmark_list: + if len(bc['name']) > longest_name: + longest_name = len(bc['name']) + return longest_name + + +def calculate_change(old_val, new_val): + """ + Return a float representing the decimal change between old_val and new_val. + """ + if old_val == 0 and new_val == 0: + return 0.0 + if old_val == 0: + return float(new_val - old_val) / (float(old_val + new_val) / 2) + return float(new_val - old_val) / abs(old_val) + + +def filter_benchmark(json_orig, family, replacement=""): + """ + Apply a filter to the json, and only leave the 'family' of benchmarks. + """ + regex = re.compile(family) + filtered = {} + filtered['benchmarks'] = [] + for be in json_orig['benchmarks']: + if not regex.search(be['name']): + continue + filteredbench = copy.deepcopy(be) # Do NOT modify the old name! + filteredbench['name'] = regex.sub(replacement, filteredbench['name']) + filtered['benchmarks'].append(filteredbench) + return filtered + + +def generate_difference_report(json1, json2, use_color=True): + """ + Calculate and report the difference between each test of two benchmarks + runs specified as 'json1' and 'json2'. + """ + first_col_width = find_longest_name(json1['benchmarks']) + def find_test(name): + for b in json2['benchmarks']: + if b['name'] == name: + return b + return None + first_col_width = max(first_col_width, len('Benchmark')) + first_line = "{:<{}s}Time CPU Time Old Time New CPU Old CPU New".format( + 'Benchmark', 12 + first_col_width) + output_strs = [first_line, '-' * len(first_line)] + + gen = (bn for bn in json1['benchmarks'] if 'real_time' in bn and 'cpu_time' in bn) + for bn in gen: + other_bench = find_test(bn['name']) + if not other_bench: + continue + + if bn['time_unit'] != other_bench['time_unit']: + continue + + def get_color(res): + if res > 0.05: + return BC_FAIL + elif res > -0.07: + return BC_WHITE + else: + return BC_CYAN + fmt_str = "{}{:<{}s}{endc}{}{:+16.4f}{endc}{}{:+16.4f}{endc}{:14.0f}{:14.0f}{endc}{:14.0f}{:14.0f}" + tres = calculate_change(bn['real_time'], other_bench['real_time']) + cpures = calculate_change(bn['cpu_time'], other_bench['cpu_time']) + output_strs += [color_format(use_color, fmt_str, + BC_HEADER, bn['name'], first_col_width, + get_color(tres), tres, get_color(cpures), cpures, + bn['real_time'], other_bench['real_time'], + bn['cpu_time'], other_bench['cpu_time'], + endc=BC_ENDC)] + return output_strs + +############################################################################### +# Unit tests + +import unittest + +class TestReportDifference(unittest.TestCase): + def load_results(self): + import json + testInputs = os.path.join(os.path.dirname(os.path.realpath(__file__)), 'Inputs') + testOutput1 = os.path.join(testInputs, 'test1_run1.json') + testOutput2 = os.path.join(testInputs, 'test1_run2.json') + with open(testOutput1, 'r') as f: + json1 = json.load(f) + with open(testOutput2, 'r') as f: + json2 = json.load(f) + return json1, json2 + + def test_basic(self): + expect_lines = [ + ['BM_SameTimes', '+0.0000', '+0.0000', '10', '10', '10', '10'], + ['BM_2xFaster', '-0.5000', '-0.5000', '50', '25', '50', '25'], + ['BM_2xSlower', '+1.0000', '+1.0000', '50', '100', '50', '100'], + ['BM_1PercentFaster', '-0.0100', '-0.0100', '100', '99', '100', '99'], + ['BM_1PercentSlower', '+0.0100', '+0.0100', '100', '101', '100', '101'], + ['BM_10PercentFaster', '-0.1000', '-0.1000', '100', '90', '100', '90'], + ['BM_10PercentSlower', '+0.1000', '+0.1000', '100', '110', '100', '110'], + ['BM_100xSlower', '+99.0000', '+99.0000', '100', '10000', '100', '10000'], + ['BM_100xFaster', '-0.9900', '-0.9900', '10000', '100', '10000', '100'], + ['BM_10PercentCPUToTime', '+0.1000', '-0.1000', '100', '110', '100', '90'], + ['BM_ThirdFaster', '-0.3333', '-0.3334', '100', '67', '100', '67'], + ['BM_BadTimeUnit', '-0.9000', '+0.2000', '0', '0', '0', '1'], + ] + json1, json2 = self.load_results() + output_lines_with_header = generate_difference_report(json1, json2, use_color=False) + output_lines = output_lines_with_header[2:] + print("\n".join(output_lines_with_header)) + self.assertEqual(len(output_lines), len(expect_lines)) + for i in range(0, len(output_lines)): + parts = [x for x in output_lines[i].split(' ') if x] + self.assertEqual(len(parts), 7) + self.assertEqual(parts, expect_lines[i]) + + +class TestReportDifferenceBetweenFamilies(unittest.TestCase): + def load_result(self): + import json + testInputs = os.path.join(os.path.dirname(os.path.realpath(__file__)), 'Inputs') + testOutput = os.path.join(testInputs, 'test2_run.json') + with open(testOutput, 'r') as f: + json = json.load(f) + return json + + def test_basic(self): + expect_lines = [ + ['.', '-0.5000', '-0.5000', '10', '5', '10', '5'], + ['./4', '-0.5000', '-0.5000', '40', '20', '40', '20'], + ['Prefix/.', '-0.5000', '-0.5000', '20', '10', '20', '10'], + ['Prefix/./3', '-0.5000', '-0.5000', '30', '15', '30', '15'], + ] + json = self.load_result() + json1 = filter_benchmark(json, "BM_Z.ro", ".") + json2 = filter_benchmark(json, "BM_O.e", ".") + output_lines_with_header = generate_difference_report(json1, json2, use_color=False) + output_lines = output_lines_with_header[2:] + print("\n") + print("\n".join(output_lines_with_header)) + self.assertEqual(len(output_lines), len(expect_lines)) + for i in range(0, len(output_lines)): + parts = [x for x in output_lines[i].split(' ') if x] + self.assertEqual(len(parts), 7) + self.assertEqual(parts, expect_lines[i]) + + +if __name__ == '__main__': + unittest.main() + +# vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 +# kate: tab-width: 4; replace-tabs on; indent-width 4; tab-indents: off; +# kate: indent-mode python; remove-trailing-spaces modified; diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/util.py b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/util.py new file mode 100755 index 00000000000..07c23772754 --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/gbench/util.py @@ -0,0 +1,159 @@ +"""util.py - General utilities for running, loading, and processing benchmarks +""" +import json +import os +import tempfile +import subprocess +import sys + +# Input file type enumeration +IT_Invalid = 0 +IT_JSON = 1 +IT_Executable = 2 + +_num_magic_bytes = 2 if sys.platform.startswith('win') else 4 +def is_executable_file(filename): + """ + Return 'True' if 'filename' names a valid file which is likely + an executable. A file is considered an executable if it starts with the + magic bytes for a EXE, Mach O, or ELF file. + """ + if not os.path.isfile(filename): + return False + with open(filename, mode='rb') as f: + magic_bytes = f.read(_num_magic_bytes) + if sys.platform == 'darwin': + return magic_bytes in [ + b'\xfe\xed\xfa\xce', # MH_MAGIC + b'\xce\xfa\xed\xfe', # MH_CIGAM + b'\xfe\xed\xfa\xcf', # MH_MAGIC_64 + b'\xcf\xfa\xed\xfe', # MH_CIGAM_64 + b'\xca\xfe\xba\xbe', # FAT_MAGIC + b'\xbe\xba\xfe\xca' # FAT_CIGAM + ] + elif sys.platform.startswith('win'): + return magic_bytes == b'MZ' + else: + return magic_bytes == b'\x7FELF' + + +def is_json_file(filename): + """ + Returns 'True' if 'filename' names a valid JSON output file. + 'False' otherwise. + """ + try: + with open(filename, 'r') as f: + json.load(f) + return True + except: + pass + return False + + +def classify_input_file(filename): + """ + Return a tuple (type, msg) where 'type' specifies the classified type + of 'filename'. If 'type' is 'IT_Invalid' then 'msg' is a human readable + string represeting the error. + """ + ftype = IT_Invalid + err_msg = None + if not os.path.exists(filename): + err_msg = "'%s' does not exist" % filename + elif not os.path.isfile(filename): + err_msg = "'%s' does not name a file" % filename + elif is_executable_file(filename): + ftype = IT_Executable + elif is_json_file(filename): + ftype = IT_JSON + else: + err_msg = "'%s' does not name a valid benchmark executable or JSON file" % filename + return ftype, err_msg + + +def check_input_file(filename): + """ + Classify the file named by 'filename' and return the classification. + If the file is classified as 'IT_Invalid' print an error message and exit + the program. + """ + ftype, msg = classify_input_file(filename) + if ftype == IT_Invalid: + print("Invalid input file: %s" % msg) + sys.exit(1) + return ftype + +def find_benchmark_flag(prefix, benchmark_flags): + """ + Search the specified list of flags for a flag matching `` and + if it is found return the arg it specifies. If specified more than once the + last value is returned. If the flag is not found None is returned. + """ + assert prefix.startswith('--') and prefix.endswith('=') + result = None + for f in benchmark_flags: + if f.startswith(prefix): + result = f[len(prefix):] + return result + +def remove_benchmark_flags(prefix, benchmark_flags): + """ + Return a new list containing the specified benchmark_flags except those + with the specified prefix. + """ + assert prefix.startswith('--') and prefix.endswith('=') + return [f for f in benchmark_flags if not f.startswith(prefix)] + +def load_benchmark_results(fname): + """ + Read benchmark output from a file and return the JSON object. + REQUIRES: 'fname' names a file containing JSON benchmark output. + """ + with open(fname, 'r') as f: + return json.load(f) + + +def run_benchmark(exe_name, benchmark_flags): + """ + Run a benchmark specified by 'exe_name' with the specified + 'benchmark_flags'. The benchmark is run directly as a subprocess to preserve + real time console output. + RETURNS: A JSON object representing the benchmark output + """ + output_name = find_benchmark_flag('--benchmark_out=', + benchmark_flags) + is_temp_output = False + if output_name is None: + is_temp_output = True + thandle, output_name = tempfile.mkstemp() + os.close(thandle) + benchmark_flags = list(benchmark_flags) + \ + ['--benchmark_out=%s' % output_name] + + cmd = [exe_name] + benchmark_flags + print("RUNNING: %s" % ' '.join(cmd)) + exitCode = subprocess.call(cmd) + if exitCode != 0: + print('TEST FAILED...') + sys.exit(exitCode) + json_res = load_benchmark_results(output_name) + if is_temp_output: + os.unlink(output_name) + return json_res + + +def run_or_load_benchmark(filename, benchmark_flags): + """ + Get the results for a specified benchmark. If 'filename' specifies + an executable benchmark then the results are generated by running the + benchmark. Otherwise 'filename' must name a valid JSON output file, + which is loaded and the result returned. + """ + ftype = check_input_file(filename) + if ftype == IT_JSON: + return load_benchmark_results(filename) + elif ftype == IT_Executable: + return run_benchmark(filename, benchmark_flags) + else: + assert False # This branch is unreachable \ No newline at end of file diff --git a/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/strip_asm.py b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/strip_asm.py new file mode 100755 index 00000000000..9030550b43b --- /dev/null +++ b/contrib/nlohmann_json/benchmarks/thirdparty/benchmark/tools/strip_asm.py @@ -0,0 +1,151 @@ +#!/usr/bin/env python + +""" +strip_asm.py - Cleanup ASM output for the specified file +""" + +from argparse import ArgumentParser +import sys +import os +import re + +def find_used_labels(asm): + found = set() + label_re = re.compile("\s*j[a-z]+\s+\.L([a-zA-Z0-9][a-zA-Z0-9_]*)") + for l in asm.splitlines(): + m = label_re.match(l) + if m: + found.add('.L%s' % m.group(1)) + return found + + +def normalize_labels(asm): + decls = set() + label_decl = re.compile("^[.]{0,1}L([a-zA-Z0-9][a-zA-Z0-9_]*)(?=:)") + for l in asm.splitlines(): + m = label_decl.match(l) + if m: + decls.add(m.group(0)) + if len(decls) == 0: + return asm + needs_dot = next(iter(decls))[0] != '.' + if not needs_dot: + return asm + for ld in decls: + asm = re.sub("(^|\s+)" + ld + "(?=:|\s)", '\\1.' + ld, asm) + return asm + + +def transform_labels(asm): + asm = normalize_labels(asm) + used_decls = find_used_labels(asm) + new_asm = '' + label_decl = re.compile("^\.L([a-zA-Z0-9][a-zA-Z0-9_]*)(?=:)") + for l in asm.splitlines(): + m = label_decl.match(l) + if not m or m.group(0) in used_decls: + new_asm += l + new_asm += '\n' + return new_asm + + +def is_identifier(tk): + if len(tk) == 0: + return False + first = tk[0] + if not first.isalpha() and first != '_': + return False + for i in range(1, len(tk)): + c = tk[i] + if not c.isalnum() and c != '_': + return False + return True + +def process_identifiers(l): + """ + process_identifiers - process all identifiers and modify them to have + consistent names across all platforms; specifically across ELF and MachO. + For example, MachO inserts an additional understore at the beginning of + names. This function removes that. + """ + parts = re.split(r'([a-zA-Z0-9_]+)', l) + new_line = '' + for tk in parts: + if is_identifier(tk): + if tk.startswith('__Z'): + tk = tk[1:] + elif tk.startswith('_') and len(tk) > 1 and \ + tk[1].isalpha() and tk[1] != 'Z': + tk = tk[1:] + new_line += tk + return new_line + + +def process_asm(asm): + """ + Strip the ASM of unwanted directives and lines + """ + new_contents = '' + asm = transform_labels(asm) + + # TODO: Add more things we want to remove + discard_regexes = [ + re.compile("\s+\..*$"), # directive + re.compile("\s*#(NO_APP|APP)$"), #inline ASM + re.compile("\s*#.*$"), # comment line + re.compile("\s*\.globa?l\s*([.a-zA-Z_][a-zA-Z0-9$_.]*)"), #global directive + re.compile("\s*\.(string|asciz|ascii|[1248]?byte|short|word|long|quad|value|zero)"), + ] + keep_regexes = [ + + ] + fn_label_def = re.compile("^[a-zA-Z_][a-zA-Z0-9_.]*:") + for l in asm.splitlines(): + # Remove Mach-O attribute + l = l.replace('@GOTPCREL', '') + add_line = True + for reg in discard_regexes: + if reg.match(l) is not None: + add_line = False + break + for reg in keep_regexes: + if reg.match(l) is not None: + add_line = True + break + if add_line: + if fn_label_def.match(l) and len(new_contents) != 0: + new_contents += '\n' + l = process_identifiers(l) + new_contents += l + new_contents += '\n' + return new_contents + +def main(): + parser = ArgumentParser( + description='generate a stripped assembly file') + parser.add_argument( + 'input', metavar='input', type=str, nargs=1, + help='An input assembly file') + parser.add_argument( + 'out', metavar='output', type=str, nargs=1, + help='The output file') + args, unknown_args = parser.parse_known_args() + input = args.input[0] + output = args.out[0] + if not os.path.isfile(input): + print(("ERROR: input file '%s' does not exist") % input) + sys.exit(1) + contents = None + with open(input, 'r') as f: + contents = f.read() + new_contents = process_asm(contents) + with open(output, 'w') as f: + f.write(new_contents) + + +if __name__ == '__main__': + main() + +# vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 +# kate: tab-width: 4; replace-tabs on; indent-width 4; tab-indents: off; +# kate: indent-mode python; remove-trailing-spaces modified; diff --git a/contrib/nlohmann_json/cmake/config.cmake.in b/contrib/nlohmann_json/cmake/config.cmake.in new file mode 100644 index 00000000000..9a17a7d7b2d --- /dev/null +++ b/contrib/nlohmann_json/cmake/config.cmake.in @@ -0,0 +1,15 @@ +include(FindPackageHandleStandardArgs) +set(${CMAKE_FIND_PACKAGE_NAME}_CONFIG ${CMAKE_CURRENT_LIST_FILE}) +find_package_handle_standard_args(@PROJECT_NAME@ CONFIG_MODE) + +if(NOT TARGET @PROJECT_NAME@::@NLOHMANN_JSON_TARGET_NAME@) + include("${CMAKE_CURRENT_LIST_DIR}/@NLOHMANN_JSON_TARGETS_EXPORT_NAME@.cmake") + if((NOT TARGET @NLOHMANN_JSON_TARGET_NAME@) AND + (NOT @PROJECT_NAME@_FIND_VERSION OR + @PROJECT_NAME@_FIND_VERSION VERSION_LESS 3.2.0)) + add_library(@NLOHMANN_JSON_TARGET_NAME@ INTERFACE IMPORTED) + set_target_properties(@NLOHMANN_JSON_TARGET_NAME@ PROPERTIES + INTERFACE_LINK_LIBRARIES @PROJECT_NAME@::@NLOHMANN_JSON_TARGET_NAME@ + ) + endif() +endif() diff --git a/contrib/nlohmann_json/cmake/download_test_data.cmake b/contrib/nlohmann_json/cmake/download_test_data.cmake new file mode 100644 index 00000000000..a3f3f199f1b --- /dev/null +++ b/contrib/nlohmann_json/cmake/download_test_data.cmake @@ -0,0 +1,56 @@ +set(JSON_TEST_DATA_URL https://github.com/nlohmann/json_test_data) +set(JSON_TEST_DATA_VERSION 3.0.0) + +# if variable is set, use test data from given directory rather than downloading them +if(JSON_TestDataDirectory) + message(STATUS "Using test data in ${JSON_TestDataDirectory}.") + add_custom_target(download_test_data) + file(WRITE ${CMAKE_BINARY_DIR}/include/test_data.hpp "#define TEST_DATA_DIRECTORY \"${JSON_TestDataDirectory}\"\n") +else() + find_package(Git) + # target to download test data + add_custom_target(download_test_data + COMMAND test -d json_test_data || ${GIT_EXECUTABLE} clone -c advice.detachedHead=false --branch v${JSON_TEST_DATA_VERSION} ${JSON_TEST_DATA_URL}.git --quiet --depth 1 + COMMENT "Downloading test data from ${JSON_TEST_DATA_URL} (v${JSON_TEST_DATA_VERSION})" + WORKING_DIRECTORY ${CMAKE_BINARY_DIR} + ) + # create a header with the path to the downloaded test data + file(WRITE ${CMAKE_BINARY_DIR}/include/test_data.hpp "#define TEST_DATA_DIRECTORY \"${CMAKE_BINARY_DIR}/json_test_data\"\n") +endif() + +# determine the operating system (for debug and support purposes) +find_program(UNAME_COMMAND uname) +find_program(VER_COMMAND ver) +find_program(LSB_RELEASE_COMMAND lsb_release) +find_program(SW_VERS_COMMAND sw_vers) +set(OS_VERSION_STRINGS "${CMAKE_SYSTEM}") +if (VER_COMMAND) + execute_process(COMMAND ${VER_COMMAND} OUTPUT_VARIABLE VER_COMMAND_RESULT OUTPUT_STRIP_TRAILING_WHITESPACE) + set(OS_VERSION_STRINGS "${OS_VERSION_STRINGS}; ${VER_COMMAND_RESULT}") +endif() +if (SW_VERS_COMMAND) + execute_process(COMMAND ${SW_VERS_COMMAND} OUTPUT_VARIABLE SW_VERS_COMMAND_RESULT OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET) + string(REGEX REPLACE "[ ]*\n" "; " SW_VERS_COMMAND_RESULT "${SW_VERS_COMMAND_RESULT}") + set(OS_VERSION_STRINGS "${OS_VERSION_STRINGS}; ${SW_VERS_COMMAND_RESULT}") +endif() +if (LSB_RELEASE_COMMAND) + execute_process(COMMAND ${LSB_RELEASE_COMMAND} -a OUTPUT_VARIABLE LSB_RELEASE_COMMAND_RESULT OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET) + string(REGEX REPLACE "[ ]*\n" "; " LSB_RELEASE_COMMAND_RESULT "${LSB_RELEASE_COMMAND_RESULT}") + set(OS_VERSION_STRINGS "${OS_VERSION_STRINGS}; ${LSB_RELEASE_COMMAND_RESULT}") +endif() +if (UNAME_COMMAND) + execute_process(COMMAND ${UNAME_COMMAND} -a OUTPUT_VARIABLE UNAME_COMMAND_RESULT OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_QUIET) + set(OS_VERSION_STRINGS "${OS_VERSION_STRINGS}; ${UNAME_COMMAND_RESULT}") +endif() + +message(STATUS "Operating system: ${OS_VERSION_STRINGS}") + +# determine the compiler (for debug and support purposes) +if (MSVC) + execute_process(COMMAND ${CMAKE_CXX_COMPILER} OUTPUT_VARIABLE CXX_VERSION_RESULT OUTPUT_STRIP_TRAILING_WHITESPACE ERROR_VARIABLE CXX_VERSION_RESULT ERROR_STRIP_TRAILING_WHITESPACE) + set(CMAKE_CXX_COMPILER "${CXX_VERSION_RESULT}; MSVC_VERSION=${MSVC_VERSION}; MSVC_TOOLSET_VERSION=${MSVC_TOOLSET_VERSION}") +else() + execute_process(COMMAND ${CMAKE_CXX_COMPILER} --version OUTPUT_VARIABLE CXX_VERSION_RESULT OUTPUT_STRIP_TRAILING_WHITESPACE) +endif() +string(REGEX REPLACE "[ ]*\n" "; " CXX_VERSION_RESULT "${CXX_VERSION_RESULT}") +message(STATUS "Compiler: ${CXX_VERSION_RESULT}") diff --git a/contrib/nlohmann_json/cmake/nlohmann_jsonConfigVersion.cmake.in b/contrib/nlohmann_json/cmake/nlohmann_jsonConfigVersion.cmake.in new file mode 100644 index 00000000000..10910859734 --- /dev/null +++ b/contrib/nlohmann_json/cmake/nlohmann_jsonConfigVersion.cmake.in @@ -0,0 +1,20 @@ +# This is essentially cmake's BasicConfigVersion-SameMajorVersion.cmake.in but +# without the 32/64-bit check. Since json is a header-only library, it doesn't +# matter if it was built on a different platform than what it is used on (see +# https://github.com/nlohmann/json/issues/1697). +set(PACKAGE_VERSION "@PROJECT_VERSION@") + +if(PACKAGE_VERSION VERSION_LESS PACKAGE_FIND_VERSION) + set(PACKAGE_VERSION_COMPATIBLE FALSE) +else() + + if(PACKAGE_FIND_VERSION_MAJOR STREQUAL "@PROJECT_VERSION_MAJOR@") + set(PACKAGE_VERSION_COMPATIBLE TRUE) + else() + set(PACKAGE_VERSION_COMPATIBLE FALSE) + endif() + + if(PACKAGE_FIND_VERSION STREQUAL PACKAGE_VERSION) + set(PACKAGE_VERSION_EXACT TRUE) + endif() +endif() diff --git a/contrib/nlohmann_json/cmake/pkg-config.pc.in b/contrib/nlohmann_json/cmake/pkg-config.pc.in new file mode 100644 index 00000000000..3541abf0bad --- /dev/null +++ b/contrib/nlohmann_json/cmake/pkg-config.pc.in @@ -0,0 +1,4 @@ +Name: ${PROJECT_NAME} +Description: JSON for Modern C++ +Version: ${PROJECT_VERSION} +Cflags: -I${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_INCLUDEDIR} diff --git a/contrib/nlohmann_json/doc/Doxyfile b/contrib/nlohmann_json/doc/Doxyfile new file mode 100644 index 00000000000..9884f959b02 --- /dev/null +++ b/contrib/nlohmann_json/doc/Doxyfile @@ -0,0 +1,331 @@ +# Doxyfile 1.8.19 + +#--------------------------------------------------------------------------- +# Project related configuration options +#--------------------------------------------------------------------------- +DOXYFILE_ENCODING = UTF-8 +PROJECT_NAME = "JSON for Modern C++" +PROJECT_NUMBER = 3.9.1 +PROJECT_BRIEF = +PROJECT_LOGO = +OUTPUT_DIRECTORY = . +CREATE_SUBDIRS = NO +ALLOW_UNICODE_NAMES = NO +OUTPUT_LANGUAGE = English +OUTPUT_TEXT_DIRECTION = None +BRIEF_MEMBER_DESC = YES +REPEAT_BRIEF = NO +ABBREVIATE_BRIEF = +ALWAYS_DETAILED_SEC = YES +INLINE_INHERITED_MEMB = NO +FULL_PATH_NAMES = YES +STRIP_FROM_PATH = +STRIP_FROM_INC_PATH = +SHORT_NAMES = NO +JAVADOC_AUTOBRIEF = NO +JAVADOC_BANNER = NO +QT_AUTOBRIEF = NO +MULTILINE_CPP_IS_BRIEF = NO +INHERIT_DOCS = YES +SEPARATE_MEMBER_PAGES = YES +TAB_SIZE = 4 +ALIASES = "complexity=@par Complexity^^" \ + "liveexample{2}=@par Example^^ \1 ^^ @includelineno \2.cpp \n Output (play with this example @htmlinclude \2.link):^^ @verbinclude \2.output ^^ The example code above can be translated with @verbatim g++ -std=c++11 -Isingle_include doc/examples/\2.cpp -o \2 @endverbatim" \ + "requirement=@par Requirements^^" \ + "exceptionsafety=@par Exception safety^^" \ + "iterators=@par Iterator validity^^" +OPTIMIZE_OUTPUT_FOR_C = NO +OPTIMIZE_OUTPUT_JAVA = NO +OPTIMIZE_FOR_FORTRAN = NO +OPTIMIZE_OUTPUT_VHDL = NO +OPTIMIZE_OUTPUT_SLICE = NO +EXTENSION_MAPPING = +MARKDOWN_SUPPORT = YES +TOC_INCLUDE_HEADINGS = 0 +AUTOLINK_SUPPORT = NO +BUILTIN_STL_SUPPORT = YES +CPP_CLI_SUPPORT = NO +SIP_SUPPORT = NO +IDL_PROPERTY_SUPPORT = YES +DISTRIBUTE_GROUP_DOC = NO +GROUP_NESTED_COMPOUNDS = NO +SUBGROUPING = YES +INLINE_GROUPED_CLASSES = NO +INLINE_SIMPLE_STRUCTS = NO +TYPEDEF_HIDES_STRUCT = NO +LOOKUP_CACHE_SIZE = 0 +#--------------------------------------------------------------------------- +# Build related configuration options +#--------------------------------------------------------------------------- +EXTRACT_ALL = YES +EXTRACT_PRIVATE = NO +EXTRACT_PRIV_VIRTUAL = NO +EXTRACT_PACKAGE = YES +EXTRACT_STATIC = YES +EXTRACT_LOCAL_CLASSES = YES +EXTRACT_LOCAL_METHODS = YES +EXTRACT_ANON_NSPACES = YES +HIDE_UNDOC_MEMBERS = NO +HIDE_UNDOC_CLASSES = NO +HIDE_FRIEND_COMPOUNDS = NO +HIDE_IN_BODY_DOCS = NO +INTERNAL_DOCS = NO +CASE_SENSE_NAMES = NO +HIDE_SCOPE_NAMES = NO +HIDE_COMPOUND_REFERENCE= NO +SHOW_INCLUDE_FILES = YES +SHOW_GROUPED_MEMB_INC = NO +FORCE_LOCAL_INCLUDES = NO +INLINE_INFO = YES +SORT_MEMBER_DOCS = YES +SORT_BRIEF_DOCS = YES +SORT_MEMBERS_CTORS_1ST = YES +SORT_GROUP_NAMES = NO +SORT_BY_SCOPE_NAME = NO +STRICT_PROTO_MATCHING = NO +GENERATE_TODOLIST = YES +GENERATE_TESTLIST = YES +GENERATE_BUGLIST = YES +GENERATE_DEPRECATEDLIST= YES +ENABLED_SECTIONS = +MAX_INITIALIZER_LINES = 30 +SHOW_USED_FILES = NO +SHOW_FILES = NO +SHOW_NAMESPACES = NO +FILE_VERSION_FILTER = +LAYOUT_FILE = +CITE_BIB_FILES = +#--------------------------------------------------------------------------- +# Configuration options related to warning and progress messages +#--------------------------------------------------------------------------- +QUIET = YES +WARNINGS = YES +WARN_IF_UNDOCUMENTED = YES +WARN_IF_DOC_ERROR = YES +WARN_NO_PARAMDOC = YES +WARN_AS_ERROR = NO +WARN_FORMAT = "$file:$line: $text" +WARN_LOGFILE = +#--------------------------------------------------------------------------- +# Configuration options related to the input files +#--------------------------------------------------------------------------- +INPUT = ../single_include/nlohmann/json.hpp \ + index.md +INPUT_ENCODING = UTF-8 +FILE_PATTERNS = +RECURSIVE = NO +EXCLUDE = +EXCLUDE_SYMLINKS = NO +EXCLUDE_PATTERNS = +EXCLUDE_SYMBOLS = nlohmann::detail +EXAMPLE_PATH = examples +EXAMPLE_PATTERNS = +EXAMPLE_RECURSIVE = NO +IMAGE_PATH = images +INPUT_FILTER = +FILTER_PATTERNS = +FILTER_SOURCE_FILES = NO +FILTER_SOURCE_PATTERNS = +USE_MDFILE_AS_MAINPAGE = index.md +#--------------------------------------------------------------------------- +# Configuration options related to source browsing +#--------------------------------------------------------------------------- +SOURCE_BROWSER = YES +INLINE_SOURCES = NO +STRIP_CODE_COMMENTS = YES +REFERENCED_BY_RELATION = NO +REFERENCES_RELATION = NO +REFERENCES_LINK_SOURCE = NO +SOURCE_TOOLTIPS = YES +USE_HTAGS = NO +VERBATIM_HEADERS = NO +#--------------------------------------------------------------------------- +# Configuration options related to the alphabetical class index +#--------------------------------------------------------------------------- +ALPHABETICAL_INDEX = YES +COLS_IN_ALPHA_INDEX = 5 +IGNORE_PREFIX = +#--------------------------------------------------------------------------- +# Configuration options related to the HTML output +#--------------------------------------------------------------------------- +GENERATE_HTML = YES +HTML_OUTPUT = html +HTML_FILE_EXTENSION = .html +HTML_HEADER = +HTML_FOOTER = +HTML_STYLESHEET = +HTML_EXTRA_STYLESHEET = css/mylayout.css +HTML_EXTRA_FILES = +HTML_COLORSTYLE_HUE = 220 +HTML_COLORSTYLE_SAT = 100 +HTML_COLORSTYLE_GAMMA = 80 +HTML_TIMESTAMP = YES +HTML_DYNAMIC_MENUS = YES +HTML_DYNAMIC_SECTIONS = YES +HTML_INDEX_NUM_ENTRIES = 100 +GENERATE_DOCSET = YES +DOCSET_FEEDNAME = "Doxygen generated docs" +DOCSET_BUNDLE_ID = me.nlohmann.json +DOCSET_PUBLISHER_ID = me.nlohmann +DOCSET_PUBLISHER_NAME = NielsLohmann +GENERATE_HTMLHELP = NO +CHM_FILE = +HHC_LOCATION = +GENERATE_CHI = NO +CHM_INDEX_ENCODING = +BINARY_TOC = NO +TOC_EXPAND = NO +GENERATE_QHP = NO +QCH_FILE = +QHP_NAMESPACE = org.doxygen.Project +QHP_VIRTUAL_FOLDER = doc +QHP_CUST_FILTER_NAME = +QHP_CUST_FILTER_ATTRS = +QHP_SECT_FILTER_ATTRS = +QHG_LOCATION = +GENERATE_ECLIPSEHELP = NO +ECLIPSE_DOC_ID = org.doxygen.Project +DISABLE_INDEX = NO +GENERATE_TREEVIEW = NO +ENUM_VALUES_PER_LINE = 4 +TREEVIEW_WIDTH = 250 +EXT_LINKS_IN_WINDOW = NO +HTML_FORMULA_FORMAT = png +FORMULA_FONTSIZE = 10 +FORMULA_TRANSPARENT = YES +FORMULA_MACROFILE = +USE_MATHJAX = NO +MATHJAX_FORMAT = HTML-CSS +MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest +MATHJAX_EXTENSIONS = +MATHJAX_CODEFILE = +SEARCHENGINE = YES +SERVER_BASED_SEARCH = NO +EXTERNAL_SEARCH = NO +SEARCHENGINE_URL = +SEARCHDATA_FILE = searchdata.xml +EXTERNAL_SEARCH_ID = +EXTRA_SEARCH_MAPPINGS = +#--------------------------------------------------------------------------- +# Configuration options related to the LaTeX output +#--------------------------------------------------------------------------- +GENERATE_LATEX = NO +LATEX_OUTPUT = latex +LATEX_CMD_NAME = latex +MAKEINDEX_CMD_NAME = makeindex +LATEX_MAKEINDEX_CMD = \makeindex +COMPACT_LATEX = NO +PAPER_TYPE = a4 +EXTRA_PACKAGES = +LATEX_HEADER = +LATEX_FOOTER = +LATEX_EXTRA_STYLESHEET = +LATEX_EXTRA_FILES = +PDF_HYPERLINKS = YES +USE_PDFLATEX = YES +LATEX_BATCHMODE = NO +LATEX_HIDE_INDICES = NO +LATEX_SOURCE_CODE = NO +LATEX_BIB_STYLE = plain +LATEX_TIMESTAMP = NO +LATEX_EMOJI_DIRECTORY = +#--------------------------------------------------------------------------- +# Configuration options related to the RTF output +#--------------------------------------------------------------------------- +GENERATE_RTF = NO +RTF_OUTPUT = rtf +COMPACT_RTF = NO +RTF_HYPERLINKS = NO +RTF_STYLESHEET_FILE = +RTF_EXTENSIONS_FILE = +RTF_SOURCE_CODE = NO +#--------------------------------------------------------------------------- +# Configuration options related to the man page output +#--------------------------------------------------------------------------- +GENERATE_MAN = NO +MAN_OUTPUT = man +MAN_EXTENSION = .3 +MAN_SUBDIR = +MAN_LINKS = NO +#--------------------------------------------------------------------------- +# Configuration options related to the XML output +#--------------------------------------------------------------------------- +GENERATE_XML = YES +XML_OUTPUT = xml +XML_PROGRAMLISTING = YES +XML_NS_MEMB_FILE_SCOPE = NO +#--------------------------------------------------------------------------- +# Configuration options related to the DOCBOOK output +#--------------------------------------------------------------------------- +GENERATE_DOCBOOK = NO +DOCBOOK_OUTPUT = docbook +DOCBOOK_PROGRAMLISTING = NO +#--------------------------------------------------------------------------- +# Configuration options for the AutoGen Definitions output +#--------------------------------------------------------------------------- +GENERATE_AUTOGEN_DEF = NO +#--------------------------------------------------------------------------- +# Configuration options related to the Perl module output +#--------------------------------------------------------------------------- +GENERATE_PERLMOD = NO +PERLMOD_LATEX = NO +PERLMOD_PRETTY = YES +PERLMOD_MAKEVAR_PREFIX = +#--------------------------------------------------------------------------- +# Configuration options related to the preprocessor +#--------------------------------------------------------------------------- +ENABLE_PREPROCESSING = YES +MACRO_EXPANSION = NO +EXPAND_ONLY_PREDEF = NO +SEARCH_INCLUDES = YES +INCLUDE_PATH = +INCLUDE_FILE_PATTERNS = +PREDEFINED = +EXPAND_AS_DEFINED = +SKIP_FUNCTION_MACROS = YES +#--------------------------------------------------------------------------- +# Configuration options related to external references +#--------------------------------------------------------------------------- +TAGFILES = +GENERATE_TAGFILE = html/nlohmann_json.tag +ALLEXTERNALS = NO +EXTERNAL_GROUPS = YES +EXTERNAL_PAGES = YES +#--------------------------------------------------------------------------- +# Configuration options related to the dot tool +#--------------------------------------------------------------------------- +CLASS_DIAGRAMS = NO +DIA_PATH = +HIDE_UNDOC_RELATIONS = YES +HAVE_DOT = YES +DOT_NUM_THREADS = 0 +DOT_FONTNAME = Helvetica +DOT_FONTSIZE = 10 +DOT_FONTPATH = +CLASS_GRAPH = NO +COLLABORATION_GRAPH = NO +GROUP_GRAPHS = YES +UML_LOOK = YES +UML_LIMIT_NUM_FIELDS = 10 +TEMPLATE_RELATIONS = NO +INCLUDE_GRAPH = NO +INCLUDED_BY_GRAPH = NO +CALL_GRAPH = NO +CALLER_GRAPH = NO +GRAPHICAL_HIERARCHY = NO +DIRECTORY_GRAPH = NO +DOT_IMAGE_FORMAT = svg +INTERACTIVE_SVG = YES +DOT_PATH = +DOTFILE_DIRS = +MSCFILE_DIRS = +DIAFILE_DIRS = +PLANTUML_JAR_PATH = +PLANTUML_CFG_FILE = +PLANTUML_INCLUDE_PATH = +DOT_GRAPH_MAX_NODES = 50 +MAX_DOT_GRAPH_DEPTH = 0 +DOT_TRANSPARENT = NO +DOT_MULTI_TARGETS = NO +GENERATE_LEGEND = YES +DOT_CLEANUP = YES diff --git a/contrib/nlohmann_json/doc/avatars.png b/contrib/nlohmann_json/doc/avatars.png new file mode 100644 index 0000000000000000000000000000000000000000..e3c29989ee3bd1c74522a302ba04999fdd9fd1f1 GIT binary patch literal 1174355 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%0Dh(TUE zb5UWaFYi5>>$eQxq9k(q#W5cHT4N+ZCNzQ&n*2C^h&At~!0oDyu;ZHDJ;&BiH~kR9 zTZ9+$NM8LBq^l0o{Gt9duJd|=-A6SESql&&p};0~#v^lUon2D6*fG3Vg_E-(puTyD z7Z-7sALuacv)zMz4bNKm)W6 z?AgHGSpK|{x(N0(`9+mB$iBF^(ApDVb&ZthO>7|9M?ieT`%zD>?G-n4xg8&`6# zads}1xh}Q$t8BzQrZsDtMBy{|@s#^ulWu$%r7 zzzge2(s9t+i_4M*SV`}Tym)l8VIE5_p>MU4%^Q8T0k*22uWyz9UKgQ@IsV*A)Wigq zT!YgT3j-)CjkP>cJpegqiO8wtL(c0|W6!}PH8CkwA|5KLgA1hx4FT?cF(!;HF5 zrUF*mvk;po6`XA;H=?64q_T=0iA^V_rE8_@~Sp(+JINeCr6^8!br(u%4a#7#% zYbrPIoRbV4Em^C8ZG{KOhHIjpi12&))nP07m2B78v9zl(`zXM4v%oMe}=dqMb6{#;l9Ythy0y(~p{ z5vvz?aJtmtcD?5I%GEU?K7REL-FlNg?@DcfXMOg`oXk3UU*LJwouWVAWA7T?P4Q!1 zSu%WLkTV{?{K(vNZ_sYskTk0>8x2jFkWD-VpPk<>uR@Qe% z=c#V%MXc}c_IB`6O5U5bzf~pt1x#mhj;jVA_8VPCk9-L9ZSH!|B9-Nb?CioB zz%Wbr-mAbSF)1ly+-S?TSSgd@oiaVyYsKIw0u)(}Ud%SLt@trotd@+!;na%;Wj1Rse)J^OKR5uwX)h{9wh32} z6l+n1<`l-p*^Q|zG^J8(by_2DWBlHO`vI%KWrNB-BYD`&jzur zFn;$KgLn&$q#)eyg_W?B8EaL<+o2^EA^c!5B}pg>5TVl^K6{LWrxpVRD{~)oHCyb7 zyv9%I$-hN1_ZdwT4Qu zwJCggKx3mu0?VYEPw>f!f`#B)*0bMT3j0FyEP-X!4J`^{Vus~ojJ8O=cjni+%ork+tfr^=a5iYpX%ktZ4&KxK0%2WMoXv&c-dj^ml$2*F-Mz zwi66`_hShl`%ivZ-)X(MhSy(ipsM6gX1p{KS=b}#RcO3Cg>R+PvPBw@VR*};I}4U6 zhddsBS}t##oo0TjQlHP&mytvsYxJO6Jx>TUe?lu3EsaHFA2yZt8&H5mGx~et(KSAe zhGm!z6=fvv1fUhu%({<@A9|{HOy{f#wl&ctHY1_NS`VT-qa+n}RQi2r=&gx8D0F49Yn)R-{`+vfG;{pF!D zx+YEE#elh7&|pfFPl8XPEVU;9(JdqJpDKtrk^}TB8+Eky>UIK?;2W^kx}~R*BoY9d zU)sD1bU+2T0a9lW{;yR z9C4rPOBtZ}hc*}qiV+~UZEN+xv^BG?jg@AV7{!bFp|p2DI1fjxO=8|&0g==AiOuKy zsh;(MFcAjrY%jH?hB@AtZ@NI+t&fsq!X)v&+iBfx2{=hRJ~=5VF8(ZOolQ#`u4bB# z;q4CsyG{^5pQ#bsF~O%_lPkJsG>^!fRKiSb8JA=7 zQ;DiQvPFqsjgG0Kg!Gwc&L75qc-}ipXRTW_2SKl3Y;gEx@Y5%SI4ia$eI~B((3(<1 zPR?>6VhJ)LL5L{R7p@U?(>S`=&!LeLU0#seh2s{sw@avn{KF^uevnv7FtI_k#0`>9 z)`r){*p*>i>DF^O`H>J|wZ@Sa?@ePM`XcSVqR*=UhxM3sGHb}&g5`4{X<0@_Okq$a zFDECSlLFHqY-wpRJvRv?ER;~E(nL(MuqQwTO8k67y`#(ZtXXMcW0t z5(F4FTU^o@^^|eBQkC&`ASy)9s+qwftGJmKi3@V`L;v`@vO|L$ z5C2FK)6u9x6OtSQQ=}v}2#Mlqo62;V*`J)3S(V4($;NXIDL2UmjExny1b8$6}uF|FitCqn#h$fEx^{G?;|h*QX|#o)gBpzl0-V<@M5HG zns(?#bbZ3ItlXYltQDh1bz{KAn6sacz3XR%pkV7lbAI==$ow#bm_Z^zt31Qy)i%@x zL=7M~?gSZM^usBZcXn)`nwYXtkJe|U0}q-s9T;>YTl)BVYR{L->z*H9M0%77+3BV| z4F5g3Pnh}syQBY94UZ5=g%!ZHbPT(WKI$0S{Th9p^1>IoUHf>zwQhP_LQU_dkyGvW zduSpC)%g>1TlI2n+>=o03#gw1=Wfkfsyvbl#6U6hSx`^<|2Fe$Yr5HT);M{9Ed;E6 z@fF8~Ih_-1&P(HU$lLD=r3stk8@;)63+hWZgu4HbY)= z(Ko|h6T!RXRkmSgw{isd#sN`{0k9Mjzq6A9~xx3 zJ_-PCH~+KoWT~W2f(c7HpLpTs8erYwrTtj`5=rVnLdLI$L$7!l4T9%X6#D~g&oqbF zIU)lc0vvo?kDuDGb04WUPj55XdSY#{m`76Ud>6Uo ze)W&#LqiUeGN>{9Kh&yPbM5^7uNVAZ?d`lROJbkM$WCh}=TESB4w_Hkjo0aeKuO|M zq#5@`5+}-=H8n2o>%puSc(gup!8FY$ZmV>i%)+#y9ht{G#s0xg|EOSk3N4SXROo0N zdLN-yt)QF;;TR(|u(;;GDSIBglQK-x$zHOiJ1P8@m0HnQ4EeH9(MA^swf`*1MM3BD zmY>bnbhZijVp$!9>$xtGY#GyoE5U@)aZiuW(?Gv+#j9m&M>hMSapZnEebllu-v}%r z`L$or;lUVc+qmk_V-3{m-})%$qGDR9lPPUxv+{uLfX1A*L)|nIjZYsyCKtvGy!or9X{!-4XESKAulj;ILpnS_%#GHIO=K;iH~U|%A`YxK1gz7z8uDVP$2c) zy5F`>pV*0?fu+#;<#XZS&ihs6K!Gpy4$qCB)b&T`y)wz zS{Gi8##t%AKcU<+kxQA)-1G_Zd?QZL-DM>Ff~PWlwl^El9kh9A2Im zH$LIgq+r(?)es1Sk>*eIIV*cKy?8cd4)d!uuOw63p0V)w#u<))XQTZpi-Lr~QKBnh zs<5I}BxhWqbyeN`tIDbh*whTbr!X#0>r3@y|7b1bUsv-eH4C)iEYv`n{N*R5`# zm}$Jl)M3?|?7{12H2v97Ne0i%^3|(FkdG$rg-B{&v$ZAPYJ+RNd2Vhl;8iG%Bncg6 zQs&IeuF?cdj3Qx?5Q10kLx_?JUs1wB0$vF$4@z>Xnm7!a_ntMc?DP1x>8VEC2IZ`G z=RH! zv>fp7Uxx`h^>gX3MQYL;|D|=?TKmP>%e!~j5EaFU8S}q2jGt0#-XQLmdML2^3*V^S zO9p-`0aK8-6pGr`Ef{mXciH9}*yT~mNgdT-c8Br+pgcI+jU|!mhCW264hu!nPd1E6d>F zQCxX@tIEx%v6zQSP2@q@YOA zP-&u67TLEXP`P)@GymBk;Hm8Xz|@!5R;I^0QcM&Mj6&26lDUwZp7s4uZJ=}d%m#-4 zumRX5NB#g#$2jmG`;PR5HS{%^fh^qr{YI^AR6ot1Eu%5t$>!7m4;$UQ43Q|;0O{PE z>>x$$T(h~^ty0e#dTt66`tS>34V=V%z4RyBmo>^CL-pr!%2jEo99t);MBaR*Ro;=zx5!z6~nfu{XE&1y5BMR7eC*9c2AOCzDMX^J|)WmFYZ)A zLV4krBxJYP|5ZP8LW_+TJ7wCL&Qa8j^YeLy!oZzZ{AhLgu$A+SgbaLH zlu21N$Ga$J?4P|?KV7<%v5$>?dn-rgcIT(xMMO!IJZX9q^W4{0_r5%mKSsG^({lqt zOs2#akxW7#=?2e)-?`XwTpU2E(dVEgjSX&$Whzy12XQyuyeF$;6!_A^gO&p35*P`RI zgOFA(R|ty8CP*ks-|N~hHOV*9kNKF*R4(-?iQjNfhGX}R?3l_?3^U|j%=`VHTdz*Y zoO+qRcwS^?5lEeeS6KsBwyN(rm}c5Da$+tNH2Ytt@fFo_gZdX)+K{$rDFQH`c>-tD zH{QD{GQ4|tB<0W+zyBjjSAF=GN?G;X)~hX_3?daiVr6aYAc&X4;S zthDqYvk^=W7C?6F9~E_8_^tKCVzYR5L-J9e;Wr#5jIzP{rAGY2qK2_XvB?=r37ez^ zW5##LvMH>->pP_~M5fA3teY4At)5lkj>QD0ac8{7`Cs%D#rxMFC{m2(EZiO<*Xd81 zdPqRz5&c}zW?Bh|6q2XJ{dPUPdRRdQ%F10HQ($Hy17Hd=@`tN{L_vPnFLC$6Dbp{v z3Ugqd=+zFDo_f$f7LnX*qRMAS&C+FoL?*+>oxM@i9@(9_QtTfMs#?!C%8{F~Jw5gk zy?okEnH22MhVJUE#QHn{<~ViF$1xqvJNZZ< zB=Cs?gaNM zl>&O_XPr76L<=w4>OncZuG(4yRJmfBVU+C}++a3)zS}{qkX{U3mVd%TX*&D|2RBTI zGp-iN|1g7{+>4U@^nVncWjvjK7{<+*9EWMsb#!+hebjN7VWyex?&&zXO>=ZiPft%b zlbdd4Y8d-Je=ofA!SkHo{k!A3zV{~GK}yO9W-uMbMEvVO8JYO>E8ozv{6L|YB8^sl zNzv=?<_Yh+|K8L1-{S+&h1T|VU2r<4DH<4MW)vQS;FY1bOphd6@(_L1-}`HCVijM) z8G!$oJ2J51Lf_RadYhj-J)8%fwe54k48TO5UN_aUOBaZiS{wu~ z6W!CFnTobob6#)ly6prh*qiF3g}R$X(q`W}ROaA87 zL#JyYL+YUjY5FxU>8G=04DNJW0h0w&0Tjo*4^XYwNT5l;H&*_$ukZs2bHcdpr<$e( zgm38Lk&!sZ3-rw^{G&ev2-oR8dKt3qEMUrjz3Dte?i~4rOf{Q{8oUE9s7i zsI;A94bP}RMKO?b0)j(g@#f8RLtoU0s-$XCwI~&_6uu#NS8#dRy)`P~<^-G+-$pPQ zI0zI6!VJG#%1e(r_y)chf*bP| z6St#}vh5v9z(~F?GN8Cgi-MDanduOv7;KJ>B zMPBk%tqrsmbfsKlz|m2wn%P{AZctD^aaLWoVYo_;TVz&Yz)@LqsvdA=F=4Luq5qjG z%6+J#S7y^g^a8+g60~x0>0G8NXxfE2XVb?CY-`W)zf!VNXJ!xl(`>f`bKL{!qSI=d zr`gstwJxdXsA0lJsWx#y2(2v_yO*+%CUjtOrrdcbNM`uVgDtC>pawO)MKePlxwwkker;d>7E(ClvFs_3qYxHgTImR){z4*=PWPow z5*|mXpgtF%U70m;J+YtnurfcdQwNM!`Y}CT;|0S<3?YK#aYANwKd1n%9V#F-Ptk7% z#5c>Q?(LVCZX|RRc*WqNREfKtl*hn-A2F!GB&u$1ZY1^a8lo7}#)TvI)lkzO7>95C zn21xWfx)3c*WN>6Gqbw+lE)=XP*T)mcV!_bF#E^Z>nfcW4q~)uBG0l8Q-ga4T&O}B z$4X>(aD&MJos2R$9Uc;08dtB72<~7{&q85I8~Z__9JzMh^67LEX}6U5b@1Y1(6`Hw z?Rv}J@`F>?TwH^_r`6WX<$lGUBvrx!RBSA3g(?G82-@5n-itV_AX- z+e@PZwW)DhZ`Z2Oq4wFC0XCk>ec>x}OoLjYL~ZLqRZz%*J?bgKPHUJrANTJJRP7u< zXcJa$R=&ReW`^Bt506Gtj_JePH6B0T#xmtUUtfpInPcwGqRI_nx=^Kqmnr2*em{Fr zB17f@bz`YgU77{Igc6G@zqSjAY!=HMxqx=TspdQFyd26_(MT&*AnMM=VraGp^cI0mGj5H~nVMD;X<+Ts-rWXqG%s z--wg?JO~E|=WagixLqZC_eH9bFzfE$9X&Sl zlu_TB17G?%U2-!41E7h5O;BFkWGcf!W`#w^_cBI_`rqE>qJ!ibJuW}fGqu(qJss^6 z?+Q1rEmNOYuw+w`r3i>+y3CrIb9;GlyG!@;4;fHO@MU3Pdh zeBe(6>EvA<6g{o)fb}Lq&sfyj)G;IH7cUZ%r8?S+w)n7_f0mkNp?GseR`crB!>jf#2Bm~O(owQ0 zKU#!ajR)W#FuaB3mM_~s&Coo~c>Rmp7Mg5I&bgSrlo(riG!2@b!sSo5HWz?14$z_! zV5UE}R#2(f?2zABb19E9)Z+2%*5Ve?VDngTc|_fpk(lgQ&tpJC^;T0OVgGpEhQOke z7?ta#Vs2`9Oa%ifFHB}WW(sC)fZgq)R`5RIMTqxc1M=$6_?1yvU6ZR%7Gbh{R(xEG zJK9K+R!fo>C+jn&xR{4p>8b{AvfIZ3&pJtH;UAj*5%`?pg4rXRWMs@g+{hl4~ z(Z6-%(kmhG4L?!lxpRre-Yyh)K!)oz%x(dH^0#Q zWvgPLugevd_t}RFnB!y#GLhKe8lGX#o!=nBG#JTy4@W56)Y#9IbchU%pO@5UQ&b^s zN)e2;U;Yktbv>5nf4_gX5RWy1e8Ma=SQVgX_dtnF6?4fhEmYGU45n9-i7MLMxT$Tj zbq!p^4^X{ZuoGTd5{g|I?K^Q7K-{jJW@PA+f7mWGzBa6S!|_T96D^y+V2*=wK*cW8 zdLW4n^EFgpzuC`mX$N*^ldAi!38OLM@AoaUoB^-1H9!_SzhcyD0-b+op2G&jGm)5W5jn^m|FeI|Sg5~v)h?aiG0(NQXo>iGpyOx-> zTNQ#i{_Qj~d5I)WJUb-IvOZWtdU2FTI<{CO%?5_;7ab??1#gNx5Mx0cgyLH8i@6aO z1#Awlkoi1+Ae(Mr_rCC%3+N?=R*=0_1KA6;?0e3m7AL#DFHAQ z9jB?$iyl}JP|Cv{a#@Rww41PMTy+y+2)5qjq_1|?BUyP)zNpnM4L_wNNkaJrZ4(g| ze~YPc1oDVup~6s|NX!9^C)&qyHB^-C+Io_Y6iw>_TKaoD@lgEj zK%WMq$|b*0@9BiI+S;1)Rty^wt62j7M5`K&RvpZn_DAst&Z%2HUX+B1Ng+bwvPX`_ zb}EHW6T00(sh|+FB*M>_sW4Sc6!g!L5_l*nZZA&0k!nF^wxT4&L`C(v-hz?G$H#B$ zjC>wee+1rNWi2f1zLqEKD@?7e13bKgfIbU=vT=}T=1E-i;c#=Uclm8@DbUF`F0ZYx z14c+lg`t?&nIYGiR?VB++gqm}MgS!QU*cErc01%3fR99WsJ^W=^x5A|$d_{SwX$N4 zHAm|7{1}_P8o1c@d6nVD^*Yk6yRlKbZt4Bf8(rQ$Omc#0KqTKZ8~inkCzu5G(KDbD zK`90>Oy->@kB|jgtiA|WMe#1jvIW*Z{&h@Vp5m5~M?@U;c!|@u(~zF!TPgw(M**^k zZv5aJu{5~IfzykRKhBi&Kno2S)(lAOSmYiLRY?)?CF7eyQVyM%ieKA$Yztlr%{vd) z<0d@v$DT!|Z4?813yARvb^H!0yEk}p3I3B&!+bH67tSc)ENAA@{ke6)DPp!1a)Vr` z&Mdq4z~#BUy~l$bavZ>qHRn>HY>DNK{jsPqa?*JLWiu~ge0O|(I_mo)`?GGXH{=yR zA|?0Hs%q&~4u6)a%{%M?LNv7AKgvfEUg{W4rvyRKFgx|Uh6}&jGj(-!H!eWfxO$Ec z+N3)7wg)7MKm?k(T$7*z)G&5-RVv98=Hj{W`#w>BT3WkKXOXHsf5&?KkLD{Bi+P2G zy#QEA)f#t_V}G2tH2u z#JX?#puvT&hp@_k)vOqbm{b>zr=XxA9u{IohmhUMX#)%VNW%j zs2bmIt*sf>=mL5q<=TPb<{Jr3R(+22-)MD4b&;lpOUHr~*Q>4ncLO_W?GTUCky7sG z8(jbi5P&@y)Uv{=*8dyvN1Q)&4c-Q zM!F_A*ZH~dHh8kZ-rpYh%Th;Y=UsACjUQHc;-_+?0?J>ivzjBwn-DW10IA?{r=mD( zTqpSsbu=)_Bu=NG8HxyXlrkw4xGA0o_e+>&eQR(B&~$f0adF7iTdLgOU}2ki$|3eo z;s<_dt~TH|J#!Q|eTv0rD5wPMrac)WdE<=es{BYp#`tTfpM$G=_pgme8egHqawKzR z7mIYjUGtJr$KNL>?;lDVAKIMfHdBFCgb*5N{u>O=tn;%;?0ErX_^|vu;H&ERCv{P3 zhBO_Qj0X>C%((hdy^r%=# zPJ6Yc2J=P*{|%-2I}O0@067a~oMOG6{6G!>S?V(S2Z*9YYj+D^>iL`}| zTcKNSPnOZ{alQ&Zdc8`E#yKw1SWN$bo~bySROqPuC$G1hbk-K7CH-J$F|wii1A;gC zH-@>@QnxiUet%g0c}P%8m0!R0Jq0-JGbc?iX#TV~(ZOPy*4ta9t#3(5N+;FO^2kTk z6jTgq?(_D~P^r%@C+G&{XiA#XMy4?`b8>xNo|+`;j6J(uo4$SC`!MznFFbgr>v}z< zQHhzPR6}zCb;(V>fZxHL2;0pnkRJV$)$*8AHJb8NUgkR+&l`hv26I8nM9d^*BnMk; z7);)+eBG>C5aSh@HQig4CeJ2)b9oYUd3j)R*ZAd&$ZI?=FRv8F5j*hEcV`jCFbn;b zo*rpns;AIjUtb>=ckS3JE-c*I)n!@3N`$SSy@z8(6ZmKILw>-`_j>bd-*uN9z-Ulk z&kOnXOjc-pd84hP=_;)(&-cf}#_h(f)CJ(8cn`>ddA_f$#1xh5vS!2}{r@ztp6+bF z)&}6jJdACb8InYT5Y%F;%Izo-YO=WWL@RFiVXzzXn^~Fzpx3i9Bg^1C7CE~h5W~RW$yFdzz;;lUI7xpt#9ZcA!7-?!he;khOG0Iv zbYFYf@-Ugrb-%l^_FQSrwM~ypr0-OC)v;n_Ltj(y)a#+f&x@VCrcr61WNOm?epZ!F zkffXr4a>A|`4~_BfOjZ$w(SS6Xw8B_EJ@!LCAQR3Y$VGH^}(uq}m4UF6-`SJy}ahsxzO zhU`xf;BNa!<2=-ndzNDC%Qw-`bDz;;=jiF_X71+TaeXmNbAEfT6$JVN_yNK|lM1hg z#aG2yH1ddY`rl=j7FV^J%)lWv&4?Ku+~x*op-w4(VvUilgIW~R*BQ8j+ZKwl4SBH& z$wy8-IV`b>#XLAGK{#?@w*oS_5>}9;i_=?mEoQsAe4HI9CT`SVS+_*(9#OxKN!TE3 zPwr+}$^u~aO2-OSjXN6KX3Ex=7H_gAwue)2tLBEeIBGbyX(?J(jH>1keq|a{I!9@} zHzpp9qJq*jANhtme2(Knnup7q6U9-oj}!N_^{um-$?)4z7B6uYd`~xqgczzp_tb7* z=2HO^6VMXb3o&r2uryw7ewnNGG4o}>amRt^b4QG!<&)@z0|uv#gGGs7f0NG%Y+nX9 zS%ccO+UE{)^KGX?Av{a6!_Q~tXZ-O|O^G=7TqaifUEYl06QjE_lOj{yHcmZTTZDex zO?tJ}J^+3Gx@wNMRf5AVfN@k$*Q$uv?nU6TLk1>RHuWJqH{WZDN9=`m7o6YDkbxhHO5y892Y(R~!Hh zKim`}3?u?;6BhNis6kg{ec8{WJ_puaENK2lUKnPP%pYINjsgZ-Vo?-~S~Fo47S3cb zCox&RB|08N{kj&nu&NzCo78p)R0yQH{X9^%U0-s@@=4w4Iappb$(QTWoBNEi55a`8 z^DXI4v2FT9eqBR#U}Al8DA0@SkLBjOErTVuS&p`=HSKfGFxh~cjo&fHq-&LWMjN=D zMeo>@Q!Gvcy;>v7l=P1r7BJQPb4Iqv}E#;jfSKsn9o8mVhw_+%e}vDS|otB(%u?Lc^v7~>*+v= zvBLrE?6=2P`#{35ovV@IR@>AN)qU<)`^j>7XCMq-xooeYp&|AA8v{^W0dK|64@e@{ zRU1!MyH8g)Zl7*}**+4$fv&D>h`H^l;i>uM?Tg{jGppp30y2tsfJ@*ta|y#a=eJ#REJGQjZ|wVT5?6!%P#O0|4OjQ!8!FNfCFUi?v}p-}io zUDCWDa~}uu1eg-Jv!pR}_2@)}B#Gj~0xA*Y73QG3G_`Upg<3?(!g+dCxEa{-$7;|i z^6gpB&%W;iI(2hLcqI(-HBxk|x!U{GnbLuqV?F;K9&?+!u20`(I4O34kC-|-YIHk9 z5q@5^>nFmWFfQ!o>3NFl5DMl5jRJFrD4;3n-_$1dJ`Vgzt^wvB?CK8xJSE++YKl05 zG8?Lf-t&?C4(ad3o}89RMkalpKqV*2+Cf9>eRaaNnT+JQ z0|#9gkC~D>T!wMw^@dGVv#cuU8<+rMMo?4#*ZF~hes7kIyZg^p5`$7am3W@&=yIsd zr@yPr%%u_i;FzM%FtwBcgKb|&DN3S0y&D@wHM(;K58XjPO5RTn2;)q6KoEfJNowT1 zd9vI%XjZ>^3i!&Vm3QU2}IDopT3XDt(CO07wugFSJ83jl8d$m8d&= zHpp0p+PhZ|n>zXn6|!w?67^6+V37c_CwkV7^4(0qYFy1ZiBZrav~EuS?^ij>33vM= zM(#mdg1{ zLP9affqF~)qAh^bu?=c~7)tx7zjqNw}x6w>y-#U`EoO@*j1 z3Q^Gzan*>I0H0PtDx45{6(xoO!@irIHhK51BYOwA(qO5|mX;&z6iC%vOXH3*-N}OT z*`&9R^PP~*iA|f~;(#Xudvq#q#L!EbM;}Vh5O+MvVyPp0#Hn1 zC^v0xT%1O`scM3B?{>n|Q5gf}nN7A(MI+;|8B7 zvU;oastsJ!L$yNbieLzsRc0wm->KidLOI)P=k-UAx%i%~-I|WFscc~$o^H!`tu$X2 z;PqQrXFBI{oL;wf$XGe;o`z&eIt9qvP?6- z+yBn>$88!sZ=Z=Ung_R^$AZZB_C&wlOhJNVZkzkC2%Mox zV4>X0`Rvp$$!)*ZV76Se*CMb#UhgmpP6E{AI#DufwmxI=c}WnLjlVvdU&Q@3Le}NX zcOkncZn{04PevNNxlM^*@)##HidbJUs3FczKap`ZX&QGnesQ_nBb~cI46?E@b$-1J z80Enck0IUP9j`_*>Zbt~27sNG$?b+|_r@K~WY-&8FbT6|c3>a+2e zJa^(yM~s}3YL^LCOPb0Km@4@|2(Tu$cuI_X4xG$t{pjqmc>4}}Q*rS2k=9+U#pT^p zL`|X!vz3RCurRaz+|Mvx2oaVb{N0EAM_M#m=<{Xwf$C+^bguVC;GML--dg9^R+b1rjH8-ukzlrmWX1jNM3s-+H zr^a(;>aCxWiJio%#H7yNb`7<$d|?g>JXW1+d_R{>xkV5ef*sB%&x%!icQPsYxc04D z>?t#EUA#!+ewO{m#rU47T*Ry8qd83}9WG2;SA5sF+)Gg#a`Lt3rh+>3OVY1(;454wE0Nx1Zc1s48r8VKm;5ma6|??JgqzEEP7% zi~A9VKFaq}ny9$#ud-)f%ju9#5ihZ(JVX2lM+zUROt}uBt)2q9um3$GbFSOur|j(a zOH|a<`t9x&=NJe=8H@I=;umty1r;I%9!J;O+yFlH6uF(P^@-QRdZjAh2gar=Nyh#R zukr2X4u?Sn1%=g*GZ&YaD@^0EJ>@9dlo|PWc!Gm3NjZLne&xY+%nsvKFRr$oVLF24 z6BeZwp}ag4*f$KLlM63Lm4&`px`Z&5Y=3Vlgg&c%*K@w)<*+6V`;8;6y1JxsoIN9M zKv6|D;CRd}<+UmqByrt0U-@R3c-ZZekuMvf6lWw{(Z|Bs!rI$kAXmA>Jl>RVD04re zBhoEPzbb>K%gXsYzOeTR|FM5}WHAf>$Db<9X0`>_`ouE$T`iG3BH@H9*Xq#telM$hPziB+62M*`Zi1wGT0>^42o^peuLMyVB_ z*|IP%X1);5nLz4zH;BcO+jal_m6%xBy6>fC48wZq+#0p2+L!j?)&$0%82oJ zSRZSBxodxcE&05Fe!XD>?u%@^z=jSOoxuww^oJMNJ#FWAJVa|v64Em0!SlDzQ5n;0 zS<@OS+$#;Q)li==6EZv)q+IAoP@{F5ipQtc>oI0bC1?ONcaA^iZBR=AV~VK^#v;q? zkC?255U9Kys{-o`5jYH_$Xckz`sUhDGs=H(J7+n4L^Q!b!ioS7%BBPDH~M(IaPjmA zNO&d;cI822CwB+HDSo@rQy&lReOpIL-0wO|J1gFU8 zi#Fv4`2dR=TZv-RGPhILd1b-EJ|6Co=hT8VZfPlqfsEH_RA*fAr)}qX;-9k1sC-Ve zK6KqBuRfiQEq|2sKjh7LTK9M-B;_~k6c|!;!XQYt&G_?R)NIBqHPn=4cFlusJgX&K z4V8>>rvMEue5i+>fVu0+#w1v|00r>(DWG{hub-VqZ;IlH8yN~g&4m*w3f{wfxA^;k z|Go}En7|!xRvY?cOv1`XOmyjs2rjyk;1%*9LIRez)g@*c3siRHI`5}Gr26EM#wnQ9 zA6VCd;uN8QnVjj0jd%VPgxKT}rYpP_WF!il@miG;6iZ`VAu<)zhNA+4ku;++CW0`g zDP{2p1-Xh6Q|CE>FP8dg&~Ol8!Z1!a1Zm))Ty|jLXC~<%F{0)fpfyBB3>nXpd>AA( z#tosRhQt(dZOFBWq4@9W2L z$J;nC*%qL_E7foh)R#w$Bn8I23@6cLd1PedBFBH-xc!eG&i*X-SPTy}geN7zdsFam zAUYe~u*xW9KYs(}1#2=P{KGQ`zuybVgWvuRDh(F#n4e+y7<%;E(#D~yzSa1G8q2UZ zSyPJ}mKf$*3Q9|bfFi;u#$$-8-bBL31X$_d$^|ie6kvVN(A9H4Q)llGas(XOrp30i zRUuGFgv?`Cu9UTwhYxOn83ZU?41Z8g5L3=w_%FDUSJSSx%?iUCk04Lle?2dJV zJB$`CiQu1Pwa2+SjM{`UF)(Rm3lQu~pND>`3h*SWt>8#Tswls%``mm_(P1j4<>q|zIX$hs%rBzFr9~L* zLYWrlJr->ML|hIxa#++jaEHK-Cct~Ownmkd2ANrb%TvTkH;ow3A?}n>(9RvST}Y9M zMlmtmUrW_N12aLNF$k5-zOrObf`dO9P!N6gFBH-GooCo;7xd4Yo*V~hfe@eZZp*w} ztF#dVaPh%W^tcQfvp@B?5OMMG;j*v_o#(7CL1N!ObFQY0UUo)DLzvBXuq{6dV3zD- zxXfkFWSWHOl@6BErXKx9U&tYsxgs-y*v66--4#3wK45vx%JfQ#0paW%`zBvlKmZXR zFC-uUg90dmGAE{H$2|u{JgnZOdlxya2~kF+ibr)W4GZysGT6mBeijy#vFsx zVo%O&K2RUikT9R;JYVi+B3IWViSsU|!aB0TP`ve!d)JUm$!e*TYJ-UnmFvhPMI_w( zS&&dM;cO07#wx7dE4KuTm_zlj2UPYu@0PDWop&BbNBgr<$07DAqvh4u3O`ivS&@}e z`7Y>5Fd-A+ph@tv!fDUhnF5N&3B!63t@1B#xXIlr^Vs`%l9cJet3UG+Hog!1(wpSr z;Kmi38xftrVh!Ww-P3E@(Sm%OR++~)XyFW#5lL(er`Tj(_!tf;2;+gU81k^vyr$j; zPRC`ZyO^ZIia^aX1aI|o7R+bRq}O`1*4rhiv*$L~M@L61^#K^$YAN!|Eu281scH(Y z+=U|zRT#A~_1MyI?#$d&=MD}IfO0f>q(tKmj6CZ)<{JHuHJm^F{rfl3p4&XXq2XbG zX7CIE`vU}_cGLa{3~JwBz<_x6j%BXpy!}{{Ct*EsDni{awsDWElE`g$3#>H{f{)sg z5moCM(kl@Yieq_Ji`2V4sM^kKy^<8pfDYg?Fjw}6siR3{pOs4s%+Lr=`Ceu@bh*9z zFn)TH-FkTE=jrHIZ|=AcbCHnNYL?R)O~Cz4J7kRtHL4xO>7T!_XfsZYB%b~%*H7hE zNUF^pFyG9UrJP-w#l6EYV~vE*yovJf<^kvg;`)MB3BSsP0VG|#yY%akla)+EbHESHNo7QhPVed42L zL&i(qe80E=0$x3Eyv*uL+?0RZFBkVe+`fzcK0SH5U2LxQOo3UR>DPP50SU>Z zLPMEq*|x)Zq{;F;&gSWdu)P&SEs}a=W@^<^xREH1vaHISKoOqmfLXdJ3O1yCHkhI^ zsQ_HUBjOf7P*0|OySTbEw8e{~1sx>A@1MSutXRS@H8F^HP#R4ODeam0MuGyGd^12lmq9Px)@6P0W8`&@zb6jSgWaE$}>JUd_&Kuhns8{Rj+oGwU z6^vDY0HHxx=~DSnK07E)@oq)n1vga{qM)(%8YF9Tlcl|K`k8KN^D85}#6H{B#+guE zivZ0#R z^~KpW|CI{6->+Wz8jFo;FcUV{w}*j|_N!-yhlQyvt*tn8_NxH%48iN=|IMV&*`%pw zI5CV@?rv9x2s2J!BeWm~9$GM!Nsfw?Wdg^u?+RK`q*RQ%lo|gOfmJYnwMh`T@Pq@x zmi}GB`=`b0TTI?fVwNJ3^{bPWwuJ(Ib0Lwq0L5gCHxQ;bhVWfKg=o&T&uNfJ6>#BE z`doy?_|J$#b4*6Y62;~h-%{tdzkp?T!oKk=t$k;N?c$&h*{<8)==Wokjfp8s{ z^(H%v1gSN(AmyntS*9>LH2(2TtoFd|8`a5oZhJ1OY3CY<{n0erwxc);_B+=$R)V+{ zl4r!w-EhnfDBpC|Nd{*^JX>2g%SMU*YNz>Z6vwNMae zbhja|v4s6{1#cna{q^*IK~ZVMum%O)`Za0nASlW0tlg;1kn8Q}uIqCBX-i9s?E)b3 zQDr2Yv34ICCvS1!AF^K!JgFZxn>ol9w5wderkA>#*N)QTAR#wDR4dIpYvQo;_xFFi z_h5fZja2&W>WD~4Xl`wt%H!n(?~T5)q$ii9?_wjME-pPCAhuK{qgPM}md{K}B79a* zSP^i|%VM$8vB#xP;gDw){Ct%2OCtMeUAp4<=N)g+H*1`(p)QWBSI?KGM0km5U5X^q z@LZ#-Ag00t-#3godRRvTB^+8pBi4m3g7PX%!3CzS1ut}&gDKz; z0Sa?O437-TSbWJG=K^%_va%e=9fu}t+YIHpH8ezPCEr%;eP}&9-T+wKaf+`h_F4dG zMnp^Lcu4Kuo69n<7J&hV76$`@Rd){RxXcmnCOUE_J7pYnC>G30~Lp4$N=Q1!GFYDiX^w z8k$%uW`A{R+CIF9-r`^khcc1#n;DWc_!;iOg96Lmn+*uRoCJt!)&j{}inv-kI82kT z$DAwCm!jnVvN2ghkJzFR;T%O~AJ>mU<-X$fQjI>0(C(6B$1(q?A(KZDuArCk#w4_p zW7PVX%qKIIHu`hzsEcI&H+vI)pNip^LV`^9^dG7zOkJk9q8=* z3*>bJrQ4Zyu+8uS95Wlf$2IkO)lZjiNub6()^eF+yWKZa#`*VW#+|+Y*xH`vmj1n^ z=`&{f`}zE6)onXYSnBVu{{8%*r-0k_+q!@Eb-s*8Iu?UE?8yF7F$ssG2eJ0{hqI2l zo~L_l4bk1ASgzT84Hb;P#4KO&aHFdEZy*2t&S%~Mxxo|s6crV9YYj#D__jneDs;rg zxy!0guW7EyI-io@mB9Olfe*-Ae2w$}46sZ}|NEQ8{{aYd$KZW#5yzUkHp4T&A9owZ zzb^kt{Z2{<-08UoJ+X<-qgbDklac+|BJB|o5MT_Ojy8`=%e$X2i13TS%CcvKNPboP z2TkY;X1&?71N1D1fDfq;i)GDY>Akl0MqQyw-Cyg<`zK^k>8QnsF_lIMbMZ8X6p#LN zP5!wtL(t57KlR=v|Hqne&8}A#$*-P7JFXB)vZ=m$Ta!}bU!7%@H>!_ zK{+@+t~#%FbTV85WP|}zej9G94y`r%jf(2=-@G5it}={$<Id2jI^lWDxm{l5moQ)cD1A@W7Q>UlCS9U2I#Pfz0HL4V;barhk%#a60W zY;G#3n--N{*+&N9@VjjMr8I3=@D*L-SG5U2i{PND*nmvhY!IKAm;p=ECyDOo%?s_% z%QJ>hWVE%?#w8(AJq32PUQ;1PIMV<>jghAz$`K3B8n;A4N0PG#9}P2A5t@~ zdKHIB9-<@GS~OD-v_0o@>W2JDI{!yEpJFF%BL;@aejv~=jw(n0w}$AE7Jb$}xI??rO@p#dJc93)O(HY4;nZe|h!ucmzK`yKbE0+pWe zK{*|XuV*nyD@ zTdNkAcys4pgZs5|XWrc8+8*{~*Q@k#QL;A9SA_!uwKrcKrYi%fpXg8%rSywTMUtN#Xl35h^G=NWvYb zQ@Q$Zb1K9k_v8?|@UIqfypl3u1q7cv;CHY@a&VW`E{v4SJNb9VX=iBgFyYSXzdmhoCM+?;P`A6DbxF>92kR-&7DQpu z4l#cEozYB_!&XJ)Uhn{oVf42tVz4flQ2%st7mg{fMz05(cL ztRTBYv$8Ao36lWp*<49jfkrs>SvZ^xjZaKhgVAB>dU%+9M8wI_6PRQ<@x<5JSUi2Q zNO+oh#-ui1GFHhawR)?}_{r;o7O! z1a;l_w*5RefO-HhzsX7Et>BdY%Ti;e8W!D6)z0(T%SzFdYOAYr>W_G-9Rwte{8{7w z|65KQ62mUKbw&Y8@4W){#ecNjZur%G*^0@3Jo&KN;y_7G4qW4t!2I)Q1hwmNJ6;@* zc|_O*3UNK6X;!^};>g>^-bi+d;})lCAgNa6naKCUAto;UpGAtvVn0Ele1a3jLAdhI zK+sC!H`QSb#hc%~Z7z}*^&7WZEKj~mS?SyJEr?!oEr3u`%~oF%qQ$IA(SlTpw6u$k z{XW{jBo8%Pt-Ckhxqtrl^H*V;u07MQH_fRiropITk$wGd=ZI}Pd3y|EgZ`IZJU-k8 z?XnwJB)EOLNBY9d$cDr>F5=A-BwOGW9Pit&UIB^8^fatqZ>`BD#R_(Cc4pM+eWAjV z+vIt=lA>geoy1CtF)!Pxg(Q0cNy>zwc5<%HF6#d@L(FBB{>Ol? z+N>-~wtr~N=H-`4@(2c@2xifVS>)oQC83VRr6Y958f-6(sXnQa6OJi{%g+sHg<${V zW0wbG;(Kjqr9W*tNzRvsQ6>VlB_JV9Y$yT*DT-?po5vjUK+5vB+P0uX|u1Y0FY-yam?FP~wt zs!PF(x?xQb!F7Kb224gX5_%J|$=vk@pJQdW*yqZ9u-VK)7%LN&X^J$X z2g3lXySnE5Z|{}GgIOk~@=v$Hf3GX($U9>mX$v4|!PduBjGqX~Wx*Jm^yU4Z`g*>~ zFG_^NkAPm_zxDILR=0hP$u_(I_xz#NA5S-KlcM`Mz&B?+cuP}LIqUmlp20CS1#}xK zvuYtZqv3S}WYNq)E09qE(1xzF*R04vvkPQ~k=S8L%F*@R5;vMml(Y30Zt8s~mLn|e z`E4wDW&O+b%EUesdsq9D62f^(%qCqGq-cMXO@+?TYnn^klYD5vWXfKu$%V`r z0YDaL7A7u&kDK5!5~3@YzX~(}sEH2?Nca ze+$RPA$0WH64JbMeVvwCv=(geBoK(O_7J)Ow<%1+Q!aNnv60qRtVW5-p3HJ&h0;xW9;~+iT!^+K~E=b z!bSEn%|8n*{2Amn@?5sO@HTuNaCAM{zxdjS(@50*4+JxM&@98y6-#YI4OIp( zrXd46^S;D`2+^dN=;+Gd_&}vl$p-ZslP~v>SZ|;|hE^JKlq(`4$C8v^yEG(f;Bw1I zqhZbS#KFQa8HxCE;|)j<2sP(P{1nBn&u{WUTX*!By-gy)@-bmx$W!0Jeoy1;0$GIt zV9IijasLQ#fhwv>oxqj~a ztp>6!E@yql8lG(Xd)|FoRc%rW7($5UhN2}pPsS>kW(nk(w1*~B*n3NK?zX7^dm4+w zmu#Bjo3K^z&1+I)Cz7@EGh{6~_SU|ML&zelhZHMww2_G}VnVu;7FGm9uml(c<+m@x z+&@{@0>96AeDkf^P@i>=rCcERUYFloqqWrSiyJ%#@e)SEpmiN*Vv?c?G(&ZP*X--0 zLd0GFK6uGu$|8$20x$0cjBFl5S9t?r!)l-!GSIxsYe(x##Y^&p!L;yZgT& zN>xHB)5S#fS&^Yem$a5=4THz=%NNo-`zZLUQYX>bpf{(Pt>K*!0S1-=s0AS*rd383eCThTiSZ30V~*b14$N zo9mH099~mfH~gD7z-cFZ+=`-UYg=63$alX|6e2wFz3F;kKb*-%8aHe*&~@nahoYCP zpo@Z+*15W7Yfi|CRIUV5^X=IjxS6*AJMcd(Hy*U$jsqerxOnT$Il(UGfH*=g z@RqE))ayReF~d)3|Xi_<*84HfnUhafvH&$ zo~L3#`lE`CF`%@(aT}2hyy&1j@t6;Nic-=4s6c_;pt<-RQ>cTlk2@!UV~_UiQE z>rZVtp}!qj8_YnVdKUc|5YvbKrvmoV@A{aEt+A)U;&G>d;|ziMcOl55|9RbtJbJev9Bl1zGaeU|t$96TzFg=#*yAO({Y8#gHE%;Va5TbV< zeigq!mVCJlQRY8kHEQ}%AyNOP;)!2Y89}8(%C-+?(kAc^fn~MgKy(1vk&oe};K_M; zc~8#HP}{&bm4L&n3{>d$WDLdRaJkdTcW%xRyhPgNI=4WQc#tJZ2;wTo$2$swA%rya zZkwYk{7ydUzp+f30)Hp>$mppQK9`FWE{RdE7Le-E&BCLuxubMcXL|B2_*6dFdHK=b z9&0`UNz`Q3U$bwAZ9Hje<8yz8WPP8ahlVCrsoVj^Yfwq%sChS=dS8hzL*h5-o6O2r z0yBRh=cm7uvm$grTnKr0*hwrBn@{};VEp|2{DZ4e&JRRz8~%*j_NM{w=AFC24h~f& z%k;HyT=F+lw?m#S)u0X2xYw|4uymEOmdK4`4rm$Jjw=7$Ih273bU_0>rZivB7b6*o zBB#rBvPY(W%zqzMMG|0MKT>M+t?snVDLTlV%umzZL&5ViM$N_FJW!C$r7+Hi1Zmj5 z9^idl`h0KJaHb`Rh`D;M=<_$P5iB07A$~TB@b~O3lrHv_3?H(dJhF|S^18JYSU!F1 zzl-K2oAwVf_LN!%?hP8`M(^4&9zbya(-hpFAxXI*7#o3`^CDx5OyrQ`XE3L)3^OcS!>>uWATMlC^pBgSVe*jSb^8v_IHr(qiB zmH>HlSqJ=FsI_!kkJX?rwdC%g%GAX8#Npd`9YxNsdwuqjZM|ovS~Z=^E|-YQZwVx% zNHP{^Ee|U)%9NmJR_+)Ixp|*QO$B~$YDW|N^K;9|&~=cnZYiL#MG?@tc~C*$eJgOk z5L3-{q)+me0s#~)C!JwC`I* zz;DgUM$6Zg9*z;vh>;%zYJs6suj?>JJ>sMGGG zr_#2uPXOxl&3Zd`R{ZL;^kE_PRmQBshKM}V?#|8)nA$r5M3RH-<1%4p?wK>?{Y5u0 z5IpaGUFT>h{P`6Sdvw3({cUgr=KCtWm`*eOIemTohQ`JaD)0@r96XRv@bg=N0!y2q za4TWFYsyCWxYEV8hEtEJ@G(~Ah#O6^Y5_g-@TuiScYf8~(SOM{KTclgdawS>7r(sv zhH05$^B!AJ5R(TdD@s0HgkZ&^A2=Dhio(qlm7gUV%ZkI?A4yJpoy;2O2;3F-;5yA_ z_<$*U{>;~u9wuqVU)_kn!0>lEm_S(tjaB7T>z zBe`H*Wj9q385s#!prgJ0&gFVGB^jB1wUvsrbV#_X^#KdbRf{+mSMGflmw6W;qQGlg zJ!8*Hc3b@t7TsyIqB(VnGZZQ3N^MK{LDB116|Q4UOl(^3MWL>t_q<|xISMadvB1rd z!B~F#yIgLggLA^@O$#I`@1)@UJj>#}696g~7uK2#4&-kX+)G|fZB_p|M;qhhts*o3 z5_@p5#QcaU{>%)Z`yrA2@qKkTB`7rD;vG!qD{pPRM{26pgYzbSJu|GI!pF%;6>9C^ z;D2-2-FjA2sgl9J3!K*)a6{kSnudMDZZ0sm+y=Pg8K|%aO~*qb7RCt*AQH@QeG0M# zDv>j|EYg(MfE+z(e|E4w8I;+qQ_cQ%;M*7JI*GP#Uz&Zdi7SP#F2+=i>m2>72zC4e z|CZ$^eiXRdBhPkBElguO6nfDc9(pR}WO`Wt@{t5_rIDD^*+53%Rg%X`qMDtKNk%Aj zP!0@>I^E^|_C8az9XvzM`RsQ>&3U?GX8w(lkr9J0ZhlNoJ*{w!gF5&(XA1)-}nm z{-e^u=ZadlI9gOpv!?+Y1j#p-z21}P&{c`gS5s90?F1;3Fa z^)DjbH-|+6&6^Je@Uy@}qp3{0{GreAnEgl28+J<90j@Bqzi+|!`v9pwT8(Es=o#MN z@qt5CDEb*&S>^b^fT8c+agm)s3=U+U|uJcDM?Y=Se!h zTWYC2i{%*>GdI4U9;J;HJZ*Zse}C)rY#{4vu!OPmjhdV0Pyb{KUKFC7gZmh{K1fI3 zIM(3@d$dotT|=wtqg=5D^5?l!NKXBCN_D%LVs46PJ(sf`{t^{N36Fxu3M#szDZo$g@e-M0`?27PWycmPUZ;tv={v;}~Cm=jLJ&O^g3Upxl zqk3isybkHg40sRcQ4q`bGq^5#dV0RrEnXFJ_$zMzW;qXw0FX)iY9wxLAT3FO&d1l6 zm`$HoSokU-&QB)pMu_hIq-#8a3WgC1`$=NC>e3liSn0R)!B0{HOGS>MgA+gQnJd9| zmiO6U>KiH2oK+dxwcw#}L_Om4=KX>Q!Qphw<_lk6PbKQU!au>$?0a()Vp;wC{Jc;+ z7`7K<>F+=!FI%12*UDMG_t+K(Wm_@WqppMDVU?&6MKGUF3uF=(m^u+3n7=#;sBG8* z5TM|?w&iA(W6AG$(3B*-=(U<0PZzlR{t2qGKI>mU2IxTFw}-AAmbMeu0uWxn)mS!o zjoUeKj<83c-VOqHhk;Y`1h0x%>(u$J$li|?P!Skf@-7c>qaC};(u9RG2S5Av&PAB! z!A`N>OF$u*rkws)1MAt|I*K+TRWiT0>Z|HKfBpT={k^WRrlZz8#fHlkMpyAOy5a}( zK9)Ekc5fiV(+}^szO-y@yEpu&d+U9QJ2#5!L- zsJ0pe&CCjab$_>1b~Bh1kp0I$j*C2V(?0?>p*K}#oew$=u(*QXUAl{I!=Mq6qcL9d zDm{7mM_^yB8jvs>Law*XhSO6>=1E8?v+FD_=jo&SiHM;am+RPgL7^=QeEe_xW(;Uz z39b^!o|Ddr8)4J2ZrTq#-6N-XapwQDkPrcbGfQ$hoW&$}XK{)On~`+|uEDok4PgF| zr&{;YD*|_5eQp4_EGVz1yMw7f6Z6&KM<+kDCl%kf#fuWJtVc|$8eTn&W;r(Q79^>< z7@lipUm@4#MP<+clz~!%vF`umzN;uJi(dQ*;hdp+8mN7ePryZ}LBukVG%QF6F{P@0A_6d(xqml5B)f5BP{)UU?=%n6%7Z(?v0EY?Bbx{{Q*3^E-jH5DF<|TUf z{;8h{XdX9gS2Tiu{>0frUzWXb=iAcFngF=~xV-JrgTM^5$5x85cf8XM9n)vVlywfn zSDqu!of0{bFiY-+vl02S3MEE*Xu2{jj?~Akzml7Bq0+C9Xdt(&wM z)4}FaaU7nnDy}K4l*7b0$4)BG&&B1R+;6DEPwDFCoLX;zFX{53{Z$UO%;~mX5h-uJ z5c!n>lM1FH0q)K^rzI^+6Wop0wf3)_oc1$?T!A%{PtKk>ycJjqKxYHD;~fB*>DGt; z$w+?a6mP0XqT>}$n7dhie7zkt)N8xK2bfiKZPT%E3Yte zz6|5D5sBlR$WGW#(f+K3=0CG|d;TH<9sS|{PE_$Z|C$=2P??3?4RZVE?7x4zZo*spWdoqgZT zV;`gC>Ml0~HtUxn=x3L87;MCATYN8rNuNviyTK>QDCFr1(W%fs!M@eh@ZkgF@kQWd zbhA!{VI6;0W))5;5=-YG`24&2x%>=IsPq-kl|VlxA6YDN75^&)YEdSI^f~I_CK2eboOD=82B2p z0K!t!ZG2K6reF2Y!vJA?&A#Uz9v%-oF{TPQa~E9t+4cb{9ouwMQv;c-q9Y3n{$nZv zC=#sC48Bx))xW@(B|s7M;RygnU>hi{rqEX4ZlwzR&`Z>>~x`7@40{9 z4|J^vy#8AIezw)!Pp9y@>p;mTf8PHg@|1nlkLY{2tsnZW;Psxc87uNXj5Zbpr58+$ zHM4V_UWdkmqT#ST`SoGI6a4On4^E6uGiM8nf8YhbZEU@6JO^CBpw=EwiZHqpw3r^? z4Dp+H?Eu7icYTtp*j;QkaC)~1mgYGBcIt`N=<};1L*X!$N8+g2(;wEW%*nA-4+oaN zs8XTP7PAX)W7LkooAa@lYm1a0GDwWX!KpUOwN-NJEX${1AV%mguX-`lCd+8e2h~na zF3wLc6^tHCW#92a zn!t_h~i~F_VRdJ?FFAF zczZlOo#twHw}Dc?1~Bp#zzXh@uO(sAwT9=GS?imEUFWx8YW;($7kJo*vjE`)>=i8R z`baJS+P4^z7PR$Q^%Be^wO-9wqR% zAB#OesH61R$OXU_9QgCayw2&09T^jWUx}nNM3yp} z7MQ5aCm~cXs=Ez6eOpEH+0x*$hD&oI2+l7y$oMk#-LctVxU;<%Z$j?{0*YrvM!phh z0SmvW)H%P8booTG5%1GE?#UZ|S`8Ydg91y+Ou(=ccnuEog4>u%_VxTaJ5b5N?i35| zOTaS%cFZZaH#cW$>~uvb#IJX%4W|}>rUM8J*oAvp*R;wOaRG>?x@$aWw(X)(UIZas z_U7wBKG2lu^~~FB!(pz;mDMTA!YvmH<>m1Lm=<+DAqEXBhgCQEP?;7oxyg9SD@0EO z`^o5_HfvPnb06MZ{G2O^;5pd~*~f&`&^AWg4imNgEbXssMtoXuAywWq5h7Ajq2&l#67z>oy9EHCH$dq@Lqp@S8qoXk&a_5c~TvJ-WLRwAO{-XPdw8_VDpDneSk5A?bnwfsz}JH^r}P$ zm{jJ*9qnc|Y=WP;cD03HIvoGl9`a6v`C-t_E4n@AhuY*BrNJ1hh_|aI}#e zoFHbZLu*!nAFZGIxg6o>7IYKi|9oC$WNzFA!i_3XZ6vk;_XS1Q)-ZIc4$Rqgn^pN= zpBeg}P5?6{Y~9bx%L}|jlsA7KJ!sp0fccBA#PGBngmHWURhY&2vhRiGeC~`8sd?5q zE)LGkNwN6EF&AFd*RLwY1rG7MN`*pWYn6a>vwgJ4yNk#9x&y{Zu5(-Ygg_j?a*f_3i(LSgf+7|^o8gZM2C zTU9?eL>%TGjBkyNjbNe_umr#bTOMwd*%~`*YwP|LHp<%#`MKHI?=;MX&$~w^a6ZL= z_4FVl3pjeV$}1_z$*%#xY_J+ke<9+rQ8vH*3ynIj{bR)tDCz8A-J$~1UnHzc-eq+p z(KvyZih&y4w9f-ZYQBnK`W$mL;bQl5!yaBS*Wwgdn;xNuWL(uYUc3lKFq5iv;bV0v z7^}re2BBU^3YwqU)8c>id6gSjgFzFxcS_0TbO3o0@`y$gogrU$$eTZ-8QdIO8oNNh ze05e8_aG{nlI+b?7uVH!cEyky-z*c~AAArW$Q06i8*(ySXFroTXf^fK0Az8$Q1<{P zo4bo{@u5|htIxoF!QG`iHecsNxqkE5_yQFo3ijOr+2`(ZIIu$d%-sm(>mHvht%N$B z%)i*w}hM1I`#I3kK(cXc8bkc7I=F42jPV|GE&f1Z0vU77%TX*~k6(b{Q=#4OW3K>3AIcUN$C2)u2Io{1^l=~HMXdu^ zF8Lr+0rTgSQ3&55Unn(n$`XRVx)a+~FxW?}pYQ`ljY9J@_Pxu>j2@jnb27b2>6?%8 zJ3@vkE&F(VKRN%zpkPP|tvp+`dSwju;((NSMUuY!I3u?Et;n7TlR}#>A@XxxUv4=o zt;vhK0!c<_P^n=KVmB4$4x*Ee(;q)n@EW@l@w@Nl^D(3;%jJ(qnJSm(_9npsqHHxByhR6 zn*?;wye2Z76@u~b$jQn1tX}sY930d-%)ObK@RI^>;xGpB8+GPn?66>)bbxOg0VsTs zF~D6o_s}0$KD+>y8v}#6>fu+{6F``I(3JuIC@__Na2P!lu7}7pAM5_DiSns0ud9LX zBbECOyiJ*aACOtxhH?1)g>7F5b3_N=6*3k&!cx#o_4oz8mO?4OitLM+1jMVUWX|P7 zz4N=ju_a9Wt6inR$hYNo*_Obtc@5}5Rpr6^;n8qyl?l*(4Y7E$74u-DEwI z2QNGVU;v;}urc(-}ak5^J=NKbSbMrCP?j_k(K%o9~_hnOILRLDc$|E?}QKqIQ! zZ9hzu{io2<zYu;4yk9}es{SacbY zC8o|pegk*Pume`d0WdFqP<--xiWHLx6<+#ja80#efgVlqvqCTgRUJdiTAvCXUTWZO zxWp27)?E_u&U2!y04}prq@_E6 zW;_AX8!2bYbOS*cT-mEnASD>}3B|_Y75XW)^w-aI9)dnEm5+fD%g8^bFaxB zgD$D=bUM0n!s3k~>k@!djrd7;r{T(C%BNrMt}%v#YT!) zfrWuMk_lJT>yIyIvMve~B~romW&;`&QvMWMh?JH<$iBrMUUIC>9upL8i z7{L$|@X-Rj`qJ+eG_v%bf9j zS}4c8C@o2tho6=^syl~mKNkPRi7u|53lY~cjW8{dVsfjfDC&WSA!sJU@2Mb?Iq4f8 zDH6Yn%6>K?xapyi@U)+QmA$sn&AsTVMU|*tYW( z&u_Cu8&7MC(@mk$&HxrLW27A|dUk%@ixPS!;S(>0j?!GMkCwls9jGyAhV* z_-YhgF^HB4{kL~-qh*UF-6Py7zr6adO4u6N>o3qHOSP^*5}gwC64(j6w!hXn0+t09 zZCE=wr6LwR<{ZG~v_q|xdo?sDcAU9M>aq7-k)&qt@1rk<#E?klcGpUXlDxd z#w>V~YwEV{v=KGbp?oBM4s(wlqhKB!{O2@->O(L!TM-s@kIff zG%6h(xpdRP?0L)0*KY2)zR1m{K#7CPDrNb`PaAg1Wo4)|1yi=XFY3RnPg0&(d?Day zcwQXji6X(Y>b(e@3&kUkTK4Ne)G@HR0be-aiVei@O2wzosi+~p`5hP(yZRjeww?aw zZ#)B!0Y!o#f z6~)u%N$ z$b})f;ZSOY&4R#oG@_(lDojWTMSOlGk<>>bBHMXa_l$x;G*k$)7`@98R;Le_oF_{; z69KAS9xRW++XJ%xX2HGB_iZoU`BFfY@jbPItmpV;!4RbS~iX_`)F;M;}5)#;_7yg>>NPFoZdB4kunaopl$3ZCrqcZUR*KDow z@%PJaK97O!HjF3+bD9I(?mQ$F^+XvIov}cpQLx;cE>#KRQxS7~RH)@oT+7!nt~lC^ z8Wv=NG}Plb(nC3kHf~UQ(}>*RFy#EPEMuVzB>swv3Z1kNM1E{ddYZkn%D{wRQ#<3A z6e4K|kuqF`!!V+a`ULzfYOcwcm=^WfSn936Mm7E6K|z^#T8t+_C^_r zi}7^E*xL5$#~HUsX@5xyc5hl=4?-3xY+Ei4vO4;7_IKi1G2Qr>+7Z(E6PQUKaf!(Z z*3zHgN7;L9@3|btq&=RD$g%j;L;BReQ)LYcFEpY}U9$W8MU-q)rIWp8U2lvRiB@Jr zE<~)AEcZ)hw_X!|bg`5gSrIo*T`683R*_Z-lI%HSC(V;{DI~U=-D8YCMg(>!ei1D_ zoRmHjFAUqw;w!O^@H|=pGKl7zoU3zCd3h0sCiWs9u^#0_5ve=uzaqaNXy_&c-Y6ye z9@y@bbqB}QgoVF!8n`!_xp1pXxLVStefGQ4y{`6*%RW7=C#Rr_W`bnL{Devb<&$n- zD2Zg<46KpL2tAqMjd=Qct*)hUr)3G}m#5A%4!TPSZU`fWD6{0wGg4vS)dbD{5#jWa zyJ*v5aC0Bs-!0wS+1Y{aG$4^nfGGk+uoc)BR9;-Yhoe~j9)Eq1)uFgM z+OoAj1lBUG4P*Ns=$?iu=$k7A9mpOtPResGTcQ2G1kyuax2r6HkBeDotoI9hi`*~n(J*b3K zYGbg;5PF$U@H;?5KDW-=iG@!fA&cv%8`9!+yzK8=?s=;;EMk?AC{ZMqhq74l`R=w= zTjg-bJ36Omjt?Ubxi?og?3`IWB)knm-~)igFboC+FfjNC#5>7fz!vmCRKOo)7{Q9V zFaA1*`H;P!!IzLySKO45+0R&0SIo>!yqem(XJgGLw3(ZqUg=O!*`223c zTjkJgen949cqj%Hdb`%Vm%ZKDwx^Tfl0Zet#Ha7_9yd1jG-|({#h4)UFlxf!{{*|h z^5H~;HY1#v-P$_pDIecjCL?N6_+Pc{gV;ArWMiWyEe;yknI$knt%bI8MLPpuJNam- zf|&P%)Bq@%%RL|C#qAQLpS{|Mc@kQ~;F*IiSR6CqDkKr4UiQ|WiC%*#FCH#SgpetV zXX%8MqB0X{_}r>|D*N~Z9evzUR#67MG+upDT*t?BuI+KgdGmh`_v#fABpKYavI6FK zGFo0HML0BinJ24l1}XN2Y14j7Ccf+na@3?X2C4K?8a#SI5_n1wT&2V?+{;*KOiE8> z`1s5F+ku`uPycJmx~4|FPZ;ot?}=2r{4-rm7TWPK<~EH2MDa)kx}Tg)JKy?;M2`mm z8g%koAy0;{J}AnRcLyK9&TaT6;MqA$b3KH4v~WgP5AME#V2z2ocv=t%v{g(D-(8Ce zm3S<*X(c_X@86?t0|Zw=4jpGO{Zq=ttlK+ju{ir)(ipmYIo{=WA>Gf*JqNTIF8|(( zh~P(8E{T~LcrQv~AoiH$4PlwJpxu&|IBrSng@=%nSYc^~*BVP^VPu=<)`%NrI_(&JY=Wf5Jk7U!y!;;L#0H~>dY1in?{C95H;&&T1!I*N z+W%Rnhsu*jw1=H|6|kj5)D=8R86vl{b^jc}S^AdzbvP{&iN&J+Jg!T|PM)@obsVjf zZZ*bbVL!)qCmUVksb_%?UlE$|d*PX|7zH_ZIlNHRNErng*@STlmpq81Mj7$tw`WV^ zH@eNsm`Mq^C||xt6{3bDy~*Xys#N$Q>C|S>!)L|j3o8@kII!yQOpZxxHsC&0qH%Ebx zt_#9Ie(SqTJp!ZOUa|k9+AA^N8NA&6j1=v-_fef@HTt`on~DrckHLgpgPRTD;z0cU z5FUPYeGNip+*{}VN#e`Uhy7#lJrKG7)}&vn|CB)pgIOB?B3Q#9R8qENdGAG@V7O}L zq}RF4pL|kF9^qx4bj@u4^QuNn>~pcIa<<+?RXXmuthtFl-i~x;!%jnPZ%mese`QHc zd`{3YxSkx^X~M^2YLB2@!HbX~r9y>wsW=wm@*JQgJKBDm7L0c;w1-DZ(FI{D=dc=t zYs=)|5Ji|#%gA(FY3m{&!EHzygoaq09&;fqOr}%Ha=ilidchGHvHrM(<^tiabs z1&CP$B1emDI~Ln|!d*W6Lr3qd0vlh>lnOeQb|@9KLIgUEdr<^T7OPatj~*$7%!#L= zV$ym8KTRbXVMrWzQF7yc+{V z{AH6mJbz^4&!0cvZN`AZsN%sja_H4mTnyyvy4>8qVnj*6 zU)D6$UjOiuoyrT_O>uz5v#j$c%bGa*PDIuIO(c#K)Ts3R!s*DvV>{**s#hzeg^fm+ zr_X*}p~m!4R;3@OWG1{Iq4&8&7WkauI4DQC8O8Ha4Ei_~p$K?Y;$zCo>D})s|1jc( zVUx5Uo%?*G=Z?tS85q%X)fpLrs5T@MLaA~UB&boKKYzQI`+C?DWU)vYN5rd}eZnln zflhj0Kz+_U*j7qlbkqtZWnNk8@Z;hwt5z32P7)wYpyW$nA+Td$a!~r3zQ@I!f6?q} zCD0etEZ;KZ?nt@m#4vn3iXVQ>hJpn}&83%fyt|6+w9`*D=H2ezzi7`IzCZcOqoA!A z9K@GLwd{sz*=3UQ19nTO}AsoK@^V`f0Q*kD@sAv0{; zu2heS@W_Ztn1|`5X>!?blSiuwdkVok3=+8@IWH&Df|b-0XD?r%pov;aGs*y=s-BOg z_fkVc9knWo1ht1VCw9RkBc-=POVr+;E6dBp*YxKKB&P?tGr*GAsG0JVk-qe)_)9`P zhts$q1z6i3MAS};Sjg?QY`sK3QyL|tue@ddSJKDbG1^`*20()Yk$lSZ*>AB*r;Iux z0?z2@Tv%?3expu96(WoqJtUEoPL84u&1}I_$8m2{+l^0%12bkZQuOv zT8L{o{zl9JY&O~VJ_hTo$Zz>ycjd)zOc_IgzmiB%n%!N@eWmMT#ddmlZUHx&ouA2l ztN+Dko@}oj71!xMKd6X3zSMgx)-FwCY0FRrVSaEi@-hOEh4?9?^c0r0vL%qd_o3L* zoixvn=mku>U!AOV4%#&89pcw&JQ2!?%TbTd7Jv0_JUtrTX#C3DC|>Ov%nw#OM zc|dRo0!>CYQ<53uWYv6)$@LM^fg-E_iA%cI5b=*G8dVLZL1&8^0nv(qFHt_3|I|)1 zHaFth+SXXdUtJt;Yh<@i9W|HoNKz#&SYvR@^Hi~ zfMzVd6j`M|pb?x;JL6Y{RPG$z3|}LyUVmPnh#!TJ_-IpSlnPPR`)U;hk+CDflERur zfW!Hlu1Z-VRW zJXYWxF9J$0TSA`)>0%fUeQIbktrpYnWmh~mOi5a1G`;ApD8Ijerdt6=f7x>5wEnzi zZEQ*S%3A!Ik8KQHV(FZ;P{R7N)xSl9``glezpJC@j@aPj?Q_qJF6ZN< zVSo2W17l|tC`4SetGDDK?cGgL0*J-sALo-Lpnx~KRSMBxxd~0>S&-$D9-v0jV;_TKy+HTXu zfRdI0m;$59g&_a@i&mFnMA7l3E{sCu%$u=D2wFSPfiv}cxR{$a8qc=ST1keCyfYCV-QKVypHGn(JdNQbGkqk)TFJkqg5A z@w>o^{MFr^UNarrxJ`&6MZ>#_|R{y8(zcaLC{7ST@T0wFkIY(9@UR}zkzNW^Y&_{wR@IkDwSqQGSTwUZH@$B02UH25Ij2Hs(XojOTs+m@3mw@l z{2DHrq|?6l@t&LC6@GEga?A#--}b#!YOvm{|IoGPvvJlKaJwg7abE6n(VGpTiF8gR zNalGYal&b@eO{jJQ>}=oPFJexD+ugiiIhv)YPh_0+KV7a$J{5~Q%-EIQHl+>!4hXF z?_hQ8V)a|z+^bhAnhTdRRySldAD^Dq)N?tT7&uSO@^zlUt!z5_=HKl5%6no2TM}Qr zq|NPBz{1N0&%K*}r`d}O#GwJdVbl^4`zb7r^vRK^QF`c7t@sV!OJ{OOXs8+4v`It! zA_Y-OTxx#O7Ig|fQVfBhy$Tuavi4Ii9X;tXbLFYuUwkY6PP;lD&&XI=%~`u4C^jf* z)8Gq+SdN4C*H00UHj=q-&MStk*SC5e$_hAPtf}x^7$S<(T8VxcuX}d9S^h`B`c^0F zGjfsv_SgJs=!+X?r={L3vJX7iqY8W2G&DW?i~NSEGfa3HE(2UtUDvJ~|;MZihKq;40g1#N+{pv5mpB9ithlqK^^grb|# zCE6+KOoW5VQP{l^P{GKk9Eo|ZM9xCO&b*jT^Y9KTUeeufpT}F8Z

h_LrIitu}B2 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 +%&g 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%0A(sfC6euE8`#0HY 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%0D+SSn%>FzN_0 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%0D}T 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%0DfUHxV0!RVcTDBmBC>f_|adCHj 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 z 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

qqZ2^p^!C`FiMT10ndd{~g3?5WVQ*uIC8Wff zdf3f7Lm2?X2Bx|l$ihMlieboQB@_u5jb&t1d#;nM7Z%SVi$OGc_zKZ#wJa_3H>C(f~v z^RgYYDx4$xUwRIG}{OP+F4m z;a{}`@fkKT&|mj~Z2&Me_{PNeM6_-Um?pUE3FM@jL%gJy8S$mnSe4j6;hqvZ0;mDr z1L6brzG(nE&f1XPHS9cd1F!_Ssi` z+Oc)O0z+N3v^X+ubU_JwB89R5AM{}%N5V8I$@`Ckao!$vfR)MDNsl=B!|jh1H&plSfSV1M;Xsdh{;<<{Fi)V0cQSI6r^0 zwQBLKQ(>oOEX$el1U=i^6oQOV`^~=VUXDYb4H8rVFEBeEl#Mn3Q~(_Fx>pw!6&aCu z7fMUP?!(BQTg2$GeTvUssBy$bQs5dq-&OV%^f|5xiA>KX~HQiSvzQYXFfF7 zeA334LY2suDPI_G{3WpU!Oi9K!((E+-)+07FMX3Of?r(xv(jPK-qoFg9ROs72VV^5 zJl9OzCaIlnv_MPDL1&^;#4Y zeKI8Q@*by1<3sm%dFRtKh@cr6GX|QJ^y{E4j1x0HaT7xsprg`S6z<(LPs`?dc<}|A zM27Q`nETTe-ID{-{`u32$>VPJa>D=)@`6+urdD=G^x|fA?QWW5^`^t2b(6^Ca_C6c zz(`%yB*d-X@?y7bD|6`I#ciUvHEHv(#jI}&%Gs8Q50l-Z!-4mjbK!UOH^12QpwdtjTp6(71hi#&T5ODp8Je|$pHpOUJ57yN5&&rNugH#~50T*2F@ z#i>XiA;53H(BgQOB5UDe>*QqaWA5c;W$RR9_(tL%qfhwW-me(d&6umzv)H4ju!e^& z)u-Vn-+n$0-#|Tmp;>?MJBGYHK7UGKq4HSi+#n1-8!Q~uVk_aXErS%hYxb99xgE@X zXq-(ZYbSVk8XZRmvskrljxD#J7mcrZ_P>4?^WqcVvQ2_M5+gJlM+D;pM^19>P9_vD z9#{=Z#@kMqYSO6C>hE&}&DkX{rZ1+K5};&gi*b}W+5eBWgFmkbv%)U!+QRvk8+RkAj>%`rzaR$it6wfjhIUy zhVG0E7y&MhHwnWWk5d=^7cKLTUs_i^x``f-|NV>b>+{)3|16PRy8Fi!@YFAUIeGQa zy(aeMX~nU@S`R}q?RBIxVNW0+_*gAD#lr)=FyQRUe(l`*ftJ1kO%27d=8=*q6q)BI z^|mThw|p3`&$d2l-B=uNKA&Q<`fh!XwT?;}IDRFuR$LPrE(gMBRY4Zbiy~G1w_lk& z1+QhkdE@CqcwGmTuQBeo+KoHL`V;?t`_KEgMM36`YGtLI!pYD3^{JJWeQq~%eFroB zE^qxGW^O2qxOc90OXcasR$jCFdszGy$84$2Mdi$~_UkD- zlk-z+iMz&4i_J$)5FqzhTJ$Bh(-`U|Y4%0 z$!_cu{3xx>N4Q+iQPq*fs~p|)Na%b5UE)d6LEP(0yT*^jUBV66z4&%`)w@PcFb)HE z0iZC>p$flDjq#F!V?=1f9i6lTEWG@-Gzc=GKrd)lz`0caX^+kLaZ0D{9|3j4Ax7os z@pa}>q6kPt$05r1+(i65#^kOSTjEMe8Dr$JHlEoA@$!INEP8R$*IeUrhDMIQ_szp1_9Ih$>FG3|^$dn2{p0Q7o?D8QGrvhL z`b~oEl*7|`Y};eb!@I?%&?1>lc1S+bAPFo{PN#SN>l=OaP8BxW+fx~OsyDFiYywHO zFYphi|26|cy3lZ7-;yI-v~pITe=X8zJ55M!*>QEauQYJaL5~gJo zArBlL<2QOd>P7L@K$G8X<_<(@jsneCa#0^8e$K3PW1b%4%ZL=^edp7C|3mPek=6|@ypJ3@8k7qjZ&Ab0d-`E+_OqMF$RXf4i@`+ z23|u458leJe(XJKmEtY58dgNHpw3F29q&#YC_Yv>pE-(vy)v44ZtrvDEpc9|>U-Wa z-}>m?_SFBwV!HSu|J9<)LL*Aj5|27D3DNC)%f`ROxr)2NKyq{O9sd<&)cFy4EfiXy zXqR2ipX=LOBvQQhbRFnlGW+iye`l&Db={|rc5R|FJdR=gey-9_y>#NaT{b2fsT5`j zV324oJm5NJ3TLOU3k{z+2e)T4S@)|1em_Q-#pkzAfnZt>!EUULck?|=qoD?mZNB@m zQ3}JOTmKmu{Wrplo$sP^88r5Pd(n!$An;A#L4)-8`y8PjzS)Ev*{9pA0)~$8E7G}x zuH*?OsVt^l#GIr7MI{uk9K2@Pp0;x<#%s@`I3(7#{!-wlzFhe{UiDsqO~W|)J-zLz zNGi4x{-0-zmedu`;z)oD#Av|yqds~NUO}u643HK8mJA7b2S5j(O5$4rwDPHV??w}Y zp;%PkO1_p0pum#nbdffXQvD zbls3Pn^FJdZ|_Sum7PchxWvE0 zg&}JS)X~35JPBST(7VT9KcGgJ5zcRolobl=xr8A*ySHF9$_1jZYyTD#-0O6Kdgd58 z`grFG2{@01MVa4`yWd_S-TgBCw=oh%v1)WruWk-hGgji%vH&^t-I(X#RM0NiF`=s8M=OaK79AQW=Aj`BPR&^(IttXnSL; zN3ekIB{d-nB*8%hj|Yc^j5H$DyivDIps%mLub)~|GjVg%BH61*m$gLlSuI~<>UUG? zc)fg&8j}~k|2WNwu}oiJsflJBg!v_0ChB%|H9sCV96kIie)tycze|EW83b=wJx^8~ zTj7ytfCDV*Z0q#v`xxSt+XEl$EbS4>iB%e8;G&ObBQqzVMSc!do^Jmhn~zM9kIn~X z-T68hh*aAle64P#V1<$k6jQch1qPYbn`vcb(6S{L*dh!O(eH=ILhH2{LQ#8CW)YwR zR-#~*kD*Yl*1l|FU|`3;T*jt&V8t`6afx0eC*Ept3^0mqgdJnhz?Gm3&;%lqacc(fS%GKR3MohBDR(IAmvMWle1LQ71cb&EVN*5aU)^{Na_=0>-^bQe