cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Mention Python builtin methods in filter docs (#65425)

Browse source
This commit is contained in:
Sam Doran 2019-12-02 10:44:59 -05:00 committed by Alicia Cozine
parent 8ebc57c186
commit 21bbf49396
1 changed files with 5 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
docs/docsite/rst/user_guide/playbooks_filters.rst
View file

@ -6,7 +6,7 @@ Filters
.. contents:: Topics .. contents:: Topics
Filters in Ansible are from Jinja2, and are used for transforming data inside a template expression. Jinja2 ships with many filters. See `builtin filters`_ in the official Jinja2 template documentation. Filters in Ansible are from Jinja2, and are used for transforming data inside a template expression. Jinja2 ships with many filters. See `builtin filters`_ in the official Jinja2 template documentation. It is also possible to use `Python methods`_ on a variable.
Take into account that templating happens on the Ansible controller, **not** on the task's target host, so filters also execute on the controller as they manipulate local data. Take into account that templating happens on the Ansible controller, **not** on the task's target host, so filters also execute on the controller as they manipulate local data.
@ -1454,9 +1454,11 @@ A few useful filters are typically added with each new Ansible release. The dev
how to extend Ansible filters by writing your own as plugins, though in general, we encourage new ones how to extend Ansible filters by writing your own as plugins, though in general, we encourage new ones
to be added to core so everyone can make use of them. to be added to core so everyone can make use of them.
.. _Jinja2 map() docs: http://jinja.pocoo.org/docs/dev/templates/#map .. _Jinja2 map() docs: https://jinja.palletsprojects.com/templates/#map
.. _builtin filters: http://jinja.pocoo.org/docs/templates/#builtin-filters .. _builtin filters: https://jinja.palletsprojects.com/templates/#builtin-filters
.. _Python methods: https://jinja.palletsprojects.com/templates/#python-methods
.. _PyYAML library: https://pyyaml.org/ .. _PyYAML library: https://pyyaml.org/