Simple template engine. More...

#include <cwist/core/sstring/sstring.h>
#include <cjson/cJSON.h>

Include dependency graph for template.h:

This graph shows which files directly or indirectly include this file:

Functions
cwist_sstring *	cwist_template_render (const char template_str, const cJSON context)
	Renders a template string with the given cJSON context.

cwist_sstring *	cwist_template_render_file (const char file_path, const cJSON context)
	Renders a template from a file with the given cJSON context.

Detailed Description

Simple template engine.

Definition in file template.h.

Function Documentation

cwist_sstring * cwist_template_render	(	const char *	template_str,
		const cJSON *	context
	)

Renders a template string with the given cJSON context.

This function parses a template string and replaces placeholders with values from the provided cJSON context.

It supports:

Variable replacement: {{ key }}
Variable filters: {{ key | upper }}, {{ key | lower }}, {{ key | escape }}, {{ key | trim }}, {{ key | length }}, {{ key | default("n/a") }}
Simple conditionals: {% if key %}...{% endif %}
Negated conditionals: {% if not key %}...{% endif %}
Else branches: {% if key %}...{% else %}...{% endif %}
Looping over arrays: {% for item in array %}...{{ item.key }}...{% endfor %}
File includes: {% include "partial.html" %}
Comments: {# ignored #}

Parameters

template_str	The template string to render.
context	The cJSON object containing the data for the template.

Returns: A new cwist_sstring containing the rendered output. The caller is responsible for destroying the returned string. Returns NULL on failure.

Renders a template string with the given cJSON context.

Parameters

template_str	Template source to render.
context	JSON object supplying values for substitutions and control flow.

Definition at line 431 of file template.c.

References cap.

cwist_sstring * cwist_template_render_file	(	const char *	file_path,
		const cJSON *	context
	)

Renders a template from a file with the given cJSON context.

Reads a template from the specified file path and renders it using the provided cJSON context.

Parameters

file_path	The path to the template file.
context	The cJSON object containing the data for the template.

Returns: A new cwist_sstring containing the rendered output. The caller is responsible for destroying the returned string. Returns NULL if the file cannot be read or on rendering failure.

Renders a template from a file with the given cJSON context.

Parameters

file_path	Path to the template file to open.
context	JSON object supplying values for substitutions and control flow.

Returns: Heap-allocated rendered output, or NULL when file IO or rendering fails.

Definition at line 442 of file template.c.