mirror of
https://github.com/ansible-collections/community.general.git
synced 2026-02-03 23:41:51 +00:00
107 lines
2.7 KiB
Python
107 lines
2.7 KiB
Python
# (c) 2022, Alexei Znamensky <russoz@gmail.com>
|
|
# Copyright (c) 2022, Ansible Project
|
|
# Simplified BSD License (see LICENSES/BSD-2-Clause.txt or https://opensource.org/licenses/BSD-2-Clause)
|
|
# SPDX-License-Identifier: BSD-2-Clause
|
|
|
|
from __future__ import annotations
|
|
|
|
import traceback
|
|
import typing as t
|
|
from contextlib import contextmanager
|
|
from enum import Enum
|
|
|
|
from ansible.module_utils.basic import missing_required_lib
|
|
|
|
if t.TYPE_CHECKING:
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
|
|
|
|
_deps: dict[str, _Dependency] = dict()
|
|
|
|
|
|
class _State(Enum):
|
|
PENDING = "pending"
|
|
FAILURE = "failure"
|
|
SUCCESS = "success"
|
|
|
|
|
|
class _Dependency:
|
|
def __init__(self, name: str, reason: str | None = None, url: str | None = None, msg: str | None = None) -> None:
|
|
self.name = name
|
|
self.reason = reason
|
|
self.url = url
|
|
self.msg = msg
|
|
|
|
self.state = _State.PENDING
|
|
self.trace: str | None = None
|
|
self.exc: Exception | None = None
|
|
|
|
def succeed(self) -> None:
|
|
self.state = _State.SUCCESS
|
|
|
|
def fail(self, exc: Exception, trace: str) -> None:
|
|
self.state = _State.FAILURE
|
|
self.exc = exc
|
|
self.trace = trace
|
|
|
|
@property
|
|
def message(self) -> str:
|
|
if self.msg:
|
|
return str(self.msg)
|
|
else:
|
|
return missing_required_lib(self.name, reason=self.reason, url=self.url)
|
|
|
|
@property
|
|
def failed(self) -> bool:
|
|
return self.state == _State.FAILURE
|
|
|
|
def validate(self, module: AnsibleModule) -> None:
|
|
if self.failed:
|
|
module.fail_json(msg=self.message, exception=self.trace)
|
|
|
|
def __str__(self) -> str:
|
|
return f"<dependency: {self.name} [{self.state.value}]>"
|
|
|
|
|
|
@contextmanager
|
|
def declare(name: str, *args, **kwargs) -> t.Generator[_Dependency]:
|
|
dep = _Dependency(name, *args, **kwargs)
|
|
try:
|
|
yield dep
|
|
except Exception as e:
|
|
dep.fail(e, traceback.format_exc())
|
|
else:
|
|
dep.succeed()
|
|
finally:
|
|
_deps[name] = dep
|
|
|
|
|
|
def _select_names(spec: str | None) -> list[str]:
|
|
dep_names = sorted(_deps)
|
|
|
|
if spec:
|
|
if spec.startswith("-"):
|
|
spec_split = spec[1:].split(":")
|
|
for d in spec_split:
|
|
dep_names.remove(d)
|
|
else:
|
|
spec_split = spec.split(":")
|
|
dep_names = []
|
|
for d in spec_split:
|
|
_deps[d] # ensure it exists
|
|
dep_names.append(d)
|
|
|
|
return dep_names
|
|
|
|
|
|
def validate(module: AnsibleModule, spec: str | None = None) -> None:
|
|
for dep in _select_names(spec):
|
|
_deps[dep].validate(module)
|
|
|
|
|
|
def failed(spec: str | None = None) -> bool:
|
|
return any(_deps[d].failed for d in _select_names(spec))
|
|
|
|
|
|
def clear() -> None:
|
|
_deps.clear()
|