liquid 1.7.0
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG +38 -0
- data/MIT-LICENSE +20 -0
- data/Manifest.txt +60 -0
- data/README +38 -0
- data/Rakefile +24 -0
- data/example/server/example_servlet.rb +37 -0
- data/example/server/liquid_servlet.rb +28 -0
- data/example/server/server.rb +12 -0
- data/example/server/templates/index.liquid +6 -0
- data/example/server/templates/products.liquid +45 -0
- data/init.rb +6 -0
- data/lib/extras/liquid_view.rb +27 -0
- data/lib/liquid.rb +66 -0
- data/lib/liquid/block.rb +101 -0
- data/lib/liquid/condition.rb +91 -0
- data/lib/liquid/context.rb +216 -0
- data/lib/liquid/document.rb +17 -0
- data/lib/liquid/drop.rb +48 -0
- data/lib/liquid/errors.rb +7 -0
- data/lib/liquid/extensions.rb +56 -0
- data/lib/liquid/file_system.rb +62 -0
- data/lib/liquid/htmltags.rb +64 -0
- data/lib/liquid/standardfilters.rb +125 -0
- data/lib/liquid/strainer.rb +43 -0
- data/lib/liquid/tag.rb +25 -0
- data/lib/liquid/tags/assign.rb +22 -0
- data/lib/liquid/tags/capture.rb +22 -0
- data/lib/liquid/tags/case.rb +68 -0
- data/lib/liquid/tags/comment.rb +9 -0
- data/lib/liquid/tags/cycle.rb +46 -0
- data/lib/liquid/tags/for.rb +81 -0
- data/lib/liquid/tags/if.rb +51 -0
- data/lib/liquid/tags/ifchanged.rb +20 -0
- data/lib/liquid/tags/include.rb +56 -0
- data/lib/liquid/tags/unless.rb +29 -0
- data/lib/liquid/template.rb +150 -0
- data/lib/liquid/variable.rb +39 -0
- data/test/block_test.rb +50 -0
- data/test/context_test.rb +340 -0
- data/test/drop_test.rb +139 -0
- data/test/error_handling_test.rb +65 -0
- data/test/extra/breakpoint.rb +547 -0
- data/test/extra/caller.rb +80 -0
- data/test/file_system_test.rb +30 -0
- data/test/filter_test.rb +98 -0
- data/test/helper.rb +20 -0
- data/test/html_tag_test.rb +24 -0
- data/test/if_else_test.rb +95 -0
- data/test/include_tag_test.rb +91 -0
- data/test/output_test.rb +121 -0
- data/test/parsing_quirks_test.rb +14 -0
- data/test/regexp_test.rb +39 -0
- data/test/security_test.rb +41 -0
- data/test/standard_filter_test.rb +101 -0
- data/test/standard_tag_test.rb +336 -0
- data/test/statements_test.rb +137 -0
- data/test/strainer_test.rb +16 -0
- data/test/template_test.rb +26 -0
- data/test/unless_else_test.rb +19 -0
- data/test/variable_test.rb +135 -0
- metadata +114 -0
@@ -0,0 +1,64 @@
|
|
1
|
+
module Liquid
|
2
|
+
class TableRow < Block
|
3
|
+
Syntax = /(\w+)\s+in\s+(#{VariableSignature}+)/
|
4
|
+
|
5
|
+
def initialize(markup, tokens)
|
6
|
+
super
|
7
|
+
|
8
|
+
if markup =~ Syntax
|
9
|
+
@variable_name = $1
|
10
|
+
@collection_name = $2
|
11
|
+
@attributes = {}
|
12
|
+
markup.scan(TagAttributes) do |key, value|
|
13
|
+
@attributes[key] = value
|
14
|
+
end
|
15
|
+
else
|
16
|
+
raise SyntaxError.new("Syntax Error in 'table_row loop' - Valid syntax: table_row [item] in [collection] cols=3")
|
17
|
+
end
|
18
|
+
end
|
19
|
+
|
20
|
+
def render(context)
|
21
|
+
collection = context[@collection_name] or return ''
|
22
|
+
|
23
|
+
if @attributes['limit'] or @attributes['offset']
|
24
|
+
limit = context[@attributes['limit']] || -1
|
25
|
+
offset = context[@attributes['offset']] || 0
|
26
|
+
collection = collection[offset.to_i..(limit.to_i + offset.to_i - 1)]
|
27
|
+
end
|
28
|
+
|
29
|
+
length = collection.length
|
30
|
+
|
31
|
+
cols = context[@attributes['cols']].to_i
|
32
|
+
|
33
|
+
row = 1
|
34
|
+
col = 0
|
35
|
+
|
36
|
+
result = ["<tr class=\"row1\">\n"]
|
37
|
+
context.stack do
|
38
|
+
|
39
|
+
collection.each_with_index do |item, index|
|
40
|
+
context[@variable_name] = item
|
41
|
+
context['tablerowloop'] = {
|
42
|
+
'length' => length,
|
43
|
+
'index' => index + 1,
|
44
|
+
'index0' => index,
|
45
|
+
'rindex' => length - index,
|
46
|
+
'rindex0' => length - index -1,
|
47
|
+
'first' => (index == 0),
|
48
|
+
'last' => (index == length - 1) }
|
49
|
+
|
50
|
+
result << ["<td class=\"col#{col += 1}\">"] + render_all(@nodelist, context) + ['</td>']
|
51
|
+
|
52
|
+
if col == cols and not (index == length - 1)
|
53
|
+
col = 0
|
54
|
+
result << ["</tr>\n<tr class=\"row#{row += 1}\">"]
|
55
|
+
end
|
56
|
+
|
57
|
+
end
|
58
|
+
end
|
59
|
+
result + ["</tr>\n"]
|
60
|
+
end
|
61
|
+
end
|
62
|
+
|
63
|
+
Template.register_tag('tablerow', TableRow)
|
64
|
+
end
|
@@ -0,0 +1,125 @@
|
|
1
|
+
module Liquid
|
2
|
+
|
3
|
+
module StandardFilters
|
4
|
+
|
5
|
+
# Return the size of an array or of an string
|
6
|
+
def size(input)
|
7
|
+
|
8
|
+
input.respond_to?(:size) ? input.size : 0
|
9
|
+
end
|
10
|
+
|
11
|
+
# convert a input string to DOWNCASE
|
12
|
+
def downcase(input)
|
13
|
+
input.to_s.downcase
|
14
|
+
end
|
15
|
+
|
16
|
+
# convert a input string to UPCASE
|
17
|
+
def upcase(input)
|
18
|
+
input.to_s.upcase
|
19
|
+
end
|
20
|
+
|
21
|
+
# capitalize words in the input centence
|
22
|
+
def capitalize(input)
|
23
|
+
input.to_s.capitalize
|
24
|
+
end
|
25
|
+
|
26
|
+
# Truncate a string down to x characters
|
27
|
+
def truncate(input, length = 50, truncate_string = "...")
|
28
|
+
if input.nil? then return end
|
29
|
+
l = length.to_i - truncate_string.length
|
30
|
+
l = 0 if l < 0
|
31
|
+
input.length > length.to_i ? input[0...l] + truncate_string : input
|
32
|
+
end
|
33
|
+
|
34
|
+
def truncatewords(input, words = 15, truncate_string = "...")
|
35
|
+
if input.nil? then return end
|
36
|
+
wordlist = input.to_s.split
|
37
|
+
l = words.to_i - 1
|
38
|
+
l = 0 if l < 0
|
39
|
+
wordlist.length > l ? wordlist[0..l].join(" ") + truncate_string : input
|
40
|
+
end
|
41
|
+
|
42
|
+
def strip_html(input)
|
43
|
+
input.to_s.gsub(/<.*?>/, '')
|
44
|
+
end
|
45
|
+
|
46
|
+
# Join elements of the array with certain character between them
|
47
|
+
def join(input, glue = ' ')
|
48
|
+
[input].flatten.join(glue)
|
49
|
+
end
|
50
|
+
|
51
|
+
# Sort elements of the array
|
52
|
+
def sort(input)
|
53
|
+
[input].flatten.sort
|
54
|
+
end
|
55
|
+
|
56
|
+
# Reformat a date
|
57
|
+
#
|
58
|
+
# %a - The abbreviated weekday name (``Sun'')
|
59
|
+
# %A - The full weekday name (``Sunday'')
|
60
|
+
# %b - The abbreviated month name (``Jan'')
|
61
|
+
# %B - The full month name (``January'')
|
62
|
+
# %c - The preferred local date and time representation
|
63
|
+
# %d - Day of the month (01..31)
|
64
|
+
# %H - Hour of the day, 24-hour clock (00..23)
|
65
|
+
# %I - Hour of the day, 12-hour clock (01..12)
|
66
|
+
# %j - Day of the year (001..366)
|
67
|
+
# %m - Month of the year (01..12)
|
68
|
+
# %M - Minute of the hour (00..59)
|
69
|
+
# %p - Meridian indicator (``AM'' or ``PM'')
|
70
|
+
# %S - Second of the minute (00..60)
|
71
|
+
# %U - Week number of the current year,
|
72
|
+
# starting with the first Sunday as the first
|
73
|
+
# day of the first week (00..53)
|
74
|
+
# %W - Week number of the current year,
|
75
|
+
# starting with the first Monday as the first
|
76
|
+
# day of the first week (00..53)
|
77
|
+
# %w - Day of the week (Sunday is 0, 0..6)
|
78
|
+
# %x - Preferred representation for the date alone, no time
|
79
|
+
# %X - Preferred representation for the time alone, no date
|
80
|
+
# %y - Year without a century (00..99)
|
81
|
+
# %Y - Year with century
|
82
|
+
# %Z - Time zone name
|
83
|
+
# %% - Literal ``%'' character
|
84
|
+
def date(input, format)
|
85
|
+
|
86
|
+
if format.to_s.empty?
|
87
|
+
return input.to_s
|
88
|
+
end
|
89
|
+
|
90
|
+
date = case input
|
91
|
+
when String
|
92
|
+
Time.parse(input)
|
93
|
+
when Date, Time, DateTime
|
94
|
+
input
|
95
|
+
else
|
96
|
+
return input
|
97
|
+
end
|
98
|
+
|
99
|
+
date.strftime(format.to_s)
|
100
|
+
rescue => e
|
101
|
+
input
|
102
|
+
end
|
103
|
+
|
104
|
+
# Get the first element of the passed in array
|
105
|
+
#
|
106
|
+
# Example:
|
107
|
+
# {{ product.images | first | to_img }}
|
108
|
+
#
|
109
|
+
def first(array)
|
110
|
+
array.first if array.respond_to?(:first)
|
111
|
+
end
|
112
|
+
|
113
|
+
# Get the last element of the passed in array
|
114
|
+
#
|
115
|
+
# Example:
|
116
|
+
# {{ product.images | last | to_img }}
|
117
|
+
#
|
118
|
+
def last(array)
|
119
|
+
array.last if array.respond_to?(:last)
|
120
|
+
end
|
121
|
+
|
122
|
+
end
|
123
|
+
|
124
|
+
Template.register_filter(StandardFilters)
|
125
|
+
end
|
@@ -0,0 +1,43 @@
|
|
1
|
+
module Liquid
|
2
|
+
|
3
|
+
# Strainer is the parent class for the filters system.
|
4
|
+
# New filters are mixed into the strainer class which is then instanciated for each liquid template render run.
|
5
|
+
#
|
6
|
+
# One of the strainer's responsibilities is to keep malicious method calls out
|
7
|
+
class Strainer
|
8
|
+
|
9
|
+
@@required_methods = ["__send__", "__id__", "respond_to?", "extend", "methods"]
|
10
|
+
|
11
|
+
@@filters = []
|
12
|
+
|
13
|
+
def initialize(context)
|
14
|
+
@context = context
|
15
|
+
end
|
16
|
+
|
17
|
+
def self.global_filter(filter)
|
18
|
+
raise StandardError, "Passed filter is not a module" unless filter.is_a?(Module)
|
19
|
+
@@filters << filter
|
20
|
+
end
|
21
|
+
|
22
|
+
def self.create(context)
|
23
|
+
strainer = Strainer.new(context)
|
24
|
+
@@filters.each { |m| strainer.extend(m) }
|
25
|
+
strainer
|
26
|
+
end
|
27
|
+
|
28
|
+
def respond_to?(method)
|
29
|
+
method_name = method.to_s
|
30
|
+
return false if method_name =~ /^__/
|
31
|
+
return false if @@required_methods.include?(method_name)
|
32
|
+
super
|
33
|
+
end
|
34
|
+
|
35
|
+
# remove all standard methods from the bucket so circumvent security
|
36
|
+
# problems
|
37
|
+
instance_methods.each do |m|
|
38
|
+
unless @@required_methods.include?(m)
|
39
|
+
undef_method m
|
40
|
+
end
|
41
|
+
end
|
42
|
+
end
|
43
|
+
end
|
data/lib/liquid/tag.rb
ADDED
@@ -0,0 +1,25 @@
|
|
1
|
+
module Liquid
|
2
|
+
|
3
|
+
class Tag
|
4
|
+
attr_accessor :nodelist
|
5
|
+
|
6
|
+
def initialize(markup, tokens)
|
7
|
+
@markup = markup
|
8
|
+
parse(tokens)
|
9
|
+
end
|
10
|
+
|
11
|
+
def parse(tokens)
|
12
|
+
end
|
13
|
+
|
14
|
+
def name
|
15
|
+
self.class.name.downcase
|
16
|
+
end
|
17
|
+
|
18
|
+
def render(context)
|
19
|
+
''
|
20
|
+
end
|
21
|
+
end
|
22
|
+
|
23
|
+
|
24
|
+
end
|
25
|
+
|
@@ -0,0 +1,22 @@
|
|
1
|
+
module Liquid
|
2
|
+
class Assign < Tag
|
3
|
+
Syntax = /(\w+)\s*=\s*(#{QuotedFragment}+)/
|
4
|
+
|
5
|
+
def initialize(markup, tokens)
|
6
|
+
if markup =~ Syntax
|
7
|
+
@to = $1
|
8
|
+
@from = $2
|
9
|
+
else
|
10
|
+
raise SyntaxError.new("Syntax Error in 'assign' - Valid syntax: assign [var] = [source]")
|
11
|
+
end
|
12
|
+
end
|
13
|
+
|
14
|
+
def render(context)
|
15
|
+
context[@to] = context[@from]
|
16
|
+
''
|
17
|
+
end
|
18
|
+
|
19
|
+
end
|
20
|
+
|
21
|
+
Template.register_tag('assign', Assign)
|
22
|
+
end
|
@@ -0,0 +1,22 @@
|
|
1
|
+
module Liquid
|
2
|
+
class Capture < Block
|
3
|
+
Syntax = /(\w+)/
|
4
|
+
|
5
|
+
def initialize(markup, tokens)
|
6
|
+
if markup =~ Syntax
|
7
|
+
@to = $1
|
8
|
+
super
|
9
|
+
else
|
10
|
+
raise SyntaxError.new("Syntax Error in 'capture' - Valid syntax: capture [var]")
|
11
|
+
end
|
12
|
+
end
|
13
|
+
|
14
|
+
def render(context)
|
15
|
+
output = super
|
16
|
+
context[@to] = output.to_s
|
17
|
+
''
|
18
|
+
end
|
19
|
+
end
|
20
|
+
|
21
|
+
Template.register_tag('capture', Capture)
|
22
|
+
end
|
@@ -0,0 +1,68 @@
|
|
1
|
+
module Liquid
|
2
|
+
class Case < Block
|
3
|
+
Syntax = /(#{QuotedFragment})/
|
4
|
+
WhenSyntax = /(#{QuotedFragment})/
|
5
|
+
|
6
|
+
def initialize(markup, tokens)
|
7
|
+
@blocks = []
|
8
|
+
|
9
|
+
if markup =~ Syntax
|
10
|
+
@left = $1
|
11
|
+
else
|
12
|
+
raise SyntaxError.new("Syntax Error in tag 'case' - Valid syntax: case [condition]")
|
13
|
+
end
|
14
|
+
|
15
|
+
push_block('case', markup)
|
16
|
+
|
17
|
+
super
|
18
|
+
end
|
19
|
+
|
20
|
+
def unknown_tag(tag, markup, tokens)
|
21
|
+
if ['when', 'else'].include?(tag)
|
22
|
+
push_block(tag, markup)
|
23
|
+
else
|
24
|
+
super
|
25
|
+
end
|
26
|
+
end
|
27
|
+
|
28
|
+
def render(context)
|
29
|
+
@blocks.inject([]) do |output, block|
|
30
|
+
|
31
|
+
if block.else?
|
32
|
+
return render_all(block.attachment, context) if output.empty? || output.join !~ /\S/
|
33
|
+
else
|
34
|
+
|
35
|
+
if block.evaluate(context)
|
36
|
+
context.stack do
|
37
|
+
output += render_all(block.attachment, context)
|
38
|
+
end
|
39
|
+
end
|
40
|
+
|
41
|
+
end
|
42
|
+
|
43
|
+
|
44
|
+
output
|
45
|
+
end.join
|
46
|
+
end
|
47
|
+
|
48
|
+
private
|
49
|
+
|
50
|
+
def push_block(tag, markup)
|
51
|
+
|
52
|
+
block = if tag == 'else'
|
53
|
+
ElseCondition.new
|
54
|
+
elsif markup =~ WhenSyntax
|
55
|
+
Condition.new(@left, '==', $1)
|
56
|
+
else
|
57
|
+
raise SyntaxError.new("Syntax Error in tag 'case' - Valid when condition: when [condition] ")
|
58
|
+
end
|
59
|
+
|
60
|
+
@blocks.push(block)
|
61
|
+
@nodelist = block.attach(Array.new)
|
62
|
+
end
|
63
|
+
|
64
|
+
|
65
|
+
end
|
66
|
+
|
67
|
+
Template.register_tag('case', Case)
|
68
|
+
end
|
@@ -0,0 +1,46 @@
|
|
1
|
+
module Liquid
|
2
|
+
class Cycle < Tag
|
3
|
+
SimpleSyntax = /#{QuotedFragment}/
|
4
|
+
NamedSyntax = /(#{QuotedFragment})\s*\:\s*(.*)/
|
5
|
+
|
6
|
+
def initialize(markup, tokens)
|
7
|
+
case markup
|
8
|
+
when NamedSyntax
|
9
|
+
@variables = variables_from_string($2)
|
10
|
+
@name = $1
|
11
|
+
when SimpleSyntax
|
12
|
+
@variables = variables_from_string(markup)
|
13
|
+
@name = "'#{@variables.to_s}'"
|
14
|
+
else
|
15
|
+
raise SyntaxError.new("Syntax Error in 'cycle' - Valid syntax: cycle [name :] var [, var2, var3 ...]")
|
16
|
+
end
|
17
|
+
|
18
|
+
end
|
19
|
+
|
20
|
+
def render(context)
|
21
|
+
context.registers[:cycle] ||= Hash.new(0)
|
22
|
+
|
23
|
+
context.stack do
|
24
|
+
key = context[@name]
|
25
|
+
iteration = context.registers[:cycle][key]
|
26
|
+
result = context[@variables[iteration]]
|
27
|
+
iteration += 1
|
28
|
+
iteration = 0 if iteration >= @variables.size
|
29
|
+
context.registers[:cycle][key] = iteration
|
30
|
+
result
|
31
|
+
end
|
32
|
+
end
|
33
|
+
|
34
|
+
private
|
35
|
+
|
36
|
+
def variables_from_string(markup)
|
37
|
+
markup.split(',').collect do |var|
|
38
|
+
var =~ /\s*(#{QuotedFragment})\s*/
|
39
|
+
$1 ? $1 : nil
|
40
|
+
end.compact
|
41
|
+
end
|
42
|
+
|
43
|
+
end
|
44
|
+
|
45
|
+
Template.register_tag('cycle', Cycle)
|
46
|
+
end
|
@@ -0,0 +1,81 @@
|
|
1
|
+
module Liquid
|
2
|
+
class For < Block
|
3
|
+
Syntax = /(\w+)\s+in\s+(#{VariableSignature}+)/
|
4
|
+
|
5
|
+
def initialize(markup, tokens)
|
6
|
+
super
|
7
|
+
|
8
|
+
if markup =~ Syntax
|
9
|
+
@variable_name = $1
|
10
|
+
@collection_name = $2
|
11
|
+
@name = "#{$1}-#{$2}"
|
12
|
+
@attributes = {}
|
13
|
+
markup.scan(TagAttributes) do |key, value|
|
14
|
+
@attributes[key] = value
|
15
|
+
end
|
16
|
+
else
|
17
|
+
raise SyntaxError.new("Syntax Error in 'for loop' - Valid syntax: for [item] in [collection]")
|
18
|
+
end
|
19
|
+
end
|
20
|
+
|
21
|
+
def render(context)
|
22
|
+
context.registers[:for] ||= Hash.new(0)
|
23
|
+
|
24
|
+
collection = context[@collection_name]
|
25
|
+
|
26
|
+
return '' if collection.nil? or collection.empty?
|
27
|
+
|
28
|
+
range = (0..collection.length)
|
29
|
+
|
30
|
+
if @attributes['limit'] or @attributes['offset']
|
31
|
+
|
32
|
+
|
33
|
+
offset = 0
|
34
|
+
if @attributes['offset'] == 'continue'
|
35
|
+
offset = context.registers[:for][@name]
|
36
|
+
else
|
37
|
+
offset = context[@attributes['offset']] || 0
|
38
|
+
end
|
39
|
+
|
40
|
+
limit = context[@attributes['limit']]
|
41
|
+
|
42
|
+
range_end = limit ? offset + limit : collection.length
|
43
|
+
|
44
|
+
range = (offset..range_end-1)
|
45
|
+
|
46
|
+
# Save the range end in the registers so that future calls to
|
47
|
+
# offset:continue have something to pick up
|
48
|
+
context.registers[:for][@name] = range_end
|
49
|
+
end
|
50
|
+
|
51
|
+
result = []
|
52
|
+
segment = collection[range]
|
53
|
+
return '' if segment.nil?
|
54
|
+
|
55
|
+
context.stack do
|
56
|
+
length = segment.length
|
57
|
+
|
58
|
+
segment.each_with_index do |item, index|
|
59
|
+
context[@variable_name] = item
|
60
|
+
context['forloop'] = {
|
61
|
+
'name' => @name,
|
62
|
+
'length' => length,
|
63
|
+
'index' => index + 1,
|
64
|
+
'index0' => index,
|
65
|
+
'rindex' => length - index,
|
66
|
+
'rindex0' => length - index -1,
|
67
|
+
'first' => (index == 0),
|
68
|
+
'last' => (index == length - 1) }
|
69
|
+
|
70
|
+
result << render_all(@nodelist, context)
|
71
|
+
end
|
72
|
+
end
|
73
|
+
|
74
|
+
# Store position of last element we rendered. This allows us to do
|
75
|
+
|
76
|
+
result
|
77
|
+
end
|
78
|
+
end
|
79
|
+
|
80
|
+
Template.register_tag('for', For)
|
81
|
+
end
|