Files

T

dimgigov 10e4ec07d6 docs: reorganize into en/ and bg/ subfolders with numbered indices

- New docs/index.md with language selector
- docs/en/ — 01-getting-started, 02-architecture, 03-ai-integration,
  04-api-reference, 05-user-guide, 06-roadmap
- docs/bg/ — same structure in Bulgarian
- Root README.md trimmed to quick-start + links to docs/
- Removed old flat docs/ files (ARCHITECTURE.md, AI_FIRST.md, etc.)
- Added swap!/reset! examples to getting-started guides

2026-05-08 23:24:47 +03:00

3.3 KiB

Raw Blame History

← Към индекса

Ръководство за Потребителя — Clojure/Nim

Инсталация

Изисквания

Nim >= 2.0
GCC или Clang
make

Изграждане от Източник

git clone https://gitlab.com/balvatar/lisp-nim.git
cd lisp-nim
make build

CLI Команди

`compile` — Компилиране до Nim

./cljnim compile input.clj output.nim

Генерира .nim файл от Clojure изходен код.

`run` — Компилиране и Изпълнение

./cljnim run examples/hello.clj

Компилира до Nim, после до C, после до бинарен файл, и го изпълнява.

`read` — Парсиране и Отпечатване на AST

./cljnim read examples/hello.clj

Показва Clojure AST като S-изрази.

`repl` — Интерактивен REPL

# Човешки режим
./cljnim repl

# AI режим (структуриран JSON)
./cljnim repl --json

Писане на Clojure/Nim Програми

Базов Синтаксис

; Коментарите започват с точка и запетая

; Дефиниране на променлива
(def x 42)

; Дефиниране на функция
(defn greet [name]
  (println "Здравей, " name))

; Извикване на функция
(greet "Свят")

; Аритметика
(+ 1 2 3)      ; => 6
(* 10 20)      ; => 200
(/ 100 4)      ; => 25

; Условни изрази
(if (> x 0)
  "положително"
  "неположително")

; Локални обвързвания
(let [a 10
      b 20]
  (+ a b))     ; => 30

Работа с Данни

; Вектори (използват Nim seq вътрешно)
(def nums [1 2 3 4 5])

; Ключови думи
(def person {:name "Алиса" :age 30})

; Картите и множествата използват persistent HAMT структури
; със structural sharing и O(log₃₂ n) операции.

Рекурсия

(defn factorial [n]
  (if (= n 0)
    1
    (* n (factorial (- n 1)))))

(println (factorial 5))  ; => 120

Ръководство за AI REPL

JSON REPL е проектиран за програмно взаимодействие.

Стартиране на AI REPL

./cljnim repl --json

Оценка на Форма

{"op": "eval", "form": "(+ 1 2 3)"}

Отговор:

{
  "status": "ok",
  "result": {"printed": "6"},
  "meta": {"ns": "user", "ms": 861, "form": "(+ 1 2 3)"}
}

Batch Оценка

{"op": "eval-batch", "forms": ["(defn f [x] x)", "(f 42)"]}

Листване на Дефиниции

{"op": "get-defs"}