dimgigov
79cd9c08d8
- Bulk replace Clojure/Nim → Bara Lang in src/, lib/, examples/, benchmarks/, experiments/, books/, LICENSE, cljnim.nimble, PLAN.md, AI_AGENT.md - Rename book chapters: 05-clojure-nim.md → 05-bara-lang.md (en + bg) - Update all chapter index links and anchors - Replace project-specific 'Clojure' references with 'Bara Lang' in experiments/, src/ai_assist.nim, src/tui_screens.nim, src/emitter.nim, src/reader.nim, src/types.nim, lib/cljnim_runtime*.nim - Keep legitimate JVM Clojure/ClojureScript/Clojure CLR references intact
1.9 KiB
1.9 KiB
Bara Lang — The Native Clojure Book
A practical guide to Clojure that compiles to native binaries. No JVM required.
What You Will Learn
This book teaches Clojure through the lens of Bara Lang — a real compiler that turns your Clojure code into native machine code via Nim and C.
You do not need Java. You do not need Leiningen. You need Nim, a C compiler, and curiosity.
Book Structure
| Chapter | Topic | Why It Matters |
|---|---|---|
| 01 — Fundamentals | Syntax, data structures, functions, control flow | The foundation. Applies to all Clojure dialects. |
| 02 — Advanced | Transducers, specs, parallelism, performance | Write code that scales. |
| 03 — Tooling | Project structure, deps, testing, debugging | Ship reliable software. |
| 04 — Recipes | Common patterns, state management, APIs | Copy-paste solutions that work. |
| 05 — Bara Lang | Native compilation, AI integration, JSON REPL, WASM | What makes this dialect unique. |
Quick Start
git clone https://gitlab.com/balvatar/lisp-nim.git
cd lisp-nim
make build && make check
./cljnim run examples/hello.clj
Running the Examples
Most examples work in any Clojure REPL. Chapter 5 examples are specific to Bara Lang:
# Human REPL
./cljnim repl
# JSON REPL (for AI agents)
./cljnim repl --json
# Compile to native binary
./cljnim run myprogram.clj
# Generate code with AI
./cljnim ai "function that reverses a list"
Language Versions
Stats
- 8 chapters (4 core + 4 translated)
- 1 new chapter on Bara Lang (native compilation, AI, cross-targets)
- All code tested against Bara Lang v0.1.0
This book is maintained as part of the Bara Lang project.