# Solid

[![Build Status](](
[![Module Version](](
[![Hex Docs](](
[![Total Download](](
[![Last Updated](](

Solid is an implementation in Elixir of the template language [Liquid]( It uses [nimble_parsec]( to generate the parser.

## Basic Usage

iex> template = "My name is {{ }}"
iex> {:ok, template} = Solid.parse(template)
iex> Solid.render(template, %{ "user" => %{ "name" => "José" } }) |> to_string
"My name is José"

## Installation

The package can be installed with:

def deps do
  [{:solid, "~> 0.10"}]

## Custom tags

To implement a new tag you need to create a new module that implements the `Tag` behaviour:

defmodule MyCustomTag do
  import NimbleParsec
  @behaviour Solid.Tag

  @impl true
  def spec(_parser) do
    space = Solid.Parser.Literal.whitespace(min: 0)

    |> ignore(space)
    |> ignore(string("my_tag"))
    |> ignore(space)
    |> ignore(string("%}"))

  @impl true
  def render(tag, _context, _options) do
    [text: "my first tag"]

- `spec` defines how to parse your tag;
- `render` defines how to render your tag.

Now we need to add the tag to the parser

defmodule MyParser do
  use Solid.Parser.Base, custom_tags: [MyCustomTag]

And finally pass the custom parser as an option:

"{% my_tag %}"
|> Solid.parse!(parser: MyParser)
|> Solid.render()

## Contributing

When adding new functionality or fixing bugs consider adding a new test case here inside `test/cases`. These cases are tested against the Ruby gem so we can try to stay as close as possible to the original implementation.


* [x] Integration tests using Liquid gem to build fixtures; [#3](
* [x] All the standard filters [#8](
* [x] Support to custom filters [#11](
* [x] Tags (if, case, unless, etc)
  - [x] `for`
    - [x] `else`
    - [x] `break`
    - [x] `continue`
    - [x] `limit`
    - [x] `offset`
    - [x] Range (3..5)
    - [x] `reversed`
    - [x] `forloop` object
  - [x] `raw` [#18](
  - [x] `cycle` [#17](
  - [x] `capture` [#19](
  - [x] `increment` [#16](
  - [x] `decrement` [#16](
* [x] Boolean operators [#2](
* [x] Whitespace control [#10](

## Copyright and License

Copyright (c) 2016 Eduardo Gurgel Pinho

This work is free. You can redistribute it and/or modify it under the
terms of the MIT License. See the [](./ file for more details.