Add a dynamic version of blocks.

[estheruary]

SUMMARY

Adds a new keyword/module called do which is the dynamic version of block. Among other things, this allows you to loop over multiple tasks without including an external file.

We have include as the dynamic version of import. How about do as the dynamic version of block?

## Replaces this:
# 

- name: Loop over tasks.
  include_tasks: stuff.yml
  loop: "{{ items }}"

# stuff.yml
- name: Task 1
  debug:
    msg: Task 1

- name: Task 2
  debug:
    var: item

## With this
#

- name: Loop over tasks.
  do:
    - name: Task 1
      debug:
        msg: Task 1

    - name: Task 2
      debug:
        var: item
  loop: "{{ items }}"

ISSUE TYPE

• Feature Pull Request

Spiritually implements #13262

COMPONENT NAME

do

ADDITIONAL INFORMATION

Right now the feature works but obviously needs some testing and documentation. Figured I'd hold off on the tedious parts until I find out if this is something you folks actually want upstream.

The name is inspired by how Ruby handles passing blocks.

[ansibot]

The test ansible-test sanity --test validate-modules [explain] failed with 1 error:

lib/ansible/modules/do.py:0:0: invalid-documentation: DOCUMENTATION.author: Invalid author for dictionary value @ data['author']. Got 'Estelle Poulin (dev@inspiredby.es)'

The test ansible-test sanity --test pylint [explain] failed with 4 errors:

lib/ansible/parsing/mod_args.py:219:19: bad-whitespace: No space allowed after bracket             args = { u'_raw_params': thing }                    ^
lib/ansible/parsing/mod_args.py:219:43: bad-whitespace: No space allowed before bracket             args = { u'_raw_params': thing }                                            ^
lib/ansible/playbook/task_include.py:120:48: bad-whitespace: No space allowed before :         if self.action not in ('include', 'do') :                                                 ^
lib/ansible/plugins/strategy/free.py:308:0: trailing-whitespace: Trailing whitespace

The test ansible-test sanity --test pep8 [explain] failed with 5 errors:

lib/ansible/parsing/mod_args.py:219:21: E201: whitespace after '{'
lib/ansible/parsing/mod_args.py:219:43: E202: whitespace before '}'
lib/ansible/playbook/task_include.py:120:48: E203: whitespace before ':'
lib/ansible/plugins/strategy/free.py:308:1: W293: blank line contains whitespace
lib/ansible/plugins/strategy/free.py:310:13: E303: too many blank lines (2)

click here for bot help

[ansibot]

@estheruary this PR contains the following merge commits:

• b47ebe1

Please rebase your branch to remove these commits.

click here for bot help