variables in include tag with filters

[jens-na]

Use variable {% include %} with filters
This pull request adds support for filters when using the include tag with a variable.
To be more precise:

Since PR #1495 it is possible to use variables inside an include tag, like that:

    {% for item in page.dependencies %}
        {% include {{item}} %}
    {% endfor %}

but unfortunately you cannot use filters.

With this pull reuqest you can use something like this:

    {% for item in page.dependencies %}
        {% include {{ item | append: '.html' }} %}
    {% endfor %}

This is especially useful when you want to modify the file/filename which should get included.

Possible use cases

Append .html to the file name

{% include {{ item | append: '.html' }} %}

Make sure the file name is lowercase

{% include {{ item | downcase | append: '.html' }} %}

Prepend a directory to choose another directory inside the _includes/ directory

{% include {{ item | downcase | prepend: '/dependencies/' | append: '.html' }} %}
==> ./_includes/dependencies/<item>.html

[maul-esel]

Looks great:exclamation: A few questions:

• Does this also tackle the problem where something like {% include {{ var }} %} was failing (note the spaces inside the inner brackets) ? If so, could you please add a small test for that or change one of the original tests and remove the note concerning this limitation from the docs?
• I saw you changed the error messages to use file instead of @file. Any specific reason?
• Does it also work for literals with filters, like {{ 'myfile' | append: '.html' }} ? Not that I see urgent need for that, just asking :)
• Might not be a bad idea to add a test with several filters, to make sure it's not accidentally broken in the future.

[jens-na]

Thanks for your feedback!

I readjusted the regex which does the parsing. Now arbitary whitespace may be used inside the variable. Something like this should be possbile: http://rubular.com/r/SqZ9BbyNNl

I changed the error messages, because @file is not always the value you want to see in an error message:

file = retrieve_variable(context) || @file
# @file => "{{ item | append: '.html'}}"
# file => "myfile.html"

Example error message with @file
Liquid Exception: Included file '{{ item | append: '.html'}}' not found in '_includes' directory in _layouts/post.html
Example error message with file
Liquid Exception: Included file '<path>/_includes/myfile.html' not found in '_includes' directory in _layouts/post.html

I think the 2nd error message is more informative. What do you think?

Filtering literals like {{ 'myfile' | append: '.html' }} does not work right now. Sorry :(

I will add some tests!

[maul-esel]

1. Cool! That was an old result of my lazyness I always wanted to remove. :) Thanks for taking care of it.
2. I'm undecided - best would be to work around it by showing both. If only the actual path is displayed, people (especially people like me) could go all crazy about "I don't even have that kind of tag anywhere", if only the variable / filters are displayed, one has to do extra steps to output the actual value to debug that.
3. Well, no need to be sorry. I couldn't imagine a real-world use-case anyway.
4. 👍

[maul-esel]

As always, the regex currently fails in Ruby 1.8.7 because it can't do named groups. @parkr, @mattr- is it necessary to work around this or not as 2.0 won't be 1.8.7-compatible anyway?

[maul-esel]

As you're using the same regex twice, you might want to move it to a constant, like VALID_SYNTAX above.

[mattr-]

I wouldn't worry about working around the named group problem.

[parkr]

Fixed by merge of #1841.