langkit 1.0.0-beta.2

A builder library for creating programming languages in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# langkit

Langkit is a Rust builder library for creating programming languages with a simple, high-level API.

## Status

This crate is in beta and evolving toward 1.0.0. The public API is intended to be stable, but minor
changes may still happen before the final release.

## Highlights

- Built-in module packs via `lang.lib("base")` (math/io/fs/net/time/http).
- File imports with module namespacing (`import "utils.arc"` → `utils.*`).
- Bytecode cache support and fast rebuilds.
- Simple LSP diagnostics and minimal LSP server.
- Tiny macro helpers: `@include("file")`, `@repeat(n){...}`.
- REPL with history.

## Goals

- Minimal boilerplate for language definition.
- Simple syntax rules with sensible defaults.
- Optional static or dynamic typing.
- Easy integration with Rust crates and FFI.

## Quick Start

```rust
use langkit::{Lang, Typing, Value};

fn main() {
    let mut lang = Lang::new();
    lang.name("arc");
    lang.extension(".arc");
    lang.var("let");
    lang.mut_kw("var");
    lang.assign("=");
    lang.typing(Typing::Dynamic);
    lang.lib("base");

    lang.token("print");
    lang.action("print", Box::new(|args| {
        let s: Vec<String> = args.iter().map(|a| a.to_string()).collect();
        println!("{}", s.join(" "));
        Value::Null
    }));

    lang.run("let x = 5\nprint x").unwrap();
}
```

## Documentation

Run:

```bash
cargo doc --open
```