1
0
mirror of https://github.com/danog/liquid.git synced 2024-11-27 02:54:44 +01:00
Go to file
2017-07-08 09:10:13 -04:00
.github Add IsTemplateError 2017-07-05 14:24:15 -04:00
cmd/liquid Improve some internal names 2017-07-05 19:09:59 -04:00
evaluator Optional filter arguments declared as functions 2017-07-08 09:08:06 -04:00
expression identifiers can include '-' 2017-07-07 11:55:41 -04:00
filters Optional filter arguments declared as functions 2017-07-08 09:08:06 -04:00
parser simplify 2017-07-07 07:30:32 -04:00
render Implement uniq filter 2017-07-07 09:32:24 -04:00
scripts Coverage 2017-07-02 07:51:24 -04:00
tags Remove else/elsif from unless 2017-07-08 09:10:13 -04:00
.gitignore Add an executable 2017-07-05 13:46:30 -04:00
.travis.yml make install-dev-tools doesn't update packages 2017-07-05 09:50:50 -04:00
CONTRIBUTING.md README 2017-07-07 09:35:47 -04:00
drops.go Implement drops 2017-07-03 12:00:43 -04:00
engine_test.go Add Template.SetSourcePath 2017-07-04 16:48:38 -04:00
engine.go simplify 2017-07-07 07:30:32 -04:00
LICENSE Create LICENSE 2017-06-26 15:36:29 -04:00
liquid_test.go Split package render->parser 2017-07-07 05:51:40 -04:00
liquid.go simplify 2017-07-07 05:51:40 -04:00
Makefile Add an executable 2017-07-05 13:46:30 -04:00
README.md README 2017-07-07 09:35:47 -04:00
template_test.go Add Template.SetSourcePath 2017-07-04 16:48:38 -04:00
template.go simplify 2017-07-07 05:51:40 -04:00
test.html Rename to match Liquid terminology 2017-07-02 13:31:34 -04:00

Go Liquid Template Parser

“Any sufficiently complicated C or Fortran program contains an ad-hoc, informally-specified, bug-ridden, slow implementation of half of Common Lisp.” Philip Greenspun

liquid ports Shopify Liquid templates to Go. It was developed for use in gojekyll.

liquid provides a functional API for defining tags and filters. See examples here, here, and here.

Status

This library is at an early stage of development. There's probably lots of corner cases, and the API for defining tags may still change.

Differences from Liquid

Refer to the feature parity board for a list of known differences from Liquid.

Other differences, that might not change:

  • This implementation is probably more liberal in where it accepts parentheses.
  • Two hashes with the same keys and values, or two drops that return deeply equal hashes, are equal for purposes of uniq. I don't know if it's practical to fix this.

Install

go get -u github.com/osteele/goliquid

make install install a command-line liquid program in your GO bin. This is intended to make it easier to create test cases for bug reports. Run liquid --help for help.

Contributing

Bug reports, test cases, and code contributions are more than welcome. Please refer to the contribution guidelines.

References

Attribution

Package Author Description License
gopkg.in/yaml.v2 Canonical YAML support (for printing parse trees) Apache License 2.0
jeffjen/datefmt Jeffrey Jen Go bindings to GNU strftime and strptime MIT
Ragel Adrian Thurston scanning expressions MIT

Michael Hamrah's Lexing with Ragel and Parsing with Yacc using Go was essential to understanding go yacc.

The original Liquid engine, of course, for the design and documentation of the Liquid template language. Many of the tag and filter test cases are taken directly from the Liquid documentation.

Other Implementations

Go

Other Languages

See Shopify's ports of Liquid to other environments.

License

MIT License