onec-ops 0.9.3__tar.gz

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 (77) hide show
  1. onec_ops-0.9.3/.gitignore +50 -0
  2. onec_ops-0.9.3/CHANGELOG.md +299 -0
  3. onec_ops-0.9.3/LICENSE +21 -0
  4. onec_ops-0.9.3/PKG-INFO +514 -0
  5. onec_ops-0.9.3/README.md +480 -0
  6. onec_ops-0.9.3/SKILL.md +208 -0
  7. onec_ops-0.9.3/agents/openai.yaml +7 -0
  8. onec_ops-0.9.3/onec_ops/__init__.py +0 -0
  9. onec_ops-0.9.3/onec_ops/__main__.py +7 -0
  10. onec_ops-0.9.3/onec_ops/actions/__init__.py +52 -0
  11. onec_ops-0.9.3/onec_ops/actions/base.py +103 -0
  12. onec_ops-0.9.3/onec_ops/actions/check_extension.py +57 -0
  13. onec_ops-0.9.3/onec_ops/actions/check_modules.py +105 -0
  14. onec_ops-0.9.3/onec_ops/actions/create_ib_file.py +99 -0
  15. onec_ops-0.9.3/onec_ops/actions/delete_extension.py +75 -0
  16. onec_ops-0.9.3/onec_ops/actions/dump_cf.py +74 -0
  17. onec_ops-0.9.3/onec_ops/actions/dump_config.py +108 -0
  18. onec_ops-0.9.3/onec_ops/actions/dump_dt.py +69 -0
  19. onec_ops-0.9.3/onec_ops/actions/dump_epf.py +77 -0
  20. onec_ops-0.9.3/onec_ops/actions/extension_target.py +40 -0
  21. onec_ops-0.9.3/onec_ops/actions/list_extensions.py +54 -0
  22. onec_ops-0.9.3/onec_ops/actions/load_cf.py +81 -0
  23. onec_ops-0.9.3/onec_ops/actions/load_config.py +115 -0
  24. onec_ops-0.9.3/onec_ops/actions/load_epf.py +73 -0
  25. onec_ops-0.9.3/onec_ops/actions/open_designer.py +74 -0
  26. onec_ops-0.9.3/onec_ops/actions/open_enterprise.py +82 -0
  27. onec_ops-0.9.3/onec_ops/actions/partial_list.py +77 -0
  28. onec_ops-0.9.3/onec_ops/actions/repo_add_user.py +71 -0
  29. onec_ops-0.9.3/onec_ops/actions/repo_bind.py +62 -0
  30. onec_ops-0.9.3/onec_ops/actions/repo_create.py +76 -0
  31. onec_ops-0.9.3/onec_ops/actions/repo_update.py +60 -0
  32. onec_ops-0.9.3/onec_ops/actions/restore_dt.py +82 -0
  33. onec_ops-0.9.3/onec_ops/actions/update_db.py +77 -0
  34. onec_ops-0.9.3/onec_ops/cli.py +155 -0
  35. onec_ops-0.9.3/onec_ops/lib/__init__.py +0 -0
  36. onec_ops-0.9.3/onec_ops/lib/config.py +47 -0
  37. onec_ops-0.9.3/onec_ops/lib/exceptions.py +25 -0
  38. onec_ops-0.9.3/onec_ops/lib/logging_setup.py +42 -0
  39. onec_ops-0.9.3/onec_ops/lib/platform_check.py +46 -0
  40. onec_ops-0.9.3/onec_ops/lib/runner.py +284 -0
  41. onec_ops-0.9.3/onec_ops/skill_install.py +204 -0
  42. onec_ops-0.9.3/pyproject.toml +82 -0
  43. onec_ops-0.9.3/references/commands.md +1026 -0
  44. onec_ops-0.9.3/references/troubleshooting.md +275 -0
  45. onec_ops-0.9.3/references/workflows.md +165 -0
  46. onec_ops-0.9.3/tests/__init__.py +0 -0
  47. onec_ops-0.9.3/tests/conftest.py +12 -0
  48. onec_ops-0.9.3/tests/test_check_modules.py +162 -0
  49. onec_ops-0.9.3/tests/test_cli_smoke.py +38 -0
  50. onec_ops-0.9.3/tests/test_config.py +153 -0
  51. onec_ops-0.9.3/tests/test_config_cli.py +134 -0
  52. onec_ops-0.9.3/tests/test_create_ib_file.py +149 -0
  53. onec_ops-0.9.3/tests/test_display_check.py +74 -0
  54. onec_ops-0.9.3/tests/test_dump_cf.py +158 -0
  55. onec_ops-0.9.3/tests/test_dump_config.py +133 -0
  56. onec_ops-0.9.3/tests/test_dump_dt.py +168 -0
  57. onec_ops-0.9.3/tests/test_dump_epf.py +181 -0
  58. onec_ops-0.9.3/tests/test_extensions.py +264 -0
  59. onec_ops-0.9.3/tests/test_ib_auth.py +267 -0
  60. onec_ops-0.9.3/tests/test_load_cf.py +194 -0
  61. onec_ops-0.9.3/tests/test_load_config.py +129 -0
  62. onec_ops-0.9.3/tests/test_load_epf.py +165 -0
  63. onec_ops-0.9.3/tests/test_open_designer.py +204 -0
  64. onec_ops-0.9.3/tests/test_open_enterprise.py +226 -0
  65. onec_ops-0.9.3/tests/test_partial_xml.py +259 -0
  66. onec_ops-0.9.3/tests/test_platform_check.py +40 -0
  67. onec_ops-0.9.3/tests/test_repo_add_user.py +161 -0
  68. onec_ops-0.9.3/tests/test_repo_bind.py +104 -0
  69. onec_ops-0.9.3/tests/test_repo_cli.py +132 -0
  70. onec_ops-0.9.3/tests/test_repo_create.py +124 -0
  71. onec_ops-0.9.3/tests/test_repo_update.py +91 -0
  72. onec_ops-0.9.3/tests/test_restore_dt.py +255 -0
  73. onec_ops-0.9.3/tests/test_runner.py +454 -0
  74. onec_ops-0.9.3/tests/test_skill.py +83 -0
  75. onec_ops-0.9.3/tests/test_skill_install.py +267 -0
  76. onec_ops-0.9.3/tests/test_update_db.py +130 -0
  77. onec_ops-0.9.3/tests/test_validation_regressions.py +139 -0
@@ -0,0 +1,50 @@
1
+ # Python
2
+ __pycache__/
3
+ *.py[cod]
4
+ *.egg-info/
5
+ .venv/
6
+ venv/
7
+ .pytest_cache/
8
+ .coverage
9
+ htmlcov/
10
+ .ruff_cache/
11
+ .mypy_cache/
12
+
13
+ # IDE
14
+ .vscode/
15
+ .idea/
16
+ *.swp
17
+ *.swo
18
+
19
+ # OS
20
+ .DS_Store
21
+ Thumbs.db
22
+
23
+ # Логи
24
+ *.log
25
+ logs/
26
+
27
+ # Тестовые данные 1С (могут быть конфиденциальными)
28
+ inputs/*
29
+ !inputs/.gitkeep
30
+
31
+ # Выходные артефакты
32
+ outputs/*
33
+ !outputs/.gitkeep
34
+ *.epf
35
+ *.erf
36
+ *.cfe
37
+ *.dt
38
+ *.cf
39
+ *.cfu
40
+
41
+ # Локальные копии Skill для агентов
42
+ .agents/
43
+ .claude/
44
+
45
+ # Локальные настройки Codex
46
+ .codex/
47
+
48
+ # Сборка пакета
49
+ dist/
50
+ build/
@@ -0,0 +1,299 @@
1
+ # Changelog
2
+
3
+ Все значимые изменения в проекте onec-ops.
4
+
5
+ Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/).
6
+ Проект использует [Semantic Versioning](https://semver.org/lang/ru/).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [0.9.2] — 2026-11-16
11
+
12
+ ### Added
13
+
14
+ - README: установка навыка в Kimi Code (`~/.kimi-code/skills/`, `~/.agents/skills/`,
15
+ каталог проекта) и вызов `/skill:onec-ops`.
16
+
17
+ ### Changed
18
+
19
+ - README: проверка актуальности копий навыка охватывает все каталоги агентов.
20
+
21
+ ## [0.9.1] — 2026-11-16
22
+
23
+ ### Fixed
24
+
25
+ - `description` в `SKILL.md` взят в кавычки: «: » в описании больше не ломает
26
+ разбор YAML (`quick_validate.py`: `mapping values are not allowed here`).
27
+ - Тест навыка проверяет, что значения frontmatter с «: » или « #» взяты в кавычки.
28
+
29
+ ## [0.9.0] — 2026-11-06
30
+
31
+ ### Added
32
+
33
+ - CI на Linux и Windows, Python 3.11–3.14, с проверкой формата и запуска CLI.
34
+ Запускается и на пуш в `release/**`. Упавшие тесты видны аннотацией.
35
+ - Порог покрытия 90%, точная версия Ruff, `.pre-commit-config.yaml`,
36
+ `.git-blame-ignore-revs`, `CONTRIBUTING.md`.
37
+
38
+ ### Fixed
39
+
40
+ - `onec-ops --help` больше не падает с `UnicodeEncodeError`, если в кодировке вывода
41
+ нет кириллицы, например при выводе в канал на Windows.
42
+
43
+ ### Changed
44
+
45
+ - Код отформатирован через `ruff format`.
46
+ - Всего 572 теста, покрытие 98%.
47
+
48
+ ## [0.8.4] — 2026-11-06
49
+
50
+ ### Added
51
+
52
+ - Команды `check-modules` и `check-config`. По умолчанию проверяются все пять
53
+ режимов: `/CheckModules` без режимов пропускает ошибки и возвращает 0. Замечания
54
+ (код 1С 101) дают код 1 и строку «Найдены замечания 1С:».
55
+ - Частичная выгрузка `dump-config --object | --list-file` и загрузка
56
+ `load-config --file | --list-file`. Пустой список и сочетание с `--all-extensions`
57
+ отклоняются до запуска 1С.
58
+ - 65 новых проверок; всего 571 тест, покрытие 98%.
59
+
60
+ ### Fixed
61
+
62
+ - `create-ib` создаёт базу по пути с пробелом. Путь с двойной кавычкой отклоняется
63
+ понятным сообщением.
64
+
65
+ ## [0.8.3] — 2026-10-24
66
+
67
+ ### Fixed
68
+
69
+ - Пустой или состоящий из пробелов `--extension` отклоняется в командах
70
+ `dump-config`, `load-config`, `dump-cf` и `load-cf`, вместо молчаливого выбора
71
+ основной конфигурации или передачи пустого имени платформе.
72
+ - Относительный путь к платформе из CLI, окружения или TOML приводится
73
+ к абсолютному: `--platform ./1cv8` больше не ищет файл через `PATH`.
74
+ - Каталог больше не принимается за исполняемый файл платформы, в том числе
75
+ при `--dry-run`.
76
+ - Ошибки открытия журнала и подготовки каталога новой ИБ выводятся
77
+ понятным сообщением с кодом 1 вместо Python traceback.
78
+
79
+ ### Added
80
+
81
+ - 19 регрессионных проверок валидации аргументов, путей платформы и файловых
82
+ ошибок; всего 506 тестов, покрытие 98%.
83
+
84
+ ## [0.8.2] — 2026-10-23
85
+
86
+ ### Fixed
87
+
88
+ - `load-config --all-extensions` принимает каталог, созданный
89
+ `dump-config --all-extensions`: `Configuration.xml` находится в подкаталогах
90
+ расширений и больше не требуется в корне.
91
+ - Ошибки чтения и разбора TOML-конфига, а также неверный тип `platform`
92
+ выводятся с путём файла и кодом 1 вместо Python traceback.
93
+
94
+ ### Changed
95
+
96
+ - Версия Python-пакета синхронизирована с релизом: `0.8.2`.
97
+
98
+ ### Added
99
+
100
+ - 8 регрессионных проверок загрузки всех расширений и некорректного конфига;
101
+ всего 487 тестов, покрытие 98%.
102
+
103
+ ## [0.8.1] — 2026-10-23
104
+
105
+ ### Fixed
106
+
107
+ - При таймауте и Ctrl+C оставались работать `1cv8` и `Xvfb` (убивалась только
108
+ обёртка `xvfb-run`), зависший `1cv8` держал ИБ. Теперь 1С запускается в своей
109
+ группе процессов, и завершается вся группа.
110
+ - Ошибка запуска платформы (`OSError`) выводилась трейсбеком — теперь
111
+ «Не удалось запустить 1С: …».
112
+ - README и `references/commands.md` обещали `.cfu` в несуществующем релизе v0.2.4.
113
+
114
+ ### Added
115
+
116
+ - Тесты выбора платформы: `--platform` → `ONEC_OPS_PLATFORM` → конфиг → по умолчанию.
117
+
118
+ ## [0.7.0] — 2026-10-23
119
+
120
+ Выпущен после 0.8.0.
121
+
122
+ ### Added
123
+
124
+ - Команда `update-db` — применение загруженной конфигурации к БД (`/UpdateDBCfg`):
125
+ `--extension` / `--all-extensions`, `--dynamic` / `--no-dynamic`, `--warnings-as-errors`.
126
+ - Skill: `update-db` в списке разрушающих команд; после `repo-bind` / `repo-update` —
127
+ `update-db`; сценарий «Изменения из хранилища в БД».
128
+
129
+ ## [0.8.0] — 2026-10-23
130
+
131
+ ### Changed
132
+
133
+ - `SKILL.md` переписан: `description` со всеми группами операций, правила
134
+ безопасности для агента, коды возврата, таблица всех команд с `--ib`.
135
+ - Пакет навыка самодостаточен: ссылки только на `references/`.
136
+ - `references/commands.md`: оглавление, общие параметры, коды возврата.
137
+ - `references/troubleshooting.md`: оглавление и разделы о платформе,
138
+ дисплее, таймауте, подтверждении, расширениях.
139
+ - README: установка навыка в Claude Code и Codex, обновление копий,
140
+ установка утилиты через pipx из GitHub.
141
+
142
+ ### Added
143
+
144
+ - `references/workflows.md` — типовые сценарии.
145
+ - `tests/test_skill.py` — проверка дрейфа между CLI и навыком.
146
+
147
+ ### Fixed
148
+
149
+ - `create-ib --force --dry-run` удалял существующую ИБ: dry-run больше не удаляет каталог.
150
+ - Сообщение о `--type server` ссылалось на несуществующий релиз v0.1.1.
151
+
152
+ ## [0.6.0] — 2026-10-23
153
+
154
+ ### Added
155
+
156
+ - Команда `list-extensions` — список расширений ИБ в stdout.
157
+ - Команда `check-extension` — проверка, можно ли применить расширение.
158
+ - Команда `delete-extension` — удаление расширения с подтверждением (`--yes` для CI).
159
+ - `run_1c` возвращает текст `/Out` (`OneCCompletedProcess.out_text`).
160
+
161
+ ## [0.5.3] — 2026-10-23
162
+
163
+ ### Added
164
+
165
+ - Общие параметры `--ib-user` / `--ib-password` — пользователь ИБ (`/N`, `/P`)
166
+ для всех команд с `--ib`, включая пакетные.
167
+ - Переменные окружения `ONEC_OPS_IB_USER` / `ONEC_OPS_IB_PASSWORD`.
168
+
169
+ ### Deprecated
170
+
171
+ - `--user` / `--password` у `open-designer` и `open-enterprise` — используйте
172
+ `--ib-user` / `--ib-password`.
173
+
174
+ ## [0.5.2] — 2026-10-22
175
+
176
+ ### Added
177
+
178
+ - Сообщения 1С из `/Out` в журнале и в тексте ошибки CLI: пакетные `DESIGNER`/`CREATEINFOBASE`
179
+ получают `/Out <временный файл>` (UTF-8 с BOM), файл удаляется после запуска.
180
+
181
+ ## [0.5.1] — 2026-10-22
182
+
183
+ ### Added
184
+
185
+ - Команда `repo-add-user` — добавление пользователя в хранилище конфигурации.
186
+ - Опции: `--rights`, `--password`, `--restore-deleted`.
187
+ - Маскирование пароля `-Pwd` в журнале команды.
188
+
189
+ ## [0.5.0] — 2026-10-20
190
+
191
+ ### Added
192
+
193
+ - Команда `repo-create` — создание хранилища конфигурации.
194
+ - Команда `repo-bind` — подключение базы к хранилищу.
195
+ - Команда `repo-update` — обновление из хранилища.
196
+
197
+ ### Known Limitations
198
+
199
+ - Только файловое хранилище (без `crserver`, tcp://, http://).
200
+ - Один пользователь хранилища = одна база (`repo-add-user` — v0.5.1).
201
+
202
+ ## [0.4.0] — 2026-10-19
203
+
204
+ ### Added
205
+
206
+ - Команда `dump-dt` — выгрузка базы в .dt.
207
+ - Команда `restore-dt` — восстановление базы из .dt.
208
+ - Опции: --force, --yes для безопасного восстановления.
209
+
210
+ ## [0.3.0] — 2026-10-11
211
+
212
+ ### Added
213
+
214
+ - Команда `dump-epf` — разборка внешней обработки/отчёта .epf/.erf в XML.
215
+ - Команда `load-epf` — сборка внешней обработки/отчёта .epf/.erf из XML.
216
+
217
+ ## [0.2.3] — 2026-10-10
218
+
219
+ ### Added
220
+
221
+ - Команда `open-designer` — открыть Конфигуратор 1С.
222
+ - Команда `open-enterprise` — открыть клиент 1С.
223
+ - Опции: `--user`, `--password`, `--no-wait`.
224
+ - Для `open-enterprise`: `--execute`, `--c`.
225
+ - Проверки DISPLAY через xdpyinfo и признака sandbox Codex; запуск через Popen.
226
+
227
+ ## [0.2.2] — 2026-10-06
228
+
229
+ ### Changed
230
+
231
+ - `dump-cf` и `load-cf` работают с конфигурацией `.cf` и расширениями `.cfe` через `--extension`.
232
+ - Для `.cfe` требуется `--extension`; для `.cf` эта опция запрещена. Другие суффиксы вызывают WARNING.
233
+ - Исправлена семантика форматов: `.cfu` — обновление конфигурации, `.cfe` — расширение.
234
+
235
+ ### Removed
236
+
237
+ - Команды `dump-cfu` и `load-cfu`, их действия и тесты.
238
+
239
+ ## [0.2.1] — 2026-10-06
240
+
241
+ ### Added
242
+
243
+ - Команда `dump-cf` — выгрузка конфигурации в .cf.
244
+ - Команда `load-cf` — загрузка конфигурации из .cf.
245
+ - Команда `dump-cfu` — выгрузка расширения в .cfu.
246
+ - Команда `load-cfu` — загрузка расширения из .cfu.
247
+
248
+ ## [0.2.0] — 2026-10-06
249
+
250
+ ### Added
251
+
252
+ - Команда `dump-config` — выгрузка конфигурации в XML.
253
+ - Команда `load-config` — загрузка конфигурации из XML.
254
+ - Опции `--format`, `--extension`, `--all-extensions`, `--update-db-cfg`.
255
+ - Общий параметр `--ib` и проверка существующей файловой ИБ.
256
+
257
+ ## [0.1.0] — 2026-10-03
258
+
259
+ ### Added
260
+
261
+ - Кроссплатформенный runner (Linux DISPLAY/xvfb-run, Windows direct).
262
+ - Команда `create-ib --type file` — создание файловой ИБ.
263
+ - Безопасный `--force` с интерактивным подтверждением Y/n.
264
+ - Флаг `--yes` для неинтерактивной среды (CI).
265
+ - Проверка окружения: DISPLAY, xvfb-run, платформа 1С.
266
+ - Таймаут 600 с, UTF-8-декодирование, маскирование паролей.
267
+ - `xvfb-run -a -s "-nolisten unix"` для работы без прав root.
268
+ - Agent Skill: SKILL.md, agents/openai.yaml, references/commands.md.
269
+ - Установка через pipx как глобальная команда `onec-ops`.
270
+ - 20 unit-тестов, покрытие 73%.
271
+
272
+ ### Known Limitations
273
+
274
+ - Codex в sandbox-режиме не может запускать 1С (X11 заблокирован).
275
+ Решение: `sandbox_mode = "danger-full-access"` в `~/.codex/config.toml`.
276
+ - `create-ib --type server` — заглушка (v0.1.1 отложен).
277
+
278
+ [Unreleased]: https://github.com/guesto/onec-ops/compare/v0.9.2...HEAD
279
+ [0.9.2]: https://github.com/guesto/onec-ops/compare/v0.9.1...v0.9.2
280
+ [0.9.1]: https://github.com/guesto/onec-ops/compare/v0.9.0...v0.9.1
281
+ [0.9.0]: https://github.com/guesto/onec-ops/compare/v0.8.4...v0.9.0
282
+ [0.8.4]: https://github.com/guesto/onec-ops/compare/v0.8.3...v0.8.4
283
+ [0.8.3]: https://github.com/guesto/onec-ops/compare/v0.8.2...v0.8.3
284
+ [0.8.2]: https://github.com/guesto/onec-ops/compare/v0.8.1...v0.8.2
285
+ [0.8.1]: https://github.com/guesto/onec-ops/compare/v0.7.0...v0.8.1
286
+ [0.7.0]: https://github.com/guesto/onec-ops/compare/v0.8.0...v0.7.0
287
+ [0.8.0]: https://github.com/guesto/onec-ops/compare/v0.6.0...v0.8.0
288
+ [0.6.0]: https://github.com/guesto/onec-ops/compare/v0.5.3...v0.6.0
289
+ [0.5.3]: https://github.com/guesto/onec-ops/compare/v0.5.2...v0.5.3
290
+ [0.5.2]: https://github.com/guesto/onec-ops/compare/v0.5.1...v0.5.2
291
+ [0.5.1]: https://github.com/guesto/onec-ops/compare/v0.5.0...v0.5.1
292
+ [0.5.0]: https://github.com/guesto/onec-ops/compare/v0.4.0...v0.5.0
293
+ [0.4.0]: https://github.com/guesto/onec-ops/compare/v0.3.0...v0.4.0
294
+ [0.3.0]: https://github.com/guesto/onec-ops/compare/v0.2.3...v0.3.0
295
+ [0.2.3]: https://github.com/guesto/onec-ops/compare/v0.2.2...v0.2.3
296
+ [0.2.2]: https://github.com/guesto/onec-ops/compare/v0.2.1...v0.2.2
297
+ [0.2.1]: https://github.com/guesto/onec-ops/compare/v0.2.0...v0.2.1
298
+ [0.2.0]: https://github.com/guesto/onec-ops/compare/v0.1.0...v0.2.0
299
+ [0.1.0]: https://github.com/guesto/onec-ops/releases/tag/v0.1.0
onec_ops-0.9.3/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Guesto
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.