Adding upstream version 6.13.1.upstream/6.13.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 168 insertions, 0 deletions

diff --git a/src/ansiblelint/constants.py b/src/ansiblelint/constants.py
new file mode 100644
index 0000000..0fec8fd
--- /dev/null
+++ b/src/ansiblelint/constants.py
@@ -0,0 +1,168 @@
+"""Constants used by AnsibleLint."""
+import os.path
+from enum import Enum
+from typing import Literal
+
+DEFAULT_RULESDIR = os.path.join(os.path.dirname(__file__), "rules")
+CUSTOM_RULESDIR_ENVVAR = "ANSIBLE_LINT_CUSTOM_RULESDIR"
+RULE_DOC_URL = "https://ansible-lint.readthedocs.io/rules/"
+
+SUCCESS_RC = 0
+VIOLATIONS_FOUND_RC = 2
+INVALID_CONFIG_RC = 3
+LOCK_TIMEOUT_RC = 4
+EXIT_CONTROL_C_RC = 130
+
+# Minimal version of Ansible we support for runtime
+ANSIBLE_MIN_VERSION = "2.12"
+
+ANSIBLE_MOCKED_MODULE = """\
+# This is a mocked Ansible module generated by ansible-lint
+from ansible.module_utils.basic import AnsibleModule
+
+DOCUMENTATION = '''
+module: {name}
+
+short_description: Mocked
+version_added: "1.0.0"
+description: Mocked
+
+author:
+    - ansible-lint (@nobody)
+'''
+EXAMPLES = '''mocked'''
+RETURN = '''mocked'''
+
+
+def main():
+    result = dict(
+        changed=False,
+        original_message='',
+        message='')
+
+    module = AnsibleModule(
+        argument_spec=dict(),
+        supports_check_mode=True,
+    )
+    module.exit_json(**result)
+
+
+if __name__ == "__main__":
+    main()
+"""
+
+FileType = Literal[
+    "playbook",
+    "rulebook",
+    "meta",  # role meta
+    "meta-runtime",
+    "tasks",  # includes pre_tasks, post_tasks
+    "handlers",  # very similar to tasks but with some specifics
+    # https://docs.ansible.com/ansible/latest/galaxy/user_guide.html#installing-roles-and-collections-from-the-same-requirements-yml-file
+    "requirements",
+    "role",  # that is a folder!
+    "yaml",  # generic yaml file, previously reported as unknown file type
+    "ansible-lint-config",
+    "",  # unknown file type
+]
+
+
+# Aliases for deprecated tags/ids and their newer names
+RENAMED_TAGS = {
+    "102": "no-jinja-when",
+    "104": "deprecated-bare-vars",
+    "105": "deprecated-module",
+    "106": "role-name",
+    "202": "risky-octal",
+    "203": "no-tabs",
+    "205": "playbook-extension",
+    "206": "jinja[spacing]",
+    "207": "jinja[invalid]",
+    "208": "risky-file-permissions",
+    "301": "no-changed-when",
+    "302": "deprecated-command-syntax",
+    "303": "command-instead-of-module",
+    "304": "inline-env-var",
+    "305": "command-instead-of-shell",
+    "306": "risky-shell-pipe",
+    "401": "latest[git]",
+    "402": "latest[hg]",
+    "403": "package-latest",
+    "404": "no-relative-paths",
+    "501": "partial-become",
+    "502": "unnamed-task",
+    "503": "no-handler",
+    "504": "deprecated-local-action",
+    "505": "missing-import",
+    "601": "literal-compare",
+    "602": "empty-string-compare",
+    "701": "meta-no-info",
+    "702": "meta-no-tags",
+    "703": "meta-incorrect",
+    "704": "meta-video-links",
+    "911": "syntax-check",
+    "var-spacing": "jinja[spacing]",
+    "unnamed-task": "name[missing]",
+    "git-latest": "latest[git]",
+    "hg-latest": "latest[hg]",
+    "no-jinja-nesting": "jinja[invalid]",
+    "no-loop-var-prefix": "loop-var-prefix",
+    "fqcn-builtins": "fqcn[action-core]",
+}
+
+PLAYBOOK_TASK_KEYWORDS = [
+    "tasks",
+    "handlers",
+    "pre_tasks",
+    "post_tasks",
+]
+NESTED_TASK_KEYS = [
+    "block",
+    "always",
+    "rescue",
+]
+
+# Keys that are used internally when parsing YAML/JSON files
+SKIPPED_RULES_KEY = "__skipped_rules__"
+LINE_NUMBER_KEY = "__line__"
+FILENAME_KEY = "__file__"
+ANNOTATION_KEYS = [FILENAME_KEY, LINE_NUMBER_KEY, SKIPPED_RULES_KEY]
+
+INCLUSION_ACTION_NAMES = {
+    "include",
+    "include_tasks",
+    "import_playbook",
+    "import_tasks",
+    "ansible.builtin.include",
+    "ansible.builtin.include_tasks",
+    "ansible.builtin.import_playbook",
+    "ansible.builtin.import_tasks",
+}
+
+ROLE_IMPORT_ACTION_NAMES = {
+    "ansible.builtin.import_role",
+    "ansible.builtin.include_role",
+    "ansible.legacy.import_role",
+    "ansible.legacy.include_role",
+    "import_role",
+    "include_role",
+}
+
+# Newer versions of git might fail to run when different file ownership is
+# found of repo. One example is on GHA runners executing containerized
+# reusable actions, where the mounted volume might have different owner.
+#
+# https://github.com/ansible/ansible-lint-action/issues/138
+GIT_CMD = ["git", "-c", f"safe.directory={os.getcwd()}"]
+
+
+class States(Enum):
+    """States used are used as sentinel values in various places."""
+
+    NOT_LOADED = "File not loaded"
+    LOAD_FAILED = "File failed to load"
+    UNKNOWN_DATA = "Unknown data"
+
+    def __bool__(self) -> bool:
+        """Ensure all states evaluate as False as booleans."""
+        return False