Avoid stacktrace with broken ansible.cfg files (#3916)

Author: ssbarnea

.github/workflows/tox.yml

@@ -70,7 +70,7 @@ jobs:
     env:
       # Number of expected test passes, safety measure for accidental skip of
       # tests. Update value if you add/remove tests.
-      PYTEST_REQPASS: 847
+      PYTEST_REQPASS: 848
     steps:
       - uses: actions/checkout@v4
         with:

src/ansiblelint/__main__.py

@@ -36,6 +36,17 @@
 from filelock import FileLock, Timeout
 from rich.markup import escape
 
+from ansiblelint.constants import RC, SKIP_SCHEMA_UPDATE
+
+# safety check for broken ansible core, needs to happen first
+try:
+    # pylint: disable=unused-import
+    from ansible.parsing.dataloader import DataLoader  # noqa: F401
+
+except Exception as _exc:  # pylint: disable=broad-exception-caught # noqa: BLE001
+    logging.fatal(_exc)
+    sys.exit(RC.INVALID_CONFIG)
+# pylint: disable=ungrouped-imports
 from ansiblelint import cli
 from ansiblelint._mockings import _perform_mockings_cleanup
 from ansiblelint.app import get_app
@@ -53,7 +64,6 @@
     log_entries,
     options,
 )
-from ansiblelint.constants import RC, SKIP_SCHEMA_UPDATE
 from ansiblelint.loaders import load_ignore_txt
 from ansiblelint.runner import get_matches
 from ansiblelint.skip_utils import normalize_tag

src/ansiblelint/schemas/__store__.json

@@ -36,7 +36,7 @@
     "url": "https://raw.githubusercontent.com/ansible/ansible-lint/main/src/ansiblelint/schemas/molecule.json"
   },
   "playbook": {
-    "etag": "8ae42e48318ff6da41f6d383dc19b643221258ea6521886f834e31cb8d3a7322",
+    "etag": "b86e7f78281e33eb16de9c5c066da0f88798243b647cc195573441d92e1e78a5",
     "url": "https://raw.githubusercontent.com/ansible/ansible-lint/main/src/ansiblelint/schemas/playbook.json"
   },
   "requirements": {
@@ -52,7 +52,7 @@
     "url": "https://raw.githubusercontent.com/ansible/ansible-rulebook/main/ansible_rulebook/schema/ruleset_schema.json"
   },
   "tasks": {
-    "etag": "f9fbc0855680d1321fa3902181131d73838d922362d8dfb85a4f59402240cc07",
+    "etag": "495ec0c6cb49d60feed7e2bc7c0ef0135bab473a28c3c8d4a7be4f210e8c53fc",
     "url": "https://raw.githubusercontent.com/ansible/ansible-lint/main/src/ansiblelint/schemas/tasks.json"
   },
   "vars": {

test/fixtures/broken-ansible.cfg/ansible.cfg

@@ -0,0 +1,5 @@
+[defaults]
+
+# This breaks ansible-core, because it loads the value as null and only
+# integers are accepted.
+gather_timeout=

test/test_main.py

@@ -10,6 +10,7 @@
 from pytest_mock import MockerFixture
 
 from ansiblelint.config import get_version_warning
+from ansiblelint.constants import RC
 
 
 @pytest.mark.parametrize(
@@ -104,3 +105,20 @@ def test_nodeps(lintable: str) -> None:
         env=env,
     )
     assert proc.returncode == 0, proc
+
+
+def test_broken_ansible_cfg() -> None:
+    """Asserts behavior when encountering broken ansible.cfg files."""
+    py_path = Path(sys.executable).parent
+    proc = subprocess.run(
+        [str(py_path / "ansible-lint"), "--version"],
+        check=False,
+        capture_output=True,
+        text=True,
+        cwd="test/fixtures/broken-ansible.cfg",
+    )
+    assert proc.returncode == RC.INVALID_CONFIG, proc
+    assert (
+        "Invalid type for configuration option setting: DEFAULT_GATHER_TIMEOUT"
+        in proc.stderr
+    )