dexoron/dcr
1
1
Fork 0
mirror of https://github.com/dexoron/dcr.git synced 2026-10-21 08:58:35 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
cb8a3b200152dc716b0ac5b35bd3f9c5b645d1df
dcr/docs/ru/README_ru.md

5.2 KiB
Raw Blame History

DCR (Dexoron Cargo Realization)

DCR — это утилита для управления проектами на C/C++ в стиле Cargo.

Текущая реализация написана на Rust.

Зачем DCR

  • Единая структура проекта без ручной настройки
  • Простые команды для типовых задач
  • Прозрачная компиляция и предсказуемые профили сборки

Возможности

  • Создание нового проекта или инициализация текущей директории
  • Сборка проекта в профилях debug и release
  • Запуск собранного бинарника
  • Очистка результатов сборки
  • Генерация минимального шаблона C-проекта
  • Обновление бинарника через dcr --update (GitHub Releases, не для pacman-установок)

Поддерживаемые платформы

  • Linux: x86_64-unknown-linux-gnu
  • macOS Intel: x86_64-apple-darwin
  • macOS Apple Silicon: aarch64-apple-darwin
  • Windows: x86_64-pc-windows-msvc

Установка

Пакетный менеджер

ArchLinux

yay -S dcr # или paru и остальные менеджеры пакетов AUR

Из исходников

git clone https://github.com/dexoron/dcr.git
cd dcr
cargo build --release
mkdir -p ~/.local/bin
ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr

Через install.sh (Linux/macOS)

curl -fsSL https://dcr.dexoron.su/install.sh | bash

Через install.ps1 (Windows)

irm https://dcr.dexoron.su/install.ps1 | iex

Оба скрипта при запуске спрашивают:

  • скачать готовый бинарник из GitHub Release
  • или собрать проект из git

Релизные ассеты:

  • dcr-x86_64-unknown-linux-gnu
  • dcr-x86_64-apple-darwin
  • dcr-aarch64-apple-darwin
  • dcr-x86_64-pc-windows-msvc.exe

Обновление

  • Если DCR установлен из GitHub Releases, через install.sh, install.ps1 или собран вручную:
    • используйте dcr --update
  • Если DCR установлен через pacman/AUR:
    • обновляйте через пакетный менеджер: paru/yay -Syu dcr или sudo pacman -Syu dcr
    • dcr --update определяет пакетную установку и подсказывает обновляться через пакетный менеджер

Быстрый старт

Создать новый проект: dcr new hello

Или инициализировать текущую директорию (директория должна быть пустой): dcr init

Структура проекта:

hello/
- src/
- - main.c
- dcr.toml

Сборка и запуск проекта: dcr run или dcr run --release

Команды

dcr new <name>

Создает проект в текущей директории с указанным именем.

dcr init

Создает проект в текущей директории. Имя проекта будет равно имени директории. Директория должна быть пустой.

dcr build [profile]

Собирает проект. Если профиль не указан, используется --debug.

dcr run [profile]

Собирает проект и запускает бинарник. Если профиль не указан, используется --debug.

Запуск вручную: ./target/<profile>/<name>

dcr clean

Удаляет папку target в корне проекта.

Профили сборки

Поддерживаются два профиля:

  • --debug (по умолчанию) — встроенные флаги для каждого компилятора
  • --release — встроенные флаги для каждого компилятора

Кастомные флаги можно добавить через build.cflags и build.ldflags в dcr.toml. Можно указать build.target, чтобы задать директорию выхода бинарника (без привязки к профилю).

Конфигурация

Основной файл проекта — dcr.toml.

Пример dcr.toml:

[package]
name = "hello"
version = "0.1.0"

[build]
language = "c"
standard = "c11"
compiler = "clang"
# Опциональные флаги
cflags = ["-Wall", "-Wextra"]
ldflags = ["-lm"]

[dependencies]

Поддерживаются path-зависимости. DCR резолвит их при сборке и создаёт dcr.lock.

Требования

  • Rust toolchain (rustc, cargo) - Для ручной сборки DCR
  • C-компилятор (clang, gcc или 'cl'(msvc))

Релизы

Релизы собираются автоматически через GitHub Actions (.github/workflows/release.yml) при пуше тега формата v*.

Лицензия

См. файл LICENSE.