Fix: fix mock_modules generated stubs failing YAML/doc parsing #5031

src/ansiblelint/constants.py

@@ -55,9 +55,12 @@ class RC:  # pylint: disable=too-few-public-methods
 author:
     - ansible-lint (@nobody)
 '''
-EXAMPLES = '''mocked'''
-RETURN = '''mocked'''
-
+EXAMPLES = '''\
+- name: Mocked module example
+  {name}:
+'''
+RETURN = r\"\"\"
+# \"\"\"
 
 def main():
     result = dict(

test/test_mockings.py

@@ -61,3 +61,21 @@ def test_options_collection_mocks() -> None:
 
     opts.mock_modules = ["ns.coll.mod"]
     assert opts.has_collection_mocks() is True
+
+
+def test_mock_modules_stub_is_lintable(tmp_path: Path) -> None:
+    """Ensure generated mock module docs do not trip yaml/doc parsing."""
+    (tmp_path / ".ansible-lint.yml").write_text(
+        "mock_modules:\n  - some_ns.some_coll.some_module\n"
+    )
+    (tmp_path / "playbook.yml").write_text(
+        "---\n"
+        "- name: Test mocked module\n"
+        "  hosts: localhost\n"
+        "  gather_facts: false\n"
+        "  tasks:\n"
+        "    - name: Run mocked module\n"
+        "      some_ns.some_coll.some_module:\n"
+    )
+    result = run_ansible_lint("playbook.yml", cwd=tmp_path)
+    assert result.returncode == 0, result.stdout