danog/liquid
1
0
Fork 0
mirror of https://github.com/danog/liquid.git synced 2024-11-26 23:14:39 +01:00
Code Issues Projects Releases Wiki Activity
54 Commits 5 Branches 16 Tags 3.2 MiB
Go 95.6%
Yacc 2.3%
Ragel 1.2%
Makefile 0.6%
Shell 0.2%
Other 0.1%
3dba4eeb10
Go to file
Oliver Steele 3dba4eeb10 Makefile default target is ci
2017-06-27 18:10:12 -04:00
chunks Unconfuse unless/endunless 2017-06-27 17:43:35 -04:00
errors Lint 2017-06-27 13:36:38 -04:00
expressions Implement and, or, != 2017-06-27 17:54:24 -04:00
filters Add reverse filter; improve generics 2017-06-27 17:29:50 -04:00
generics Implement and, or, != 2017-06-27 17:54:24 -04:00
tags Unconfuse unless/endunless 2017-06-27 17:43:35 -04:00
.gitignore Makefile default target is ci 2017-06-27 18:10:12 -04:00
.travis.yml Add a Travis file 2017-06-26 10:16:02 -04:00
engine.go Implement filters: default; date (w/out format) 2017-06-27 16:02:05 -04:00
LICENSE Create LICENSE 2017-06-26 15:36:29 -04:00
liquid_test.go Move tags to own package 2017-06-27 11:39:32 -04:00
Makefile Makefile default target is ci 2017-06-27 18:10:12 -04:00
README.md Add references to README 2017-06-27 18:06:26 -04:00
template.go Add public DefineTag 2017-06-27 07:43:42 -04:00

README.md

Go Liquid Template Parser

goliquid is a very early-stage Go implementation of the Shopify Liquid template language, for use in Gojekyll.

Status

Build Status Go Report Card

  • Basics
    • Literals
      • String Escapes
    • Variables
    • Operators
    • Arrays
    • Whitespace Control
  • Tags
    • Comment
    • Control Flow
      • if/else/elsif
      • unless
      • case/when
    • Iteration - [x] for - [ ] limit - [ ] offset - [ ] range - [x] reversed - [ ] break, continue - [ ] loop variables - [ ] tablerow - [ ] cycle
    • Raw
    • Variable
      • Assign
      • Capture
  • Filters
    • some
    • all

Install

go get -u github.com/osteele/goliquid

Contribute

Setup

make setup

Install Ragel. On macOS: brew install ragel.

Workflow

go generate ./...
go test ./...

Test just the scanner:

cd expressions
ragel -Z scanner.rl && go test

References

https://shopify.github.io/liquid

https://help.shopify.com/themes/liquid

https://github.com/Shopify/liquid/wiki/Liquid-for-Designers

Attribution

Kyoung-chan Lee's https://github.com/leekchan/timeutil for formatting dates.

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.

(That said, this is a clean-room implementation to make sure it just implements the documented design.)

License

MIT License