1 files changed, 98 insertions, 0 deletions
diff --git a/test/units/module_utils/common/validation/test_check_required_by.py b/test/units/module_utils/common/validation/test_check_required_by.py
new file mode 100644
index 0000000..62cccff
--- /dev/null
+++ b/test/units/module_utils/common/validation/test_check_required_by.py
@@ -0,0 +1,98 @@
+# -*- coding: utf-8 -*-
+# Copyright: (c) 2021, Ansible Project
+# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
+
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
+import pytest
+
+from ansible.module_utils._text import to_native
+from ansible.module_utils.common.validation import check_required_by
+
+
+@pytest.fixture
+def path_arguments_terms():
+    return {
+        "path": ["mode", "owner"],
+    }
+
+
+def test_check_required_by():
+    arguments_terms = {}
+    params = {}
+    assert check_required_by(arguments_terms, params) == {}
+
+
+def test_check_required_by_missing():
+    arguments_terms = {
+        "force": "force_reason",
+    }
+    params = {"force": True}
+    expected = "missing parameter(s) required by 'force': force_reason"
+
+    with pytest.raises(TypeError) as e:
+        check_required_by(arguments_terms, params)
+
+    assert to_native(e.value) == expected
+
+
+def test_check_required_by_multiple(path_arguments_terms):
+    params = {
+        "path": "/foo/bar",
+    }
+    expected = "missing parameter(s) required by 'path': mode, owner"
+
+    with pytest.raises(TypeError) as e:
+        check_required_by(path_arguments_terms, params)
+
+    assert to_native(e.value) == expected
+
+
+def test_check_required_by_single(path_arguments_terms):
+    params = {"path": "/foo/bar", "mode": "0700"}
+    expected = "missing parameter(s) required by 'path': owner"
+
+    with pytest.raises(TypeError) as e:
+        check_required_by(path_arguments_terms, params)
+
+    assert to_native(e.value) == expected
+
+
+def test_check_required_by_missing_none(path_arguments_terms):
+    params = {
+        "path": "/foo/bar",
+        "mode": "0700",
+        "owner": "root",
+    }
+    assert check_required_by(path_arguments_terms, params)
+
+
+def test_check_required_by_options_context(path_arguments_terms):
+    params = {"path": "/foo/bar", "mode": "0700"}
+
+    options_context = ["foo_context"]
+
+    expected = "missing parameter(s) required by 'path': owner found in foo_context"
+
+    with pytest.raises(TypeError) as e:
+        check_required_by(path_arguments_terms, params, options_context)
+
+    assert to_native(e.value) == expected
+
+
+def test_check_required_by_missing_multiple_options_context(path_arguments_terms):
+    params = {
+        "path": "/foo/bar",
+    }
+    options_context = ["foo_context"]
+
+    expected = (
+        "missing parameter(s) required by 'path': mode, owner found in foo_context"
+    )
+
+    with pytest.raises(TypeError) as e:
+        check_required_by(path_arguments_terms, params, options_context)
+
+    assert to_native(e.value) == expected