Semantically a dialect of ClojureScript. Built with Rust. Compiles to JavaScript ES Modules.
- Home https://calcit-lang.org/
- API Doc https://apis.calcit-lang.org/
- Guidebook https://guide.calcit-lang.org/
Browse examples or also try WASM version online.
Core design:
- Interpreter runs on Rust, extensible with Rust FFI
- Persistent Data Structure
- Structural Editor(with indentation-based syntax as a fallback)
- Lisp macros, functional style
- Compiles to JavaScript in ES Modules, JavaScript Interop
- Hot code swapping friendly
Build and install with Rust:
# get Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# get Calcit
cargo install calcit
3 binaries are installed:
calcit
, the runtime and js compilercaps
, for downloading dependencies declared indeps.cirru
bundle_calcit
, bundle code if you don't want to use Calcit Editor
To use Calcit in GitHub Actions, try setup-cr.
Snippets evaling:
cr eval 'range 100'
multi-lines snippet:
cr eval '
println "|a demo"
->
range 100
map $ fn (x)
* x x
'
Run with a compact.cirru:
cr compact.cirru -1 # run only once
cr compact.cirru # watch mode enabled by default
By default Calcit reads :init-fn
and :reload-fn
inside compact.cirru
configs. You may also specify functions,
cr compact.cirru --init-fn='app.main/main!' --reload-fn='app.main/reload!'
and even configure :entries
in compact.cirru
:
cr compact.cirru --entry server
It compiles to JavaScript and runs in consistet semantics. However it might require a lot of JavaScript interop.
cr compact.cirru js # compile to js
cr compact.cirru js --emit-path=out/ # compile to js and save in `out/`
By default, js code is generated to js-out/
. You will need Vite or Node to run it, from an entry file:
import { main_$x_, reload_$x_ } from "./js-out/app.main.mjs";
main_$x_();
Install Calcit Editor and run ct
to launch editor server,
which writes compact.cirru
and .compact-inc.cirru
on saving. Try launching example by cloning Calcit Workflow.
Read more in Minimal Calcit to learn how to code Calcit with a plain text editor.
Read more in Respo Calcit Workflow to learn to create an MVC webpage with Respo.
deps.cirru
declares dependencies that need to download, which correspond to repositories on GitHub. Specify a branch or a tag:
{}
:dependencies $ {}
|calcit-lang/memof |0.0.11
|calcit-lang/lilac |main
Run caps
to download. Sources are downloaded into ~/.config/calcit/modules/
. If a module contains build.sh
, it will be executed mostly for compiling Rust dylibs.
To load modules, use :modules
configuration in calcit.cirru
and compact.cirru
:
:configs $ {}
:modules $ [] |memof/compact.cirru |lilac/
Paths defined in :modules
field are just loaded as files from ~/.config/calcit/modules/
,
i.e. ~/.config/calcit/modules/memof/compact.cirru
.
Modules that ends with /
s are automatically suffixed compact.cirru
since it's the default filename.
I use these commands to run local examples:
# run tests in Rust
cargo run --bin cr -- calcit/test.cirru -1
# run tests in Node.js
cargo run --bin cr -- calcit/test.cirru -1 js && yarn try-js
# run snippet
cargo run --bin cr -- eval 'range 100'
cr compact.cirru -1 ir # compiles intermediate representation into program-ir.cirru
- Cirru Parser for indentation-based syntax parsing.
- Cirru EDN for
compact.cirru
file parsing. - Ternary Tree for immutable list data structure.
Other tools:
- Error Viewer for displaying
.calcit-error.cirru
- IR Viewer for rendering
program-ir.cirru
Some resources:
- Dev Logs https://github.com/calcit-lang/calcit/discussions
- 视频记录 https://space.bilibili.com/14227306/channel/seriesdetail?sid=281171
MIT