{"id":13446525,"url":"https://github.com/vanessa-opensource/vanessa-runner","last_synced_at":"2026-01-26T13:06:54.582Z","repository":{"id":38842952,"uuid":"56483153","full_name":"vanessa-opensource/vanessa-runner","owner":"vanessa-opensource","description":"утилита автоматизации базовых операций разработчика 1С","archived":false,"fork":false,"pushed_at":"2026-01-11T23:29:02.000Z","size":2218,"stargazers_count":241,"open_issues_count":137,"forks_count":117,"subscribers_count":29,"default_branch":"develop","last_synced_at":"2026-01-12T01:11:40.243Z","etag":null,"topics":["1c","1c-devops","devops-1c","hacktoberfest","oscript-lib","oscript-package","vanessa","vanessa-runner"],"latest_commit_sha":null,"homepage":"","language":"1C Enterprise","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vanessa-opensource.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2016-04-18T06:35:56.000Z","updated_at":"2026-01-11T23:29:02.000Z","dependencies_parsed_at":"2023-11-19T10:29:46.054Z","dependency_job_id":"dc2cada3-b4f1-4747-b396-3249069b0df9","html_url":"https://github.com/vanessa-opensource/vanessa-runner","commit_stats":null,"previous_names":["silverbulleters/vanessa-runner"],"tags_count":44,"template":false,"template_full_name":null,"purl":"pkg:github/vanessa-opensource/vanessa-runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanessa-opensource%2Fvanessa-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanessa-opensource%2Fvanessa-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanessa-opensource%2Fvanessa-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanessa-opensource%2Fvanessa-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vanessa-opensource","download_url":"https://codeload.github.com/vanessa-opensource/vanessa-runner/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanessa-opensource%2Fvanessa-runner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28778805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T11:46:04.308Z","status":"ssl_error","status_checked_at":"2026-01-26T11:46:02.664Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["1c","1c-devops","devops-1c","hacktoberfest","oscript-lib","oscript-package","vanessa","vanessa-runner"],"created_at":"2024-07-31T05:00:54.085Z","updated_at":"2026-01-26T13:06:54.566Z","avatar_url":"https://github.com/vanessa-opensource.png","language":"1C Enterprise","funding_links":[],"categories":["Библиотеки и утилиты для работы"],"sub_categories":[],"readme":"\u003ca id=\"markdown-автоматизация-повседневных-операций-1с-разработчика\" name=\"автоматизация-повседневных-операций-1с-разработчика\"\u003e\u003c/a\u003e\r\n# Автоматизация повседневных операций 1С разработчика\r\n\r\n[![Chat on Telegram vanessa_opensource_chat](https://img.shields.io/badge/chat-Telegram-brightgreen.svg)](https://t.me/vanessa_opensource_chat)\r\n[![GitHub release](https://img.shields.io/github/release/vanessa-opensource/vanessa-runner.svg)](https://github.com/vanessa-opensource/vanessa-runner/releases) \r\n[![Тестирование](https://github.com/vanessa-opensource/vanessa-runner/actions/workflows/testing.yml/badge.svg)](https://github.com/vanessa-opensource/vanessa-runner/actions/workflows/testing.yml)\r\n[![Статус Порога Качества](https://sonar.openbsl.ru/api/project_badges/measure?project=vanessa-runner\u0026metric=alert_status)](https://sonar.openbsl.ru/dashboard?id=vanessa-runner) \r\n[![Покрытие](https://sonar.openbsl.ru/api/project_badges/measure?project=vanessa-runner\u0026metric=coverage)](https://sonar.openbsl.ru/dashboard?id=vanessa-runner)\r\n[![Технический долг](https://sonar.openbsl.ru/api/project_badges/measure?project=vanessa-runner\u0026metric=sqale_index)](https://sonar.openbsl.ru/dashboard?id=vanessa-runner)\r\n[![Строки кода](https://sonar.openbsl.ru/api/project_badges/measure?project=vanessa-runner\u0026metric=ncloc)](https://sonar.openbsl.ru/dashboard?id=vanessa-runner) \r\n\r\n\u003c!-- [![Статус Порога Качества](https://sonar.openbsl.ru/api/project_badges/measure?project=vanessa-runner\u0026metric=alert_status)](https://sonar.openbsl.ru/dashboard?id=vanessa-runner) [![Покрытие](https://sonar.openbsl.ru/api/project_badges/measure?project=vanessa-runner\u0026metric=coverage)](https://sonar.openbsl.ru/dashboard?id=vanessa-runner) [![Строки кода](https://sonar.openbsl.ru/api/project_badges/measure?project=vanessa-runner\u0026metric=ncloc)](https://sonar.openbsl.ru/dashboard?id=vanessa-runner) --\u003e\r\n\r\n\u003c!-- TOC --\u003e\r\n\r\n- [Автоматизация повседневных операций 1С разработчика](#автоматизация-повседневных-операций-1с-разработчика)\r\n  - [Описание](#описание)\r\n- [Автоматизация повседневных операций 1С разработчика](#автоматизация-повседневных-операций-1с-разработчика-1)\r\n- [Описание](#описание-1)\r\n  - [Установка](#установка)\r\n  - [Использование](#использование)\r\n    - [Создание проекта](#создание-проекта)\r\n      - [Примеры создания проекта](#примеры-создания-проекта)\r\n        - [1. Создание проекта по указанному шаблону](#1-создание-проекта-по-указанному-шаблону)\r\n        - [2. Создание проекта по файлу настроек](#2-создание-проекта-по-файлу-настроек)\r\n        - [3. Сборка обработок при создании проекта](#3-сборка-обработок-при-создании-проекта)\r\n    - [Сборка обработок и конфигураций](#сборка-обработок-и-конфигураций)\r\n    - [Примеры настройки и вызова](#примеры-настройки-и-вызова)\r\n      - [1. Создание ИБ из последней конфигурации хранилища 1С, обновление в режиме Предприятия и первоначальное заполнение ИБ](#1-создание-иб-из-последней-конфигурации-хранилища-1с-обновление-в-режиме-предприятия-и-первоначальное-заполнение-иб)\r\n      - [2. Вызов модульных тестов через Vanessa-ADD (TDD)](#2-вызов-модульных-тестов-через-vanessa-add-tdd)\r\n      - [3. Вызов проверки поведения через Vanessa-ADD (BDD)](#3-вызов-проверки-поведения-через-vanessa-add-bdd)\r\n      - [4. Переопределение аргументов запуска](#4-переопределение-аргументов-запуска)\r\n      - [Переопределение переменной окружения](#переопределение-переменной-окружения)\r\n        - [Установка значения](#установка-значения)\r\n      - [Шаблонные переменные](#шаблонные-переменные)\r\n    - [Вывод отладочной информации](#вывод-отладочной-информации)\r\n      - [Примеры](#примеры)\r\n    - [Дополнительные обработки для режима 1С:Предприятие](#дополнительные-обработки-для-режима-1спредприятие)\r\n    - [Дополнительная настройка различных команд](#дополнительная-настройка-различных-команд)\r\n      - [Настройка синтаксической проверки](#настройка-синтаксической-проверки)\r\n      - [Настройка режимов реструктуризации при обновлении конфигурации БД](#настройка-режимов-реструктуризации-при-обновлении-конфигурации-бд)\r\n\r\n\u003c!-- /TOC --\u003e\r\n\r\n\u003ca id=\"markdown-описание\" name=\"описание\"\u003e\u003c/a\u003e\r\n## Описание\r\nАвтоматизация повседневных операций 1С разработчика\r\n==\r\n\r\nОписание\r\n===\r\n\r\nКонсольное приложение проекта `oscript.io` для автоматизации различных операции для работы с `cf/cfe/epf` файлами, а также автоматизация  запуска сценариев поведения (BDD) и тестов из фреймворка [Vanessa-ADD](https://github.com/vanessa-opensource/add).\r\n\r\nПредназначено для организации разработки 1С в режиме, когда работа в git идет напрямую с исходниками или работаем через хранилище 1С.\r\n\r\nПозволяет обеспечить единообразный запуск команд \"локально\" и на серверах сборки `CI-CD`\r\n\r\n\u003ca id=\"markdown-установка\" name=\"установка\"\u003e\u003c/a\u003e\r\n## Установка\r\n\r\nиспользуйте пакетный менеджер `opm` из стандартной поставки дистрибутива `oscript.io`\r\n\r\n```cmd\r\nopm install vanessa-runner\r\n```\r\n\r\nпри установке будет создан исполняемый файл `vrunner` в каталоге `bin` интерпретатора `oscript`.\r\n\r\nПосле чего доступно выполнение команд через командную строку `vrunner \u003cимя команды\u003e`\r\n\r\n\u003ca id=\"markdown-использование\" name=\"использование\"\u003e\u003c/a\u003e\r\n\r\n## Использование\r\n\r\nКлюч `help` покажет справку по параметрам.\r\n\r\n```cmd\r\nvrunner help\r\n```\r\n\r\nили внутри батника (**ВАЖНО**) через `call`\r\n```cmd\r\ncall vrunner help\r\n```\r\n\r\nОсновной принцип - запустили bat файл с настроенными командами и получили результат.\r\n\r\n\u003ca id=\"markdown-создание-проекта\" name=\"создание-проекта\"\u003e\u003c/a\u003e\r\n### Создание проекта\r\n\r\nС помощью команды `init-project` можно создать структуру проекта следующими командами:\r\n\r\n```cmd\r\nvrunner init-project \r\n```\r\n\u003cimg src=\"examples/init-project.png\" alt=\"vrunner init-project\" /\u003e\r\n\r\nКоманда клонирует шаблон \u003ca href=\"https://github.com/vanessa-opensource/vanessa-bootstrap\"\u003evanessa-bootstrap\u003c/a\u003e и предложит для установки три библиотеки для проекта:\r\n\r\n- \u003ca href=\"https://github.com/oscript-library/gitsync\"\u003egitsync\u003c/a\u003e\r\n- \u003ca href=\"https://github.com/otymko/gitrules\"\u003egitrules\u003c/a\u003e\r\n- \u003ca href=\"https://github.com/xDrivenDevelopment/precommit1c\"\u003eprecommit1c\u003c/a\u003e\r\n\r\n#### Примеры создания проекта\r\n\r\n#### 1. Создание проекта по указанному шаблону\r\n\r\n```cmd\r\nvrunner init-project --template https://github.com/user/myrepo.git\r\n```\r\n`--template` cсылка на шаблон, из которого будет клонироваться проект.\r\n\r\nПри использовании ключа `--template` клонируется указанный шаблон, считываются пакеты из env файла шаблона, если пакеты не заданы предлагаются библиотеки по умолчанию.\r\n\r\n#### 2. Создание проекта по файлу настроек\r\n\r\n```cmd\r\nvrunner init-project --settings my-path/env.json\r\n```\r\n\r\n`--settings` путь к файлу env. \u003ca href=\"examples/example.env.json\" target=\"_blank\"\u003eПример файла настроек\u003c/a\u003e.\r\n\r\nДобавлены следующие настройки:\r\n\r\n```json\r\n{\r\n \"init-project\": {\r\n        \"ШаблонПроекта\": {\r\n            \"Использовать\": true,\r\n            \"Репозиторий\": \"https://github.com/vanessa-opensource/vanessa-bootstrap.git\"\r\n        },\r\n        \"Пакеты\": [\r\n            {\r\n                \"Имя\": \"gitsync\",\r\n                \"Использовать\": true,\r\n                \"Установка\": [\r\n                    \"opm install gitsync\"\r\n                ]\r\n            },\r\n            {\r\n                \"Имя\": \"gitrules\",\r\n                \"Использовать\": true,\r\n                \"Установка\": [\r\n                    \"opm install gitrules\",\r\n                    \"gitrules install\"\r\n                ]\r\n            },\r\n            {\r\n                \"Имя\": \"precommit1c\",\r\n                \"Использовать\": false,\r\n                \"Установка\": [\r\n                    \"opm install precommit1c\",\r\n                    \"precommit1c --install\"\r\n                ]\r\n            }\r\n        ]\r\n    }\r\n}\r\n```\r\n\r\nДля установки пакетов `gitrules` и `precommit1c` последовательно выполняются указанные команды.\r\n\r\nПри использовании ключа `--settings` считываются пакеты из указанного файла env, если пакеты не заданы предлагаются библиотеки по умолчанию.\r\n\r\n#### 3. Сборка обработок при создании проекта\r\n\r\nВы можете объединить несколько команд в файл `cmd / bat` и указать его как пакет:\r\n```json\r\n       \"Пакеты\": [\r\n            {\r\n                \"Имя\": \"compile\",\r\n                \"Использовать\": true,\r\n                \"Установка\": [\r\n                    \"compileEpf.cmd\"\r\n                ]\r\n            }\r\n        ]\r\n```\r\nВ данном примере будут собраны обработки при создании проекта. Содержимое файла `compileEpf.cmd`:\r\n```cmd\r\ncall vrunner compileepf src/tools tools/epf/utils\r\ncall vrunner compileepf src/tests tests/smoke \r\ncall vrunner compileepf src/epf tools/epf\r\n```\r\n\r\n\u003ca id=\"markdown-сборка-обработок-и-конфигураций\" name=\"сборка-обработок-и-конфигураций\"\u003e\u003c/a\u003e\r\n### Сборка обработок и конфигураций\r\n\r\nДля сборки обработок необходимо иметь установленный oscript в переменной PATH и платформу выше 8.3.8\r\n\r\nВ командной строке нужно перейти в каталог с проектом и выполнить ```tools\\compile_epf.bat```, по окончанию в каталоге build\\epf должны появиться обработки.\r\nВся разработка в конфигураторе делается в каталоге build, по окончанию доработок запускаем ```tools\\decompile_epf.bat```\r\n\r\nОбязательно наличие установленного v8unpack версии не ниже 3.0.38 в переменной PATH.\r\n  - Установку можно взять в релизах утилиты - https://github.com/e8tools/v8unpack/releases\r\n  - Подробнее про утилиту v8unpack - https://github.com/e8tools/v8unpack\r\n\r\n\u003ca id=\"markdown-примеры-настройки-и-вызова\" name=\"примеры-настройки-и-вызова\"\u003e\u003c/a\u003e\r\n### Примеры настройки и вызова\r\n\r\n\u003ca id=\"markdown-1-создание-иб-из-последней-конфигурации-хранилища-1с-обновление-в-режиме-предприятия-и-первоначальное-заполнение-иб\" name=\"1-создание-иб-из-последней-конфигурации-хранилища-1с-обновление-в-режиме-предприятия-и-первоначальное-заполнение-иб\"\u003e\u003c/a\u003e\r\n#### 1. Создание ИБ из последней конфигурации хранилища 1С, обновление в режиме Предприятия и первоначальное заполнение ИБ\r\n\r\n\r\n`1с-init.cmd` :\r\n\r\n```bat\r\n@rem Полная инициализация из репозитария, обновление в режиме Предприятия и начальное заполнение ИБ ./build/ibservice\r\n\r\n@rem Пример запуска 1с-init.cmd storage-user storage-password\r\n\r\n@chcp 65001\r\n\r\n@set RUNNER_IBNAME=/F./build/ibservice\r\n\r\n@call vrunner init-dev --storage --storage-name http:/repo-1c --storage-user %1 --storage-pwd %2\r\n\r\n@call vrunner run --command \"ЗапуститьОбновлениеИнформационнойБазы;ЗавершитьРаботуСистемы;\" --execute $runnerRoot\\epf\\ЗакрытьПредприятие.epf\r\n\r\n@call vrunner vanessa --settings tools/vrunner.first.json\r\n\r\n@rem Если убрать комментарий из последней строки, тогда можно выполнять полный прогон bdd-фич\r\n@rem @call vrunner vanessa --settings tools/vrunner.json\r\n```\r\n\r\n#### 2. Вызов модульных тестов через Vanessa-ADD (TDD)\r\n\r\n+ запуск `vrunner xunit tests --settings tools/vrunner.json`\r\n  + или внутри батника\r\n    + `call vrunner xunit --settings tools/vrunner.json`\r\n\r\n+ пример vrunner.json:\r\n\r\n```json\r\n{\r\n    \"default\": {\r\n        \"--ibconnection\": \"/F./build/ib\",\r\n        \"--db-user\": \"Администратор\",\r\n        \"--db-pwd\": \"\",\r\n        \"--ordinaryapp\": \"-1\"\r\n    },\r\n    \"xunit\": {\r\n        \"--xddConfig\": \"tools/JSON/xUnitParams.json\",\r\n        \"testsPath\": \"tests/smoke\",\r\n        \"--reportsxunit\": \"ГенераторОтчетаJUnitXML{build/smoke/junit/xddreport.xml};ГенераторОтчетаAllureXML{build/smoke/allure/allure-testsuite.xml}\",\r\n        \"--xddExitCodePath\": \"build/xddExitCodePath.txt\",\r\n        \"--testclient\": \"Автотест:123:48223\",\r\n        \"--testclient-additional\" : \"/iTaxi\"\r\n    }\r\n}\r\n```\r\n\r\nФормат файла настройки (в примере xUnitParams.json) для тестов смотрите в [справке Vanessа-ADD](https://github.com/vanessa-opensource/add/tree/develop/tests/smoke#%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B4%D1%8B%D0%BC%D0%BE%D0%B2%D1%8B%D1%85-%D1%82%D0%B5%D1%81%D1%82%D0%BE%D0%B2-%D0%BF%D0%BE%D0%B4-%D0%BA%D0%BE%D0%BD%D0%BA%D1%80%D0%B5%D1%82%D0%BD%D1%83%D1%8E-%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8E)\r\n\r\nПодсказка из командной строки\r\n```\r\nvrunner xunit \u003ctestsPath\u003e [прочие-ключи] ...\r\n \u003ctestsPath\u003e - [env RUNNER_TESTSPATH] Путь к каталогу или к файлу с тестами - tests\\ТестыПродаж или tests\\ТестыПродаж\\ТестОптовойПродажи.epf\r\nили к встроенным тестам (общие модули из тестовых расширений или подсистемы\\обработки из конфигурации), если явно указан ключ --config-tests.                                                  \r\nЕсли тесты в виде общих клиентских или серверных модулей в расширениях\\конфигурации, то указать просто имя расширения или имя конфигурации. например, Тесты_Продажи или ADD_TDD.\r\nВозможные варианты указания подсистемы или конкретного теста:                                                                           \r\n        Метаданные.Подсистемы.Тестовая или Метаданные.Подсистемы.Тестовая.Подсистемы.Подсистема1 или Метаданные.Обработки.Тест                                                                 \r\nМожно использовать переменную $addRoot, означающую каталог установки библиотеки Vanessa-ADD. Например, $addRoot/tests/smoke для запуска дымовых тестов.                                        \r\n --workspace - [env RUNNER_WORKSPACE] путь к папке, относительно которой будут определяться макросы $workspace. по умолчанию текущий.                                                          \r\n --config-tests - [env RUNNER_CONFIG_TESTS] загружать тесты, встроенные в конфигурации в указанную подсистему в виде обработок                                                                                  \r\n --pathxunit - [env RUNNER_PATHXUNIT] путь к внешней обработке, по умолчанию ищу в пакете vanessa-add                                                                                          \r\n --reportsxunit -     --reportsxunit параметры формирования отчетов в формате вида:      ФорматВыводаОтчета{Путь к файлу отчета};ФорматВыводаОтчета{Путь к файлу отчета}...      \r\n   Пример:  ГенераторОтчетаJUnitXML{build/junit.xml};ГенераторОтчетаAllureXML{build/allure.xml}    \r\n   Пример (англоязычный вариант): GenerateReportJUnitXML{build/junit.xml};GenerateReportAllureXML{build/a\r\nllure.xml}                                                                                                                                                                                     \r\n --xddExitCodePath - путь к текстовому файлу, обозначающему статус выполнению.    Внутри файла строка-значение 0 (тесты пройдены), 1 (тесты не пройдены)                                       \r\n --xddConfig - Путь к конфигурационному файлу xUnitFor1c                                                                                                                                       \r\n --testclient - Параметры подключения к тест-клиенту вида --testclient ИмяПользователя:Пароль:Порт    Пример 1: --testclient Администратор:пароль:1538    Пример 2: --testclient ::1538 (клиент\r\n тестирования будет запущен с реквизитами менеджера тестирования)                                                                                                                              \r\n --testclient-additional - Дополнительные параметры, передаваемые приложению 1С при запуске тест-клиента                                                                                       \r\n --reportxunit - путь к каталогу с отчетом jUnit (устарел)                                                                                                                                     \r\n --additional - Дополнительные параметры для запуска предприятия.                                                                                                                              \r\n --no-wait - Не ожидать завершения запущенной команды/действия                                                                                                                                 \r\n --xdddebug - Выводить отладочные сообщения при прогоне тестов                                                                                                                                 \r\n --no-shutdown - Не завершать работу 1С:Предприятие после выполнения тестов                                                                                                                    \r\n ```\r\n\r\n\u003ca id=\"markdown-2-вызов-проверки-поведения-через-vanessa-add\" name=\"2-вызов-проверки-поведения-через-vanessa-add\"\u003e\u003c/a\u003e\r\n#### 3. Вызов проверки поведения через Vanessa-ADD (BDD)\r\n\r\n+ запуск `vrunner vanessa --settings tools/vrunner.json`\r\n  + или внутри батника\r\n    + `call vrunner vanessa --settings tools/vrunner.json`\r\n\r\n+ пример vrunner.json:\r\n\r\n```json\r\n{\r\n    \"default\": {\r\n        \"--ibconnection\": \"/F./build/ib\",\r\n        \"--db-user\": \"Администратор\",\r\n        \"--db-pwd\": \"\",\r\n        \"--ordinaryapp\": \"-1\"\r\n    },\r\n    \"vanessa\": {\r\n        \"--vanessasettings\": \"./tools/VBParams.json\",\r\n        \"--workspace\": \".\",\r\n        \"--additional\": \"/DisplayAllFunctions /L ru\"\r\n    }\r\n}\r\n```\r\n\r\n+ пример VBParams.json\r\n\r\n```json\r\n{\r\n    \"ВыполнитьСценарии\": true,\r\n    \"ЗавершитьРаботуСистемы\": true,\r\n    \"ЗакрытьTestClientПослеЗапускаСценариев\": true,\r\n    \"КаталогФич\": \"$workspaceRoot/features/01-СистемаУправления\",\r\n    \"СписокТеговИсключение\": [\r\n        \"IgnoreOnCIMainBuild\",\r\n        \"FirstStart\",\r\n        \"Draft\"\r\n    ],\r\n    \"КаталогиБиблиотек\": [\r\n        \"./features/Libraries\"\r\n    ],\r\n    \"ДелатьОтчетВФорматеАллюр\": true,\r\n    \"КаталогOutputAllureБазовый\": \"$workspaceRoot/build/out/allure\",\r\n    \"ДелатьОтчетВФорматеCucumberJson\": true,\r\n    \"КаталогOutputCucumberJson\": \"$workspaceRoot/build/out/cucumber\",\r\n    \"ВыгружатьСтатусВыполненияСценариевВФайл\": true,\r\n    \"ПутьКФайлуДляВыгрузкиСтатусаВыполненияСценариев\": \"$workspaceRoot/build/out/vbStatus.log\",\r\n    \"ДелатьЛогВыполненияСценариевВТекстовыйФайл\": true,\r\n    \"ИмяФайлаЛогВыполненияСценариев\": \"$workspaceRoot/build/out/vbOnline.log\"\r\n}\r\n```\r\nФормат файлов настройки и других параметров запуска BDD смотрите в [справке Vanessа-ADD](https://github.com/vanessa-opensource/add/blob/develop/doc/%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B8-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8F-%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA%D0%B0.md)\r\n\r\nПодсказка из командной строки\r\n```\r\nvrunner vanessa --path \u003cbddPath\u003e [прочие-ключи] ...\r\n --path - Путь для запуска тестов                                                                                              \r\nВ параметре \u003cbddPath\u003e можно указывать как каталог с фичами, так и конкретную фичу                                                                    \r\n --vanessasettings - [env RUNNER_VANESSASETTINGS] путь к файлу настроек фреймворка тестирования                                \r\n --pathvanessa - [env RUNNER_PATHVANESSA] путь к внешней обработке, по умолчанию \u003cOneScript\u003e/lib/add/bddRunner.epf             \r\n           или переменная окружения RUNNER_PATHVANESSA                                                                         \r\n --workspace - [env RUNNER_WORKSPACE] путь к папке, относительно которой будут определятся макросы $workspace. по умолчанию текущий.                                                                                         \r\n --tags-ignore - Теги игнорирования фича-файлов                                                                                \r\n --tags-filter - Теги отбор фича-файлов                                                                                        \r\n --additional - Дополнительные параметры для запуска предприятия.                                                              \r\n --additional-keys - Дополнительные параметры, передаваемые в параметр /С.                                                     \r\n --no-wait - Не ожидать завершения запущенной команды/действия                                                                 \r\n ```\r\n\r\n\u003ca id=\"markdown-3-переопределение-аргументов-запуска\" name=\"3-переопределение-аргументов-запуска\"\u003e\u003c/a\u003e\r\n#### 4. Переопределение аргументов запуска\r\n\r\nВ случае необходимости переопределения параметров запуска используется схема приоритетов.\r\n\r\nПриоритет в порядке возрастания (от минимального до максимального приоритета)\r\n+ `env.json (в корне проекта)`\r\n+ `--settings ../env.json (указание файла настроек вручную)`\r\n+ `RUNNER_* (из переменных окружения)`\r\n+ `--* (ключи командной строки)`\r\n\r\nОписание:\r\n+ На первоначальном этапе читаются настройки из файла настроек, указанного в ключе команды ```--settings tools/vrunner.json```\r\n+ Потом, если настройка есть в переменной окружения, тогда берем из неe.\r\n+ Если же настройка есть, как в файле json, так и в переменной окружения и непосредственно в командной строке, то берем настройку из командной строки.\r\n\r\nНапример:\r\n\r\n\u003ca id=\"markdown-переопределение-переменной-окружения\" name=\"переопределение-переменной-окружения\"\u003e\u003c/a\u003e\r\n#### Переопределение переменной окружения\r\n\r\n\u003ca id=\"markdown-установка-значения\" name=\"установка-значения\"\u003e\u003c/a\u003e\r\n##### Установка значения\r\n\r\n  1. Допустим, в файле vrunner.json указана настройка\r\n        ```json\r\n        \"--db-user\":\"Администратор\"\r\n        ```\r\n        а нам для определенного случая надо переопределить имя пользователя,\r\n        тогда можно установить переменную: ```set RUNNER_DBUSER=Иванов``` и в данный параметр будет передано значение `Иванов`\r\n\r\n  2. Очистка значения после установки\r\n        ```cmd\r\n        set RUNNER_DBUSER=Иванов\r\n        set RUNNER_DBUSER=\r\n        ```\r\n        в данном случае установлено полностью пустое значение и имя пользователя будет взято из tools/vrunner.json, если оно там есть.\r\n\r\n  3. Установка пустого значения:\r\n        ```cmd\r\n        set RUNNER_DBUSER=\"\"\r\n        set RUNNER_DBUSER=''\r\n        ```\r\n\r\n        Если необходимо установить в поле пустое значение, тогда указываем кавычки и в параметр `--db-user` будет установлена пустая строка.\r\n\r\n  4. Переопределение через параметры командной строки.\r\n\r\n        Любое указание параметра в командной строке имеет наивысший приоритет.\r\n\r\n\u003ca id=\"markdown-шаблонные-переменные\" name=\"шаблонные-переменные\"\u003e\u003c/a\u003e\r\n#### Шаблонные переменные\r\n\r\nПри указании значений параметров внутри строки с параметром можно использовать шаблонные переменные.\r\nСписок таких переменных:\r\n\r\n+ workspaceRoot - означает каталог текущего проекта\r\n+ runnerRoot - означает каталог установки Vanessa-Runner\r\n+ addRoot - означает каталог установки библиотеки Vanessa-ADD\r\n\r\n\u003ca id=\"markdown-вывод-отладочной-информации\" name=\"вывод-отладочной-информации\"\u003e\u003c/a\u003e\r\n### Вывод отладочной информации\r\n\r\nУправление выводом логов выполняется с помощью типовой для oscript-library настройки логирования через пакет logos.\r\n\r\nОсновной лог vanessa-runner имеет название ``oscript.app.vanessa-runner``.\r\n\r\n\u003ca id=\"markdown-примеры\" name=\"примеры\"\u003e\u003c/a\u003e\r\n#### Примеры\r\n\r\nВключение всех отладочных логов:\r\n\r\n```bat\r\nrem только для logos версии \u003e=0.6\r\nset LOGOS_CONFIG=logger.rootLogger=DEBUG\r\n\r\ncall vrunner \u003cпараметры запуска\u003e\r\n```\r\n\r\nЕсли выводится сообщение про неправильные параметры командной строки:\r\n\r\n```bat\r\nset LOGOS_CONFIG=logger.oscript.lib.cmdline=DEBUG\r\ncall vrunner \u003cпараметры запуска\u003e\r\n```\r\n\r\nВключит отладочный лог только для библиотеки cmdline, которая анализирует параметры командной строки.\r\n\r\n\u003ca id=\"markdown-дополнительные-обработки-для-режима-1спредприятие\" name=\"дополнительные-обработки-для-режима-1спредприятие\"\u003e\u003c/a\u003e\r\n### Дополнительные обработки для режима 1С:Предприятие\r\n\r\nВ папке epf есть несколько обработок, позволяющих упростить развертывание/тестирование для конфигураций, основанных на БСП.\r\n\r\n+ Основной пример (см. ниже пример вызова) - это передача через параметры `/C` команды `\"ЗапуститьОбновлениеИнформационнойБазы;ЗавершитьРаботуСистемы\"` и одновременная передача через `/Execute \"ЗакрытьПредприятие.epf\"`.\r\n\r\n  + При запуске с такими ключами подключается обработчик ожидания, который проверяет наличие формы с заголовком обновления и при окончании обновления завершает 1С:Предприятие. Данное действие необходимо для полного обновления информационной базы 1С:Предприятия, пока действует блокировка на фоновые задачи и запуск пользователей.\r\n\r\n  + также выполняется отключение запроса при завершении работы программы для БСП-конфигураций\r\n\r\n  + код запуска\r\n\r\n```bat\r\n  @call vrunner run --command \"ЗапуститьОбновлениеИнформационнойБазы;ЗавершитьРаботуСистемы;\" --execute $runnerRoot\\epf\\ЗакрытьПредприятие.epf\r\n```\r\n\r\n+ **ЗагрузитьРасширение** позволяет подключать расширение в режиме предприятия и получать результат ошибки. Предназначено для подключения в конфигурациях, основанных на БСП. В параметрах /C передается путь к расширению и путь к файлу лога подключения.\r\n\r\n+ **ЗагрузитьВнешниеОбработки** позволяет загрузить все внешние обработки и подключить в справочник \"Дополнительные отчеты и обработки\", т.к. их очень много то первым параметром идет каталог, вторым параметром путь к файлу лога. Все обработки обновляются согласно версиям.\r\n\r\n+ **СозданиеПользователей** позволяет создать первого пользователя-администратора, если в ИБ еще не существует пользователей. Администратор назначается роль `ПолныеПрава`, если она существует в ИБ.\r\n\r\n  + также выполняется отключение запроса при завершении работы программы для БСП-конфигураций\r\n\r\n  + код запуска для создания пользователя с именем `Администратор`\r\n\r\n```bat\r\n      @call vrunner run --command \"СоздатьАдминистратора;Имя=Администратор;ЗавершитьРаботуСистемы\" --execute $runnerRoot\\epf\\СоздатьПользователей.epf\r\n```\r\n\r\n\u003ca id=\"markdown-дополнительная-настройка-различных-команд\" name=\"дополнительная-настройка-различных-команд\"\u003e\u003c/a\u003e\r\n### Дополнительная настройка различных команд\r\n\r\n\u003ca id=\"markdown-настройка-синтаксической-проверки\" name=\"настройка-синтаксической-проверки\"\u003e\u003c/a\u003e\r\n#### Настройка синтаксической проверки\r\n\r\nДля управления режима синтаксической проверки рекомендуется использовать json-файл настройки.\r\nДля его использования нужно\r\n- установить путь к нему в параметре `VRUNNER_CONF`\r\n- внутри json-файла нужно добавить секцию `syntax-check`\r\n- список всех используемых параметров можно уточнить, выполнив команду `vrunner help syntax-check`\r\n- ссылка на подготовленный файл [examples\\example.env.json](./examples/example.env.json)\r\n- также можно передавать параметры синтакс-проверки через командную строку\r\n  - в этом случае режимы проверки должны быть указаны **последним** параметров ком.строки последовательно, через пробел\r\n    -  например, `vrunner syntax-check --groupbymetadata --mode -ExtendedModulesCheck -Server -ThinClient -ExternalConnection`\r\n\r\nПример настройки в файле\r\n```json\r\n{\r\n    \"syntax-check\": {\r\n        \"--groupbymetadata\":true,\r\n        \"--exception-file\":\"\",\r\n        \"--mode\": [\r\n            \"-ExtendedModulesCheck\",\r\n            \"-ThinClient\",\r\n             \"-WebClient\",\r\n             \"-Server\",\r\n             \"-ExternalConnection\",\r\n             \"-ThickClientOrdinaryApplication\"\r\n             // \"-Extension\" : \"ИмяРасширения\",\r\n             // \"-AllExtensions\" : true\r\n        ]\r\n    }\r\n}\r\n```\r\n\r\n\u003ca id=\"markdown-настройка-режимов-реструктуризации-при-обновлении-конфигурации-бд\" name=\"настройка-режимов-реструктуризации-при-обновлении-конфигурации-бд\"\u003e\u003c/a\u003e\r\n#### Настройка режимов реструктуризации при обновлении конфигурации БД\r\n\r\nВозможно использование специальных режимов реструктуризации `-v1` и `-v2`.\r\n\r\n- В режиме командной строки\r\n  - указываются ключи `--v1` и `--v2`. Важно: указать двойной знак `--`, а не одиночный!\r\n  - 3 команды поддерживают эти ключи\r\n    - `init-dev`\r\n    - `update-dev`\r\n    - `updatedb`\r\n  - например, `vrunner updatedb --ibconnection /F./build/ibservice --uccode test --v2`\r\n- в json-файле настройки\r\n  - например,\r\n\r\n```json\r\n{\r\n    \"updatedb\": {\r\n        \"--v2\": true,\r\n        \"--uccode\": \"test\"\r\n    },\r\n    \"init-dev\": {\r\n        \"--v2\": true\r\n    }\r\n    },\r\n    \"update-dev\": {\r\n        \"--v2\": true\r\n    }\r\n}\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanessa-opensource%2Fvanessa-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanessa-opensource%2Fvanessa-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanessa-opensource%2Fvanessa-runner/lists"}