mirror of
https://github.com/ansible-collections/community.general.git
synced 2024-09-14 20:13:21 +02:00
07a4079a81
* aws module utils including AnsibleAWSModule * fail_json_aws method on AnsibleAWSModule to do fail_json nicely with AWS exceptions * aws module util - feedback - rename to aws/core.py & improve doc strings
139 lines
6.1 KiB
Python
139 lines
6.1 KiB
Python
# -*- coding: utf-8 -*-
|
|
# (c) 2017, Michael De La Rue
|
|
#
|
|
# This file is part of Ansible
|
|
#
|
|
# Ansible is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# Ansible is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
# Make coding more python3-ish
|
|
from __future__ import (absolute_import, division, print_function)
|
|
from pytest import importorskip
|
|
import unittest
|
|
from ansible.module_utils import basic
|
|
from ansible.module_utils.aws.core import AnsibleAWSModule
|
|
from ansible.module_utils._text import to_bytes
|
|
from ansible.compat.tests.mock import Mock, patch
|
|
import json
|
|
|
|
importorskip("boto3")
|
|
botocore = importorskip("botocore")
|
|
|
|
|
|
class AWSModuleTestCase(unittest.TestCase):
|
|
|
|
basic._ANSIBLE_ARGS = to_bytes(json.dumps({'ANSIBLE_MODULE_ARGS': {}}))
|
|
|
|
def test_create_aws_module_should_set_up_params(self):
|
|
m = AnsibleAWSModule(argument_spec=dict(
|
|
win_string_arg=dict(type='list', default=['win'])
|
|
))
|
|
m_noretry_no_customargs = AnsibleAWSModule(
|
|
auto_retry=False, default_args=False,
|
|
argument_spec=dict(
|
|
success_string_arg=dict(type='list', default=['success'])
|
|
)
|
|
)
|
|
assert m, "module wasn't true!!"
|
|
assert m_noretry_no_customargs, "module wasn't true!!"
|
|
|
|
m_params = m.params
|
|
m_no_defs_params = m_noretry_no_customargs.params
|
|
assert 'region' in m_params
|
|
assert 'win' in m_params["win_string_arg"]
|
|
assert 'success' in m_no_defs_params["success_string_arg"]
|
|
assert 'aws_secret_key' not in m_no_defs_params
|
|
|
|
|
|
class ErrorReportingTestcase(unittest.TestCase):
|
|
|
|
def test_botocore_exception_reports_nicely_via_fail_json_aws(self):
|
|
|
|
basic._ANSIBLE_ARGS = to_bytes(json.dumps({'ANSIBLE_MODULE_ARGS': {}}))
|
|
module = AnsibleAWSModule(argument_spec=dict(
|
|
fail_mode=dict(type='list', default=['success'])
|
|
))
|
|
|
|
fail_json_double = Mock()
|
|
err_msg = {'Error': {'Code': 'FakeClass.FakeError'}}
|
|
with patch.object(basic.AnsibleModule, 'fail_json', fail_json_double):
|
|
try:
|
|
raise botocore.exceptions.ClientError(err_msg, 'Could not find you')
|
|
except Exception as e:
|
|
print("exception is " + str(e))
|
|
module.fail_json_aws(e, msg="Fake failure for testing boto exception messages")
|
|
|
|
assert(len(fail_json_double.mock_calls) >
|
|
0), "failed to call fail_json when should have"
|
|
assert(len(fail_json_double.mock_calls) <
|
|
2), "called fail_json multiple times when once would do"
|
|
assert("test_botocore_exception_reports_nicely"
|
|
in fail_json_double.mock_calls[0][2]["exception"]), \
|
|
"exception traceback doesn't include correct function, fail call was actually: " \
|
|
+ str(fail_json_double.mock_calls[0])
|
|
|
|
assert("Fake failure for testing boto exception messages:"
|
|
in fail_json_double.mock_calls[0][2]["msg"]), \
|
|
"error message doesn't include the local message; was: " \
|
|
+ str(fail_json_double.mock_calls[0])
|
|
assert("Could not find you" in fail_json_double.mock_calls[0][2]["msg"]), \
|
|
"error message doesn't include the botocore exception message; was: " \
|
|
+ str(fail_json_double.mock_calls[0])
|
|
try:
|
|
fail_json_double.mock_calls[0][2]["error"]
|
|
except KeyError:
|
|
raise Exception("error was missing; call was: " + str(fail_json_double.mock_calls[0]))
|
|
assert("FakeClass.FakeError" == fail_json_double.mock_calls[0][2]["error"]["code"]), \
|
|
"Failed to find error/code; was: " + str(fail_json_double.mock_calls[0])
|
|
|
|
def test_botocore_exception_without_response_reports_nicely_via_fail_json_aws(self):
|
|
basic._ANSIBLE_ARGS = to_bytes(json.dumps({'ANSIBLE_MODULE_ARGS': {}}))
|
|
module = AnsibleAWSModule(argument_spec=dict(
|
|
fail_mode=dict(type='list', default=['success'])
|
|
))
|
|
|
|
fail_json_double = Mock()
|
|
err_msg = None
|
|
with patch.object(basic.AnsibleModule, 'fail_json', fail_json_double):
|
|
try:
|
|
raise botocore.exceptions.ClientError(err_msg, 'Could not find you')
|
|
except Exception as e:
|
|
print("exception is " + str(e))
|
|
module.fail_json_aws(e, msg="Fake failure for testing boto exception messages")
|
|
|
|
assert(len(fail_json_double.mock_calls) > 0), "failed to call fail_json when should have"
|
|
assert(len(fail_json_double.mock_calls) < 2), "called fail_json multiple times"
|
|
|
|
assert("test_botocore_exception_without_response_reports_nicely_via_fail_json_aws"
|
|
in fail_json_double.mock_calls[0][2]["exception"]), \
|
|
"exception traceback doesn't include correct function, fail call was actually: " \
|
|
+ str(fail_json_double.mock_calls[0])
|
|
|
|
assert("Fake failure for testing boto exception messages"
|
|
in fail_json_double.mock_calls[0][2]["msg"]), \
|
|
"error message doesn't include the local message; was: " \
|
|
+ str(fail_json_double.mock_calls[0])
|
|
|
|
# I would have thought this should work, however the botocore exception comes back with
|
|
# "argument of type 'NoneType' is not iterable" so it's probably not really designed
|
|
# to handle "None" as an error response.
|
|
#
|
|
# assert("Could not find you" in fail_json_double.mock_calls[0][2]["msg"]), \
|
|
# "error message doesn't include the botocore exception message; was: " \
|
|
# + str(fail_json_double.mock_calls[0])
|
|
|
|
|
|
# TODO:
|
|
# - an exception without a message
|
|
# - plain boto exception
|
|
# - socket errors and other standard things.
|