9 releases (5 breaking)

0.6.1 Oct 16, 2023
0.6.0 Sep 13, 2023
0.5.1 Jun 28, 2023
0.4.0 Jun 21, 2023
0.1.1 Apr 25, 2023

#138 in Template engine

Download history 135/week @ 2024-08-03 67/week @ 2024-08-10 80/week @ 2024-08-17 50/week @ 2024-08-24 63/week @ 2024-08-31 44/week @ 2024-09-07 39/week @ 2024-09-14 77/week @ 2024-09-21 62/week @ 2024-09-28 48/week @ 2024-10-05 59/week @ 2024-10-12 48/week @ 2024-10-19 87/week @ 2024-10-26 46/week @ 2024-11-02 55/week @ 2024-11-09 151/week @ 2024-11-16

341 downloads per month
Used in 22 crates (4 directly)

Apache-2.0

34KB
798 lines

Liquid JSON template library

This library is a small wrapper around the Liquid templating engine that recursively processes structured JSON values for Liquid templates.

Liquid JSON templates help templatize JSON files used in configuration or RPC transmission.

Usage

use serde_json::json;
let template_json = json!({"this":"{{myval}}"});
let template_data = json!({"myval": 5});
let tmpl = liquid_json::LiquidJson::new(template_json);
let actual = tmpl.render(&template_data).unwrap();

let expected = json!({"this": 5}); // {{myval}} is replaced with 5
assert_eq!(actual, expected);

Features

The serde feature (enabled by default) exposes LiquidJsonValue. LiquidJsonValue is a wrapper around LiquidJson (and serde_json::Value) that lets you embed LiquidJson templates in your structs, e.g.

use serde_json::json;
#[derive(serde::Serialize, serde::Deserialize, Debug, PartialEq)]
struct YourStruct {
    inner_liquid: liquid_json::LiquidJsonValue,
}

let json_data = json!({"inner_liquid":"{{myval}}"});

let template_data = json!({"myval": 5});

let yours: YourStruct = serde_json::from_value(json_data).unwrap();
let actual = yours.inner_liquid.render(&template_data).unwrap();

Additional Filters

This library extends the default Liquid filters with the following:

  • json: parses a JSON string into a Liquid object (recursing through arrays/objects as necessary).
  • each: apply a template over every element in an array.
  • output: mark a Liquid value as the output value of the template. Useful when you want to return an array or an object instead of a string.
  • base64_encode: encode a value to a base64 string.
  • base64_decode: decode a base64 value to a string. This will error if the result is not a string.

Example

Those filters can combine to produce complex JSON structures from simple input data. E.g.:

The input data:

{
  "to": ["john@example.com", "jane@example.com"]
}

Applied to the liquid JSON template:

{
  "recipients" : "{{ to | each: '{ \"email\": \"{{ el }}\" }' | json | output }}"
}

Produces the JSON:

{
  "recipients": [
    {
      "email": "john@example.com"
    },
    {
      "email": "jane@example.com"
    }
  ]
}

Dependencies

~9.5MB
~178K SLoC