#json-object #json #write #slice #highlight #highlighting #printing

json-highlight-writer

json-highlight-writer is a writer for json-rust object which supports highlighting slices when printing JSON objects

3 releases (stable)

1.1.0 May 2, 2019
1.0.0 May 2, 2019
0.1.0 May 2, 2019

#21 in #highlight


Used in jg

MIT license

120KB
807 lines

json-highlight-writer

A writer for json-rust object which supports highlighting slices when printing JSON objects

Usage

There are two public functions:

highlight

highlight takes a JSON object and a vector of slices you wish to highlight.

use colored::*;
use json::*;
use json_highlight_writer::{highlight_with_colors, highlight};

let res = object!{
    "code" => 200,
    "success" => true,
    "payload" => object!{
        "features" => array![
            "awesome",
            "easyAPI",
            "lowLearningCurve"
        ]
    }
};

println!("{:#}", highlight(&res, vec![&res["code"], &res["payload"]["features"]]));

This code will print out the entire JSON structure with the code field and array of features highlighted in red.

Single Color Matches

highlight_with_colors

highlight_with_colors takes a JSON object, a vector of slices you wish to highlight and a vector of colors to cycle through when matching slices.

println!("{:#}", highlight_with_colors(&res, vec![&res["code"], &res["payload"]["features"]], Some(vec![Color::Red, Color::Green]), None));

println!("{:#}", highlight_with_colors(&res, vec![&res["payload"], &res["payload"]["features"]], Some(vec![Color::Red, Color::Green]), None));

This code will print out the entire JSON structure twice, with the slices highlighted in red, the green. Note the inner color highlighting which is used to display matching slices in different colors if a matched slice resides inside of another matched slice.

Multiple Color Matches

If there are more slices than there are specified colors the highlighting will cycle back through the vector.

println!("{:#}", highlight_with_colors(&res, vec![&res["code"], &res["payload"], &res["payload"]["features"]], Some(vec![Color::Red, Color::Green]), None));

highlight_with_colors can also take a color for the remainder, that is, the parts of the JSON that don't overlap with the slice.

println!("{:#}", highlight_with_colors(&res, vec![&res["code"], &res["payload"], &res["payload"]["features"]], Some(vec![Color::Red, Color::Green]), Some(Color::White)));

Overlapping Matches

Dependencies

~0.2–8.5MB
~50K SLoC