Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/content/ru-RU/docs/2.reference/2.module-file.md
diff options
context:
space:
mode:
authorLeitwolf2026-11-16 14:49:23 +0300
committerGitHub2026-11-16 14:49:23 +0300
commit324048967d1fb198e3489b1722ca1ff317338550 (patch)
treee270ad6dc86200cc79cbdccfa1ef6de1da8aff0d /content/ru-RU/docs/2.reference/2.module-file.md
parent45c1bb14326cbee8fe57c6f639550e8eadd81f0a (diff)
parent4ee77681379619b3fab7b8b33446a67164216cc8 (diff)
downloadtazel.net-main.tar.gz
Merge pull request #10 from Progmasoft/content/new-tazelHEADmain
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.md110
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` читаются и проверяются.