dcr 0.8.3

DCR is a utility for managing C/C++ projects in a Cargo-like style.
dcr-0.8.3 is not a library.

Why DCR?

  • No boilerplate — one config file, predictable structure
  • Cargo-like workflow — build, run, clean, test, add, fmt
  • Cross-compilation — full target triple support with short names
  • IDE integration — VS Code, CLion, compile_commands.json out of the box
  • Dependencies — path, git, and registry-based with lock file
  • Man pages — man dcr and per-command pages (man dcr-build, man dcr-new, etc.)

Installation

yay -S dcr

brew tap dexoron/dexoron
brew install dcr

nix run github:dexoron/dcr
# or install to profile:
nix profile install github:dexoron/dcr

cargo install dcr

curl -fsSL https://sh.dcr-tool.ru | sh -s -- self-install
export PATH="$HOME/.dcr/bin:$PATH"
dcrup install stable

irm https://ps1.dcr-tool.ru | iex
# or:
# irm https://ps1.dcr-tool.ru -OutFile dcrup.ps1
# powershell -File .\dcrup.ps1 self-install
# $env:Path += ";$env:USERPROFILE\.dcr\bin"
dcrup install stable

Snap Store publishing temporarily disabled — see #51671. Download the .snap from GitHub Releases and install manually:

sudo snap install --classic --dangerous dcrup_*.snap

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

Quick Start

dcr new hello
cd hello
dcr run

Project structure:

hello/
├── dcr.toml       # project config
└── src/
    └── main.c

dcr.toml Example

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

[build]
language = "c"
standard = "c11"
compiler = "clang"
kind = "bin"

[dependencies]

Base Commands

Command Description
dcr new <name> Create a new project
dcr init Initialize current directory
dcr add <dep> Add a dependency
dcr build [--release] Build the project
dcr run [--release] Build and run
dcr clean Remove build artifacts
dcr test Run project tests
dcr fmt Format C/C++ sources (clang-format)
dcr tree View dependency tree
dcr gen <vscode|clion|compile-commands> Generate IDE integration
dcr setup Initialize DCR registry

other in docs/, dcr --help and dcr <command> --help

Platforms (pre-built binary)

OS x86_64 aarch64 armv7 i686 riscv64
Linux (GNU) ✅ ✅ ✅ ✅ ✅
Linux (Musl) ✅ ✅ ✅ ✅ 🚧
macOS ✅ ✅ ❌ ❌ ❌
Windows (MSVC) ✅ ✅ ❌ ✅ ❌
Windows (MinGW) ✅ 🚧 ❌ ❌ ❌
FreeBSD ✅ 🚧 ❌ ❌ ❌
OpenBSD ✅ 🚧 ❌ ❌ ❌
NetBSD ✅ 🚧 ❌ ❌ ❌

✅ pre-built binary · 🚧 planned · ❌ not supported by platform or CI

Documentation

Full docs at dcr.dexoron.su or in the docs/ directory.

Contributors

Name Role GitHub
👤 Dexoron (Bezotechestvo Vladimir) Maintainer, Creator @dexoron
👤 Kai Maintainer @peoplemiau1

Contributing

See CONTRIBUTING.md. Before a PR:

cargo fmt --all
cargo clippy --all-targets --all-features -- -D warnings
cargo test

GPL-3.0 — see LICENSE DCR is a build tool, not a library. The GPL applies only to DCR's own source code, not to projects built with it. Made with ❤️ by Dexoron and contributors.