Make sure collection is a list if a str is given (#69081)

* Make sure collection is a list if a str is given

* Call field validation early on collections

Because we are doing work on modifying the collections value before
it is actually validated, we can validate it ourselves early to make
sure the user supplies either a string or list. Dicts are not valid.

The new validation allows us to simplify the _ensure_default_collection()
function. And since the field is now static, we no longer need to specify
a default for it, which also allows us to simplify the function. Since
the default is now removed, we can also remove the sanity/ignore.txt entry
for collectionsearch.py.

New unit tests are added (and the existing one modified) that allow us to
make sure that we throw a parser error if a user specifies something other
than a string or list for the collections value everywhere it can be specified.

* Revert removing the collection default

The default is actually used, so restore it.

* Fix unit tests in test_helpers.py affected by early collection validation
This commit is contained in:
David Shrewsbury 2020-04-28 11:47:11 -04:00 committed by GitHub
parent 91bb5af688
commit ff47d3f766
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
6 changed files with 75 additions and 23 deletions

View file

@ -0,0 +1,2 @@
bugfixes:
- Make sure if a collection is supplied as a string that we transform it into a list.

View file

@ -16,15 +16,13 @@ display = Display()
def _ensure_default_collection(collection_list=None): def _ensure_default_collection(collection_list=None):
default_collection = AnsibleCollectionLoader().default_collection default_collection = AnsibleCollectionLoader().default_collection
# Will be None when used as the default
if collection_list is None: if collection_list is None:
collection_list = [] collection_list = []
if default_collection: # FIXME: exclude role tasks? # FIXME: exclude role tasks?
if isinstance(collection_list, string_types): if default_collection and default_collection not in collection_list:
collection_list = [collection_list] collection_list.insert(0, default_collection)
if default_collection not in collection_list:
collection_list.insert(0, default_collection)
# if there's something in the list, ensure that builtin or legacy is always there too # if there's something in the list, ensure that builtin or legacy is always there too
if collection_list and 'ansible.builtin' not in collection_list and 'ansible.legacy' not in collection_list: if collection_list and 'ansible.builtin' not in collection_list and 'ansible.legacy' not in collection_list:
@ -40,6 +38,10 @@ class CollectionSearch:
always_post_validate=True, static=True) always_post_validate=True, static=True)
def _load_collections(self, attr, ds): def _load_collections(self, attr, ds):
# We are always a mixin with Base, so we can validate this untemplated
# field early on to guarantee we are dealing with a list.
ds = self.get_validated_value('collections', self._collections, ds, None)
# this will only be called if someone specified a value; call the shared value # this will only be called if someone specified a value; call the shared value
_ensure_default_collection(collection_list=ds) _ensure_default_collection(collection_list=ds)
@ -47,8 +49,9 @@ class CollectionSearch:
return None return None
# This duplicates static attr checking logic from post_validate() # This duplicates static attr checking logic from post_validate()
# because if the user attempts to template a collection name, it will # because if the user attempts to template a collection name, it may
# error before it ever gets to the post_validate() warning. # error before it ever gets to the post_validate() warning (e.g. trying
# to import a role from the collection).
env = Environment() env = Environment()
for collection_name in ds: for collection_name in ds:
if is_template(collection_name, env): if is_template(collection_name, env):

View file

@ -184,14 +184,14 @@ class Task(Base, Conditional, Taggable, CollectionSearch):
# since this affects the task action parsing, we have to resolve in preprocess instead of in typical validator # since this affects the task action parsing, we have to resolve in preprocess instead of in typical validator
default_collection = AnsibleCollectionLoader().default_collection default_collection = AnsibleCollectionLoader().default_collection
# use the parent value if our ds doesn't define it collections_list = ds.get('collections')
collections_list = ds.get('collections', self.collections)
if collections_list is None: if collections_list is None:
collections_list = [] # use the parent value if our ds doesn't define it
collections_list = self.collections
if isinstance(collections_list, string_types): else:
collections_list = [collections_list] # Validate this untemplated field early on to guarantee we are dealing with a list.
# This is also done in CollectionSearch._load_collections() but this runs before that call.
collections_list = self.get_validated_value('collections', self._collections, collections_list, None)
if default_collection and not self._role: # FIXME: and not a collections role if default_collection and not self._role: # FIXME: and not a collections role
if collections_list: if collections_list:

View file

@ -406,3 +406,10 @@
hosts: testhost hosts: testhost
roles: roles:
- testns.testcoll.call_standalone - testns.testcoll.call_standalone
# Issue https://github.com/ansible/ansible/issues/69054
- name: Test collection as string
hosts: testhost
collections: foo
tasks:
- debug: msg="Test"

View file

@ -18,6 +18,10 @@
from __future__ import (absolute_import, division, print_function) from __future__ import (absolute_import, division, print_function)
__metaclass__ = type __metaclass__ = type
from ansible.errors import AnsibleParserError
from ansible.playbook.play import Play
from ansible.playbook.task import Task
from ansible.playbook.block import Block
from ansible.playbook.collectionsearch import CollectionSearch from ansible.playbook.collectionsearch import CollectionSearch
import pytest import pytest
@ -28,11 +32,47 @@ def test_collection_static_warning(capsys):
Also, make sure that users see the warning message for the referenced name. Also, make sure that users see the warning message for the referenced name.
""" """
collection_name = "foo.{{bar}}"
collection_name = 'foo.{{bar}}' p = Play.load(dict(
cs = CollectionSearch() name="test play",
assert collection_name in cs._load_collections(None, [collection_name]) hosts=['foo'],
gather_facts=False,
connection='local',
collections=collection_name,
))
assert collection_name in p.collections
std_out, std_err = capsys.readouterr() std_out, std_err = capsys.readouterr()
assert '[WARNING]: "collections" is not templatable, but we found: %s' % collection_name in std_err assert '[WARNING]: "collections" is not templatable, but we found: %s' % collection_name in std_err
assert '' == std_out assert '' == std_out
def test_collection_invalid_data_play():
"""Test that collection as a dict at the play level fails with parser error"""
collection_name = {'name': 'foo'}
with pytest.raises(AnsibleParserError):
Play.load(dict(
name="test play",
hosts=['foo'],
gather_facts=False,
connection='local',
collections=collection_name,
))
def test_collection_invalid_data_task():
"""Test that collection as a dict at the task level fails with parser error"""
collection_name = {'name': 'foo'}
with pytest.raises(AnsibleParserError):
Task.load(dict(
name="test task",
collections=collection_name,
))
def test_collection_invalid_data_block():
"""Test that collection as a dict at the block level fails with parser error"""
collection_name = {'name': 'foo'}
with pytest.raises(AnsibleParserError):
Block.load(dict(
block=[dict(name="test task", collections=collection_name)]
))

View file

@ -316,7 +316,7 @@ class TestLoadListOfTasks(unittest.TestCase, MixinForMocks):
# print(res) # print(res)
def test_one_bogus_include_role(self): def test_one_bogus_include_role(self):
ds = [{'include_role': {'name': 'bogus_role'}}] ds = [{'include_role': {'name': 'bogus_role'}, 'collections': []}]
res = helpers.load_list_of_tasks(ds, play=self.mock_play, res = helpers.load_list_of_tasks(ds, play=self.mock_play,
block=self.mock_block, block=self.mock_block,
variable_manager=self.mock_variable_manager, loader=self.fake_role_loader) variable_manager=self.mock_variable_manager, loader=self.fake_role_loader)
@ -324,7 +324,7 @@ class TestLoadListOfTasks(unittest.TestCase, MixinForMocks):
self._assert_is_task_list_or_blocks(res) self._assert_is_task_list_or_blocks(res)
def test_one_bogus_include_role_use_handlers(self): def test_one_bogus_include_role_use_handlers(self):
ds = [{'include_role': {'name': 'bogus_role'}}] ds = [{'include_role': {'name': 'bogus_role'}, 'collections': []}]
res = helpers.load_list_of_tasks(ds, play=self.mock_play, use_handlers=True, res = helpers.load_list_of_tasks(ds, play=self.mock_play, use_handlers=True,
block=self.mock_block, block=self.mock_block,
variable_manager=self.mock_variable_manager, variable_manager=self.mock_variable_manager,
@ -395,7 +395,7 @@ class TestLoadListOfBlocks(unittest.TestCase, MixinForMocks):
loader=None) loader=None)
def test_block_unknown_action(self): def test_block_unknown_action(self):
ds = [{'action': 'foo'}] ds = [{'action': 'foo', 'collections': []}]
mock_play = MagicMock(name='MockPlay') mock_play = MagicMock(name='MockPlay')
res = helpers.load_list_of_blocks(ds, mock_play, parent_block=None, role=None, task_include=None, use_handlers=False, variable_manager=None, res = helpers.load_list_of_blocks(ds, mock_play, parent_block=None, role=None, task_include=None, use_handlers=False, variable_manager=None,
loader=None) loader=None)