annet 0.1__py3-none-any.whl

annet/argparse.py

@@ -0,0 +1,415 @@
+import abc
+import argparse
+import contextlib
+import functools
+import os
+import sys
+from functools import lru_cache
+from typing import (
+    Callable,
+    ContextManager,
+    Dict,
+    Iterable,
+    Iterator,
+    List,
+    Optional,
+    Type,
+    TypeVar,
+    Union,
+)
+
+from annet.connectors import Connector
+
+
+T = TypeVar("T")
+
+_ARGS_ATTR_NAME = "_alan_opts"
+
+
+# =====
+class FuncMeta:
+    opts: List[Callable]
+    parent: Optional[Callable]
+    parser: Optional[argparse.ArgumentParser]
+
+    def __init__(self):
+        self.cmd_name = ""
+        self.opts = []
+        self.parent = None
+        self.parser = None
+        self.sub = None
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}(" + ", ".join((
+            f"cmd_name={self.cmd_name}",
+            f"opt={self.opts}",
+            f"parent={self.parent}",
+            f"parser={self.parser}",
+            f"sub={self.sub}",
+        )) + ")"
+
+
+def _get_meta(func: Callable) -> FuncMeta:
+    if not hasattr(func, _ARGS_ATTR_NAME):
+        _reset_meta(func)
+    return getattr(func, _ARGS_ATTR_NAME)
+
+
+def _reset_meta(func: Callable):
+    setattr(func, _ARGS_ATTR_NAME, FuncMeta())
+
+
+class ConvertibleDefault:
+    def __init__(self, value: str):
+        self.value = value
+
+    def convert(self, type_function: Callable[[str], T]) -> T:
+        return type_function(self.value)
+
+
+class DefaultFromEnv(ConvertibleDefault):
+    def __init__(self, var_name: str, default_val: str):
+        super().__init__(os.environ.get(var_name, default_val))
+        self.var_name = var_name
+
+    def convert(self, type_function: Callable[[str], T]) -> T:
+        try:
+            return super().convert(type_function)
+        except Exception:
+            function_name = getattr(type_function, "__name__", repr(type_function))
+            raise ValueError(f"invalid {function_name} in the {self.var_name} environment variable: {repr(self.value)}")
+
+
+class Arg:
+    """аргумент CLI"""
+
+    def __init__(self, *args, **kwargs):
+        """Конструктор повторяет прототип parser.add_argument()"""
+        if args and isinstance(args[0], type(self)):
+            # copy constructor
+            args = args[0].args
+            new_kwargs = args[0].kwargs.copy()
+            new_kwargs.update(kwargs)
+            kwargs = new_kwargs
+
+        self.args = args
+        self.kwargs = kwargs
+
+        self._prepared = False
+        self.default = None
+
+        self.dest = None  # заполняется в attach()
+
+    def _prepare(self):
+        if self._prepared:
+            return
+        self._prepared = True
+        default = self.kwargs.get("default", None)
+        if isinstance(default, ConvertibleDefault) and "type" in self.kwargs:
+            default = self.kwargs["default"] = default.convert(self.kwargs["type"])
+        elif default is False and "action" not in self.kwargs:
+            self.kwargs["action"] = "store_true"
+        self.default = default
+
+        if default is not None and not (default is False and self.kwargs.get("action") == "store_true"):
+            if "help" not in self.kwargs:
+                self.kwargs["help"] = ""
+            self.kwargs["help"] += " (default: %r)" % default
+
+    def attach(self, parser: argparse.ArgumentParser):
+        self._prepare()
+        arg = parser.add_argument(*self.args, **self.kwargs)
+        self.dest = arg.dest
+
+
+class ArgGroup:
+    """
+    Контейнер для нескольких аргументов.
+    Класс служит для описания набора аргументов, а экземляр - для хранения значений.
+
+    Пример:
+    class Group1(ArgGroup):
+        in = Arg("--in")
+        out = Arg("--out")
+
+    values = Group1(in="/dev/null", out="/dev/null")
+    open(values.in)
+    """
+    def __init__(self, *args, **kwargs):
+        """
+        В kwargs - пары ключ-значение. Соотвествующие опции должны быть объявлены в классе
+        """
+        keys = {arg_name: arg.default for arg_name, arg in self._enum_args().items()}
+        for src_obj in args:
+            for opt, val in vars(src_obj).items():
+                if opt in keys:
+                    keys[opt] = val
+        for opt, val in kwargs.items():
+            if opt in keys:
+                keys[opt] = val
+            else:
+                raise TypeError("Unknown argument %r for %s" % (opt, type(self).__qualname__))
+        self.__dict__.update(keys)
+
+    @classmethod
+    @lru_cache()
+    def _enum_args(cls) -> Dict[str, Arg]:
+        ret = {}
+        for base in cls.__mro__:
+            for name, value in vars(base).items():
+                if not name.startswith("_") and isinstance(value, Arg):
+                    ret[name] = value
+        return ret
+
+    @classmethod
+    def attach(cls, parser: argparse.ArgumentParser):
+        for arg in cls._enum_args().values():
+            arg.attach(parser)
+
+    @classmethod
+    def construct_from(cls, ns: argparse.Namespace) -> "ArgGroup":
+        kwargs = {}
+        for arg_name, arg in cls._enum_args().items():
+            kwargs[arg_name] = getattr(ns, arg.dest)
+        return cls(**kwargs)
+
+    @classmethod
+    def copy_from(cls, other: "ArgGroup", **more_kwargs) -> "ArgGroup":
+        kwargs = {}
+        for arg_name in cls._enum_args():
+            try:
+                kwargs[arg_name] = getattr(other, arg_name)
+            except AttributeError:
+                pass
+
+        kwargs.update(more_kwargs)
+        return cls(**kwargs)
+
+    def __repr__(self):
+        return "%(classname)s(%(params)s)" % dict(
+            classname=type(self).__qualname__,
+            params=", ".join(
+                "%s=%r" % (key, getattr(self, key))
+                for key in sorted(self._enum_args())
+            )
+        )
+
+    def stdin(self, **kwargs):
+        ret = {}
+        stdin_used = False
+        for arg, val in kwargs.items():
+            if val == "-":
+                if stdin_used:
+                    raise ValueError("stdin can not be used twice")
+                self.validate_stdin(arg, val, **kwargs.copy())
+                ret[arg] = _read_stdin_once()
+                stdin_used = True
+            else:
+                ret[arg] = None
+        return ret
+
+    def validate_stdin(self, arg, val, **kwargs):
+        pass
+
+
+class _HelpFormatter(argparse.HelpFormatter):
+    def __init__(self, *args, **kwargs):
+        kwargs["width"] = self._get_term_width()
+        super().__init__(*args, **kwargs)
+
+    @staticmethod
+    def _get_term_width():
+        try:
+            return int(os.environ["COLUMNS"])
+        except (KeyError, ValueError):
+            try:
+                return os.get_terminal_size(sys.stdout.fileno()).columns
+            except OSError:
+                return None
+
+
+class ArgDispatcher(abc.ABC):
+    @abc.abstractmethod
+    def setup(self) -> ContextManager[None]:
+        pass
+
+    @abc.abstractmethod
+    def exec(self) -> ContextManager[None]:
+        pass
+
+    @abc.abstractmethod
+    def pre_call(self) -> ContextManager[None]:
+        pass
+
+    @contextlib.contextmanager
+    def func_opts(self, arg: Union[Arg, Type[ArgGroup]]) -> ContextManager[None]:
+        pass
+
+    @abc.abstractmethod
+    def func(self, ns: argparse.Namespace) -> ContextManager[None]:
+        pass
+
+
+class NullArgDispatcher(ArgDispatcher):
+    @contextlib.contextmanager
+    def setup(self) -> Iterator[None]:
+        yield
+
+    @contextlib.contextmanager
+    def exec(self) -> ContextManager[None]:
+        yield
+
+    @contextlib.contextmanager
+    def pre_call(self) -> ContextManager[None]:
+        yield
+
+    @contextlib.contextmanager
+    def func_opts(self, arg: Union[Arg, Type[ArgGroup]]) -> ContextManager[None]:
+        yield
+
+    @contextlib.contextmanager
+    def func(self, ns: argparse.Namespace) -> ContextManager[None]:
+        yield
+
+
+class _DispatcherConnector(Connector[ArgDispatcher]):
+    name = "Dispatcher"
+    ep_name = "dispatcher"
+
+    def _get_default(self) -> Type["ArgDispatcher"]:
+        return NullArgDispatcher
+
+
+dispatcher_connector = _DispatcherConnector()
+
+
+class ArgParser(argparse.ArgumentParser):
+    def __init__(self, *args, **kwargs):
+        if "formatter_class" not in kwargs:
+            kwargs["formatter_class"] = _HelpFormatter
+        super().__init__(*args, **kwargs)
+        self._dispatcher: ArgDispatcher = dispatcher_connector.get()
+
+    def argv(self):
+        return sys.argv[1:]
+
+    def add_commands(self, commands: Iterable[Callable]):
+        subparsers = self.add_subparsers()
+        commands = list(commands)
+        failcount = 0
+        while commands and failcount < len(commands):
+            func, commands = commands[0], commands[1:]
+            if not self.add_func(func, subparsers):
+                commands.append(func)
+                failcount += 1
+            else:
+                failcount = 0
+        if failcount:
+            raise RuntimeError("Failed to resolve subparsers")
+
+    def add_func(self, func, sub):
+        meta = _get_meta(func)
+        parent = meta.parent
+        if parent:
+            parent_meta = _get_meta(parent)
+            if not parent_meta.parser:
+                return False
+            if not parent_meta.sub:
+                parent_meta.sub = parent_meta.parser.add_subparsers()
+            sub = parent_meta.sub
+
+        sp = sub.add_parser(meta.cmd_name, help=func.__doc__)
+        sp.set_defaults(func=func)
+        meta.parser = sp
+
+        for arg in self.func_opts(func):
+            arg.attach(sp)
+        return True
+
+    def set_dispatcher(self, dispatcher: ArgDispatcher) -> None:
+        self._dispatcher = dispatcher
+
+    def dispatch(self, pre_call=None, add_help_command=False):
+        with self._dispatcher.setup():
+            with self._dispatcher.exec():
+                argv = self.argv()
+                if add_help_command and argv and argv[0] == "help":
+                    argv.pop(0)
+                    argv.append("--help")
+
+                # show usage in cache when no options specified
+                if not argv:
+                    argv = [""]
+
+                ns = self.parse_args(argv)
+                assert ns.func
+                if pre_call:
+                    with self._dispatcher.pre_call():
+                        pre_call(ns)
+
+                values = []
+                for arg in self.func_opts(ns.func):
+                    with self._dispatcher.func_opts(arg):
+                        if isinstance(arg, Arg):
+                            values.append(getattr(ns, arg.dest))
+                        else:
+                            # arg is a ArgGroup-derived type
+                            values.append(arg.construct_from(ns))
+
+                with self._dispatcher.func(ns):
+                    return ns.func(*values)
+
+    @staticmethod
+    def find_subcommands(variables):
+        for var in variables.values():
+            if callable(var) and hasattr(var, _ARGS_ATTR_NAME):
+                yield var
+
+    @classmethod
+    def func_opts(cls, func):
+        yield from _get_meta(func).opts
+
+
+def subcommand(*arg_list: Union[Arg, Type[ArgGroup]], parent: Callable = None):
+    """
+    декоратор, задающий cli-аргументы подпрограммы
+
+    Пример:
+    @subcommand(Arg(), ArgGroup)
+    def cmd1(arg1, arg2):
+        pass
+
+    Связь аргументов происходит только по порядковому номеру, каждый аргумент subcommand становится аргументом функции.
+    Функция вызывается только с позиционными аргументами, всегда с одним и тем же количеством аргументов.
+
+    Для создания более одного уровня команд используeтся агрумент parent
+
+    Пример: 'ann some thing' - вызовет some_thing()
+
+    @subcommand()
+    def some():
+        pass
+
+
+    @subcommand(parent=some)
+    def some_thing():
+        pass
+    """
+    def _amend_func(func):
+        meta = _get_meta(func)
+        cmd_name = func.__name__
+        if parent:
+            parentprefix = parent.__name__ + "_"
+            if cmd_name.startswith(parentprefix):
+                cmd_name = cmd_name[len(parentprefix):]
+            meta.parent = parent
+
+        meta.cmd_name = cmd_name.replace("_", "-").lower()
+        meta.opts.extend(arg_list)
+        return func
+    return _amend_func
+
+
+@functools.lru_cache()
+def _read_stdin_once():
+    return sys.stdin.read()

annet/cli.py

@@ -0,0 +1,192 @@
+import argparse
+import operator
+import os
+import platform
+import subprocess
+import shutil
+from typing import Generator, Tuple
+
+import yaml
+from contextlog import get_logger
+from valkit.python import valid_logging_level
+
+from annet import api, cli_args, filtering
+from annet.api import collapse_texts
+from annet.argparse import ArgParser, subcommand
+from annet.diff import gen_sort_diff
+from annet.gen import Loader, old_raw
+from annet.lib import get_context_path, repair_context_file
+from annet.output import output_driver_connector
+from annet.storage import Storage, storage_connector
+
+
+def fill_base_args(parser: ArgParser, pkg_name: str, logging_config: str):
+    parser.add_argument("--log-level", default="WARN", type=valid_logging_level,
+                        help="Уровень детализации логов (DEBUG, DEBUG2 (with comocutor debug), INFO, WARN, CRITICAL)")
+    parser.add_argument("--pkg_name", default=pkg_name, help=argparse.SUPPRESS)
+    parser.add_argument("--logging_config", default=logging_config, help=argparse.SUPPRESS)
+
+
+def list_subcommands():
+    return globals().copy()
+
+
+@subcommand(cli_args.QueryOptions, cli_args.opt_config, cli_args.FileOutOptions)
+def show_current(args: cli_args.QueryOptions, config, arg_out: cli_args.FileOutOptions) -> None:
+    """ Показать текущий конфиг устройств """
+
+    def _gen_items(storage: Storage) -> Generator[Tuple[str, str, bool], None, None]:
+        for device, result in old_raw(
+            cli_args.GenOptions(args, no_acl=True),
+            storage,
+            config,
+            stdin=args.stdin(storage=storage, config=config),
+            do_files_download=True,
+            use_mesh=False,
+        ):
+            output_driver = output_driver_connector.get()
+            destname = output_driver.cfg_file_names(device)[0]
+            if device.hw.vendor != "pc":
+                yield (destname, result, False)
+            else:
+                for entire_path, entire_data in sorted(result.items(), key=operator.itemgetter(0)):
+                    if entire_data is None:
+                        entire_data = ""
+                    yield (output_driver.entire_config_dest_path(device, entire_path), entire_data, False)
+
+    with storage_connector.get().storage()(args) as storage:
+        ids = storage.resolve_object_ids_by_query(args.query)
+        if not ids:
+            get_logger().error("No devices found for %s", args.query)
+        output_driver_connector.get().write_output(arg_out, _gen_items(storage), len(ids))
+
+
+@subcommand(cli_args.ShowGenOptions)
+def gen(args: cli_args.ShowGenOptions):
+    """ Сгенерировать конфиг для устройств """
+    (success, fail) = api.gen(args)
+    out = [item for items in success.values() for item in items]
+    output_driver = output_driver_connector.get()
+    if args.dest is None:
+        text_mapping = {item[0]: item[1] for item in out}
+        out = [(",".join(key), value, False) for key, value in collapse_texts(text_mapping).items()]
+    out.extend(output_driver.format_fails(fail, args))
+    total = len(success) + len(fail)
+    if not total:
+        get_logger().error("No devices found for %s", args.query)
+    output_driver.write_output(args, out, total)
+
+
+@subcommand(cli_args.ShowDiffOptions)
+def diff(args: cli_args.ShowDiffOptions):
+    """ Сгенерировать конфиг для устройств и показать дифф по рулбуку с текущим """
+    with storage_connector.get().storage()(args) as storage:
+        filterer = filtering.filterer_connector.get()
+        loader = Loader(storage, args)
+        output_driver_connector.get().write_output(
+            args,
+            gen_sort_diff(api.diff(args, loader, filterer), args),
+            len(loader.device_ids)
+        )
+
+
+@subcommand(cli_args.ShowPatchOptions)
+def patch(args: cli_args.ShowPatchOptions):
+    """ Сгенерировать конфиг для устройств и сформировать патч """
+    (success, fail) = api.patch(args)
+    out = [item for items in success.values() for item in items]
+    output_driver = output_driver_connector.get()
+    out.extend(output_driver.format_fails(fail, args))
+    total = len(success) + len(fail)
+    if not total:
+        get_logger().error("No devices found for %s", args.query)
+    output_driver.write_output(args, out, total)
+
+
+@subcommand(cli_args.DeployOptions)
+def deploy(args: cli_args.DeployOptions):
+    """ Сгенерировать конфиг для устройств и задеплоить его """
+    return api.deploy(args)
+
+
+@subcommand(cli_args.FileDiffOptions)
+def file_diff(args: cli_args.FileDiffOptions):
+    """ Показать дифф по рулбуку между файлами или каталогами """
+    (success, fail) = api.file_diff(args)
+    out = []
+    output_driver = output_driver_connector.get()
+    if not args.fails_only:
+        out.extend(item for items in success.values() for item in items)
+    out.extend(output_driver.format_fails(fail))
+    # todo отрефакторить логику с отображением хоста в диффе: передавать в write_output явно критерий
+    output_driver.write_output(args, out, len(out) + 1)
+
+
+@subcommand(cli_args.FilePatchOptions)
+def file_patch(args: cli_args.FilePatchOptions):
+    """ Сформировать патч для файлов или каталогов """
+    (success, fail) = api.file_patch(args)
+    out = []
+    output_driver = output_driver_connector.get()
+    if not args.fails_only:
+        out.extend(item for items in success.values() for item in items)
+    out.extend(output_driver.format_fails(fail))
+    output_driver.write_output(args, out, len(out))
+
+
+@subcommand()
+def context():
+    """ Операции для управления файлом контекста.
+
+    По-умолчанию находится в '~/.annushka/context.yml', либо по пути в переменной окружения ANN_CONTEXT_CONFIG_PATH.
+    """
+    context_touch()
+
+
+@subcommand(parent=context)
+def context_touch():
+    """ Вывести путь к файлу контекста и, при отсутствии, создать его и наполнить данными (команда по-умолчанию) """
+    print(get_context_path(touch=True))
+
+
+@subcommand(cli_args.SelectContext, parent=context)
+def context_set_context(args: cli_args.SelectContext):
+    """ Задать текущий активный контекст по имени в конфигурации
+
+    Выбранный контекст будет использоваться по-умолчанию при незаданной переменной окружения ANN_SELECTED_CONTEXT
+    """
+    with open(path := get_context_path(touch=True)) as f:
+        data = yaml.safe_load(f)
+    if args.context_name not in data.get("context", {}):
+        raise KeyError(f"Cannot select context with name '{args.context_name}'. "
+                       f"Available options are: {list(data.get('context', []))}")
+    data["selected_context"] = args.context_name
+    with open(path, "w") as f:
+        yaml.dump(data, f, sort_keys=False)
+
+
+@subcommand(parent=context)
+def context_edit():
+    """ Открыть файл конфигурации контекста в редакторе из переменной окружения EDITOR
+
+    Если переменная окружения EDITOR не задана,
+    для Windows пытаемся открыть файл средствами ОС, для остальных случаев пытаемся открыть в vi
+    """
+    editor = ""
+    if e := os.getenv("EDITOR"):
+        editor = e
+    elif platform.system() == "Windows":
+        editor = "notepad.exe"
+    elif shutil.which("vim"):
+        editor = "vim"
+    else:
+        editor = "vi"
+    path = get_context_path(touch=True)
+    proc = subprocess.Popen([editor, path])
+    proc.wait()
+
+
+@subcommand(parent=context)
+def context_repair():
+    """ Попытаться исправить расхождения в формате файла контекста после изменении версии """
+    repair_context_file()