onec-ops 0.9.3__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. onec_ops/__init__.py +0 -0
  2. onec_ops/__main__.py +7 -0
  3. onec_ops/actions/__init__.py +52 -0
  4. onec_ops/actions/base.py +103 -0
  5. onec_ops/actions/check_extension.py +57 -0
  6. onec_ops/actions/check_modules.py +105 -0
  7. onec_ops/actions/create_ib_file.py +99 -0
  8. onec_ops/actions/delete_extension.py +75 -0
  9. onec_ops/actions/dump_cf.py +74 -0
  10. onec_ops/actions/dump_config.py +108 -0
  11. onec_ops/actions/dump_dt.py +69 -0
  12. onec_ops/actions/dump_epf.py +77 -0
  13. onec_ops/actions/extension_target.py +40 -0
  14. onec_ops/actions/list_extensions.py +54 -0
  15. onec_ops/actions/load_cf.py +81 -0
  16. onec_ops/actions/load_config.py +115 -0
  17. onec_ops/actions/load_epf.py +73 -0
  18. onec_ops/actions/open_designer.py +74 -0
  19. onec_ops/actions/open_enterprise.py +82 -0
  20. onec_ops/actions/partial_list.py +77 -0
  21. onec_ops/actions/repo_add_user.py +71 -0
  22. onec_ops/actions/repo_bind.py +62 -0
  23. onec_ops/actions/repo_create.py +76 -0
  24. onec_ops/actions/repo_update.py +60 -0
  25. onec_ops/actions/restore_dt.py +82 -0
  26. onec_ops/actions/update_db.py +77 -0
  27. onec_ops/cli.py +155 -0
  28. onec_ops/lib/__init__.py +0 -0
  29. onec_ops/lib/config.py +47 -0
  30. onec_ops/lib/exceptions.py +25 -0
  31. onec_ops/lib/logging_setup.py +42 -0
  32. onec_ops/lib/platform_check.py +46 -0
  33. onec_ops/lib/runner.py +284 -0
  34. onec_ops/skill/SKILL.md +208 -0
  35. onec_ops/skill/agents/openai.yaml +7 -0
  36. onec_ops/skill/references/commands.md +1026 -0
  37. onec_ops/skill/references/troubleshooting.md +275 -0
  38. onec_ops/skill/references/workflows.md +165 -0
  39. onec_ops/skill_install.py +204 -0
  40. onec_ops-0.9.3.dist-info/METADATA +514 -0
  41. onec_ops-0.9.3.dist-info/RECORD +44 -0
  42. onec_ops-0.9.3.dist-info/WHEEL +4 -0
  43. onec_ops-0.9.3.dist-info/entry_points.txt +2 -0
  44. onec_ops-0.9.3.dist-info/licenses/LICENSE +21 -0
onec_ops/__init__.py ADDED
File without changes
onec_ops/__main__.py ADDED
@@ -0,0 +1,7 @@
1
+ """Запуск через python -m onec_ops."""
2
+
3
+ import sys
4
+
5
+ from onec_ops.cli import main
6
+
7
+ sys.exit(main())
@@ -0,0 +1,52 @@
1
+ """Реестр действий onec-ops."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from .base import Action
6
+ from .check_extension import CheckExtensionAction
7
+ from .check_modules import CheckConfigAction, CheckModulesAction
8
+ from .create_ib_file import CreateIbFileAction
9
+ from .delete_extension import DeleteExtensionAction
10
+ from .dump_cf import DumpCfAction
11
+ from .dump_config import DumpConfigAction
12
+ from .dump_dt import DumpDtAction
13
+ from .dump_epf import DumpEpfAction
14
+ from .list_extensions import ListExtensionsAction
15
+ from .load_cf import LoadCfAction
16
+ from .load_config import LoadConfigAction
17
+ from .load_epf import LoadEpfAction
18
+ from .open_designer import OpenDesignerAction
19
+ from .open_enterprise import OpenEnterpriseAction
20
+ from .repo_add_user import RepoAddUserAction
21
+ from .repo_bind import RepoBindAction
22
+ from .repo_create import RepoCreateAction
23
+ from .repo_update import RepoUpdateAction
24
+ from .restore_dt import RestoreDtAction
25
+ from .update_db import UpdateDbAction
26
+
27
+
28
+ def get_actions() -> list[Action]:
29
+ """Возвращает доступные действия CLI."""
30
+ return [
31
+ CreateIbFileAction(),
32
+ DumpConfigAction(),
33
+ LoadConfigAction(),
34
+ DumpCfAction(),
35
+ LoadCfAction(),
36
+ OpenDesignerAction(),
37
+ OpenEnterpriseAction(),
38
+ DumpEpfAction(),
39
+ LoadEpfAction(),
40
+ DumpDtAction(),
41
+ RestoreDtAction(),
42
+ RepoCreateAction(),
43
+ RepoBindAction(),
44
+ RepoUpdateAction(),
45
+ RepoAddUserAction(),
46
+ ListExtensionsAction(),
47
+ CheckExtensionAction(),
48
+ DeleteExtensionAction(),
49
+ UpdateDbAction(),
50
+ CheckModulesAction(),
51
+ CheckConfigAction(),
52
+ ]
@@ -0,0 +1,103 @@
1
+ """Базовый интерфейс действий CLI."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import logging
7
+ import subprocess
8
+ from abc import ABC, abstractmethod
9
+ from pathlib import Path
10
+
11
+ from onec_ops.lib.exceptions import OneCFailed, OneCOpsError
12
+ from onec_ops.lib.runner import RunContext
13
+
14
+ logger = logging.getLogger(__name__)
15
+
16
+
17
+ class Action(ABC):
18
+ """Базовый класс действия onec-ops."""
19
+
20
+ name: str
21
+ help: str
22
+ description: str = ""
23
+ requires_ib: bool = False
24
+ requires_gui: bool = False
25
+ """Требуется ли реальный DISPLAY (не Xvfb)."""
26
+ path_args: tuple[str, ...] = ()
27
+ legacy_ib_auth_options: bool = False
28
+ """Принимает ли действие устаревшие --user / --password для пользователя ИБ."""
29
+
30
+ @abstractmethod
31
+ def add_arguments(self, parser: argparse.ArgumentParser) -> None:
32
+ """Добавляет аргументы действия."""
33
+
34
+ @abstractmethod
35
+ def build_1c_args(self, ns: argparse.Namespace, ctx: RunContext) -> list[str]:
36
+ """Собирает аргументы для запуска 1С."""
37
+
38
+ def legacy_ib_auth(self, ns: argparse.Namespace) -> tuple[str | None, str | None]:
39
+ """Возвращает пользователя ИБ из устаревших --user / --password."""
40
+ if not self.legacy_ib_auth_options:
41
+ return None, None
42
+ user = getattr(ns, "user", None)
43
+ password = getattr(ns, "password", None)
44
+ if user is not None or password is not None:
45
+ logger.warning("--user / --password устарели, используйте --ib-user / --ib-password.")
46
+ return user, password
47
+
48
+ def ib_auth_args(self, ns: argparse.Namespace) -> list[str]:
49
+ """Возвращает ключи /N и /P пользователя ИБ."""
50
+ if not self.requires_ib:
51
+ return []
52
+ user = getattr(ns, "ib_user", None)
53
+ password = getattr(ns, "ib_password", None)
54
+ if password and not user:
55
+ raise OneCOpsError("--ib-password требует --ib-user.")
56
+ if not user:
57
+ return []
58
+ args = ["/N", user]
59
+ if password:
60
+ args += ["/P", password]
61
+ return args
62
+
63
+ def command_args(self, ns: argparse.Namespace, ctx: RunContext) -> list[str]:
64
+ """Собирает аргументы 1С с пользователем ИБ сразу после /F <ib>."""
65
+ args = self.build_1c_args(ns, ctx)
66
+ auth = self.ib_auth_args(ns)
67
+ if not auth:
68
+ return args
69
+ index = args.index("/F") + 2 if "/F" in args else len(args)
70
+ return [*args[:index], *auth, *args[index:]]
71
+
72
+ def resolve_paths(self, ns: argparse.Namespace) -> None:
73
+ """Преобразует объявленные пути в абсолютные."""
74
+ if self.requires_ib and getattr(ns, "ib", None):
75
+ ns.ib = Path(ns.ib).resolve()
76
+ for name in self.path_args:
77
+ value = getattr(ns, name, None)
78
+ if value:
79
+ setattr(ns, name, Path(value).resolve())
80
+
81
+ def validate(self, ns: argparse.Namespace) -> None:
82
+ """Проверяет обязательную файловую ИБ для действий с requires_ib."""
83
+ if not self.requires_ib:
84
+ return
85
+ ib = getattr(ns, "ib", None)
86
+ if ib is None:
87
+ raise OneCOpsError("Для этого действия обязательно укажите --ib.")
88
+ if not (Path(ib) / "1Cv8.1CD").is_file():
89
+ raise OneCOpsError(f"Файловая ИБ --ib не содержит файл 1Cv8.1CD: {ib}")
90
+
91
+ def pre_run(self, ns: argparse.Namespace, ctx: RunContext) -> None:
92
+ """Выполняет подготовку перед запуском."""
93
+
94
+ def post_run(
95
+ self, ns: argparse.Namespace, ctx: RunContext, result: subprocess.CompletedProcess[str]
96
+ ) -> None:
97
+ """Выполняет пост-обработку результата."""
98
+
99
+ def on_failed(self, ns: argparse.Namespace, ctx: RunContext, error: OneCFailed) -> None:
100
+ """Может заменить ошибку 1С своей; если не заменил, ошибка идёт дальше."""
101
+
102
+ def cleanup(self, ns: argparse.Namespace) -> None:
103
+ """Освобождает ресурсы действия при успехе, ошибке и таймауте."""
@@ -0,0 +1,57 @@
1
+ """Проверка возможности применить расширения конфигурации."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import logging
7
+ import subprocess
8
+
9
+ from onec_ops.lib.runner import RunContext
10
+
11
+ from .base import Action
12
+ from .extension_target import (
13
+ add_extension_target,
14
+ extension_target_args,
15
+ validate_extension_target,
16
+ )
17
+
18
+ logger = logging.getLogger(__name__)
19
+
20
+
21
+ class CheckExtensionAction(Action):
22
+ """Проверяет, можно ли применить расширение к конфигурации ИБ."""
23
+
24
+ name = "check-extension"
25
+ help = "Проверить, можно ли применить расширение"
26
+ requires_ib = True
27
+
28
+ def add_arguments(self, parser: argparse.ArgumentParser) -> None:
29
+ """Добавляет выбор расширения."""
30
+ add_extension_target(parser)
31
+
32
+ def validate(self, ns: argparse.Namespace) -> None:
33
+ """Проверяет ИБ и выбор расширения."""
34
+ super().validate(ns)
35
+ validate_extension_target(ns)
36
+
37
+ def build_1c_args(self, ns: argparse.Namespace, ctx: RunContext) -> list[str]:
38
+ """Собирает команду CheckCanApplyConfigurationExtensions."""
39
+ return [
40
+ "DESIGNER",
41
+ "/F",
42
+ str(ns.ib),
43
+ "/DisableStartupDialogs",
44
+ "/CheckCanApplyConfigurationExtensions",
45
+ *extension_target_args(ns),
46
+ ]
47
+
48
+ def post_run(
49
+ self, ns: argparse.Namespace, ctx: RunContext, result: subprocess.CompletedProcess[str]
50
+ ) -> None:
51
+ """Сообщает об успешной проверке."""
52
+ if ctx.dry_run:
53
+ return
54
+ if ns.all_extensions:
55
+ logger.info("Все расширения можно применить")
56
+ else:
57
+ logger.info("Расширение можно применить: %s", ns.extension)
@@ -0,0 +1,105 @@
1
+ """Проверка модулей и конфигурации: /CheckModules и /CheckConfig."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import logging
7
+ import subprocess
8
+
9
+ from onec_ops.lib.exceptions import OneCFailed, OneCOpsError
10
+ from onec_ops.lib.runner import RunContext
11
+
12
+ from .base import Action
13
+ from .extension_target import (
14
+ add_extension_target,
15
+ extension_target_args,
16
+ validate_extension_target,
17
+ )
18
+
19
+ logger = logging.getLogger(__name__)
20
+
21
+ FINDINGS_RETURNCODE = 101
22
+ """Код 1С «есть замечания»; сбой запуска даёт другой код."""
23
+
24
+ CHECK_MODES = {
25
+ "thin-client": "-ThinClient",
26
+ "web-client": "-WebClient",
27
+ "server": "-Server",
28
+ "external-connection": "-ExternalConnection",
29
+ "thick-client": "-ThickClientOrdinaryApplication",
30
+ }
31
+ """Без режимов /CheckModules пропускает ошибки и возвращает 0, поэтому режим есть всегда."""
32
+
33
+
34
+ class _CheckAction(Action):
35
+ """Общая логика команд проверки."""
36
+
37
+ requires_ib = True
38
+ check_args: tuple[str, ...] = ()
39
+
40
+ def add_arguments(self, parser: argparse.ArgumentParser) -> None:
41
+ """Добавляет режимы, расширенную проверку и выбор расширения."""
42
+ parser.add_argument(
43
+ "--mode",
44
+ action="append",
45
+ choices=tuple(CHECK_MODES),
46
+ dest="modes",
47
+ help="Режим проверки, можно повторять. По умолчанию все режимы",
48
+ )
49
+ parser.add_argument(
50
+ "--extended",
51
+ action="store_true",
52
+ help="Расширенная проверка (-ExtendedModulesCheck); предупреждения дают код 1",
53
+ )
54
+ add_extension_target(parser)
55
+
56
+ def validate(self, ns: argparse.Namespace) -> None:
57
+ """Проверяет ИБ и необязательный выбор расширения."""
58
+ super().validate(ns)
59
+ validate_extension_target(ns, required=False)
60
+
61
+ def build_1c_args(self, ns: argparse.Namespace, ctx: RunContext) -> list[str]:
62
+ """Собирает команду проверки с режимами в постоянном порядке."""
63
+ modes = ns.modes or tuple(CHECK_MODES)
64
+ args = [
65
+ "DESIGNER",
66
+ "/F",
67
+ str(ns.ib),
68
+ "/DisableStartupDialogs",
69
+ *self.check_args,
70
+ *(switch for mode, switch in CHECK_MODES.items() if mode in modes),
71
+ ]
72
+ if ns.extended:
73
+ args += ["-ExtendedModulesCheck"]
74
+ return args + extension_target_args(ns)
75
+
76
+ def on_failed(self, ns: argparse.Namespace, ctx: RunContext, error: OneCFailed) -> None:
77
+ """Отделяет замечания проверки от сбоя запуска 1С."""
78
+ if error.returncode != FINDINGS_RETURNCODE:
79
+ return
80
+ _, _, findings = str(error).partition("\n")
81
+ raise OneCOpsError(f"Найдены замечания 1С:\n{findings}") from error
82
+
83
+ def post_run(
84
+ self, ns: argparse.Namespace, ctx: RunContext, result: subprocess.CompletedProcess[str]
85
+ ) -> None:
86
+ """Сообщает об успешной проверке."""
87
+ if ctx.dry_run:
88
+ return
89
+ logger.info("Проверка пройдена: %s", getattr(result, "out_text", "") or "замечаний нет")
90
+
91
+
92
+ class CheckModulesAction(_CheckAction):
93
+ """Проверяет синтаксис модулей."""
94
+
95
+ name = "check-modules"
96
+ help = "Проверить синтаксис модулей"
97
+ check_args = ("/CheckModules",)
98
+
99
+
100
+ class CheckConfigAction(_CheckAction):
101
+ """Проверяет конфигурацию: логическую целостность, ссылки и модули."""
102
+
103
+ name = "check-config"
104
+ help = "Проверить конфигурацию"
105
+ check_args = ("/CheckConfig", "-ConfigLogIntegrity", "-IncorrectReferences")
@@ -0,0 +1,99 @@
1
+ """Действие создания файловой информационной базы."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import logging
7
+ import shutil
8
+ import sys
9
+ from pathlib import Path
10
+
11
+ from onec_ops.lib.exceptions import OneCOpsError
12
+ from onec_ops.lib.runner import RunContext
13
+
14
+ from .base import Action
15
+
16
+ logger = logging.getLogger(__name__)
17
+
18
+
19
+ class CreateIbFileAction(Action):
20
+ """Создаёт файловую информационную базу 1С."""
21
+
22
+ name = "create-ib"
23
+ help = "Создать информационную базу"
24
+ requires_ib = False
25
+ path_args = ("path",)
26
+
27
+ def add_arguments(self, parser: argparse.ArgumentParser) -> None:
28
+ """Добавляет аргументы create-ib."""
29
+ parser.add_argument("--type", choices=("file", "server"), required=True, dest="ib_type")
30
+ parser.add_argument("--path", type=Path, help="Путь к файловой ИБ")
31
+ parser.add_argument("--force", action="store_true", help="Перезаписать существующую ИБ")
32
+ parser.add_argument(
33
+ "--yes",
34
+ action="store_true",
35
+ help="Подтвердить удаление без интерактива (для CI)",
36
+ )
37
+ parser.add_argument("--server", help="Сервер 1С")
38
+ parser.add_argument("--ref", help="Имя ИБ на сервере")
39
+
40
+ def validate(self, ns: argparse.Namespace) -> None:
41
+ """Проверяет параметры создания ИБ."""
42
+ if ns.ib_type == "server":
43
+ raise OneCOpsError(
44
+ "Клиент-серверная ИБ пока не поддержана (запланирована в v0.3.1). Используйте --type file."
45
+ )
46
+ if ns.path is None:
47
+ raise OneCOpsError("Для --type file обязательно укажите --path.")
48
+ path = Path(ns.path)
49
+ if '"' in str(path.resolve()):
50
+ raise OneCOpsError(f"Путь --path не может содержать двойную кавычку: {path}")
51
+ if path.exists() and not path.is_dir():
52
+ raise OneCOpsError(f"--path должен указывать на каталог: {path}")
53
+ database_file = path / "1Cv8.1CD"
54
+ if not database_file.exists():
55
+ return
56
+ if not ns.force:
57
+ raise OneCOpsError(
58
+ f"ИБ уже существует: {ns.path}. Если вы уверены, что хотите "
59
+ "её удалить и создать заново, запустите с флагом --force."
60
+ )
61
+ if ns.yes:
62
+ logger.warning("--force --yes: удаляю существующую ИБ: %s", ns.path)
63
+ return
64
+ if not sys.stdin.isatty():
65
+ raise OneCOpsError(
66
+ "--force требует интерактивного подтверждения. "
67
+ "В неинтерактивной среде используйте --force --yes."
68
+ )
69
+ print(
70
+ f"\nВНИМАНИЕ! Каталог {ns.path} будет полностью удалён,\n"
71
+ "включая все данные и файл 1Cv8.1CD.\n\n"
72
+ "Для подтверждения введите Y: ",
73
+ file=sys.stderr,
74
+ end="",
75
+ flush=True,
76
+ )
77
+ answer = sys.stdin.readline().strip()
78
+ if not answer or answer[0].lower() != "y":
79
+ raise OneCOpsError("Отменено пользователем.")
80
+
81
+ def build_1c_args(self, ns: argparse.Namespace, ctx: RunContext) -> list[str]:
82
+ """Собирает CREATEINFOBASE для файловой ИБ."""
83
+ return ["CREATEINFOBASE", f'File="{Path(ns.path).resolve()}"', "/DisableStartupMessages"]
84
+
85
+ def pre_run(self, ns: argparse.Namespace, ctx: RunContext) -> None:
86
+ """Удаляет существующую ИБ и создаёт её каталог."""
87
+ if ns.ib_type != "file":
88
+ return
89
+ path = Path(ns.path).resolve()
90
+ try:
91
+ if ns.force and (path / "1Cv8.1CD").exists():
92
+ if ctx.dry_run:
93
+ logger.info("Dry-run: существующая ИБ не удаляется: %s", path)
94
+ return
95
+ logger.warning("Удаляю существующую ИБ: %s", path)
96
+ shutil.rmtree(path)
97
+ path.mkdir(parents=True, exist_ok=True)
98
+ except OSError as error:
99
+ raise OneCOpsError(f"Не удалось подготовить каталог ИБ {path}: {error}") from error
@@ -0,0 +1,75 @@
1
+ """Удаление расширения конфигурации из ИБ."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import logging
7
+ import sys
8
+
9
+ from onec_ops.lib.exceptions import OneCOpsError
10
+ from onec_ops.lib.runner import RunContext
11
+
12
+ from .base import Action
13
+ from .extension_target import (
14
+ add_extension_target,
15
+ extension_target_args,
16
+ extension_target_label,
17
+ validate_extension_target,
18
+ )
19
+
20
+ logger = logging.getLogger(__name__)
21
+
22
+
23
+ class DeleteExtensionAction(Action):
24
+ """Удаляет расширение конфигурации вместе с данными его объектов."""
25
+
26
+ name = "delete-extension"
27
+ help = "Удалить расширение из ИБ"
28
+ requires_ib = True
29
+
30
+ def add_arguments(self, parser: argparse.ArgumentParser) -> None:
31
+ """Добавляет выбор расширения и подтверждение."""
32
+ add_extension_target(parser)
33
+ parser.add_argument("--yes", action="store_true", help="Удалить без подтверждения (для CI)")
34
+
35
+ def validate(self, ns: argparse.Namespace) -> None:
36
+ """Проверяет ИБ и выбор расширения."""
37
+ super().validate(ns)
38
+ validate_extension_target(ns)
39
+
40
+ def build_1c_args(self, ns: argparse.Namespace, ctx: RunContext) -> list[str]:
41
+ """Собирает команду DeleteCfg."""
42
+ return [
43
+ "DESIGNER",
44
+ "/F",
45
+ str(ns.ib),
46
+ "/DisableStartupDialogs",
47
+ "/DeleteCfg",
48
+ *extension_target_args(ns),
49
+ ]
50
+
51
+ def pre_run(self, ns: argparse.Namespace, ctx: RunContext) -> None:
52
+ """Предупреждает о потере данных и запрашивает подтверждение."""
53
+ label = extension_target_label(ns)
54
+ logger.warning(
55
+ "Удаление из ИБ %s: %s. Данные объектов расширения будут потеряны.", ns.ib, label
56
+ )
57
+ if ns.yes:
58
+ logger.warning("--yes: удаляю без подтверждения")
59
+ return
60
+ if not sys.stdin.isatty():
61
+ raise OneCOpsError(
62
+ "Удаление расширения требует интерактивного подтверждения. "
63
+ "В неинтерактивной среде используйте --yes."
64
+ )
65
+ print(
66
+ f"\nВНИМАНИЕ! Удаление из ИБ {ns.ib}: {label}.\n"
67
+ "Данные объектов расширения будут потеряны.\n\n"
68
+ "Для подтверждения введите Y: ",
69
+ file=sys.stderr,
70
+ end="",
71
+ flush=True,
72
+ )
73
+ answer = sys.stdin.readline().strip().lower()
74
+ if answer not in ("y", "yes"):
75
+ raise OneCOpsError("Отменено пользователем.")
@@ -0,0 +1,74 @@
1
+ """Действие выгрузки конфигурации и расширений."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import logging
7
+ from pathlib import Path
8
+
9
+ from onec_ops.lib.exceptions import OneCOpsError
10
+ from onec_ops.lib.runner import RunContext
11
+
12
+ from .base import Action
13
+ from .extension_target import validate_extension_name
14
+
15
+ logger = logging.getLogger(__name__)
16
+
17
+
18
+ class DumpCfAction(Action):
19
+ """Выгружает конфигурацию 1С в файл .cf или .cfe."""
20
+
21
+ name = "dump-cf"
22
+ help = "Выгрузить конфигурацию (.cf) или расширение (.cfe)"
23
+ requires_ib = True
24
+ path_args = ("to",)
25
+
26
+ def add_arguments(self, parser: argparse.ArgumentParser) -> None:
27
+ """Добавляет аргументы dump-cf."""
28
+ parser.add_argument("--to", type=Path, required=True, help="Путь к выходному .cf или .cfe")
29
+
30
+ parser.add_argument(
31
+ "--extension",
32
+ help="Имя расширения. Обязателен для файлов .cfe, запрещён для .cf.",
33
+ )
34
+
35
+ def validate(self, ns: argparse.Namespace) -> None:
36
+ """Проверяет ИБ и предупреждает о перезаписи файла."""
37
+ super().validate(ns)
38
+ validate_extension_name(ns.extension)
39
+ if ns.to is None:
40
+ raise OneCOpsError("Обязательно укажите --to.")
41
+ path = Path(ns.to)
42
+ suffix = path.suffix.lower()
43
+ if suffix == ".cfe" and not ns.extension:
44
+ raise OneCOpsError("Для файлов .cfe требуется --extension.")
45
+ if suffix == ".cf" and ns.extension:
46
+ raise OneCOpsError("--extension запрещён для .cf.")
47
+ if suffix not in (".cf", ".cfe"):
48
+ logger.warning("Неизвестное расширение файла %s: ожидается .cf или .cfe", path)
49
+ if path.exists():
50
+ if not path.is_file():
51
+ raise OneCOpsError(f"--to должен указывать на файл: {path}")
52
+ logger.warning("Файл выгрузки существует и будет перезаписан: %s", path)
53
+
54
+ def build_1c_args(self, ns: argparse.Namespace, ctx: RunContext) -> list[str]:
55
+ """Собирает DumpCfg для конфигурации или расширения."""
56
+ args = [
57
+ "DESIGNER",
58
+ "/F",
59
+ str(ns.ib),
60
+ "/DisableStartupDialogs",
61
+ "/DumpCfg",
62
+ str(Path(ns.to).resolve()),
63
+ ]
64
+ if ns.extension:
65
+ args += ["-Extension", ns.extension]
66
+ return args
67
+
68
+ def pre_run(self, ns: argparse.Namespace, ctx: RunContext) -> None:
69
+ """Создаёт родительский каталог выходного файла."""
70
+ path = Path(ns.to).resolve().parent
71
+ try:
72
+ path.mkdir(parents=True, exist_ok=True)
73
+ except OSError as error:
74
+ raise OneCOpsError(f"Не удалось создать каталог выгрузки {path}: {error}") from error