Ansible filters

README.md

@@ -17,7 +17,7 @@ Usage: jinja2 [options] <input template> <input data>
 Options:
   --version             show program's version number and exit
   -h, --help            show this help message and exit
-  --format=FORMAT       format of input variables: auto, ini, json,
+  --format=FORMAT       format of input variables: auto, env, ini, json,
                         querystring, yaml, yml
   -e EXTENSIONS, --extension=EXTENSIONS
                         extra jinja2 extensions to load
@@ -26,8 +26,16 @@ Options:
                         Use only this section from the configuration
   --strict              Disallow undefined variables to be used within the
                         template
+  -a, --ansible         Enable support for Ansible filters
+  -o FILE, --outfile=FILE
+                        File to use for output. Default is stdout.
 ```
 
+## Optional Ansible support
+If `Ansible Core` is present, you can use Ansible filters within your templates.
+
+`$ pip install jinja2-cli[ansible]`
+
 ## Optional YAML support
 If `PyYAML` is present, you can use YAML as an input data source.
 

jinja2cli/cli.py

@@ -220,7 +220,13 @@ def _parse_env(data):
 }
 
 
-def render(template_path, data, extensions, strict=False):
+def _load_ansible_filters():
+    from ansible.plugins.filter.core import FilterModule
+
+    return FilterModule().filters()
+
+
+def render(template_path, data, extensions, strict=False, ansible=False):
     from jinja2 import (
         __version__ as jinja_version,
         Environment,
@@ -246,6 +252,8 @@ def render(template_path, data, extensions, strict=False):
     )
     if strict:
         env.undefined = StrictUndefined
+    if ansible:
+        env.filters.update(_load_ansible_filters())
 
     # Add environ global
     env.globals["environ"] = lambda key: force_text(os.environ.get(key))
@@ -336,7 +344,7 @@ def cli(opts, args):
 
         out = codecs.getwriter("utf8")(out)
 
-    out.write(render(template_path, data, extensions, opts.strict))
+    out.write(render(template_path, data, extensions, opts.strict, opts.ansible))
     out.flush()
     return 0
 
@@ -422,6 +430,13 @@ def main():
         dest="strict",
         action="store_true",
     )
+    parser.add_option(
+        "-a",
+        "--ansible",
+        help="Enable support for Ansible filters",
+        dest="ansible",
+        action="store_true",
+    )
     parser.add_option(
         "-o",
         "--outfile",

setup.py

@@ -29,6 +29,7 @@
     license="BSD",
     install_requires=install_requires,
     extras_require={
+        "ansible": install_requires + ["ansible-core"],
         "yaml": install_requires + ["pyyaml"],
         "toml": install_requires + ["toml"],
         "xml": install_requires + ["xmltodict"],