20 Commits

Author SHA1 Message Date
0e2d05788a New translations test-framework.mdx (Russian)
[ci skip]
2026-07-06 15:02:04 +08:00
468cdef2d9 New translations running-tests.mdx (Russian)
[ci skip]
2026-07-06 15:02:02 +08:00
ee9cade5c8 New translations self-update.mdx (Russian)
[ci skip]
2026-07-06 15:01:59 +08:00
25ab25b9a2 New translations platform-support.mdx (Russian)
[ci skip]
2026-07-06 15:01:54 +08:00
360619fb78 New translations environment-variables.mdx (Russian)
[ci skip]
2026-07-06 15:01:52 +08:00
4c24089cb2 New translations dependencies.mdx (Russian)
[ci skip]
2026-07-06 15:01:49 +08:00
3e810c476d New translations dcr-toml.mdx (Russian)
[ci skip]
2026-07-06 15:01:47 +08:00
5682792c2f New translations cross-compilation.mdx (Russian)
[ci skip]
2026-07-06 15:01:44 +08:00
ff5d8ba4bf New translations build-system.mdx (Russian)
[ci skip]
2026-07-06 15:01:41 +08:00
0f1fff7072 New translations build-profiles.mdx (Russian)
[ci skip]
2026-07-06 15:01:38 +08:00
b8cceb2945 New translations license.mdx (Russian)
[ci skip]
2026-07-06 15:01:29 +08:00
fce6804c32 New translations ide-integration.mdx (Russian)
[ci skip]
2026-07-06 15:01:27 +08:00
a988adea3a New translations installation.mdx (Russian)
[ci skip]
2026-07-06 15:01:24 +08:00
6575f5d2f0 New translations first-steps.mdx (Russian)
[ci skip]
2026-07-06 15:01:22 +08:00
17aa2937be New translations faq.mdx (Russian)
[ci skip]
2026-07-06 15:01:19 +08:00
828624860a New translations contributing.mdx (Russian)
[ci skip]
2026-07-06 15:01:16 +08:00
66195b53e2 New translations system-commands.mdx (Russian)
[ci skip]
2026-07-06 15:01:14 +08:00
8ded7958f6 New translations quality-commands.mdx (Russian)
[ci skip]
2026-07-06 15:01:11 +08:00
9c9a2d9096 New translations changelog.mdx (Russian)
[ci skip]
2026-07-06 15:01:09 +08:00
9d033ef9a4 New translations readme.mdx (Russian)
[ci skip]
2026-07-06 15:01:06 +08:00
20 changed files with 301 additions and 309 deletions

View File

@@ -23,19 +23,19 @@ dcr run
## Содержание ## Содержание
| Раздел | Описание | | Раздел | Описание |
| ----------------------------------------------------- | -------------------------------------------- | | --------------------------------------------------- | -------------------------------------------- |
| [Getting Started](/docs/getting-started/installation) | Установка и первые шаги | | [Начало работы](/docs/getting-started/installation) | Установка и первые шаги |
| [Commands](/docs/commands/project-commands) | Все CLI-команды DCR | | [Команды](/docs/commands/project-commands) | Все CLI-команды DCR |
| [Reference](/docs/reference/dcr-toml) | Конфигурация, сборка, зависимости, платформы | | [Ссылка](/docs/reference/dcr-toml) | Конфигурация, сборка, зависимости, платформы |
| [Testing](/docs/testing/test-framework) | Встроенный фреймворк тестирования | | [Тестирование](/docs/testing/test-framework) | Встроенный фреймворк тестирования |
| [Recipes](/docs/recipes/cross-to-windows) | Типовые сценарии | | [Рецепты](/docs/recipes/cross-to-windows) | Типовые сценарии |
| [IDE Integration](/docs/ide-integration) | VS Code, CLion, compile_commands.json | | [Интеграция с IDE](/docs/ide-integration) | VS Code, CLion, compile_commands.json |
| [Self Update](/docs/self-update) | Автообновление | | [Автоматическое обновление](/docs/self-update) | Автообновление |
| [FAQ](/docs/faq) | Частые вопросы | | [Часто задаваемые вопросы](/docs/faq) | Частые вопросы |
| [Changelog](/docs/changelog) | История версий | | [Журнал изменений](/docs/changelog) | История версий |
| [License](/docs/license) | Лицензии DCR и вендорных библиотек | | [Лицензия](/docs/license) | Лицензии DCR и вендорных библиотек |
| [Contributing](/docs/contributing) | Разработка DCR | | [Внести свой вклад](/docs/contributing) | Разработка DCR |
## Особенности ## Особенности
@@ -49,5 +49,5 @@ dcr run
* **Registry + Git + Path** — три механизма зависимостей * **Registry + Git + Path** — три механизма зависимостей
* **Генерация IDE** — VS Code, CLion, compile_commands.json, JSON metadata * **Генерация IDE** — VS Code, CLion, compile_commands.json, JSON metadata
* **pkg-config** — автоматический поиск системных библиотек * **pkg-config** — автоматический поиск системных библиотек
* **Per-command `--help`** — `dcr build --help`, `dcr new --help`, etc. * **Команда `--help` для каждой команды** — `dcr build --help`, `dcr new --help` и т. д.
* **Man pages** — `man dcr`, `man dcr-build`, `man dcr-new` * **Справочные страницы** — `man dcr`, `man dcr-build`, `man dcr-new`

View File

@@ -1,56 +1,56 @@
--- ---
sidebar_label: Changelog sidebar_label: Список изменений
--- ---
# Changelog # Список изменений
## 0.7.1 (2026-06-02) ## 0.7.1 (02.06.2026)
### Добавлено: ### Добавлено:
* **`--help` for all commands** — `dcr build --help`, `dcr run --help`, `dcr new --help`, * **`--help` для всех команд** — `dcr build --help`, `dcr run --help`, `dcr new --help`,
`dcr init --help`, `dcr clean --help`, `dcr add --help`, `dcr fmt --help`, `dcr init --help`, `dcr clean --help`, `dcr add --help`, `dcr fmt --help`,
`dcr setup --help`, `dcr tree --help`, `dcr gen --help`, `dcr --update --help`, `dcr setup --help`, `dcr tree --help`, `dcr gen --help`, `dcr --update --help`,
`dcr test --help`. All output uses styled headers (green) and usage lines (cyan). `dcr test --help`. Во всех результатах вывода используются стилизованные заголовки (зелёного цвета) и строки с информацией об использовании (голубого цвета).
* **Man pages** — 12 troff pages in `man/man1/`: `dcr.1`, `dcr-build.1`, * **Справочные страницы** — 12 страниц в формате troff в каталоге `man/man1/`: `dcr.1`, `dcr-build.1`,
`dcr-run.1`, `dcr-new.1`, `dcr-init.1`, `dcr-clean.1`, `dcr-add.1`, `dcr-test.1`, `dcr-run.1`, `dcr-new.1`, `dcr-init.1`, `dcr-clean.1`, `dcr-add.1`, `dcr-test.1`,
`dcr-gen.1`, `dcr-fmt.1`, `dcr-tree.1`, `dcr-setup.1`. `dcr-gen.1`, `dcr-fmt.1`, `dcr-tree.1`, `dcr-setup.1`.
* **Man pages in all packaging** — install.sh, install_bsd.sh, AUR PKGBUILD, * **Справочные страницы во всех пакетах** — install.sh, install_bsd.sh, PKGBUILD из AUR,
Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew Debian (cargo-deb), RPM (cargo-generate-rpm), Nix (postInstall), Homebrew
(resource), Snap, GitHub Release assets. (ресурс), Snap, ресурсы релизов GitHub.
* **Project name validation** — `dcr init` and `dcr new` now validate names before * **Проверка имени проекта** — команды `dcr init` и `dcr new` теперь проверяют имена перед созданием файлов
creating files. Only ASCII letters, digits, `_` and `-` are allowed. . Допускаются только буквы ASCII, цифры, символы `_` и `-`.
* **`documentation` and `homepage` fields** — added to `Cargo.toml`. * **Поля `documentation` и `homepage`** — добавлены в файл `Cargo.toml`.
* **Release profile optimizations** — `opt-level = "z"`, LTO, `codegen-units = 1`, * **Оптимизации профиля релиза** — `opt-level = "z"`, LTO, `codegen-units = 1`,
`panic = "abort"`, `strip = true` for smaller binaries. `panic = "abort"`, `strip = true` для уменьшения размера бинарных файлов.
* **Linux i686, armv7, riscv64 targets** — added to release workflow and install scripts. * **Платформы Linux i686, armv7, riscv64** — добавлены в рабочий процесс выпуска и скрипты установки.
* **Linux musl i686, armv7 targets** — cross-compiled via zigbuild in CI. * **Платформы Linux musl i686 и armv7** — скомпилированы с помощью zigbuild в системе непрерывной интеграции (CI).
* **AUR packages** — `dcr-dev`, `dcr-dev-bin` publishing workflow. * **Пакеты AUR** — рабочий процесс публикации `dcr-dev`, `dcr-dev-bin`.
* **Snap publishing** — automated Snapcraft publishing in CI. * **Публикация Snap** — автоматическая публикация Snapcraft в рамках непрерывной интеграции (CI).
* **Snap badge** — in README. * **Значок Snap** — в файле README.
### Изменено: ### Изменено:
* **`validate_package_name` made public** — callable from CLI commands. * **`validate_package_name` стал общедоступным** — его можно вызывать из команд CLI.
* **README platform table** — reorganized: libc variants as separate OS rows, * **Таблица платформы README** — реорганизована: варианты libc вынесены в отдельные строки по ОС,
removed extra columns. Linux architecture list updated. удалены лишние столбцы. Обновлен список архитектур Linux.
* **`gen.rs` no-args output** — now uses styled output instead of raw `eprintln!`. * **Вывод `gen.rs` без аргументов** — теперь используется стилизованный вывод вместо необработанного `eprintln!`.
* **`tree.rs`, `fmt.rs`, and `setup.rs`** — now accept arguments for `--help`. * **`tree.rs`, `fmt.rs` и `setup.rs`** — теперь поддерживают аргументы для опции `--help`.
* **README install commands** — `| bash` → `| sh` for POSIX compatibility. * **Команды установки из файла README** — `| bash` → `| sh` для обеспечения совместимости с POSIX.
### Исправлено: ### Исправлено:
* **`dcr new \<invalid-name>` creates directory then fails** — validation now * **`dcr new \<invalid-name>` создает каталог, а затем завершается с ошибкой** — теперь проверка
happens before any file operations. выполняется до начала любых операций с файлами.
* **`dcr init` on invalid directory name** — same fix. * **`dcr init` при указании недопустимого имени каталога** — то же исправление.
* **Man pages missing in installed packages** — now shipped in all formats. * **Отсутствующие справочные страницы в установленных пакетах** — теперь поставляются во всех форматах.
* **Windows drive letter false positive** — in dependency file parser. * **Ложное срабатывание по букве диска Windows** — в модуле анализа файлов зависимостей.
* **CRLF (`\r\n`) breaks dependency parser** — now handles mixed line endings. * **CRLF (`\r\n`) вызывает сбой в работе парсера зависимостей** — теперь поддерживается обработка смешанных символов окончания строк.
* **Newline after backslash not consumed** — in `parse_d_file` escape handling. * **Новая строка после обратного слеша не обработана** — при обработке экранирующих символов в функции `parse_d_file`.
## 0.7.0 (2026-06-01) ## 0.7.0 (01.06.2026)
### Added ### Добавлено
* **Поддержка целевых платформ OpenBSD и NetBSD** — полная маршрутизация по платформам с динамически генерируемыми тройками целевых параметров с использованием `std::env::consts::ARCH` и `std::env::consts::OS`. Затрагивает команды `build`, `run`, `clean` и модуль платформы. * **Поддержка целевых платформ OpenBSD и NetBSD** — полная маршрутизация по платформам с динамически генерируемыми тройками целевых параметров с использованием `std::env::consts::ARCH` и `std::env::consts::OS`. Затрагивает команды `build`, `run`, `clean` и модуль платформы.
* **`src/platform/bsd.rs`** — новый специальный модуль платформы BSD, общий для FreeBSD, OpenBSD и NetBSD, предоставляющий `bin_path`, `lib_path`, `elf_path`, `efi_path` и `shared_lib_path`. * **`src/platform/bsd.rs`** — новый специальный модуль платформы BSD, общий для FreeBSD, OpenBSD и NetBSD, предоставляющий `bin_path`, `lib_path`, `elf_path`, `efi_path` и `shared_lib_path`.
@@ -65,7 +65,7 @@ sidebar_label: Changelog
* **Интеграционные тесты** — `build_with_target_config` (проверяет `build.target = «linux»`) и `build_with_out_dir` (проверяет настраиваемый каталог вывода). * **Интеграционные тесты** — `build_with_target_config` (проверяет `build.target = «linux»`) и `build_with_out_dir` (проверяет настраиваемый каталог вывода).
* **`get_build_string_with_profile` стал `pub`** — чтобы `run.rs` мог определять конфигурацию настраиваемого каталога вывода. * **`get_build_string_with_profile` стал `pub`** — чтобы `run.rs` мог определять конфигурацию настраиваемого каталога вывода.
### Changed ### Изменено
* **Изменена семантика `build.target`** — теперь строго содержит тройку целей (например, `x86_64-unknown-linux-gnu`) или короткое имя (`linux`, `macos`, `windows`). Больше не используется в качестве пользовательского каталога вывода — эта функциональность перенесена в `build.out_dir`. * **Изменена семантика `build.target`** — теперь строго содержит тройку целей (например, `x86_64-unknown-linux-gnu`) или короткое имя (`linux`, `macos`, `windows`). Больше не используется в качестве пользовательского каталога вывода — эта функциональность перенесена в `build.out_dir`.
* **`build.standard` стал опциональным** — изменен с `String` на `Option\<String>`. Проверка обеспечивает только непустоту для языков, отличных от ASM. Пропускается в выводе `dcr.toml`, если пуст. * **`build.standard` стал опциональным** — изменен с `String` на `Option\<String>`. Проверка обеспечивает только непустоту для языков, отличных от ASM. Пропускается в выводе `dcr.toml`, если пуст.
@@ -75,7 +75,7 @@ sidebar_label: Changelog
* **Таблица совместимости README** — статус сборки/работы на FreeBSD, OpenBSD, NetBSD повышен с «сообщество/по возможности» до «официально поддерживается». * **Таблица совместимости README** — статус сборки/работы на FreeBSD, OpenBSD, NetBSD повышен с «сообщество/по возможности» до «официально поддерживается».
* **Обновлена документация** — `build-section.md` описывает новые поля `build.target` и `build.out_dir`. `target-directory.md` переписан для уточнения различия. * **Обновлена документация** — `build-section.md` описывает новые поля `build.target` и `build.out_dir`. `target-directory.md` переписан для уточнения различия.
### Fixed ### Исправлено
* **stdout/stderr `dcr run` не наследуются** — вывод дочернего процесса захватывался и выводился вручную, что приводило к сбоям интерактивных программ. Исправлено путем перехода на `Command::status()`. * **stdout/stderr `dcr run` не наследуются** — вывод дочернего процесса захватывался и выводился вручную, что приводило к сбоям интерактивных программ. Исправлено путем перехода на `Command::status()`.
* **Условие гонки в CI релиза** — задания матрицы сборки могли загружать ресурсы в релиз, который еще не существовал. Исправлено добавлением специального задания `create-release`. * **Условие гонки в CI релиза** — задания матрицы сборки могли загружать ресурсы в релиз, который еще не существовал. Исправлено добавлением специального задания `create-release`.

View File

@@ -25,11 +25,11 @@ dcr test --init
Что делает `dcr test`: Что делает `dcr test`:
1. Builds the project 1. Собирает проект
2. Collects `tests/*.c` files (`.c` only, not `.cpp`) 2. Собирает файлы `tests/*.c` (только `.c`, не `.cpp`)
3. Compiles and links each test file 3. Компилирует и линкует каждый файл теста
4. Runs each test binary 4. Запускает каждый бинарник тестов
5. Prints summary: TOTAL, PASS, SKIP, FAIL 5. Вывод сводки: TOTAL, PASS, SKIP, FAIL
6. Возвращает ненулевой код при наличии FAIL 6. Возвращает ненулевой код при наличии FAIL
## `dcr fmt` ## `dcr fmt`
@@ -40,21 +40,21 @@ dcr test --init
dcr fmt dcr fmt
``` ```
Processes: `src/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}` and `tests/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}`. Процессы: `src/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}` и `tests/**/*.{c,cpp,cxx,cc,h,hpp,hxx,hh}`.
Использует `.clang-format` в корне проекта (если таковой имеется), иначе стиль clang-format по умолчанию. Использует `.clang-format` в корне проекта (если таковой имеется), иначе стиль clang-format по умолчанию.
## `dcr lint` ## `dcr lint`
Runs `clang-tidy` on C/C++ source files for static analysis. Выполняет `clang-tidy` на C/C++ исходных файлах для статического анализа.
```bash ```bash
dcr lint # show diagnostics dcr lint # отобразить диагностику
dcr lint --fix # apply fixes automatically dcr lint --fix # автоматически применить исправления
dcr lint --help # detailed help dcr lint --help # подробная справка
``` ```
Processes: `src/**/*.{c,cpp,cxx,cc}` and `tests/**/*.{c,cpp,cxx,cc}`. Процессы: `src/**/*.{c,cpp,cxx,cc}` и `tests/**/*.{c,cpp,cxx,cc}`.
Without `--fix`, clang-tidy reports warnings and errors without modifying files. Без параметра `--fix` clang-tidy выдает предупреждения и ошибки, не внося изменений в файлы.
With `--fix`, clang-tidy applies automatic suggestions in place. При параметре `--fix` clang-tidy автоматически вносит предложения по исправлениям на месте.

View File

@@ -12,7 +12,7 @@ sidebar_label: Системные команды (setup, --help, ...)
dcr setup dcr setup
``` ```
If `~/.dcr/config.toml` is not found, DCR returns an error. Create it manually: Если файл `~/.dcr/config.toml` не найден, DCR возвращает ошибку. Создайте его вручную:
```toml ```toml
[[registry]] [[registry]]
@@ -22,31 +22,30 @@ url = "https://index.dcr.pm"
## `dcr --help` ## `dcr --help`
Shows help for all commands. Отображает справку по всем командам.
```bash ```bash
dcr --help dcr --help
dcr build --help # справка по конкретной команде
``` ```
## `dcr --version` ## `dcr --version`
Shows version and target triple. Отображает версию и целевую платформу.
```bash ```bash
dcr --version # dcr 0.7.0 dcr --version # dcr 0.7.0 (x86_64-unknown-linux-gnu)
``` ```
## `dcr --update` ## `dcr --update`
Самообновление. Скачивает последний релиз с GitHub Releases и заменяет текущий бинарник. Автоматическое обновление. Загружает последнюю версию бинарного файла из раздела «Релизы» на GitHub и заменяет текущую версию.
```bash ```bash
dcr --update dcr --update
``` ```
Особенности: Возможности:
* Определяет платформу и архитектуру автоматически * Определяет платформу и архитектуру автоматически
* Warns if installed via AUR (use package manager instead) * Выдает предупреждение при установке через AUR (вместо этого используйте пакетный менеджер)
* Работает на Linux, macOS, Windows * Работает на Linux, macOS, Windows

View File

@@ -1,10 +1,10 @@
--- ---
sidebar_label: Contributing sidebar_label: Вклад
--- ---
# Contributing # Вклад
## Setup ## Настройка
```bash ```bash
git clone https://github.com/dexoron/dcr git clone https://github.com/dexoron/dcr
@@ -12,12 +12,12 @@ cd dcr
cargo build cargo build
``` ```
## Code style ## Стиль написания кода
Весь код форматируется через `cargo fmt`: Весь код форматируется через `cargo fmt`:
```bash ```bash
cargo fmt формат груза
``` ```
## Линтер ## Линтер
@@ -29,10 +29,10 @@ cargo clippy --all-targets -- -D warnings
## Тесты ## Тесты
```bash ```bash
cargo test --all-targets тест cargo --all-targets
``` ```
## PR process ## Процесс связей с общественностью
1. Форкните репозиторий 1. Форкните репозиторий
2. Создайте ветку: `git checkout -b feature/description` 2. Создайте ветку: `git checkout -b feature/description`

View File

@@ -4,16 +4,16 @@ sidebar_label: Часто задаваемые вопросы
# Часто задаваемые вопросы # Часто задаваемые вопросы
## Registry not found ## Реестр не найден
``` ```
error: registry not found Ошибка: реестр не найден
``` ```
**Solution:** Make sure `~/.dcr/config.toml` exists: **Решение:** Убедитесь, что файл `~/.dcr/config.toml` существует:
```toml ```toml
[[registry]] [[реестр]]
name = "default" name = "default"
url = "https://index.dcr.pm" url = "https://index.dcr.pm"
``` ```
@@ -24,27 +24,27 @@ url = "https://index.dcr.pm"
echo $DCR_INDEX_PATH echo $DCR_INDEX_PATH
``` ```
## Compiler not found ## Компилятор не найден
``` ```
error: compiler not found Ошибка: компилятор не найден
``` ```
**Решение:** Убедитесь, что компилятор установлен и доступен в PATH. **Решение:** Убедитесь, что компилятор установлен и доступен в PATH.
```bash ```bash
which gcc какой gcc
which clang какой clang
``` ```
Или укажите явно через `[toolchain]` или `DCR_COMPILER`. Или укажите явно через `[toolchain]` или `DCR_COMPILER`.
## openssl-sys build failed ## Сбой сборки openssl-sys
При сборке DCR из исходников: При сборке DCR из исходников:
``` ```
error: failed to run custom build command for openssl-sys Ошибка: не удалось выполнить пользовательскую команду сборки для openssl-sys
``` ```
**Решение:** Установите OpenSSL development headers: **Решение:** Установите OpenSSL development headers:
@@ -68,7 +68,7 @@ DCR корректно обрабатывает SIGINT: прерывает те
[Library Recipe](/docs/recipes/library-project). [Library Recipe](/docs/recipes/library-project).
## How to cross-compile to Windows? ## Как выполнить кросс-компиляцию для Windows?
См. [Cross-Compile Recipe](/docs/recipes/cross-to-windows). См. [Cross-Compile Recipe](/docs/recipes/cross-to-windows).

View File

@@ -27,32 +27,27 @@ my-app/
name = "my-app" name = "my-app"
version = "0.1.0" version = "0.1.0"
type = "none" type = "none"
description=""
author=""
license = "GPL-3.0-or-later"
[build] [build]
language = "c" language = "c"
standard = "c11" standard = "c11"
compiler = "clang" compiler = "clang"
kind = "bin" kind = "bin"
[dependencies]
``` ```
## Build ## Сборка
```bash ```bash
dcr build dcr build
``` ```
Output — `target/\<triple>/debug/my-app` (Linux) or `target/debug/my-app.exe` (Windows). Результат — `target/\<triple>/debug/my-app` (Linux) или `target/debug/my-app.exe` (Windows).
Профиль: Профиль сборки:
```bash ```bash
dcr build --release # релизная сборка dcr build --release # release сборка
dcr build --debug # дебажная (по умолчанию) dcr build --debug # debug (по умолчанию)
``` ```
## Запустить ## Запустить
@@ -63,11 +58,11 @@ dcr run
Собирает (если нужно) и запускает бинарник. Собирает (если нужно) и запускает бинарник.
## First test ## Первый тест
```bash ```bash
dcr test --init # create test template dcr test --init # создать шаблон теста
dcr test # run tests dcr test # запустить тесты
``` ```
## Форматирование ## Форматирование

View File

@@ -29,7 +29,7 @@ sudo dnf install dcr
## Arch Linux (AUR) ## Arch Linux (AUR)
```sh ```sh
yay -S dcr ура -S dcr
``` ```
## macOS / Linux (Homebrew) ## macOS / Linux (Homebrew)
@@ -37,8 +37,6 @@ yay -S dcr
```sh ```sh
brew tap dexoron/dexoron brew tap dexoron/dexoron
brew install dcr brew install dcr
# or
brew install dexoron/dexoron/dcr
``` ```
## Snap (Linux) ## Snap (Linux)
@@ -51,7 +49,7 @@ sudo snap install dcrup
```sh ```sh
nix run github:dexoron/dcr nix run github:dexoron/dcr
# or install to profile: # или установить в профиль:
nix profile install github:dexoron/dcr nix profile install github:dexoron/dcr
``` ```
@@ -61,13 +59,13 @@ nix profile install github:dexoron/dcr
cargo install dcr cargo install dcr
``` ```
## Linux / macOS (script) ## Linux / macOS (скрипт)
```sh ```sh
curl -fsSL https://dcr.dexoron.su/install_bsd.sh | bash curl -fsSL https://dcr.dexoron.su/install_bsd.sh | bash
``` ```
## BSD (script) ## BSD (скрипт)
```sh ```sh
curl -fsSL https://dcr.dexoron.su/install.sh | bash curl -fsSL https://dcr.dexoron.su/install.sh | bash
@@ -79,7 +77,7 @@ curl -fsSL https://dcr.dexoron.su/install.sh | bash
irm https://dcr.dexoron.su/install.ps1 | iex irm https://dcr.dexoron.su/install.ps1 | iex
``` ```
## From source ## Из источника
```sh ```sh
git clone https://github.com/dexoron/dcr.git git clone https://github.com/dexoron/dcr.git
@@ -87,22 +85,22 @@ cd dcr && cargo build --release
ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
``` ```
## Post-install ## После установки
Verify the installation: Проверьте установку:
```bash ```bash
dcr setup dcr setup
``` ```
Man pages are available after installation: После установки становятся доступны man страницы:
```bash ```bash
man dcr man dcr
man dcr-build man dcr-build
``` ```
Команда создаёт `~/.dcr/` с дефолтным `config.toml` и скачивает публичный реестр. Чтобы использовать реестр, создайте файл `~/.dcr/config.toml`:
```toml ```toml
[[registry]] [[registry]]

View File

@@ -27,25 +27,25 @@ dcr gen clion
Генерирует в `.idea/`: Генерирует в `.idea/`:
| Файл | Назначение | | Файл | Назначение |
| ----------------------------------------- | ----------------------------------------------- | | ----------------------------------------- | ------------------------------------------------ |
| `externalTools.xml` | Build, Run, Clean, Test как внешние инструменты | | `externalTools.xml` | Build, Run, Clean, Test как внешние инструменты |
| `customTargets.xml` | Кастомные цели сборки | | `customTargets.xml` | Кастомные цели сборки |
| `misc.xml` | Настройки C/C++ проекта | | `misc.xml` | Настройки C/C++ проекта |
| `runConfigurations/dcr_build_and_run.xml` | Per-binary run configurations | | `runConfigurations/dcr_build_and_run.xml` | Конфигурации запуска для каждого бинарного файла |
## compile_commands.json ## compile_commands.json
```bash ```bash
dcr gen compile-commands dcr gen команды компиляции
``` ```
Генерирует `compile_commands.json` в корне проекта. Стандартный формат для: Генерирует `compile_commands.json` в корне проекта. Стандартный формат для:
## project-info ## информация о проекте
```bash ```bash
dcr gen project-info dcr gen info-проекта
``` ```
Выводит JSON с метаданными проекта (см. [gen-commands](/docs/commands/gen-commands)). Выводит JSON с метаданными проекта (см. [gen-commands](/docs/commands/gen-commands)).

View File

@@ -14,33 +14,33 @@ DCR распространяется под лицензией [GPL-3.0-or-later
DCR статически связывает следующие C-библиотеки через вендорные Rust-зависимости: DCR статически связывает следующие C-библиотеки через вендорные Rust-зависимости:
| Библиотека | Лицензия | Bundled by | | Библиотека | Лицензия | В комплекте с |
| ------------------------------------------ | ------------------ | ----------------------------- | | -------------------------------------------- | ------------------ | ----------------------------- |
| [libgit2](https://libgit2.org) | MIT OR Apache-2.0 | `git2` / `libgit2-sys` | | [libgit2](https://libgit2.org) | MIT ИЛИ Apache-2.0 | `git2` / `libgit2-sys` |
| [libssh2](https://libssh2.org) | MIT OR Apache-2.0 | `libgit2-sys` | | [libssh2](https://libssh2.org) | MIT ИЛИ Apache-2.0 | `libgit2-sys` |
| [zlib](https://zlib.net) | MIT OR Apache-2.0 | `libgit2-sys` | | [zlib](https://zlib.net) | MIT ИЛИ Apache-2.0 | `libgit2-sys` |
| [OpenSSL](https://openssl.org) | Apache-2.0 | `openssl-sys` / `openssl-src` | | [OpenSSL](https://openssl.org) | Apache-2.0 | `openssl-sys` / `openssl-src` |
| [ring](https://github.com/briansmith/ring) | Apache-2.0 AND ISC | `rustls` | | [кольцо](https://github.com/briansmith/ring) | Apache-2.0 И ISC | `rustls` |
## Rust-зависимости ## Rust-зависимости
DCR написан на Rust. Ниже перечислены основные статически связываемые крейты: DCR написан на Rust. Ниже перечислены основные статически связываемые крейты:
| Крейт | Лицензия | | Крейт | Лицензия |
| --------------------------------------------- | ------------------------ | | --------------------------------------------- | -------------------------- |
| [`reqwest`](https://crates.io/crates/reqwest) | MIT OR Apache-2.0 | | [`reqwest`](https://crates.io/crates/reqwest) | MIT ИЛИ Apache-2.0 |
| [`rustls`](https://crates.io/crates/rustls) | Apache-2.0 OR ISC OR MIT | | [`rustls`](https://crates.io/crates/rustls) | Apache-2.0 ИЛИ ISC ИЛИ MIT |
| [`serde`](https://crates.io/crates/serde) | MIT OR Apache-2.0 | | [`serde`](https://crates.io/crates/serde) | MIT ИЛИ Apache-2.0 |
| [`toml`](https://crates.io/crates/toml) | MIT OR Apache-2.0 | | [`toml`](https://crates.io/crates/toml) | MIT ИЛИ Apache-2.0 |
| [`sha2`](https://crates.io/crates/sha2) | MIT OR Apache-2.0 | | [`sha2`](https://crates.io/crates/sha2) | MIT ИЛИ Apache-2.0 |
| [`git2`](https://crates.io/crates/git2) | MIT OR Apache-2.0 | | [`git2`](https://crates.io/crates/git2) | MIT ИЛИ Apache-2.0 |
| [`openssl`](https://crates.io/crates/openssl) | Apache-2.0 | | [`openssl`](https://crates.io/crates/openssl) | Apache-2.0 |
| [`tokio`](https://crates.io/crates/tokio) | MIT | | [`tokio`](https://crates.io/crates/tokio) | MIT |
| [`hyper`](https://crates.io/crates/hyper) | MIT | | [`hyper`](https://crates.io/crates/hyper) | MIT |
| [`ctrlc`](https://crates.io/crates/ctrlc) | MIT OR Apache-2.0 | | [`ctrlc`](https://crates.io/crates/ctrlc) | MIT ИЛИ Apache-2.0 |
Полное дерево зависимостей (143 пакета) доступно в [`Cargo.lock`](https://github.com/dexoron/dcr/blob/main/Cargo.lock). Подавляющее большинство имеют двойную лицензию MIT OR Apache-2.0. Полное дерево зависимостей (143 пакета) доступно в [`Cargo.lock`](https://github.com/dexoron/dcr/blob/main/Cargo.lock). Подавляющее большинство имеют двойную лицензию MIT OR Apache-2.0.
## Additional credits ## Дополнительные благодарности
* Дизайн CLI и модель проектов DCR вдохновлены [Cargo](https://doc.rust-lang.org/cargo/). * Дизайн CLI и модель проектов DCR вдохновлены [Cargo](https://doc.rust-lang.org/cargo/).

View File

@@ -25,29 +25,29 @@ cflags = ["-O3", "-flto"]
Поля из `[build.\<profile>]` **мержатся поверх** `[build]` Поля из `[build.\<profile>]` **мержатся поверх** `[build]`
* **Scalar fields** (strings, numbers, bools) — replaced * **Скалярные поля** (строки, числа, логические значения) — заменены
* Массивы (`cflags`, `ldflags`, ...) **заменяются полностью**, а не дополняются * Массивы (`cflags`, `ldflags`, ...) **заменяются полностью**, а не дополняются
Set `inherit = false` to disable array inheritance (only profile's own arrays are used). Установите `inherit = false`, чтобы отключить наследование массивов (будут использоваться только собственные массивы профиля).
## Кастомные профили ## Кастомные профили
The default flags for each profile are composed from three config fields: Флаги по умолчанию для каждого профиля формируются из трёх полей конфигурации:
| Field | Default cflags | Профили сборки | | Поле | Default cflags | Профили сборки |
| ----------- | ------------------ | -------------- | | ---------------- | ------------------ | -------------- |
| `opt_level` | `-O0 -g` | `"3"` | | `opt_level` | `-O0 -g` | `"3"` |
| `debug` | `true` | `false` | | `debug` | `true` | `false` |
| `warnings` | `["all", "extra"]` | `[]` | | `предупреждения` | `["all", "extra"]` | `[]` |
Which produce the equivalent compiler flags: Которые генерируют соответствующие флаги компилятора:
| Профиль | Effective flags | | Профиль | Действующие флаги |
| --------- | ---------------------------------------------------------- | | ------- | ---------------------------------------------------------- |
| `debug` | `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG` | | `debug` | `-O0 -g -Wall -Wextra -fno-omit-frame-pointer -DDCR_DEBUG` |
| `release` | `-O3 -DNDEBUG` | | `релиз` | `-O3 -DNDEBUG` |
Additional build options can be toggled per-profile: Дополнительные параметры сборки можно включать или отключать для каждого профиля:
```toml ```toml
[build.release] [build.release]
@@ -73,7 +73,7 @@ cflags = ["-DLINUX"]
cflags = ["-DWIN32", "-O0", "-g"] cflags = ["-DWIN32", "-O0", "-g"]
``` ```
Application order (highest priority first): Порядок применения (в порядке убывания приоритета):
1. `[build.\<target>.\<profile>]` 1. `[build.\<target>.\<profile>]`
2. `[build.\<profile>.\<target>]` 2. `[build.\<profile>.\<target>]`

View File

@@ -2,36 +2,36 @@
sidebar_label: Система сборки sidebar_label: Система сборки
--- ---
# Build System # Система сборки
## Compiler Backends ## Бэкенды компилятора
DCR поддерживает 4 бэкенда компиляции. Выбор происходит автоматически на основе расширения файла и target triple. DCR поддерживает 4 бэкенда компиляции. Выбор происходит автоматически на основе расширения файла и target triple.
| Backend | Файлы | Когда используется | | Бэкенд | Файлы | Когда используется |
| --------- | --------------------------------------- | ------------------------------- | | --------- | --------------------------------------- | ------------------------------------- |
| `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.s`, `.S` | gcc/clang на Linux/macOS/BSD | | `unix_cc` | `.c`, `.cpp`, `.cxx`, `.cc`, `.s`, `.S` | gcc/clang на Linux/macOS/BSD |
| `msvc` | `.c`, `.cpp`, `.cxx`, `.cc` | Windows (cl, clang-cl) | | `msvc` | `.c`, `.cpp`, `.cxx`, `.cc` | Windows (cl, clang-cl) |
| `gas` | `.s`, `.S` | ARM/ARM64 ассемблер | | `газ` | `.s`, `.S` | ARM/ARM64 ассемблер |
| `nasm` | `.asm`, `.s` | x86/x86_64 ассемблер | | `nasm` | `.asm`, `.s` | x86/x86_64 ассемблер |
| `masm` | `.asm` | MASM (ml/ml64) on Windows | | `masm` | `.asm` | MASM (ml/ml64) в Windows |
| `fasm` | `.asm`, `.fasm` | Flat Assembler | | `fasm` | `.asm`, `.fasm` | Сборщик плоских деталей |
| `llvm_ir` | `.ll` | LLVM IR via `llc -filetype=obj` | | `llvm_ir` | `.ll` | LLVM IR с помощью `llc -filetype=obj` |
## Qt Support ## Поддержка Qt
DCR provides native Qt support for automatic meta-object handling (MOC, UIC, RCC). DCR обеспечивает встроенную поддержку Qt для автоматической обработки метаобъектов (MOC, UIC, RCC).
Enable it by setting `build.qt = true` in `dcr.toml`. DCR will automatically detect Qt-related files (`.ui`, `.qrc`, `.h` with `Q_OBJECT`) and process them. Чтобы включить эту функцию, установите значение `build.qt = true` в файле `dcr.toml`. DCR автоматически обнаружит файлы, связанные с Qt (`.ui`, `.qrc`, `.h` с `Q_OBJECT`), и обработает их.
```toml ```toml
[build] [build]
qt = true qt = true
``` ```
*Note: Requires `qt6` modules (Core, Widgets, Gui, Svg) installed via `pkg-config`.* *Примечание: Требуется установка модулей `qt6` (Core, Widgets, Gui, Svg) с помощью `pkg-config`.*
Advanced customization is still possible via `build.steps` if special handling is needed: Если требуется специальная обработка, по-прежнему можно выполнить расширенную настройку с помощью файла `build.steps`:
```toml ```toml
[build.steps] [build.steps]
@@ -43,10 +43,10 @@ moc = "moc {in} -o {out}"
* Компилятор определяется через `resolve_compiler()`: CC/CXX из [toolchain], DCR_COMPILER/env, PATH * Компилятор определяется через `resolve_compiler()`: CC/CXX из [toolchain], DCR_COMPILER/env, PATH
* Поддерживает генерацию `.d` файлов для header dependency tracking * Поддерживает генерацию `.d` файлов для header dependency tracking
* Флаги: `-std=`, `-MMD -MF`, `-c -o`, `-I`, `-L`, `-l` * Флаги: `-std=`, `-MMD -MF`, `-c -o`, `-I`, `-L`, `-l`
* Conditional flags based on config: * Условные флаги, зависящие от настроек:
* `freestanding` or bare-metal target: `-ffreestanding` (compile), `-nostdlib -static` (link) * `freestanding` или целевая среда «bare-metal»: `-ffreestanding` (компиляция), `-nostdlib -static` (линковка)
* `lto`: `-flto` (compile + link) * `lto`: `-flto` (компиляция + линковка)
* `panic = "abort"`: `-fno-exceptions` (C++ only), `-fno-unwind-tables`, `-fno-asynchronous-unwind-tables` * `panic = "abort"`: `-fno-exceptions` (только для C++), `-fno-unwind-tables`, `-fno-asynchronous-unwind-tables`
### MSVC ### MSVC
@@ -58,10 +58,10 @@ moc = "moc {in} -o {out}"
* GAS: `-I`, `-c -o`, `--defsym` * GAS: `-I`, `-c -o`, `--defsym`
* NASM: `-I`, `-c -o`, `-D`, `-f` (формат: win64/elf64/macho64/macho32/elf32) * NASM: `-I`, `-c -o`, `-D`, `-f` (формат: win64/elf64/macho64/macho32/elf32)
* MASM: `/nologo /c /Fo\<obj> <source>` * MASM: `/nologo /c /Fo\<obj> <source>`
* FASM: `<source> \<output>` (output path is the object file) * FASM: `<source> \<output>` (путь вывода — объектный файл)
* LLVM IR: `-filetype=obj <source> -o \<output>` * LLVM IR: `-filetype=obj <source> -o \<output>`
## Incremental Builds ## Инкрементные сборки
Три уровня инкрементальности: Три уровня инкрементальности:
@@ -69,31 +69,31 @@ moc = "moc {in} -o {out}"
2. **`.d` files** — отслеживание изменений в заголовочных файлах (включая транзитивные) 2. **`.d` files** — отслеживание изменений в заголовочных файлах (включая транзитивные)
3. **SHA256 fingerprint** — если флаги компиляции изменились, файл перекомпилируется (fingerprint хранится в `.dcr_fingerprint`) 3. **SHA256 fingerprint** — если флаги компиляции изменились, файл перекомпилируется (fingerprint хранится в `.dcr_fingerprint`)
## Parallel Compilation ## Параллельная компиляция
* Используется `thread::scope` для создания пула потоков * Используется `thread::scope` для создания пула потоков
* Атомарная очередь задач (`AtomicU64`) * Атомарная очередь задач (`AtomicU64`)
* Мьютекс на запись в stdout (`OUTPUT_MUTEX`) * Мьютекс на запись в stdout (`OUTPUT_MUTEX`)
* Thread count = `available_parallelism()`, capped by `build.codegen-units` if set * Количество потоков = `available_parallelism()`, ограниченное значением `build.codegen-units`, если оно задано
## Build Kinds ## Типы сборок
| Kind | Тип | Path (Linux example) | | Тип | Тип | Путь (пример для Linux) |
| ----------- | ------------------------------------ | ----------------------------------------------------------------------------------------------- | | ------------------ | ------------------------------------ | ----------------------------------------------------------------------------------------------- |
| `bin` | Executable | `target/\<profile>/\<name>` (.exe) | | `bin` | Исполняемый файл | `target/\<profile>/\<name>` (.exe) |
| `staticlib` | Статическая библиотека | `target/\<profile>/lib\<name>.a` (.lib) | | `staticlib` | Статическая библиотека | `target/\<profile>/lib\<name>.a` (.lib) |
| `sharedlib` | Динамическая библиотека | `target/\<profile>/lib\<name>.so` (.dll/.dylib) | | `sharedlib` | Динамическая библиотека | `target/\<profile>/lib\<name>.so` (.dll/.dylib) |
| `efi` | UEFI приложение | `target/\<profile>/\<name>.efi` | | `efi` | UEFI приложение | `target/\<profile>/\<name>.efi` |
| `elf` | ELF без стандартной библиотеки | `target/\<profile>/\<name>` | | `эльф` | ELF без стандартной библиотеки | `target/\<profile>/\<name>` |
| `none` | Compile only, no link | — | | `нет` | Только компиляция, без линковки | — |
| `custom` | Полный контроль filename + extension | `target/\<profile>/\<filename>.\<extension>` | | `пользовательский` | Полный контроль filename + extension | `target/\<profile>/\<filename>.\<extension>` |
## Build Steps ## Этапы сборки
DCR поддерживает pre-build и post-build шаги через Qt codegen: DCR поддерживает pre-build и post-build шаги через Qt codegen:
* `build.steps` — commands before compilation * `build.steps` — команды, выполняемые перед компиляцией
* `build.post_steps` — commands after compilation * `build.post_steps` — команды, выполняемые после компиляции
Подстановки: `{stem}`, `{in}`, `{out}`. Подстановки: `{stem}`, `{in}`, `{out}`.
@@ -106,7 +106,7 @@ moc = "moc {in} -o {out}"
## pkg-config ## pkg-config
Automatic lookup (read from raw config): Автоматический поиск (чтение из исходного файла конфигурации):
```toml ```toml
[build] [build]
@@ -115,17 +115,17 @@ pkg_config = ["sdl2", "gl"]
DCR вызывает `pkg-config --cflags sdl2 gl` и `pkg-config --libs sdl2 gl` и добавляет результат в флаги компиляции/линковки. DCR вызывает `pkg-config --cflags sdl2 gl` и `pkg-config --libs sdl2 gl` и добавляет результат в флаги компиляции/линковки.
## Variable Substitution ## Подстановка переменных
Supported variables: Поддерживаемые переменные:
| Variable | Описание | | Переменная | Описание |
| ----------------------- | ------------------------------- | | ----------------------- | ----------------------------------------- |
| `{version}` | Версия пакета | | `{version}` | Версия пакета |
| `{version_major}` | Major version part | | `{version_major}` | Часть, обозначающая основную версию |
| `{version_minor}` | Minor version part | | `{version_minor}` | Часть, обозначающая второстепенную версию |
| `{version_patch}` | Переменная | | `{version_patch}` | Переменная |
| `{version_suffix}` | Suffix (e.g., `-rc1`) | | `{version_suffix}` | Суффикс (например, `-rc1`) |
| `{version_suffix_dash}` | Suffix with dash | | `{version_suffix_dash}` | Суффикс с тире |
| `{profile}` | Имя профиля (debug/release/...) | | `{profile}` | Имя профиля (debug/release/...) |
| `{name}` | Имя пакета | | `{name}` | Имя пакета |

View File

@@ -4,21 +4,21 @@ sidebar_label: Кросс-компиляция
# Кросс-компиляция # Кросс-компиляция
## Short Names ## Сокращённые названия
DCR поддерживает короткие имена платформ, которые автоматически раскрываются в полные triples: DCR поддерживает короткие имена платформ, которые автоматически раскрываются в полные triples:
| Short Name | Full Triple | | Краткое название | Полный тройной |
| ---------- | -------------------------- | | ---------------- | -------------------------- |
| `linux` | `x86_64-unknown-linux-gnu` | | `linux` | `x86_64-unknown-linux-gnu` |
| `macos` | `x86_64-apple-darwin` | | `macos` | `x86_64-apple-darwin` |
| `windows` | `x86_64-pc-windows-msvc` | | `windows` | `x86_64-pc-windows-msvc` |
```bash ```bash
dcr build --target windows dcr build --target windows
``` ```
## Full Triples ## Полные тройки
```bash ```bash
dcr build --target aarch64-unknown-linux-gnu dcr build --target aarch64-unknown-linux-gnu
@@ -39,12 +39,12 @@ target = "aarch64-unknown-linux-gnu"
## Bare-Metal ## Bare-Metal
For targets containing `none`, `-elf`, `eabi`, or `baremetal`, DCR automatically: Для целевых платформ, содержащих значения `none`, `-elf`, `eabi` или `baremetal`, DCR автоматически:
1. Для none/elf/eabi/bare-metal target-ов отключаются DCR default флаги (нет `-I` системных путей, нет `-l` libc). 1. Для none/elf/eabi/bare-metal target-ов отключаются DCR default флаги (нет `-I` системных путей, нет `-l` libc).
2. **Injects `-ffreestanding`** at compile time and `-nostdlib -static` at link time 2. **Вставляет `-ffreestanding`** на этапе компиляции и `-nostdlib -static` на этапе линковки
You can also enable freestanding mode explicitly: Кроме того, можно явно включить автономный режим:
```toml ```toml
[build] [build]
@@ -55,15 +55,15 @@ freestanding = true
dcr build --target aarch64-none-elf dcr build --target aarch64-none-elf
``` ```
## Target Directory ## Целевой каталог
On Linux with explicit target: В Linux с явным указанием цели:
``` ```
target/<triple>/<profile>/ target/<triple>/<profile>/
``` ```
On macOS/Windows or without target: В macOS/Windows или без указания целевой платформы:
``` ```
target/<profile>/ target/<profile>/

View File

@@ -36,15 +36,15 @@ sidebar_label: Обзор dcr.toml
# настройки запуска # настройки запуска
``` ```
## [package] ## [пакет]
| Поле | Обязательное | Описание | | Поле | Обязательное | Описание |
| --------- | ------------ | --------------------------- | | ---------- | ------------ | --------------------------- |
| `name` | да | Имя проекта | | `имя` | да | Имя проекта |
| `version` | да | Семантическая версия | | `версия` | да | Семантическая версия |
| `type` | да | `app`, `lib`, `none` | | `тип` | да | `app`, `lib`, `none` |
| `license` | нет | SPDX-идентификатор лицензии | | `лицензия` | нет | SPDX-идентификатор лицензии |
| `author` | нет | Автор | | `автор` | нет | Автор |
```toml ```toml
[package] [package]
@@ -55,50 +55,50 @@ license = "MIT"
author = "John Doe" author = "John Doe"
``` ```
## [build] ## [сборка]
... ...
* `build.qt` — (bool) Enable automatic Qt meta-object handling (MOC, UIC, RCC). Requires `qt6` modules installed via `pkg-config`. * `build.qt` — (bool) Включить автоматическую обработку метаобъектов Qt (MOC, UIC, RCC). Требуется установка модулей `qt6` с помощью `pkg-config`.
| Поле | По умолчанию | Описание | | Поле | По умолчанию | Описание |
| ---------------- | ------------------------------------------- | --------------------------------------------------------------------- | | ------------------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `language` | `"c"` | `"c"`, `"cxx"`, `"cpp"` | | `язык` | `"c"` | `"c"`, `"cxx"`, `"cpp"` |
| `standard` | `"c11"` | Стандарт C (`c11`, `c17`, `c23`) | | `стандартный` | `"c11"` | Стандарт C (`c11`, `c17`, `c23`) |
| `cxx_standard` | `"c++20"` | Стандарт C++ (`c++17`, `c++20`, `c++23`) | | `cxx_standard` | `"c++20"` | Стандарт C++ (`c++17`, `c++20`, `c++23`) |
| `compiler` | `cxxflags` | Предпочитаемый компилятор | | `компилятор` | `cxxflags` | Предпочитаемый компилятор |
| `kind` | `"bin"` | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom` | | `тип` | `"bin"` | `bin`, `staticlib`, `sharedlib`, `efi`, `elf`, `none`, `custom` |
| `target` | хост | Target triple для кросс-компиляции | | `target` | хост | Target triple для кросс-компиляции |
| `platform` | `"native"` | `native`, `efi`, `freestanding` | | `платформа` | `"нативный"` | `native`, `efi`, `freestanding` |
| `cflags` | `[]` | Дополнительные флаги C++ | | `cflags` | `[]` | Дополнительные флаги C++ |
| `ldflags` | `[]` | Дополнительные флаги линковки | | `ldflags` | `[]` | Дополнительные флаги линковки |
| `filename` | `""` | Кастомное имя выходного файла | | `имя файла` | `""` | Кастомное имя выходного файла |
| `extension` | `""` | Custom file extension | | `расширение` | `""` | Пользовательское расширение файла |
| `roots` | `["src"]` | Корневые директории с исходниками | | `корни` | `["src"]` | Корневые директории с исходниками |
| `exclude` | `[]` | Паттерны исключений | | `exclude` | `[]` | Паттерны исключений |
| `include` | `[]` | Дополнительные include-директории | | `include` | `[]` | Дополнительные include-директории |
| `src_disable` | `false` | Disable auto source discovery | | `src_disable` | `false` | Отключить автоматический поиск источников |
| `inherit` | `false` | Наследовать build от корня workspace | | `наследовать` | `false` | Наследовать build от корня workspace |
| `clean` | `[]` | Glob patterns for custom clean paths | | `clean` | `[]` | Шаблоны Glob для настраиваемых чистых путей |
| `out_dir` | `""` | Custom output directory | | `out_dir` | `""` | Пользовательский каталог для вывода данных |
| `workspace_only` | `false` | Только для workspace, не собирать отдельно | | `только рабочая область` | `false` | Только для workspace, не собирать отдельно |
| `freestanding` | `false` | Compile in freestanding mode (`-ffreestanding` + `-nostdlib -static`) | | `отдельно стоящий` | `false` | Компилировать в автономном режиме (`-ffreestanding` + `-nostdlib -static`) |
| `opt_level` | `"0"` (debug) / `"3"` (release) | Optimization level: `0`-`3`, `"s"`, `"z"` | | `opt_level` | `"0"` (отладочная версия) / `"3"` (релизная версия) | Уровень оптимизации: `0`–`3`, `"s"`, `"z"` |
| `ldscript` | `true` (debug) / `false` (release) | Emit debug symbols (`-g`) | | `ldscript` | `true` (отладочный режим) / `false` (релизный режим) | Выводить отладочные символы (`-g`) |
| `lto` | `false` | Link-time optimization (`-flto` for both compiler and linker) | | `lto` | `false` | Оптимизация на этапе компоновки (`-flto` как для компилятора, так и для компоновщика) |
| `asflags` | `false` | Strip symbols from output (`-s` in ldflags) | | `asflags` | `false` | Удалить символы из вывода (опция `-s` в ldflags) |
| `true` | `["all", "extra"]` (debug) / `[]` (release) | Warning flags (e.g. `"all"`, `"extra"`, `"pedantic"`) | | `true` | `["all", "extra"]` (отладочная версия) / `[]` (релизная версия) | Флаги предупреждений (например, `"all"`, `"extra"`, `"pedantic"`) |
| `panic` | `""` | Panic strategy: `"abort"` disables exceptions and unwind tables | | `panic` | `""` | Стратегия «Паника»: `"abort"` отключает исключения и таблицы развертки |
| `codegen-units` | `""` | Max parallel compilation jobs (`"0"` = auto) | | `codegen-units` | `""` | Максимальное количество параллельных заданий компиляции (`"0"` = автоматически) |
| `qt` | `false` | Enable automatic Qt meta-object handling (MOC, UIC, RCC) | | `qt` | `false` | Включить автоматическую обработку метаобъектов Qt (MOC, UIC, RCC) |
Settings from raw config (not in typed struct): Параметры из исходного файла конфигурации (не в виде типизированной структуры):
* Пакеты для pkg-config * Пакеты для pkg-config
* Путь к linker script * Путь к linker script
* `build.steps` / `build.post_steps` — codegen steps * `build.steps` / `build.post_steps` — этапы генерации кода
Example: Пример:
```toml ```toml
[build] [build]
@@ -112,7 +112,7 @@ cflags = ["-Wall", "-Wextra"]
pkg_config = ["sdl2", "gl"] pkg_config = ["sdl2", "gl"]
``` ```
## [toolchain] ## [набор инструментов]
```toml ```toml
[toolchain] [toolchain]
@@ -126,16 +126,16 @@ moc = "/usr/bin/moc" # Qt
rcc = "/usr/bin/rcc" # Qt rcc = "/usr/bin/rcc" # Qt
``` ```
Raw config also supports `uic`, `moc`, `rcc` for Qt codegen. Raw config также поддерживает `uic`, `moc` и `rcc` для генерации кода Qt.
## [dependencies] ## [зависимости]
См. [dependencies](/docs/reference/dependencies). См. [dependencies](/docs/reference/dependencies).
## [run] ## [запустить]
```toml ```toml
[run] [запустить]
cmd = "./target/{profile}/{name}" cmd = "./target/{profile}/{name}"
``` ```
@@ -143,11 +143,11 @@ cmd = "./target/{profile}/{name}"
* `{version}` — версия из [package] * `{version}` — версия из [package]
* `pkg_config` * `pkg_config`
* `{profile}` — debug / release * `{profile}` — отладочная / релизная версия
* `{name}` — имя из [package] * `{name}` — имя из [package]
По умолчанию `cmd` вычисляется как `./target/{profile}/{name}`. По умолчанию `cmd` вычисляется как `./target/{profile}/{name}`.
## [workspace] ## [рабочая область]
См. [workspaces](/docs/reference/workspaces). См. [workspaces](/docs/reference/workspaces).

View File

@@ -8,7 +8,7 @@ sidebar_label: Зависимости
В секции `[dependencies]` поддерживаются три формата: В секции `[dependencies]` поддерживаются три формата:
### String (registry) ### Строка (реестр)
```toml ```toml
[dependencies] [dependencies]
@@ -17,7 +17,7 @@ spdlog = "^1.12"
catch2 = ">=3.0,<4.0" catch2 = ">=3.0,<4.0"
``` ```
The version string is used as-is for registry lookup. Строка версии используется без изменений для поиска в реестре.
### Табличный (git) ### Табличный (git)
@@ -35,7 +35,7 @@ fmt = { git = "https://github.com/fmtlib/fmt", tag = "10.1.1" }
mylib = { path = "../mylib" } mylib = { path = "../mylib" }
``` ```
## Registry ## Реестр
## RegistryDCR использует реестр пакетов для поиска зависимостей по имени.```toml ## RegistryDCR использует реестр пакетов для поиска зависимостей по имени.```toml
# ~/.dcr/config.toml # ~/.dcr/config.toml
@@ -50,7 +50,7 @@ name = "default"
url = "https://index.dcr.pm" url = "https://index.dcr.pm"
``` ```
Registry priority: order in `config.toml`. Переменная `DCR_INDEX_PATH` переопределяет путь к index.json. Приоритет реестра: порядок в файле `config.toml`. Переменная `DCR_INDEX_PATH` переопределяет путь к index.json.
## Git-зависимости ## Git-зависимости
@@ -59,9 +59,9 @@ Registry priority: order in `config.toml`. Переменная `DCR_INDEX_PATH`
* `branch` — переключиться на ветку * `branch` — переключиться на ветку
* `tag` — переключиться на тег * `tag` — переключиться на тег
* `rev` — переключиться на конкретный коммит * `rev` — переключиться на конкретный коммит
* `features` — feature flags (parsed, but does not affect build) * `features` — флаги функций (проанализированы, но не влияют на сборку)
Cache path: `~/.dcr/git/\<hash>/`. Путь к кэшу: `~/.dcr/git/\<hash>/`.
## Path-зависимости ## Path-зависимости
@@ -77,12 +77,12 @@ mylib = { path = "../relative/path" }
Файл блокировки зависимостей. Содержит точные версии, хеши и источники. Файл блокировки зависимостей. Содержит точные версии, хеши и источники.
Created during `dcr build` when registry dependencies are present. Автоматически обновляется при `dcr add`. Создаётся при выполнении команды `dcr build` при наличии зависимостей реестра. Автоматически обновляется при `dcr add`.
## Процесс резолва ## Процесс резолва
1. Загружаются все зависимости (registry → git → path) 1. Загружаются все зависимости (registry → git → path)
2. For path deps: recursively read their `dcr.toml` 2. Для зависимостей типа «path»: рекурсивно прочитать их файлы `dcr.toml`
3. For registry deps: search `index.json` 3. Для зависимостей реестра: выполните поиск в файле `index.json`
4. For git deps: clone to cache 4. Для зависимостей Git: клонировать в кэш
5. Собираются include_dirs, lib_dirs, libs для передачи компилятору 5. Собираются include_dirs, lib_dirs, libs для передачи компилятору

View File

@@ -6,17 +6,17 @@ sidebar_label: Переменные среды
## DCR_COMPILER ## DCR_COMPILER
Переопределяет компилятор для всех языков. **Highest priority.** Переопределяет компилятор для всех языков. **Наивысший приоритет.**
```bash ```bash
export DCR_COMPILER=clang export DCR_COMPILER=clang
dcr build dcr build
``` ```
Compiler resolution priority: Приоритет разрешения компилятора:
1. `DCR_COMPILER` (env) 1. `DCR_COMPILER` (переменная среды)
2. `DCR_CC` / `DCR_CXX` / `DCR_AS` (env) 2. `DCR_CC` / `DCR_CXX` / `DCR_AS` (переменная среды)
3. `[toolchain]` (dcr.toml) 3. `[toolchain]` (dcr.toml)
4. `build.compiler` (dcr.toml) 4. `build.compiler` (dcr.toml)
5. `PATH` 5. `PATH`
@@ -33,7 +33,7 @@ export DCR_AS=arm-linux-gnueabihf-as
## DCR_LD / DCR_AR ## DCR_LD / DCR_AR
Override linker and archiver. Переопределить линкер и архиватор.
```bash ```bash
export DCR_LD=ld.lld export DCR_LD=ld.lld

View File

@@ -4,7 +4,7 @@ sidebar_label: Поддержка платформ
# Поддержка платформ # Поддержка платформ
## Target Triples ## Тройные цели
DCR нормализует target triple через `platform_triple::normalize_triple()`. Если задано имя платформы (short name), оно раскрывается в triple. DCR нормализует target triple через `platform_triple::normalize_triple()`. Если задано имя платформы (short name), оно раскрывается в triple.
@@ -16,7 +16,7 @@ target/<arch>-unknown-linux-gnu/<profile>/
Поддержка архитектур: `x86_64`, `aarch64`. Поддержка архитектур: `x86_64`, `aarch64`.
Artifact type: ELF. Расширения: `.so` для sharedlib, `.a` для staticlib Тип артефакта: ELF. Расширения: `.so` для sharedlib, `.a` для staticlib
### macOS ### macOS
@@ -36,7 +36,7 @@ target/<profile>/
Поддержка архитектур: `x86_64`, `aarch64`. Поддержка архитектур: `x86_64`, `aarch64`.
Extensions: `.exe` (bin), `.lib` (staticlib), `.dll` (sharedlib), `.efi` (UEFI). Расширения: `.exe` (бинарный файл), `.lib` (статическая библиотека), `.dll` (общая библиотека), `.efi` (UEFI).
### BSD ### BSD

View File

@@ -6,7 +6,7 @@ sidebar_label: Автоматическое обновление
## dcr --update ## dcr --update
Автоматическое обновление до последней версии. Downloads a binary (not an archive) from GitHub Releases and replaces the current executable. Автоматическое обновление до последней версии. Загружает бинарный файл (не архив) из раздела «Релизы» на GitHub и заменяет им текущий исполняемый файл.
```bash ```bash
dcr --update dcr --update
@@ -15,16 +15,16 @@ dcr --update
## Как это работает ## Как это работает
1. DCR определяет текущую платформу и архитектуру 1. DCR определяет текущую платформу и архитектуру
2. Fetches the latest release from `api.github.com/repos/dexoron/dcr/releases/latest` 2. Загружает последнюю версию с `api.github.com/repos/dexoron/dcr/releases/latest`
3. Compares versions 3. Сравнивает версии
4. Downloads the matching asset (direct binary URL, not archive) 4. Загружает соответствующий ресурс (прямой URL-адрес двоичного файла, а не архива)
5. Заменяет текущий исполняемый файл 5. Заменяет текущий исполняемый файл
## Asset naming ## Названия активов
Шаблон: `dcr-\<triple>.\<ext> ` Шаблон: `dcr-\<triple>.\<ext> `
| Платформа | Asset name | | Платформа | Название актива |
| -------------- | ------------------------------------- | | -------------- | ------------------------------------- |
| Linux x86_64 | `dcr-x86_64-unknown-linux-gnu.tar.gz` | | Linux x86_64 | `dcr-x86_64-unknown-linux-gnu.tar.gz` |
| macOS x86_64 | `dcr-x86_64-apple-darwin.tar.gz` | | macOS x86_64 | `dcr-x86_64-apple-darwin.tar.gz` |
@@ -36,7 +36,7 @@ dcr --update
Если DCR установлен через AUR, `--update` выводит предупреждение: Если DCR установлен через AUR, `--update` выводит предупреждение:
``` ```
Update via package manager: yay/paru -Syu {package_name} or sudo pacman -Syu {package_name} Обновление через менеджер пакетов: yay/paru -Syu {package_name} или sudo pacman -Syu {package_name}
``` ```
## Ошибки ## Ошибки

View File

@@ -4,15 +4,15 @@ sidebar_label: Запуск тестов
# Запуск тестов # Запуск тестов
## Execution ## Выполнение
```bash ```bash
dcr test Тест DCR
``` ```
Builds the project, then compiles and runs test files from `tests/`. Выполняет сборку проекта, а затем компилирует и запускает тестовые файлы из каталога `tests/`.
## Profiles ## Профили
```bash ```bash
dcr test # debug (по умолчанию) dcr test # debug (по умолчанию)
@@ -24,12 +24,12 @@ dcr test --debug # явно debug
``` ```
===================== =====================
Testsuite summary Сводка результатов набора тестов
===================== =====================
TOTAL: 5 ИСПОЛЬЗОВАНО: 5
PASS: 3 ПРОЙДЕНО: 3
SKIP: 1 ПРОПУЩЕНО: 1
FAIL: 1 НЕ ПРОЙДЕНО: 1
===================== =====================
``` ```
@@ -38,7 +38,7 @@ FAIL: 1
* 0 — все тесты пройдены (FAIL = 0) * 0 — все тесты пройдены (FAIL = 0)
* 1 — есть упавшие тесты * 1 — есть упавшие тесты
## What gets built ## Что строится
* Все C/C++ файлы из `tests/` * Все C/C++ файлы из `tests/`
* Include path: `tests/` (для `dcr_test.h`) * Include path: `tests/` (для `dcr_test.h`)

View File

@@ -25,12 +25,12 @@ EXPECT(ptr != NULL, "ptr should not be NULL");
SKIP("not implemented on Windows yet"); SKIP("not implemented on Windows yet");
``` ```
### `TEST(name)` ### `TEST(имя)`
Определяет тест. Определяет тест.
```c ```c
TEST(addition) { TEST(сложение) {
EXPECT(1 + 1 == 2); EXPECT(1 + 1 == 2);
EXPECT(2 + 2 == 4); EXPECT(2 + 2 == 4);
} }
@@ -38,7 +38,7 @@ TEST(addition) {
### `TEST_CASE(name, ...)` ### `TEST_CASE(name, ...)`
Registers a test case. Регистрирует тестовый случай.
```c ```c
TEST_CASE(math, a, b) { TEST_CASE(math, a, b) {
@@ -66,4 +66,4 @@ tests/
└── ... # дополнительные .c файлы с тестами └── ... # дополнительные .c файлы с тестами
``` ```
Only `.c` files are compiled (`.cpp` is not supported). Компилируются только файлы с расширением `.c` (файлы с расширением `.cpp` не поддерживаются).