precommit1c

https://github.com/xdrivendevelopment/precommit1c
Admin
precommit1c is a tool for storing source code of external 1C:Enterprise reports and data processors...
Tokens:2,383
Snippets:34
Trust Score:8.1
License:Apache-2.0
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install precommit1c via OPM

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/README.md

Use the OneScript Package Manager to install the tool and its dependencies globally.

```cmd
opm install precommit1c
```

```cmd
precommit1c --install
```

--------------------------------

### precommit1c CLI usage documentation

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/README.md

Reference for command line parameters including decompile, compile, git-precommit, and installation options.

```text
Утилита сборки/разборки внешних файлов 1С

Параметры командной строки:
        --decompile inputPath outputPath
                Разбор файлов на исходники
        --help
                Показ этого экрана
        --git-check-config
                Проверка настроек репозитория git
        --git-precommit outputPath [--remove-orig-bin-files]
                Запустить чтение индекса из git и определить список файлов для разбора, разложить их и добавить исходники в индекс
                Если передан флаг --remove-orig-bin-files, обработанные файлы epf/erf будут удалены из индекса git
        --compile inputPath outputPath [--recursive]
                Собрать внешний файл/обработку.
                Если указан параметр --recursive, скрипт будет рекурсивно искать исходные коды отчетов и обработок в указанном каталоге и собирать их, повторяя структуру каталога
        --install [--remove-orig-bin-files]
                Установить precommit1c для текущего репозитория git
                Если передан флаг --remove-orig-bin-files, обработанные файлы epf/erf будут удалены из индекса git

Общие параметры:
        --use-designer
                Если передан этот флаг, то для операций сборки/разборки будет использован конфигуратор 1С.
                ТОЛЬКО ДЛЯ ВЕРСИЙ ПЛАТФОРМЫ 8.3.8 И ВЫШЕ!
        --ib-connection-string
                Строка подключения к информационной базе (для Windows-путей обязательно экранировать '\' так: '\\'!)
        --ib-user
                Имя пользователя в информационной базе
        --ib-pwd
                Пароль пользователя в информационной базе
```

--------------------------------

### Run precommit1c CLI help

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/README.md

Display the help screen and available command line parameters for the v8files-extractor utility.

```bash
oscript v8files-extractor.os ?
```

--------------------------------

### Initialize Git Submodules

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/README.md

Commands to initialize submodules after cloning the repository.

```cmd
cd путь/к/репозиторию/precommit1c
git submodule update --init --recursive
```

--------------------------------

### Configure Source Directory

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/src/tests/Fixture/Макеты/ДвоичныеДанные.txt

Specify the source directory for 1C:Enterprise files in the configuration file.

```ini
[DEFAULT]
source = plugin_source
```

--------------------------------

### Enable Debug Logging via Batch Script

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/README.md

Use this batch script to stage files, set the debug log configuration, and execute the precommit1c process.

```bat
git add XXX.epf
@set LOGOS_CONFIG=logger.rootLogger=DEBUG
@precommit1c --git-precommit src
```

--------------------------------

### Configure 1C:Enterprise Path

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/src/tests/Fixture/Макеты/ДвоичныеДанные.txt

Set the PATH1C environment variable to point to the 1C:Enterprise executable directory.

```batch
set PATH1C = d:\program\
```

--------------------------------

### Configure pyv8unpack.ini

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/src/tests/Fixture/Макеты/ДвоичныеДанные.txt

Define the path to the 1C:Enterprise executable in the pyv8unpack.ini configuration file.

```ini
[DEFAULT]
onecplatforms = c:\program\1cv8\8.3.5.823\bin\1cv8.exe
```

--------------------------------

### Configure Git for Binary Files

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/src/tests/Fixture/Макеты/ДвоичныеДанные.txt

Set the local git configuration to prevent path quoting, which is essential for handling non-ASCII characters in file paths.

```bash
git config --local core.quotepath false
```

--------------------------------

### Git Hooks Directory Structure

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/src/tests/Fixture/Макеты/ДвоичныеДанные.txt

Required file structure within the .git/hooks directory for pre-commit automation.

```text
.git\
    hooks\
        pre-commit
        V8Reader.epf
        ibService 
        pyv8unpack.py
```

--------------------------------

### Настройка конфигурации git

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/README.md

Команды для корректной обработки кириллических имен файлов и длинных путей в репозитории.

```shell
git config --local core.quotepath false
git config --local core.longpaths true
```

--------------------------------

### Настройка безопасности 1С

Source: https://github.com/xdrivendevelopment/precommit1c/blob/master/README.md

Строка конфигурации для отключения защиты от небезопасных действий в платформе 1С.

```text
DisableUnsafeActionProtection=.*
```
Tokens:
Raw