json-commons

A set of JSON common tools in Rust

This library uses the json

Usage

```rust use json_commons::JsonCommons;

fn main() { let jsonc = JsonCommons::new(); } ```

Parsing Features

Parsing features allows to read a JSON content but in case of failure a panic error occurs

Reading a JSON String

rust let content = "{\"car\": {\"model\": \"Gurgel Itaipu E400\", \"color\": \"red\"}}"; let json = jsonc.read_str(content);

Reading a JSON File

rust let path = "/user/docs/myfile.json"; let json = jsonc.read_file(path);

Dotted Paths Features

The following examples uses this json content

json { "car": { "model": "Gurgel Itaipu E400", "color": "red" } }

Path Exists

You can check if the path exists

```rust let json = jsonc.read_str(content);

jsonc.pathexists("car", json); // The output is True jsonc.pathexists("car.model", json); // The output is True

jsonc.pathexists("car.name", json); // The output is False jsonc.pathexists("person", json); // The output is False

```

Get Path

You can get any path as an optional

```rust let json = jsonc.read_str(content);

jsonc.getpath("car", json); // The output is Ok, containing a JsonValue jsonc.getpath("car.model", json); // The output is Ok, containing a JsonValue

jsonc.getpath("car.name", json); // The output is None jsonc.getpath("person", json); // The output is None

```

Dotted Paths with Lists

You can get a child element by accessing via index, see this example

json { "car": { "model": "Gurgel Itaipu E400", "variants": [ { "fuel": "gasoline", "color": "yellow" }, { "fuel": "eletric", "color": "red" } ] } }

```rust let json = jsonc.read_str(content);

jsonc.getpath("car.variants", json); // The output is Ok, containing a JsonValue jsonc.getpath("car.variants.0", json); // The output is Ok, containing a JsonValue jsonc.get_path("car.variants.1.fuel", json); // The output is Ok, containing a JsonValue

jsonc.getpath("car.variants.99", json); // The output is None jsonc.getpath("car.variants.one", json); // The output is None ```

List Features

Consider the following content

json { "cars": [ { "model": "Gurgel Itaipu E400", "color": "red" }, { "model": "Gurgel Itaipu E400", "color": "brown" } ] }

Parse to Vec

You can parse a list to a vec

```rust

let json = jsonc.read_str(content);

let cars = jsonc.getpath("cars", json).unwrap(); jsonc.parseto_vec(cars); // The output is a vec of JsonValue, with len 2

```