Mán stores templates (in iex, mustache) or markdown documents, renders it over HTTP API with dispatch in PDF, JSON or HTML formats.
"Mán" translates from the Sindarin as "Spirit". Sindarin is one of the many languages spoken by the immortal Elves.
Full API and installation description available on dedicated page.
Man consists of two main parts:
- REST API back-end that allows to manage and render Templates;
- Management UI that simplifies configuration and management.
- Rendering reports;
- Central control over Email or/and SMS templates;
- PDF/HTML printout forms generation;
- Rendering HTML pages over API.
We encourage you to perform your own tests, because synthetic results are far from real life situation. We provide them only as starting point in understanding Man's performance.
- MacBook Pro (15-inch, 2016)
- CPU 2,7 GHz Intel Core i7
- RAM 16 ГБ 2133 MHz LPDDR3
- Man v0.1.16 and PostgreSQL v9.6.2 running in Nebo15 Docker contianers (listed below);
- ApacheBench v2.3;
- wkhtmltopdf v0.12.4 (with patched qt).
| Metric/Template Syntax | Mustache | Markdown | Mustache with PDF format | Mustache with PDF format and PDF cache enabled |
|---|---|---|---|---|
| Concurrency Level | 50 | 50 | 50 | 50 |
| Time taken for tests | 8.412 sec | 8.142 sec | 442.214 sec | 11.255 sec |
| Complete requests | 10000 | 10000 | 10000 | 10000 |
| Failed requests | 0 | 0 | 0 | 0 |
| Requests per second [#/sec] (mean) | 1188.84 | 1228.25 | 22.61 | 888.52 |
| Time per request | 42.058 [ms] | 40.708 [ms] | 2211.070 [ms] | 56.274 [ms] |
| Time per request (mean, across all concurrent requests) | 0.841 [ms] | 0.814 [ms] | 44.221 [ms] | 1.125 [ms] |
Full console output is available in pertest.md.
Since generating PDF is slow, Man allows to cache wkhtmltopdf output.
This cache can be used when you have less than 1000 of different templates variations (eg. markdown templates, or mustache templates but all variables are continuous or enums). To enable it simply set CACHE_PDF_OUTPUT=true in your environment.
Enabling cache when output variety is high will hurt your performance (cache will always be cold, since it's based on HTML checksum) and may lead to node crashes (ETC table may overflow).
Application is configured via environment variables. List of supported keys and their default values can be found in docs/ENVIRONMENT.md.
Easiest way to deploy Man is to use docker containers. We constantly are releasing pre-built versions that will reduce time to deploy:
Template allows to deploy Man to Heroku just in minute (and use it for free within Heroku tiers):
wkhtmltopdf is used for HTML to PDF conversion.
See LICENSE.md.