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/4.internals | |
| 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/4.internals')
| -rw-r--r-- | content/ru-RU/docs/4.internals/1.architecture.md | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/content/ru-RU/docs/4.internals/1.architecture.md b/content/ru-RU/docs/4.internals/1.architecture.md new file mode 100644 index 0000000..d20693a --- /dev/null +++ b/content/ru-RU/docs/4.internals/1.architecture.md @@ -0,0 +1,50 @@ +--- +title: Архитектура +description: Как Tazel читает файлы проекта, планирует сборку, выполняет команды и решает, что актуально. +--- + +<!-- SPDX-FileCopyrightText: 2026 Progmasoft <[email protected]> --> +<!-- SPDX-License-Identifier: AGPL-3.0-or-later --> + +Tazel — программа на Kotlin для JVM. Он не создаёт собственных файлов сборки: он читает файлы проекта, планирует +каждую команду и сам запускает компиляторы. + +## Чтение проекта + +`MODULE.kts` и каждый `BUILD.kts` — скрипты Kotlin. Tazel компилирует и выполняет их встроенным хостом скриптов +Kotlin, поэтому машине не нужна установка Kotlin. DSL типизирован: язык и вид цели определяют, какие настройки +существуют, поэтому настройка, которой у цели быть не может, не компилируется. + +Блок цели — это функция. Tazel выполняет её один раз для каждой тройки и режима сборки, которые запрашивает команда, +с заданными `OS`, `ARCH` и `BUILD_MODE`, и получает обычные значения. Затем разрешаются метки и проверяется видимость: +цель может зависеть только от целей своего файла или файла с `isPublic = true`. + +## Планирование + +План сборки — это граф действий: + +| Действие | Запускает | +| --- | --- | +| компиляция | компилятор семейства C на одном исходнике; пишет объектный файл и depfile | +| архивация | `llvm-ar` или `ar` (`zig ar` для zig cc) над объектами статической библиотеки | +| компоновка | компилятор как компоновщик, для программы, разделяемой библиотеки или теста | +| сборка Zig | `zig build-exe`, `zig build-lib` или `zig test --test-no-exec` на корневом файле | + +Tazel запускает Zig и компиляторы семейства C напрямую; он не использует ни Ninja, ни `build.zig`. Действия, входы +которых готовы, идут параллельно, до `jobs` одновременно. После ошибки новые действия не запускаются, если этого не +требует `keepGoing`; запущенные доходят до конца. + +## Актуальность + +Для каждого действия Tazel записывает его командную строку, окружение, содержимое каждого прочитанного файла (для +компиляции — заголовки, перечисленные в depfile) и содержимое записанного. Действие запускается снова, если что-то из +этого изменилось или результат отсутствует или изменён. Файл, у которого изменилось время, но не содержимое, ничего не +запускает, а объектный файл, пересобранный в те же байты, не перезапускает ни свой архив, ни свою программу. + +Результаты попадают в `.tazel/out/<triple>/<mode>` внутри модуля. Прошедший тест записывается рядом со своей +программой и не запускается снова, пока его программа, данные, аргументы и окружение те же. + +## Поиск инструментов + +Clang, GCC, `zig`, `llvm-ar` или `ar`, clang-format и clang-tidy ищутся в `PATH`. Для тройки, отличной от тройки +машины, Tazel использует Clang с `--target=<triple>` или `zig cc` с `-target`. |