package embedded_ocaml_templates

  1. Overview
  2. Docs
EML is a simple templating language that lets you generate text with plain OCaml

Install

Dune Dependency

Authors

Maintainers

Sources

0.2.tar.gz
md5=8a7189c85de9edc4f643e8a22b100e9c
sha512=18184036d47791139fafb97790ae7daf9560f416ad6ea38e267188ed80a6443aa9457d8b5ead753f68b08997189c61b02cc8d04c550d8ce0e5df6202b0c9bef9

Description

EML is a simple templating language that lets you generate text with plain OCaml Inspired by EJS templates

Published: 04 Jul 2020

README

Embedded Ocaml Templates

EML is a simple templating language that lets you generate text with plain OCaml. The syntax is as follow :

First of all, you need to declare the template's arguments at the top of the template :

<%# arg1 (arg2:type) (arg3_1, arg3_2) %>

The you can use two tags :

<% ocaml code here %>

This tag expect any ocaml code. If what you put in here is an expression of type unit, you should include the ";" yourself. You are able to open parenthesis and close them in a subsequent tag.

<%- ocaml expression here %>

This tag expect an expression of type string and is going to be replaced by the value of the expression. If this tag is inside a loop or an if statement, it's going to behave you would expect it to.

Because OCaml does not have an eval function, the templates have to be compiled. What is provided by this package is an executable that will compile either a single .eml file into an OCaml module containing a function that render the template, or take a whole directory containing a function for each .eml file and a submodule for each subdirectory (it's recursive).

Here is an exemple of a dune rule:

(rule
 (target templates.ml)
 (deps (source_tree templates))
 (action (run eml_compiler templates)))

Dependencies (8)

  1. containers
  2. ppxlib
  3. menhir
  4. uutf
  5. core >= "v0.12" & < "v0.15"
  6. sedlex
  7. dune >= "2.5.0"
  8. ocaml >= "4.07.0"

Dev Dependencies

None

Used by

None

Conflicts

None