blob: 72cdadb4f6b3dc68a7588153e677d0ae3043a7cd (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# Unja
A template engine for C, inspired by Jinja and Liquid.
Forked from https://github.com/dannyvankooten/unja
## Example
File `base.tmpl`:
```html+jinja
<html>
<head><title>{% block title %}Default title{% endblock %}</title></head>
<body>
{% block content %}
{% endblock %}
</body>
</html>
```
File `child.tmpl`:
```html+jinja
{% extends "base.html" %}
{% block title %}Users{% endblock %}
{% block content %}
<ul>
{% for user in users %}
<li><a href="{{ user.url }}">{{ user.username | lower }}</a></li>
{% endfor %}
</ul>
{% endblock %}
```
File: `example.c`
```c
int main() {
// parse all templates in the given directory
struct env *env = env_new("./");
// create a hashmap for storing template variables
struct hashmap *vars = hashmap_new();
hashmap_insert(vars, "name", "John Doe");
// execute the template
char *output = template(env, "child.tmpl", vars);
printf("%s", output);
// clean-up allocated memory
free(output);
hashmap_free(vars);
env_free(env);
}
```
## Changes from upstream
### Done
* Use FNV1a as hashmap hashing algorithm.
* Hashmap capacity can be set programmatically and it grows/shrinks in size
when the load increases/decreases to avoid collisions/save memory.
* Include guards.
* Fix heap corruption on buffer growth.
* Define as static functions that are not used outside a TU.
### TODO
* Handle empty/non-existent variables
* Handle non-existent templates
* Let the library user decide how to handle errors, instead of just aborting the
program.
* Do not print anything to stdout/stderr. It should be up to the library user to
decide what and when to print a message.
## License
MIT
|