[WIP] Add a --trace option for validation-related commands

Signed-off-by: Juan Cruz Viotti <[email protected]>

DEPENDENCIES

@@ -4,4 +4,4 @@ jsontoolkit https://github.com/sourcemeta/jsontoolkit 7a398224cc2e76ea9ae8541a87
 hydra https://github.com/sourcemeta/hydra a4a74f3cabd32f2f829f449d67339dac33f9910e
 alterschema https://github.com/sourcemeta/alterschema 92e370ce9c1f0582014b54d43e388ee012dfe13d
 jsonbinpack https://github.com/sourcemeta/jsonbinpack d777179441d3c703e1fda1187742541aa26836b5
-blaze https://github.com/sourcemeta/blaze cf0c89cd419ffb70cc334d395ac5ab1035702e30
+blaze https://github.com/sourcemeta/blaze a5b3c8e4d77a0b88e4a93f304ae75e711b30a2e6

docs/metaschema.markdown

@@ -7,7 +7,7 @@ Metaschema
 ```sh
 jsonschema metaschema [schemas-or-directories...]
   [--verbose/-v] [--http/-h] [--extension/-e <extension>]
-  [--ignore/-i <schemas-or-directories>]
+  [--ignore/-i <schemas-or-directories>] [--trace/-t]
 ```
 
 Ensure that a schema or a set of schemas are considered valid with regards to
@@ -76,3 +76,9 @@ jsonschema metaschema path/to/schemas/ --ignore path/to/schemas/nested
 ```sh
 jsonschema metaschema --extension .schema.json
 ```
+
+### Validate the metaschema of a JSON Schema with trace information
+
+```sh
+jsonschema metaschema path/to/my/schema.json --trace
+```

docs/test.markdown

@@ -7,7 +7,7 @@ Testing
 ```sh
 jsonschema test [schemas-or-directories...]
   [--http/-h] [--verbose/-v] [--resolve/-r <schemas-or-directories> ...]
-  [--extension/-e <extension>] [--ignore/-i <schemas-or-directories>]
+  [--extension/-e <extension>] [--ignore/-i <schemas-or-directories>] [--trace/-t]
 ```
 
 Schemas are code. As such, you should run an automated unit testing suite
@@ -109,3 +109,9 @@ jsonschema test path/to/test.json --resolve path/to/external.json
 ```sh
 jsonschema test path/to/test.json --resolve path/to/schemas --extension schema.json
 ```
+
+### Run a single test definition with trace information
+
+```sh
+jsonschema test path/to/test.json --trace
+```

docs/validate.markdown

@@ -7,7 +7,7 @@ Validating
 ```sh
 jsonschema validate <schema.json> <instance.json|.jsonl...> [--http/-h]
   [--verbose/-v] [--resolve/-r <schemas-or-directories> ...] [--benchmark/-b]
-  [--extension/-e <extension>] [--ignore/-i <schemas-or-directories>]
+  [--extension/-e <extension>] [--ignore/-i <schemas-or-directories>] [--trace/-t]
 ```
 
 The most popular use case of JSON Schema is to validate JSON documents. The
@@ -94,3 +94,9 @@ jsonschema validate path/to/my/schema.json path/to/my/instance.json \
 ```sh
 jsonschema validate path/to/my/schema.json path/to/my/instance.json --benchmark
 ```
+
+### Validate a JSON instance against a schema with trace information
+
+```sh
+jsonschema validate path/to/my/schema.json path/to/my/instance.json --trace
+```

src/command_metaschema.cc

@@ -16,7 +16,7 @@
 // TODO: Add a flag to emit output using the standard JSON Schema output format
 auto sourcemeta::jsonschema::cli::metaschema(
     const std::span<const std::string> &arguments) -> int {
-  const auto options{parse_options(arguments, {"h", "http"})};
+  const auto options{parse_options(arguments, {"h", "http", "t", "trace"})};
   const auto custom_resolver{
       resolver(options, options.contains("h") || options.contains("http"))};
   bool result{true};

src/command_test.cc

@@ -66,7 +66,7 @@ static auto get_data(const sourcemeta::jsontoolkit::JSON &test_case,
 
 auto sourcemeta::jsonschema::cli::test(
     const std::span<const std::string> &arguments) -> int {
-  const auto options{parse_options(arguments, {"h", "http"})};
+  const auto options{parse_options(arguments, {"h", "http", "t", "trace"})};
   bool result{true};
   const auto test_resolver{
       resolver(options, options.contains("h") || options.contains("http"))};

src/command_validate.cc

@@ -19,7 +19,8 @@
 // TODO: Add a flag to take a pre-compiled schema as input
 auto sourcemeta::jsonschema::cli::validate(
     const std::span<const std::string> &arguments) -> int {
-  const auto options{parse_options(arguments, {"h", "http", "b", "benchmark"})};
+  const auto options{
+      parse_options(arguments, {"h", "http", "b", "benchmark", "t", "trace"})};
 
   if (options.at("").size() < 1) {
     std::cerr

src/main.cc

@@ -23,19 +23,19 @@ Global Options:
 
    validate <schema.json> <instance.json|.jsonl...> [--http/-h]
             [--benchmark/-b] [--extension/-e <extension>]
-            [--ignore/-i <schemas-or-directories>]
+            [--ignore/-i <schemas-or-directories>] [--trace/-t]
 
        Validate one of more instances against the given schema.
 
    metaschema [schemas-or-directories...] [--http/-h]
               [--extension/-e <extension>]
-              [--ignore/-i <schemas-or-directories>]
+              [--ignore/-i <schemas-or-directories>] [--trace/-t]
 
        Validate that a schema or a set of schemas are valid with respect
        to their metaschemas.
 
    test [schemas-or-directories...] [--http/-h] [--extension/-e <extension>]
-        [--ignore/-i <schemas-or-directories>]
+        [--ignore/-i <schemas-or-directories>] [--trace/-t]
 
        Run a set of unit tests against a schema.