Brittle is a JavaScript library that allows you to generate documents from templates. Similar to ejs, Brittle enables you to dynamically insert content into your templates using JavaScript code.

Installation

You can install Brittle using npm:

1npm install brittle-templates

Usage

To use Brittle, you need to import the library and utilize the runTemplate function. Here's an example of generating a document using a template:

Sample code:

1import fs from "fs";
2import runTemplate from "brittle-templates";
3
4const source = fs.readFileSync("input.md", "utf-8");
5const output = runTemplate(source);
6fs.writeFileSync("output.md", output, "utf-8");

input.md:

1# Sample Document
2
3The following list will be autogenerated:
4
5[`let randomValue`]
6[`for (let i = 1; i <= 5; i++) {`]
7[`randomValue = Math.random();`]
8[=`i`]. The resulting random value was [=`randomValue`].
9[`}`]

output.md (generated file):

1# Sample Document
2
3The following list will be autogenerated:
4
51. The resulting random value was 0.20118583281078317.
62. The resulting random value was 0.06210908536648563.
73. The resulting random value was 0.6070385756910699.
84. The resulting random value was 0.045630886770123835.
95. The resulting random value was 0.5679299839157612.

In the example above, the template consists of JavaScript code enclosed within backticks (`). The code is denoted by the brackets [] and executed during the template rendering. In this case, the code initializes a variable randomValue and generates random values within a loop.

The resulting document will be returned as a string by the runTemplate function.

License

Brittle is licensed under the MIT License.