embulk の liquid template でハマったトコ

いくつかハマったので、メモがてら・・・。
動かした embulk は・・・0.8.11 だったと思います（調べたら直しておきます）。

include のパス

include で設定するパスは、最初に読み込む liquid ファイルからの相対パスになります。
読み込んだ先の liquid ファイルで、さらに include しても、最初に読み込んだファイルからの相対パスになります。
しかも、パスにカレントディレクトリを表す「.」や、親ディレクトリを表す「..」が使えません。
なので、最初に読み込む liquid ファイルが、一番上にディレクトリにゴチャッと溜まることに・・・。

env の罠

embulk は実行時に引数を渡すことができないので、環境変数を使うことになります。
で、どの liquid ファイルで使用するかわからないので、全部最初に読み込む liquid ファイルで指定してたんですけど、

{% include 'child', args = env.ARGS %}

こんな感じで直接 include 先のファイルに渡すことができないみたいです。
一度、assign すると渡せます。

{% assign args = env.ARGS %}
{% include 'child', args = args %}

これウソでした。
もうちょっと調査して修正します。

include での渡し方

include で変数を渡すには、「:」で指定するか、「=」で指定することができます。
でも、これも謎の罠があって・・・

# parent.yml.liquid
{% include 'child', args = 'ar' %}

# _child.yml.liquid
{% assing args = args | append: 'gs' %}
{% include 'grandchild1', args: args %}  # 'ar' が渡される
{% include 'grandchild2', args = args %}  # 'args' が渡される

おわかりいただけたでしょうか？
append した内容が反映されるかどうかの差異があるようです。

これウソでした。
もうちょっと調査して修正します。

文字列に「'」と「"」を混在させたい

片方だったら、'aaa"aaa' というような感じで書けば良いのですけど、両方使いたい場合は、append するか、replace で適当な文字をあとで置き換えるかする必要があるようです。
エスケープなんてなかった（たぶん）。