mirror of
https://github.com/Shopify/liquid.git
synced 2026-09-26 13:45:13 -07:00
Add # inline comment tag.
This commit adds a new tag named `#` that behaves like a comment.
Therefore it behaves as you'd expect any tag would work. The difference
with the comment tag is that the comment is in the tag markup and that
there is no block delimiter.
What it looks like in practice:
```liquid
{%- # this is an inline comment -%}
{% # this too is an inline comment %}
{% liquid
# required args:
assign product = product
# optional args:
assign should_show_border = should_show_border | default: true
assign should_show_cursor = should_show_cursor | default: true
%}
{% liquid
# This is a very long comment that spans multiple lines.
# It looks very similar to what it would look like if you wrote
# ruby code instead of liquid. But it doesn't have all the clunk
# of having an open tag and a close tag with so many characters.
%}
```
Co-authored-by: Dylan Thacker-Smith <[email protected]>
This commit is contained in:
co-authored by
Dylan Thacker-Smith
parent
36dce29776
commit
1f0a0ad55c
@@ -0,0 +1,68 @@
|
||||
# frozen_string_literal: true
|
||||
|
||||
require 'test_helper'
|
||||
|
||||
class InlineCommentTest < Minitest::Test
|
||||
include Liquid
|
||||
|
||||
def test_inline_comment_returns_nothing
|
||||
assert_template_result('', '{%- # this is an inline comment -%}')
|
||||
assert_template_result('', '{%-# this is an inline comment -%}')
|
||||
assert_template_result('', '{% # this is an inline comment %}')
|
||||
assert_template_result('', '{%# this is an inline comment %}')
|
||||
end
|
||||
|
||||
def test_inline_comment_does_not_require_a_space_after_the_pound_sign
|
||||
assert_template_result('', '{%#this is an inline comment%}')
|
||||
end
|
||||
|
||||
def test_liquid_inline_comment_returns_nothing
|
||||
assert_template_result('Hey there, how are you doing today?', <<~LIQUID)
|
||||
{%- liquid
|
||||
# This is how you'd write a block comment in a liquid tag.
|
||||
# It looks a lot like what you'd have in ruby.
|
||||
|
||||
# You can use it as inline documentation in your
|
||||
# liquid blocks to explain why you're doing something.
|
||||
echo "Hey there, "
|
||||
|
||||
# It won't affect the output.
|
||||
echo "how are you doing today?"
|
||||
-%}
|
||||
LIQUID
|
||||
end
|
||||
|
||||
def test_inline_comment_can_be_written_on_multiple_lines
|
||||
assert_template_result('', <<~LIQUID)
|
||||
{%-
|
||||
# That kind of block comment is also allowed.
|
||||
# It would only be a stylistic difference.
|
||||
# Much like JavaScript's /* */ comments and their
|
||||
# leading * on new lines.
|
||||
-%}
|
||||
LIQUID
|
||||
end
|
||||
|
||||
def test_inline_comment_multiple_pound_signs
|
||||
assert_template_result('', <<~LIQUID)
|
||||
{%- liquid
|
||||
######################################
|
||||
# We support comments like this too. #
|
||||
######################################
|
||||
-%}
|
||||
LIQUID
|
||||
end
|
||||
|
||||
def test_inline_comments_require_the_pound_sign_on_every_new_line
|
||||
assert_match_syntax_error("Each line of comments must be prefixed by the '#' character", <<~LIQUID)
|
||||
{%-
|
||||
# some comment
|
||||
echo 'hello world'
|
||||
-%}
|
||||
LIQUID
|
||||
end
|
||||
|
||||
def test_inline_comment_does_not_support_nested_tags
|
||||
assert_template_result(' -%}', "{%- # {% echo 'hello world' %} -%}")
|
||||
end
|
||||
end
|
||||
Reference in New Issue
Block a user