# e1c-repo-tools

> Tools for 1C enterprise repository

Latest version **0.2.2** (published 2020-12-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install e1c-repo-tools
pnpm add e1c-repo-tools
yarn add e1c-repo-tools
bun add e1c-repo-tools
```

Provides the commands `e1c-dump`, `e1c-build`, `e1c-precommit-hook`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.2 |
| Published | 2020-12-24 |
| First published | 2020-12-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 39.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Maintainers | cinex-ru |
| Keywords | 1C, 1С, precommit-hook, e1c, repository-tools |

## Links

- npm: https://www.npmjs.com/package/e1c-repo-tools
- Repository: https://github.com/cinex-ru/e1c-repo-tools
- npm.io page: https://npm.io/package/e1c-repo-tools

## Dependencies (3)

- [chalk](https://npm.io/package/chalk.md) ^4.1.0
- [log-update](https://npm.io/package/log-update.md) ^4.0.0
- [log-symbols](https://npm.io/package/log-symbols.md) ^4.0.0

## Recent versions

- 0.2.2 (latest) — 2020-12-24
- 0.2.0 (v0.2.0) — 2020-12-16
- 0.1.0 (v0.1.0) — 2020-12-15
- 0.2.1 — 2020-12-23

## README

# 1C enterprise repository tools

Набор инструментов для работы с репозиторием 1С предприятия

[English version](https://github.com/cinex-ru/e1c-repo-tools/blob/master/README.en.md)

## Установка

``` bash
npm install -D e1c-repo-tools
```

или

``` bash
yarn add -D e1c-repo-tools
```

## Настройка

В файл `package.json` необходимо добавить поле `e1cRepoConfig`, содержащее следующие настройки:

- `pathToExecutable` - (строка, обязательное) полный путь к исполняемому файла 1С предприятия
- `pathToSrcDir` - (строка, по умолчанию: `./src`) путь к каталогу в котором содержатся исходные файлы внешних обработок и отчетов
- `pathToDistDir` - (строка, по умолчанию: `./dist`) путь к каталогу в котором содержатся собранные файлы внешних обработок и отчетов
- `pathToLogsDir` - (строка, по умолчанию: `./logs`) путь к каталогу в котором содержатся логи
- `filesExtensions` - (массив строк, по умолчанию: `["erf","epf"]`) расширения, которые используются для поиска файлов, при выгрузке в исходные файлы

## Использование

На текущий момент существует три команды:

- `e1c-dump` - выгрузка внешних отчетов/обработок в исходные файлы, с учетом настроек заданных в `package.json`. Если каталог, куда выполняется выгрузка, содержит изменения, то перед удалением создается его резервная копия
- `e1c-build` - сборка исходных файлов во внешние отчеты/обработки, с учетом настроек заданных в `package.json`. Если файл с соответствующим именем существует и содержит изменения, то создается его резервная копия
- `e1c-precommit-hook` - скрипт, для использования в качестве git-hook. Работает аналогично `e1c-dump`, но для выгрузки используются только подготовленные для коммита (staged) файлы. Так же после выгрузки исходных файлов, добавляет их к текущему коммиту
  
  Просто установите [husky](https://www.npmjs.com/package/husky) и добавьте в свой `package.json`
  
  ``` json
  "husky": {
      "hooks": {
        "pre-commit": "yarn e1c-precommit-hook" // or `npx e1c-precommit-hook`
      }
  }
  ```

---
_Source: https://npm.io/package/e1c-repo-tools · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._