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
|
# roscha
A jinja inspired template engine written in C11. Why would I do something like
this? Because I needed a template engine I could use in C programs, and for the
lulz, of course.
Probably not the best in terms of performance and especially features, but it
gets the job done.
## How to use
All the functions and structures that are needed to use roscha are in
`include/roscha.h`, `include/object.h`, `include/hmap.h`, `include/vector.h`,
and `include/slice.h`.
Basically you initialize roscha with `roscha_init()`, then create a new
environment where all the templates and variables will be with
`roscha_env_new()` add some templates, e.g. you can load them from a dir with
the `roscha_env_load_dir(env, dir)` function, add some variables to `env->vars`
hashmap and render a template running `roscha_env_render(env, template_name)`.
All variables used inside roscha are wrapped around a reference counted
structure called `roscha_object` that also contains the type information needed
by roscha. You should increment and decrement the reference count appropriately
using the functions `roscha_object_ref(object)` and
`roscha_object_unref(object)` accordingly.
After using roscha you should free everything related to roscha by decrementing
the reference counts, destroying the `struct roscha_env *` environment, and
calling `roscha_deinit()`.
## TODO
* Better document this... or not if nobody else uses?
* Probably fix some bugs that are currently hidden.
* k, v arguments in for...in loops over hashmaps
* make hashmaps grow in capacity over a certain load threshold.
* Other stuff like space trimming
|
