diff options
| author | Leitwolf | 2026-11-16 14:49:23 +0300 |
|---|---|---|
| committer | GitHub | 2026-11-16 14:49:23 +0300 |
| commit | 324048967d1fb198e3489b1722ca1ff317338550 (patch) | |
| tree | e270ad6dc86200cc79cbdccfa1ef6de1da8aff0d /content/ru-RU/docs/2.reference/2.module-file.md | |
| parent | 45c1bb14326cbee8fe57c6f639550e8eadd81f0a (diff) | |
| parent | 4ee77681379619b3fab7b8b33446a67164216cc8 (diff) | |
| download | tazel.net-main.tar.gz | |
Rewrite the site for the Tazel of C, C++, Objective-C, Objective-C++ and Zig
Diffstat (limited to 'content/ru-RU/docs/2.reference/2.module-file.md')
| -rw-r--r-- | content/ru-RU/docs/2.reference/2.module-file.md | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/content/ru-RU/docs/2.reference/2.module-file.md b/content/ru-RU/docs/2.reference/2.module-file.md new file mode 100644 index 0000000..e420be8 --- /dev/null +++ b/content/ru-RU/docs/2.reference/2.module-file.md @@ -0,0 +1,110 @@ +--- +title: MODULE.kts +description: Файл в корне модуля: его имя, зависимости и то, как он собирается. +--- + +<!-- SPDX-FileCopyrightText: 2026 Progmasoft <[email protected]> --> +<!-- SPDX-License-Identifier: AGPL-3.0-or-later --> + +У модуля один `MODULE.kts`, в его корне. Это скрипт Kotlin; `module { }` — единственный обязательный блок. + +```kotlin +module { + name = "greeter" + version = "1.2.0" + description = "Greets people." + authors("Ada Lovelace", "Alan Turing") + license = "MIT" +} + +dependencies { + implementation("Publisher") { + name = "toml" + version = "1.0.0" + } + testImplementation("Progmasoft") { + name = "catch3" + version = "0.4.0" + } + localImplementation { + name = "libs" + include(glob("libs/*.vipkg")) + } +} + +execution { + jobs = 8 + keepGoing = false +} +``` + +## module + +| Настройка | Значение | +| --- | --- | +| `name` | имя модуля; обязательно | +| `version` | семантическая версия, например `1.2.0` | +| `description` | одно предложение о модуле | +| `authors(...)` | его авторы | +| `license` | выражение лицензии SPDX, например `MIT` или `Apache-2.0 OR MIT` | + +## dependencies + +| Блок | Даёт | +| --- | --- | +| `implementation("Publisher") { name; version; alias }` | пакет из ViGet, от которого может зависеть любая цель | +| `testImplementation("Publisher") { ... }` | то же, только для тестовых целей | +| `localImplementation { name; include(...) }` | пакеты из файлов `.vipkg` модуля | +| `localTestImplementation { ... }` | то же, только для тестовых целей | + +Издатель — это [Progmasoft Account](https://progmasoft.com). Цель называет цель зависимости как `@name//:x`, где +`name` — это `name` зависимости, её `alias` или `name` локального блока. Локальный блок, `include` которого берёт +несколько пакетов, даёт им одно имя; одно и то же имя цели в двух из них — ошибка. + +::note +Эта версия Tazel читает зависимости и проверяет метки, которые их называют; пакеты из ViGet она не загружает. +Версии, которые разрешает модуль, фиксируются в `LOCK.sqlite3` в его корне — файле блокировки Tazel, который эта +версия не записывает. +:: + +## viget + +```kotlin +viget { + push = true + pushTarget("//core/:core", "//app/:greeter") + exclude(glob("docs/**")) +} +``` + +`pushTarget` называет цели, которые содержит пакет модуля; в их `BUILD.kts` должно быть `isPublic = true`. `exclude` +исключает файлы из пакета. По умолчанию `push` — `false`. + +## cache + +```kotlin +cache { + local = true + keep = 8 + remote("https://cache.example.com") { + read = true + write = false + token = env("TAZEL_CACHE_TOKEN") + } +} +``` + +`local` (по умолчанию `true`) и `keep` (сколько результатов хранить на цель, по умолчанию `8`) описывают локальный +кэш; `remote(...)` добавляет общий, с `read` (по умолчанию `true`), `write` (по умолчанию `false`), `token`, +`publicKey` и `signingKey`. `env("NAME")` читает переменную окружения, чтобы секреты не попадали в файл. + +## execution + +| Настройка | По умолчанию | Действие | +| --- | --- | --- | +| `jobs` | число процессоров | сколько команд идёт одновременно | +| `memory` | без ограничения | ограничение вроде `16.gigabytes` | +| `keepGoing` | `false` | после ошибки запускать команды, которые от неё не зависят | +| `remote(url) { token }` | нет | машина, которая выполняет команды | + +Эта версия Tazel учитывает `jobs` и `keepGoing`; остальные настройки `cache` и `execution` читаются и проверяются. |