mirror of
https://github.com/bia-technologies/precommit4onec.git
synced 2025-02-03 13:11:20 +02:00
47 lines
4.4 KiB
Markdown
47 lines
4.4 KiB
Markdown
# Утилита для автоматической обработки исходных файлов конфигурации, внешних отчетов и обработок для платформы 1С:Предприятие при помещении в репозиторий git
|
|
|
|
Данное решение базируется на идеях проекта [precommit1c](https://github.com/xDrivenDevelopment/precommit1c/releases), но является самостоятельным решением.
|
|
|
|
## Почему не precommit1c
|
|
|
|
Указанным продуктом пользовались долгое время, он очень хорош, но потребность в развитии и невозможность реализации некоторых сценариев работы в публичной версии сподвигли к реализации нового решения.
|
|
|
|
Особенности данного решения:
|
|
|
|
- Возможность расширения функциональности под свои нужды без потери совместимости с публичной версией
|
|
- Централизованная установка и обновление скриптов без необходимости утяжелять репозиторий проекта
|
|
- Максимально использует возможности платформы 1С:Предприятие последних версий (тестировалось на 8.3.10+, возможно на версиях 8.3.8-9 тоже будет работать)
|
|
- Возможность хранить внешние отчеты, обработки и расширения с одинаковыми именами
|
|
- Корректно обрабатывается удаление файлов
|
|
|
|
## Установка
|
|
|
|
Установка на компьютер стандартна
|
|
|
|
- `opm install precommit4onec` или
|
|
- распаковать в нужный каталог архив репозитория
|
|
|
|
## Использование
|
|
|
|
Перед использованием необходима установка precommit-hook'а в репозиторий:
|
|
|
|
- для выполнения установки в конкретный репозиторий необходимо выполнить команду `precommit4onec install repo_name`
|
|
- для выполнения установки во все репозитории каталога необходимо выполнить команду`precommit4onec install folder_reps -к`
|
|
|
|
После этого, при каждом коммите будет выполняться обработка файлов.
|
|
|
|
В комплекте присутствуют следующие сценарии обработки файлов:
|
|
|
|
- `РазборОтчетОбработокРасширений` - при выполнении данного сценария, файлы внешних отчетов, обработок и расширений средствами платформы будут разложены на исходные файлы и помещены в каталог исходных файлов репозитория в подкаталоги, соответствующие расширениям. Например внешний отчет `ВнешнийОтчет1.erf` будет разложен в каталог `src\erf\ВнешнийОтчет1`
|
|
- `РазборОбычныхФормНаИсходники` - при выполнении данного сценария, файлы обычных форм (`Form.bin`) раскладываются на исходные файлы с помощью инструмента `v8unpack`
|
|
|
|
## Расширение функциональности
|
|
|
|
Для добавления своих сценариев обработки файлов необходимо создать новый сценарий в каталоге `СценарииОбработки` скрипта используя соответствующий шаблон. Новый сценарий автоматически подключится.
|
|
|
|
## Ссылки
|
|
|
|
- [Шаблон скрипта](https://github.com/oscript-library/oscript-app-template)
|
|
- [precommit1c](https://github.com/xDrivenDevelopment/precommit1c/releases)
|
|
- [Библиотека os-скриптов](https://github.com/oscript-library)
|