ExternalVendorCode/mo
1
0
Fork 0
mirror of https://github.com/tests-always-included/mo.git synced 2024-12-18 16:27:52 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Mustache templates in pure bash
3 Commits 3 Branches 21 Tags 398 KiB
Shell 84.9%
JavaScript 15%
Dockerfile 0.1%
7a271b58f6
Go to file
Tyler Akins 7a271b58f6 In case of error, pipe something in 
This lets me run tests in a terminal.  If I mess up and the terminal is
being read by `cat` or similar, this input is used instead and now my
tests will automatically fail properly.
2015-01-23 18:05:27 +00:00
demo Forcing script execution to be in a particular directory 2015-01-23 17:47:31 +00:00
tests Initial commit 2015-01-23 17:43:08 +00:00
.gitignore Initial commit 2015-01-23 17:43:08 +00:00
LICENSE.md Initial commit 2015-01-23 17:43:08 +00:00
mo Initial commit 2015-01-23 17:43:08 +00:00
README.md Initial commit 2015-01-23 17:43:08 +00:00
run-tests In case of error, pipe something in 2015-01-23 18:05:27 +00:00

README.md

Mo - Mustache Templates in Bash

Mustache templates are simple, logic-less templates. Because of their simplicity, they are able to be ported to many languages. The syntax is quite simple.

Hello, {{NAME}}.

I hope your {{TIME_PERIOD}} was fun.

Let's try using this with some data in bash. Save those lines to trip.txt and run a command like this:

NAME=Tyler TIME_PERIOD=weekend ./mo weekend-trip.txt

Your result?

Hello, Tyler.

I hope your weekend was fun.

This bash version supports conditionals, functions (both as filters and as values), as well as indexed arrays (for iteration). You are able to leverage these additional features by adding more information into the environment. It is easiest to do this when you source mo. See the demo scripts for further examples.

Requirements

  • Bash 3.x (the aim is to make it work on Macs)
  • The "coreutils" package (basename and cat)
  • ... that's it. Why? Because bash can!

Concessions

I admit that implementing everything in bash just doesn't make a lot of sense. For example, the following things just don't work.

  • Bash does not support nested structures like fancy objects. The best you can do are arrays. I'm not able to add super complex structures to bash - it's just a shell after all!
  • There's no "top level" object that {.} refers to in mo. In other languages you can say the data for the template is a string. That's ok because using {.} when processing a top level scope is rare. Using {.} works great when iterating over an array.
  • HTML encoding is not built into mo. The {{{...}}} and {{...}} tags both work. echo '{{TEST}}' | TEST='<b>' mo will give you "<b>" instead of "&gt;b&lt;".
  • You must make sure the data is in the environment when mo runs. The easiest way to do that is to source mo in your shell script after setting up lots of other environment variables / functions.
  • Associative arrays are not addressable via their index. You can't use {{VARIABLE_NAME.INDEX_NAME}} and expect it to work. Associative arrays aren't supported in Bash 3.

Developing

Check out the code and hack away. Please add tests to show off bugs before fixing them. New functionality should also be covered by a test.

License

This program is licensed under an MIT license with an additional non-advertising clause. See LICENSE.md for the full text.