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

summaryrefslogtreecommitdiffhomepage
path: root/content/ru-RU/docs/4.internals
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/4.internals
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/4.internals')
-rw-r--r--content/ru-RU/docs/4.internals/1.architecture.md50
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`.