annet 0.14.7__py3-none-any.whl → 0.14.9__py3-none-any.whl

annet/adapters/netbox/common/manufacturer.py

@@ -25,8 +25,6 @@ def get_hw(manufacturer: str, model: str, platform_name: str):
         model = model.replace("MSN", "SN", 1)
     vendor = manufacturer + " " + model
     hw = HardwareView(_VENDORS.get(vendor.lower(), vendor), platform_name)
-    if not hw:
-        raise ValueError(f"unsupported manufacturer {manufacturer}")
     return hw
 
 
@@ -47,13 +45,4 @@ def get_breed(manufacturer: str, model: str):
         return "adva8"
     elif manufacturer == "Arista":
         return "eos4"
-    raise ValueError(f"unsupported manufacturer {manufacturer}")
-
-
-def is_supported(manufacturer: str) -> bool:
-    if manufacturer not in (
-            "Huawei", "Mellanox", "Juniper", "Cisco", "Adva", "Arista",
-    ):
-        logger.warning("Unsupported manufacturer `%s`", manufacturer)
-        return False
-    return True
+    return ""

annet/adapters/netbox/common/models.py

@@ -2,15 +2,20 @@ from dataclasses import dataclass, field
 from datetime import datetime
 from typing import List, Optional, Any, Dict
 
+from annet.annlib.netdev.views.dump import DumpableView
 from annet.annlib.netdev.views.hardware import HardwareView
 from annet.storage import Storage
 
 
 @dataclass
-class Entity:
+class Entity(DumpableView):
     id: int
     name: str
 
+    @property
+    def _dump__list_key(self):
+        return self.name
+
 
 @dataclass
 class Label:
@@ -32,15 +37,19 @@ class DeviceType:
 
 
 @dataclass
-class DeviceIp:
+class DeviceIp(DumpableView):
     id: int
     display: str
     address: str
     family: int
 
+    @property
+    def _dump__list_key(self):
+        return self.address
+
 
 @dataclass
-class Prefix:
+class Prefix(DumpableView):
     id: int
     prefix: str
     site: Entity | None
@@ -55,9 +64,13 @@ class Prefix:
     last_updated: datetime
     description: str | None = ""
 
+    @property
+    def _dump__list_key(self):
+        return self.prefix
+
 
 @dataclass
-class IpAddress:
+class IpAddress(DumpableView):
     id: int
     assigned_object_id: int
     display: str
@@ -70,6 +83,10 @@ class IpAddress:
     prefix: Optional[Prefix] = None
     vrf: Optional[Entity] = None
 
+    @property
+    def _dump__list_key(self):
+        return self.address
+
 
 @dataclass
 class InterfaceConnectedEndpoint(Entity):

annet/adapters/netbox/v24/storage.py

@@ -6,10 +6,11 @@ from annetbox.v24.client_sync import NetboxV24
 
 from annet.adapters.netbox.common import models
 from annet.adapters.netbox.common.manufacturer import (
-    is_supported, get_hw, get_breed,
+   get_hw, get_breed,
 )
 from annet.adapters.netbox.common.query import NetboxQuery
 from annet.adapters.netbox.common.storage_opts import NetboxStorageOpts
+from annet.annlib.netdev.views.hardware import HardwareView
 from annet.storage import Storage
 
 logger = getLogger(__name__)
@@ -162,7 +163,6 @@ class NetboxStorageV24(Storage):
             device
             for device in self.netbox.dcim_all_devices().results
             if _match_query(query, device)
-            if is_supported(device.device_type.manufacturer.name)
         ]
 
     def _load_interfaces(self, device_ids: List[int]) -> List[

annet/adapters/netbox/v37/storage.py

@@ -10,7 +10,7 @@ from annetbox.v37.client_sync import NetboxV37
 
 from annet.adapters.netbox.common import models
 from annet.adapters.netbox.common.manufacturer import (
-    is_supported, get_hw, get_breed,
+    get_hw, get_breed,
 )
 from annet.adapters.netbox.common.query import NetboxQuery
 from annet.adapters.netbox.common.storage_opts import NetboxStorageOpts
@@ -43,20 +43,25 @@ def extend_device(
         storage: Storage,
 ) -> models.NetboxDevice:
     platform_name: str = ""
+    breed: str = ""
+    hw = HardwareView("", "")
     if device.platform:
         platform_name = device.platform.name
-    res = extend_device_base(
-        device=device,
-        interfaces=interfaces,
-        breed=get_breed(
+    if device.device_type and device.device_type.manufacturer:
+        breed = get_breed(
             device.device_type.manufacturer.name,
             device.device_type.model,
-        ),
-        hw=get_hw(
+        )
+        hw = get_hw(
             device.device_type.manufacturer.name,
             device.device_type.model,
             platform_name,
-        ),
+        )
+    res = extend_device_base(
+        device=device,
+        interfaces=interfaces,
+        breed=breed,
+        hw=hw,
         storage=storage,
     )
     res.neighbours = neighbours
@@ -146,7 +151,6 @@ class NetboxStorageV37(Storage):
                 name__ic=query.globs,
             ).results
             if _match_query(query, device)
-            if is_supported(device.device_type.manufacturer.name)
         ]
 
     def _extend_interfaces(self, interfaces: List[models.Interface]) -> List[models.Interface]:

annet/annlib/netdev/views/dump.py

@@ -73,6 +73,14 @@ class DumpableView:
 
         if isinstance(value, DumpableView):
             ret += value.dump(prefix, seen=seen)  # pylint: disable=no-member
+        elif isinstance(value, dict):
+            for k, v in value.items():
+                ret.extend(self.__dump_value(f"{prefix}[{repr(k)}]", v, seen))
+        elif isinstance(value, (list, tuple)):
+            for i, v in enumerate(value):
+                name = getattr(v, "_dump__list_key", None)
+                name = repr(name) if name is not None else str(i)
+                ret.extend(self.__dump_value(f"{prefix}[{name}]", v, seen))
         else:
             fmt = repr(value)
             vtype = type(value)

annet/argparse.py

@@ -370,7 +370,7 @@ class ArgParser(argparse.ArgumentParser):
         yield from _get_meta(func).opts
 
 
-def subcommand(*arg_list: Union[Arg, Type[ArgGroup]], parent: Callable = None):
+def subcommand(*arg_list: Union[Arg, Type[ArgGroup]], parent: Callable = None, is_group: bool = False):
     """
     декоратор, задающий cli-аргументы подпрограммы
 
@@ -382,7 +382,7 @@ def subcommand(*arg_list: Union[Arg, Type[ArgGroup]], parent: Callable = None):
     Связь аргументов происходит только по порядковому номеру, каждый аргумент subcommand становится аргументом функции.
     Функция вызывается только с позиционными аргументами, всегда с одним и тем же количеством аргументов.
 
-    Для создания более одного уровня команд используeтся агрумент parent
+    Для создания более одного уровня команд используется аргумент parent
 
     Пример: 'ann some thing' - вызовет some_thing()
 
@@ -397,6 +397,10 @@ def subcommand(*arg_list: Union[Arg, Type[ArgGroup]], parent: Callable = None):
     """
     def _amend_func(func):
         meta = _get_meta(func)
+        if is_group:
+            @functools.wraps(func)
+            def func():
+                meta.parser.print_help()
         cmd_name = func.__name__
         if parent:
             parentprefix = parent.__name__ + "_"

annet/cli.py

@@ -70,9 +70,15 @@ def get_loader(gen_args: cli_args.GenOptions, args: cli_args.QueryOptions):
         yield Loader(*storages, args=gen_args)
 
 
-@subcommand(cli_args.QueryOptions, cli_args.opt_config, cli_args.FileOutOptions)
+@subcommand(is_group=True)
+def show():
+    """ A group of commands for showing parameters/configurations/data from deivces and data sources """
+    pass
+
+
+@subcommand(cli_args.QueryOptions, cli_args.opt_config, cli_args.FileOutOptions, parent=show)
 def show_current(args: cli_args.QueryOptions, config, arg_out: cli_args.FileOutOptions) -> None:
-    """ Показать текущий конфиг устройств """
+    """ Show current devices' configuration """
     gen_args = cli_args.GenOptions(args, no_acl=True)
     output_driver = output_driver_connector.get()
     with get_loader(gen_args, args) as loader:
@@ -89,9 +95,34 @@ def show_current(args: cli_args.QueryOptions, config, arg_out: cli_args.FileOutO
         output_driver.write_output(arg_out, items, len(loader.devices))
 
 
+@subcommand(cli_args.QueryOptions, cli_args.FileOutOptions, parent=show)
+def show_device_dump(args: cli_args.QueryOptions, arg_out: cli_args.FileOutOptions):
+    """ Show a dump of network devices' structure """
+    def _show_device_dump_items(devices):
+        for device in devices:
+            get_logger(host=device.hostname)  # add hostname into context
+            if hasattr(device, "dump"):
+                yield (
+                    device.hostname,
+                    "\n".join(device.dump("device")),
+                    False,
+                )
+            else:
+                get_logger().warning("method `dump` not implemented for %s", type(device))
+    arg_gens = cli_args.GenOptions(arg_out, args)
+    with get_loader(arg_gens, args) as loader:
+        if not loader.devices:
+            get_logger().error("No devices found for %s", args.query)
+        output_driver_connector.get().write_output(
+            arg_out,
+            _show_device_dump_items(loader.devices),
+            len(loader.device_ids),
+        )
+
+
 @subcommand(cli_args.ShowGenOptions)
 def gen(args: cli_args.ShowGenOptions):
-    """ Сгенерировать конфиг для устройств """
+    """ Generate configuration for devices """
     with get_loader(args, args) as loader:
         (success, fail) = api.gen(args, loader)
 
@@ -110,7 +141,7 @@ def gen(args: cli_args.ShowGenOptions):
 
 @subcommand(cli_args.ShowDiffOptions)
 def diff(args: cli_args.ShowDiffOptions):
-    """ Сгенерировать конфиг для устройств и показать дифф по рулбуку с текущим """
+    """ Generate configuration for devices and show a diff with current configuration using the rulebook """
     with get_loader(args, args) as loader:
         filterer = filtering.filterer_connector.get()
         device_ids = loader.device_ids
@@ -123,7 +154,7 @@ def diff(args: cli_args.ShowDiffOptions):
 
 @subcommand(cli_args.ShowPatchOptions)
 def patch(args: cli_args.ShowPatchOptions):
-    """ Сгенерировать конфиг для устройств и сформировать патч """
+    """ Generate configuration patch for devices """
     with get_loader(args, args) as loader:
         (success, fail) = api.patch(args, loader)
 
@@ -138,7 +169,7 @@ def patch(args: cli_args.ShowPatchOptions):
 
 @subcommand(cli_args.DeployOptions)
 def deploy(args: cli_args.DeployOptions):
-    """ Сгенерировать конфиг для устройств и задеплоить его """
+    """ Generate and deploy configuration for devices """
 
     deployer = Deployer(args)
     filterer = filtering.filterer_connector.get()
@@ -155,7 +186,7 @@ def deploy(args: cli_args.DeployOptions):
 
 @subcommand(cli_args.FileDiffOptions)
 def file_diff(args: cli_args.FileDiffOptions):
-    """ Показать дифф по рулбуку между файлами или каталогами """
+    """ Generate a diff between files or directories using the rulebook """
     (success, fail) = api.file_diff(args)
     out = []
     output_driver = output_driver_connector.get()
@@ -168,7 +199,7 @@ def file_diff(args: cli_args.FileDiffOptions):
 
 @subcommand(cli_args.FilePatchOptions)
 def file_patch(args: cli_args.FilePatchOptions):
-    """ Сформировать патч для файлов или каталогов """
+    """ Generate configuration patch for files or directories """
     (success, fail) = api.file_patch(args)
     out = []
     output_driver = output_driver_connector.get()
@@ -178,26 +209,27 @@ def file_patch(args: cli_args.FilePatchOptions):
     output_driver.write_output(args, out, len(out))
 
 
-@subcommand()
+@subcommand(is_group=True)
 def context():
-    """ Операции для управления файлом контекста.
+    """ A group of commands for manipulating context.
 
-    По-умолчанию находится в '~/.annushka/context.yml', либо по пути в переменной окружения ANN_CONTEXT_CONFIG_PATH.
+    By default, the context file is located in '~/.annushka/context.yml',
+    but it can be set with the ANN_CONTEXT_CONFIG_PATH environment variable.
     """
     context_touch()
 
 
 @subcommand(parent=context)
 def context_touch():
-    """ Вывести путь к файлу контекста и, при отсутствии, создать его и наполнить данными (команда по-умолчанию) """
+    """ Show the context file path, and if the file is not present, create it with the default configuration """
     print(get_context_path(touch=True))
 
 
 @subcommand(cli_args.SelectContext, parent=context)
 def context_set_context(args: cli_args.SelectContext):
-    """ Задать текущий активный контекст по имени в конфигурации
+    """ Set the current active context.
 
-    Выбранный контекст будет использоваться по-умолчанию при незаданной переменной окружения ANN_SELECTED_CONTEXT
+    The selected context is used by default unless the environment variable ANN_SELECTED_CONTEXT is set
     """
     with open(path := get_context_path(touch=True)) as f:
         data = yaml.safe_load(f)
@@ -211,12 +243,10 @@ def context_set_context(args: cli_args.SelectContext):
 
 @subcommand(parent=context)
 def context_edit():
-    """ Открыть файл конфигурации контекста в редакторе из переменной окружения EDITOR
+    """ Open the context file using an editor from the EDITOR environment variable.
 
-    Если переменная окружения EDITOR не задана,
-    для Windows пытаемся открыть файл средствами ОС, для остальных случаев пытаемся открыть в vi
+    If the EDITOR variable is not set, default variables are: "notepad.exe" for Windows and "vi" otherwise
     """
-    editor = ""
     if e := os.getenv("EDITOR"):
         editor = e
     elif platform.system() == "Windows":
@@ -232,5 +262,5 @@ def context_edit():
 
 @subcommand(parent=context)
 def context_repair():
-    """ Попытаться исправить расхождения в формате файла контекста после изменении версии """
+    """ Try to fix the context file's structure if it was generated for the older versions of annet """
     repair_context_file()

annet/cli_args.py

@@ -49,8 +49,7 @@ def valid_range(value: str):
 def opt_query_factory(**kwargs):
     return Arg(
         "query",
-        help="Запрос, определяющий список устройств. Принимается fqdn, rackcode, глоб"
-             " или путь к файлу со списком запросов (нужно писать @path/to/file)",
+        help="A query that defines a list of devices. The query's format depends on a selected storage adapter",
         **kwargs,
     )
 
@@ -62,47 +61,47 @@ opt_query_optional = opt_query_factory(nargs="*", default=[])
 
 opt_dest = Arg(
     "--dest", type=convert_to_none,
-    help="Файл или каталог для вывода сгенерированных данных"
+    help="A file or a directory to output the generated data to"
 )
 
 opt_expand_path = Arg(
     "--expand-path", default=False,
-    help="Разворачивать пути entire-генераторов при записи их на файловую систему"
+    help="Use full paths of Entire-generators and no just names when writing them to the file system"
 )
 
 opt_old = Arg(
     "old",
-    help="Файл со старым конфигом (или каталог с пачкой)"
+    help="A path to a file (or a directory with a batch of files) that contains the old config"
 )
 
 opt_new = Arg(
     "new",
-    help="Файл с новым конфигом (или каталог с пачкой)"
+    help="A path to a file (or a directory with a batch of files) that contains the new config"
 )
 
 opt_hw = Arg(
     "--hw", default="", type=valid_vendor,
-    help="Производитель устройства (например Huawei или Cisco) или полное название модели. Если его нет - пытаемся его задетектить"
+    help="Device's vendor (Huawei/Cisco/...) or model name. If left empty, annet will try to detect it automatically"
 )
 
 opt_indent = Arg(
     "--indent", default="  ",
-    help="Отступ при форматировании блоков"
+    help="Symbols to indent blocks with"
 )
 
 opt_allowed_gens = Arg(
     "-g", "--allowed-gens", type=valid_string_list,
-    help="Список классов генераторов через запятую, которые нужно запустить"
+    help="Comma-separated list of generator classes or tags to run"
 )
 
 opt_excluded_gens = Arg(
     "-G", "--excluded-gens", type=valid_string_list,
-    help="Список классов генераторов через запятую, запуск которых следует исключить"
+    help="Comma-separated list of generator classes or tags to skip"
 )
 
 opt_force_enabled = Arg(
     "--force-enabled", type=valid_string_list,
-    help="Список классов генераторов через запятую, которые не нужно считать DISABLED даже при наличии тега"
+    help="Comma-separated list of generator classes or tags, for which the DISABLED tag should be ignored"
 )
 
 opt_generators_context = Arg(
@@ -112,27 +111,27 @@ opt_generators_context = Arg(
 
 opt_no_acl = Arg(
     "--no-acl", default=False,
-    help="Отключение ACL при генерации"
+    help="Disable ACL for config generation"
 )
 
 opt_no_acl_exclusive = Arg(
     "--no-acl-exclusive", default=False,
-    help="Проверяем что ACL выполненных генераторов не пересекаются"
+    help="Check that ACLs of the executed generators do not intersect"
 )
 
 opt_acl_safe = Arg(
     "--acl-safe", default=False,
-    help="Использовать более строгий safe acl для фильтрации результата генерации"
+    help="Use stricter safe acl for filtering generation results"
 )
 
 opt_show_rules = Arg(
     "--show-rules", default=False,
-    help="Показывать правила rulebook при выводе диффа"
+    help="Show rulebook rules when showing the diff"
 )
 
 opt_tolerate_fails = Arg(
     "--tolerate-fails", default=False,
-    help="Рапортовать об ошибках без остановки генерации"
+    help="Show errors without interrupting the generation"
 )
 
 # При параллельном запуске и включённом --tolerate-fails код возврата
@@ -147,136 +146,135 @@ opt_strict_exit_code = Arg(
 
 opt_required_packages_check = Arg(
     "--required-packages-check", default=False,
-    help="Включить проверку наличия установленных deb-пакетов для Entire-генераторов"
+    help="Check that the deb-packages, required for the Entire-generators, are installed"
 )
 
 opt_profile = Arg(
     "--profile", default=False,
-    help="Показать в stderr время, затраченное на работу генераторов и обращениям к RackTables"
+    help="Print time spent by generators and inventory requests to stderr"
 )
 
 
 opt_parallel = Arg(
     "-P", "--parallel", type=int, default=1,
-    help="Количество одновременных потоков генерирования"
+    help="An amount of threads/processes to use as defined in a configured connector"
 )
 
 opt_max_tasks = Arg(
     "--max-tasks", type=int, default=None,
-    help="Рестартовать воркеры каждые N устройств, для сброса кеша и ограничения потребления памяти"
-         "По умолчанию - не рестартовать"
+    help="Maximum consecutive tasks to run in a worker before restarting it to clear memory and cache. "
+         "Defaults to infinity"
 )
 
 opt_annotate = Arg(
     "--annotate", default=False,
-    help="Добавить к сгенерированному конфигу комментарии о том откуда строчка взялась"
+    help="Annotate configuration lines to show their sources"
 )
 
 opt_config = Arg(
     "--config", default="running", type=valid_config_source,
-    help="'running', 'empty', путь к файлу конфига, "
-         "каталогу с файлами конфига в формате <hostname>.cfg "
-         "или '-' (stdin)"
+    help="'running', 'empty', path to a config file or "
+         "a directory with config files <hostname>.cfg "
+         "or '-' (stdin)"
 )
 
 opt_clear = Arg(
     "--clear", default=False,
-    help="Используя acl вычищает команды относящиеся к данному генератору, "
-         "аналогично использованию return в самом начале генератора"
+    help="Remove the generator's commands using its ACL "
 )
 
 opt_filter_acl = Arg(
     "--filter-acl", default="",
-    help="путь к файлу с дополнительным фильтрующим acl, или '-' (stdin)"
+    help="Additional ACL file path or '-' (stdin)"
 )
 
 opt_filter_ifaces = Arg(
     "-i", "--filter-ifaces", default=[], type=valid_string_list,
-    help="Генерирует filter-acl по имени интерфейса. "
-         "Принимает регекспы, через запятую: '-i 10GE,100GE'. "
-         "По-умолчанию добавляет '.*' к концу каждого. "
-         "Для указания имени точно, следует добавлять '$': '-i ae0$'. "
-         "Если filter-acl передан напрямую, данная опция игнорируется."
+    help="Additional filter-acl using interface name. "
+         "Accepts comma-separated regular expressions: '-i 10GE,100GE'. "
+         "Appends '.*' at the end of every item "
+         "One can use '$' for an exact match: '-i ae0$'. "
+         "If filter-acl is passed directly, this option is ignored."
 )
 
 opt_filter_peers = Arg(
     "-fp", "--filter-peers", default=[], type=valid_string_list,
-    help="Генерирует filter-acl по адресу/имени группы/дескрипшену пира."
+    help="Generates filter-acl using an address or name of a peer's group or description."
 )
 
 opt_filter_policies = Arg(
     "-frp", "--filter-policies", default=[], type=valid_string_list,
-    help="Генерирует filter-acl по названию политик, название должно строго соответствовать, частичные имена не пройдут"
+    help="Generates filter-acl using policies' names. The match has to be exact"
 )
 
 opt_ask_pass = Arg(
     "--ask-pass", default=False,
-    help="Спросить пароль на подключение"
+    help="Ask for a password when connecting"
 )
 
 opt_no_ask_deploy = Arg(
     "--no-ask-deploy", default=False,
-    help="Не подтвеждать команды перед выполнением"
+    help="Do not ask for confirmation on commands execution"
 )
 
 opt_no_progress = Arg(
     "--no-progress", default=False,
-    help="Выключить графику прогресс баров комокутора"
+    help="Do not show deployment progress bars"
 )
 
 opt_log_json = Arg(
     "--log-json", default=False,
-    help="Логгировать в формате json (default: plain text)"
+    help="Show logs in json format (default: plain text)"
 )
 
 opt_log_dest = Arg(
     "--log-dest", default="deploy/",
-    help="Логгировать в указанный файл/директорию, или в stdout, если указать '-'"
+    help="Log to a specified file, directory, or '-' (stdout)"
 )
 
 opt_log_nogroup = Arg(
     "--log-nogroup", default=False,
-    help="Не создавать в директории LOG-DEST поддиректории DATE_TIME/"
+    help="Do not create DATE_TIME/ subdirectories in the LOG-DEST directory"
 )
 
 opt_max_slots = Arg(
     "--max-slots", default=30, type=int,
-    help="Количество одновременно обрабатываемых asyncio устройств"
+    help="The amount of devices parsed at the same time with asyncio"
 )
 
 opt_hosts_range = Arg(
     "--hosts-range", type=valid_range,
-    help="Обработать только указанный диапазон хостов. 10 - первые 10. 10:20 - хосты с 10-го по 20-ый"
+    help="Only work with the specified hosts range: 10 - the first 10. 10:20 - host from 10th up to 20th"
 )
 
 opt_add_comments = Arg(
     "--add-comments", default=False,
-    help="Добавлять комменты подтверждения для rbprocess"
+    help=argparse.SUPPRESS,
 )
 
 opt_no_label = Arg(
     "--no-label", default=False,
-    help="Убрать лейбл с именем файла из вывода"
+    help="Hide the file name label from the output"
 )
 
 opt_no_color = Arg(
     "--no-color", default=False,
-    help="Не делать ANSI-раскраску вывода (при --dest включён)"
+    help="Do not use the output ANSI-coloring (turns on when using --dest)"
 )
 
 opt_no_check_diff = Arg(
     "--no-check-diff", default=False,
-    help="не запрашивать дифф после деплоя"
+    help="Don't check diffs after deploying"
 )
 
 opt_dont_commit = Arg(
     "--dont-commit", default=False,
-    help="не добавлять команду commit во время деплоя"
+    help="Do not run the 'commit' command during a deploy"
 )
 
 opt_rollback = Arg(
     "--rollback", default=False,
-    help="предложить откат после деплоя где это возможно"
+    help="Suggest a rollback after a deployment if possible"
 )
 
 opt_fail_on_empty_config = Arg(
@@ -287,7 +285,7 @@ opt_fail_on_empty_config = Arg(
 
 opt_show_generators_format = Arg(
     "--format", default="text", choices=["text", "json"],
-    help="Формат выдачи"
+    help="Output format"
 )
 
 
@@ -312,18 +310,18 @@ opt_entire_reload = Arg(
     choices=list(EntireReloadFlag),
     const=EntireReloadFlag.yes,
     nargs="?",
-    help="Выполнить reload() при deploy'e entire генераторов. "
-    "no/yes/force - нет/только если файл изменился/даже если не изменился"
+    help="Run reload() when deploying the Entire-generators. "
+    "no/yes/force - no/if the file was changed/always"
 )
 
 opt_show_hosts_progress = Arg(
     "--show-hosts-progress", default=False,
-    help="Показывать проценты выполнения по хостам"
+    help="Show the progress percentage per host"
 )
 
 opt_no_collapse = Arg(
     "--no-collapse", default=False,
-    help="Не схлопывать одинаковые diff для группы устройств (при --dest включён)"
+    help="Do not collapse identical diffs for a device group (turns on when using --dest)"
 )
 
 opt_fails_only = Arg(
@@ -333,12 +331,12 @@ opt_fails_only = Arg(
 
 opt_connect_timeout = Arg(
     "--connect-timeout", default=DefaultFromEnv("ANN_CONNECT_TIMEOUT", "20.0"), type=float,
-    help="Таймаут на подключение к устройству в секундах."
-         " Значение по-умолчанию можно задать в переменной окружения ANN_CONNECT_TIMEOUT"
+    help="Timeout for connecting to a device, in seconds."
+         " The default value can be set in the ANN_CONNECT_TIMEOUT environment variable."
 )
 
 opt_selected_context_name = Arg(
-    "context-name", type=str, help="Имя контекста в файле конфигурации"
+    "context-name", type=str, help="Name of a context from the context file to use"
 )
 
 

annet/executor.py

@@ -16,11 +16,7 @@ from typing import Any, Callable, Dict, List, Optional, Tuple, Union
 import colorama
 import psutil
 from annet.annlib.command import Command, CommandList, Question  # noqa: F401
-
-try:
-    from annet.storage import Device
-except ImportError:
-    from noc.annushka.annet.storage import Device  # noqa: F401
+from annet.storage import Device
 
 
 _logger = logging.getLogger(__name__)

annet/rulebook/aruba/ap_env.py

@@ -1,12 +1,7 @@
 # pylint: disable=unused-argument
 
 from annet.annlib.types import Op
-
-
-try:
-    from annet.executor import CommandList, Command
-except ImportError:
-    from noc.annushka.annet.executor import CommandList, Command
+from annet.executor import CommandList, Command
 
 
 def apply(hw, do_commit, do_finalize, **_):

annet/storage.py

@@ -69,7 +69,7 @@ class Storage(abc.ABC):
 class StorageOpts(abc.ABC):
     @classmethod
     @abc.abstractmethod
-    def parse_params(cls, conf_params: Dict[str, str] | None, cli_opts: Any):
+    def parse_params(cls, conf_params: Optional[Dict[str, str]], cli_opts: Any):
         pass
 
 

{annet-0.14.7.dist-info → annet-0.14.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: annet
-Version: 0.14.7
+Version: 0.14.9
 Summary: annet
 Home-page: https://github.com/annetutil/annet
 License: MIT

{annet-0.14.7.dist-info → annet-0.14.9.dist-info}/RECORD

@@ -1,12 +1,12 @@
 annet/__init__.py,sha256=oyElxAW97sHgQccGafhaWVBveBn1gSjjdP_xHROaRLg,2139
 annet/annet.py,sha256=TMdEuM7GJQ4TjRVmuK3bCTZN-21lxjQ9sXqEdILUuBk,725
-annet/argparse.py,sha256=MoBD0LPnHdA6HU7z1uQNArYlkD92znoeGIFTMnS4dRM,12608
-annet/cli.py,sha256=MxdH5m4r2MfXYwCbgSDUqjSibxw7VzSg7_hsB47RWnw,9601
-annet/cli_args.py,sha256=1RZ_Sy5oSiiUNzf4FIefvUa_s-JsR8IYd-SvN7apocw,15823
+annet/argparse.py,sha256=ZHKQriVCysSnox5stZnYxKLaPKzDjXbShxFyNW6LiiQ,12754
+annet/cli.py,sha256=aFFloyl5k2vz8mnm8Q2iwjAOUi4PTFWoVT9JszTkmHo,9969
+annet/cli_args.py,sha256=_Du9Jhe86F4fsx7u9njjvg25jTdoBsdbTEzbuDFgrFU,13248
 annet/connectors.py,sha256=Xgr7fNopRhFAYnkiDxhohBtjlFOLY8v0xLExHmVMr00,2511
 annet/deploy.py,sha256=B8E0P_VvCrS2URjFvgmUiIkHp95g7pAWfmT34igaDeo,18893
 annet/diff.py,sha256=zLcaCnb4lZRUb7frpH1CstQ3kacRcCblZs1uLG8J5lk,3391
-annet/executor.py,sha256=EaeQ_JeRFuUUHUoR2LXDcNvY7IVg0eA2d6zSmQVJt-M,19216
+annet/executor.py,sha256=FrYAUuh2TpSVX42SlTN_PhuSHmXG4Wj1nieY9Wqv9so,19122
 annet/filtering.py,sha256=F4ZKUCU3Yb1RlL2zKdyHtVUaWPzjWF4vWyMcdygKNYk,852
 annet/gen.py,sha256=jlAkT_phlIYrpOIqVc0GrApWp3Y8zr8lyxnZgIdL2F4,33533
 annet/hardware.py,sha256=HYPDfji_GdRn5S0_0fl4rvM7byOY9aHxG6VMAtsLaxE,1090
@@ -16,7 +16,7 @@ annet/output.py,sha256=hJNGzL4Z3KgvqaCBkkmuuiXPhb64F1QV8YHkwnfhaaI,6852
 annet/parallel.py,sha256=hLkzEht0KhzmzUWDdO4QFYQHzhxs3wPlTA8DxbB2ziw,17160
 annet/patching.py,sha256=nILbY5oJajN0b1j3f0HEJm05H3HVThnWvB7vDVh7UQw,559
 annet/reference.py,sha256=B8mH8VUMcecPnzULiTVb_kTQ7jQrCL7zp4pfIZQa5fk,4035
-annet/storage.py,sha256=BMZPOPrWGyMNmzUl9CJfv8m15xciajGesHcRv9zUaV8,3092
+annet/storage.py,sha256=-l64yc0UfGR7Aqb3GlW18Kg1SJgIF1k6cf7-Ca4MhBc,3095
 annet/tabparser.py,sha256=ZjiI43ZVbrpMVR8qNbTbNh_U3oZ26VDc_2Y9wkkDkYA,874
 annet/text_term_format.py,sha256=CHb6viv45vmYl-SK1A1vyPHGhaEni6jVybBusaQnct8,2813
 annet/tracing.py,sha256=ndpM-au1c88uBBpOuH_z52qWZL773edYozNyys_wA68,4044
@@ -26,15 +26,15 @@ annet/adapters/netbox/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 annet/adapters/netbox/provider.py,sha256=Gymku2Ad7um4GR9MqzQzm2o2cBLHLhIYbF1Ytl0r0MA,1076
 annet/adapters/netbox/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 annet/adapters/netbox/common/client.py,sha256=-lWZmphD-OPuLIHNKhW_h2bnjrVaiyKYAD_MUPasEbo,2483
-annet/adapters/netbox/common/manufacturer.py,sha256=van_-9-3cnBadZkF3Srae_m8cUSjf8KQCCCHFcdeQyo,1758
-annet/adapters/netbox/common/models.py,sha256=bJP6lIWFB85AW5gLNyfd0VHeqEtYIdLJcNH9r8cb8RI,2859
+annet/adapters/netbox/common/manufacturer.py,sha256=i-1mXQheS4ORZav1_xYxMuGBWVWQHolZYkEXNdGyf0g,1361
+annet/adapters/netbox/common/models.py,sha256=Vgxbl_Mm-zOAi2BTlEzDppTTgZjafFEC5F9s_MTd_xU,3263
 annet/adapters/netbox/common/query.py,sha256=OgUuF-bvshpoBUkrOs0tsMUAhjTsttzx3VV30ryFl0Y,577
 annet/adapters/netbox/common/status_client.py,sha256=W4nTb2yvBlJ2UkWUmUhKQ2PaSQb1shjhHj5ebb4s2s4,591
 annet/adapters/netbox/common/storage_opts.py,sha256=idOm1na_2Axdi4MdLN4tAsPvsp5zBtJYD9j7cUiI-W8,400
 annet/adapters/netbox/v24/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-annet/adapters/netbox/v24/storage.py,sha256=ogCu5XXIpcpPtuz7dWfDFIbqtz8k5G96PL6mhAQWwBU,6026
+annet/adapters/netbox/v24/storage.py,sha256=THI592VLx3ehixsPZQ1Ko3mYIAZQbnDY-toIziqBbL8,6005
 annet/adapters/netbox/v37/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-annet/adapters/netbox/v37/storage.py,sha256=plqHzb_jH0Etagmg3K8lmNw5hOWUocoSZtAPBlnnOQY,7524
+annet/adapters/netbox/v37/storage.py,sha256=z0WCVApf7vHL6bxLiF_f6FVo6AVm_hZuiMib4dDJt0w,7595
 annet/annlib/__init__.py,sha256=fT1l4xV5fqqg8HPw9HqmZVN2qwS8i6X1aIm2zGDjxKY,252
 annet/annlib/command.py,sha256=uuBddMQphtn8P5MO5kzIa8_QrtMns-k05VeKv1bcAuA,1043
 annet/annlib/diff.py,sha256=UPt3kYFQdQdVVy3ePYzNHPAxMVmHxCrCnZnMCV6ou2Q,4587
@@ -51,7 +51,7 @@ annet/annlib/netdev/db.py,sha256=fI_u5aya4l61mbYSjj4JwlVfi3s7obt2jqERSuXGRUI,163
 annet/annlib/netdev/devdb/__init__.py,sha256=aKYjjLbJebdKBjnGDpVLQdSqrV2JL24spGm58tmMWVU,892
 annet/annlib/netdev/devdb/data/devdb.json,sha256=8U-2p2yCE6jHdBehASiQoQdJ7c2_Hc9SFGefNLaGiBo,5287
 annet/annlib/netdev/views/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-annet/annlib/netdev/views/dump.py,sha256=XJ6UO6sYSO5pIoe5R4eTQmKwx0_JJ71_h8QSYAURtyk,4184
+annet/annlib/netdev/views/dump.py,sha256=rIlyvnA3uM8bB_7oq1nS2KDxTp6dQh2hz-FbNhYIpOU,4630
 annet/annlib/netdev/views/hardware.py,sha256=o-w-k1bOORWwEnSGsDq-9Q_oIeH3yQv9eiCJn_UgG-Y,3324
 annet/annlib/rbparser/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 annet/annlib/rbparser/acl.py,sha256=RR8yPt6t96_IiyuKVbeZ-3x32cyhBAT2wC1y99oWBO8,3931
@@ -82,7 +82,7 @@ annet/rulebook/patching.py,sha256=ve_D-9lnWs6Qb_NwqOLUWX-b_tI_L3pwQ7cgUPnqndY,49
 annet/rulebook/arista/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 annet/rulebook/arista/iface.py,sha256=bgj6a3r__-OE6VyYbSfnD6ps2QJKyX028W7IFJww-UY,720
 annet/rulebook/aruba/__init__.py,sha256=ILggeID6kNWcDBGzhXm_mebcfkuLSq5prBFU5DyPFs4,500
-annet/rulebook/aruba/ap_env.py,sha256=GO97lbMju82MqUUBf76OWiFBjnnF3OOVqsGcJ5jn-0c,4788
+annet/rulebook/aruba/ap_env.py,sha256=5fUVLhXH4-0DAtv8t0yoqJUibaRMuzF8Q7mGFzNsEN8,4692
 annet/rulebook/aruba/misc.py,sha256=O0p_wsR07gtB8rm1eJvJ7VYnGm5T8Uau_SVKR9FVInI,234
 annet/rulebook/cisco/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 annet/rulebook/cisco/iface.py,sha256=WISkzjp_G7WKPpg098FCIm4b7ipOxtRLOQbu-7gMUL0,1792
@@ -124,10 +124,10 @@ annet/rulebook/texts/routeros.rul,sha256=ipfxjj0mjFef6IsUlupqx4BY_Je_OUb8u_U1019
 annet_generators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 annet_generators/example/__init__.py,sha256=zVd8_DrXuOASrNzg2Ab94rPyvJff83L-_HppDFxnUjM,228
 annet_generators/example/lldp.py,sha256=68CLrK7vxTQQy9XIBxtywuEdBNlIlfXGYj8_wYWs5UI,1146
-annet-0.14.7.dist-info/AUTHORS,sha256=rh3w5P6gEgqmuC-bw-HB68vBCr-yIBFhVL0PG4hguLs,878
-annet-0.14.7.dist-info/LICENSE,sha256=yPxl7dno02Pw7gAcFPIFONzx_gapwDoPXsIsh6Y7lC0,1079
-annet-0.14.7.dist-info/METADATA,sha256=A6QRaGcStR1_xxiKBk1tkpjoFUgY0uohpBY_eU7Vav4,694
-annet-0.14.7.dist-info/WHEEL,sha256=HiCZjzuy6Dw0hdX5R3LCFPDmFS4BWl8H-8W39XfmgX4,91
-annet-0.14.7.dist-info/entry_points.txt,sha256=yHimujIzR2bwNIbb--MTs_GpXiAve89Egpu2LlgTEkg,119
-annet-0.14.7.dist-info/top_level.txt,sha256=QsoTZBsUtwp_FEcmRwuN8QITBmLOZFqjssRfKilGbP8,23
-annet-0.14.7.dist-info/RECORD,,
+annet-0.14.9.dist-info/AUTHORS,sha256=rh3w5P6gEgqmuC-bw-HB68vBCr-yIBFhVL0PG4hguLs,878
+annet-0.14.9.dist-info/LICENSE,sha256=yPxl7dno02Pw7gAcFPIFONzx_gapwDoPXsIsh6Y7lC0,1079
+annet-0.14.9.dist-info/METADATA,sha256=8qSsN16lENPe9EcC4dGlPk2hN8JDX690OlbbBaoQ_pE,694
+annet-0.14.9.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+annet-0.14.9.dist-info/entry_points.txt,sha256=yHimujIzR2bwNIbb--MTs_GpXiAve89Egpu2LlgTEkg,119
+annet-0.14.9.dist-info/top_level.txt,sha256=QsoTZBsUtwp_FEcmRwuN8QITBmLOZFqjssRfKilGbP8,23
+annet-0.14.9.dist-info/RECORD,,

{annet-0.14.7.dist-info → annet-0.14.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.2.0)
+Generator: setuptools (73.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any