Introduction

clojurust is a Rust-hosted dialect of the Clojure programming language. It reads and executes .cljrs and .cljc source files, provides an interactive REPL, and can AOT-compile programs to standalone native binaries.

Goals

• Interpreter — read and execute .cljrs (native) and .cljc (cross-platform) source files.
• Reader conditionals — .cljc files use #?(:cljrs ... :clj ... :default ...) to branch on platform; the platform key for clojurust is :cljrs (:rust is accepted as a legacy alias).
• Rust interop — Clojure code can call Rust functions through a defined set of conventions and type-marshalling primitives.
• Garbage collector — a tracing GC manages all Clojure values; an optional region-based allocator is available for allocation-heavy code paths.
• AOT compilation — cljrs compile produces a standalone native binary via Cranelift, or a WebAssembly module with --target wasm. See the WebAssembly chapter.
• Async & I/O — clojure.core.async channels and non-blocking file I/O ship as optional crates layered over the interpreter. See the Async & I/O chapter.
• Embeddable — the same runtime the CLI drives can be built inside your own Rust program as a scripting, rules, or plugin layer. See the Embedding chapter.

Source file extensions

Quick start

cljrs run hello.cljrs
cljrs repl
cljrs eval '(+ 1 2)'
cljrs compile app.cljrs -o app
cljrs test --src-path test

Detailed documentation for each subcommand is in the CLI chapter.