blob: a238c8e6d7f75b12b66ace5b5d6238cdb439a940 (
plain)
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
59
60
61
62
63
64
65
66
67
68
69
70
|
# cljcc
A toy C Compiler implementation in Clojure.
Browser version: [cljcc](https://cljcc.shagunagrawal.me)
Follows the book [Writing a C Compiler by Nora Sandler](https://nostarch.com/writing-c-compiler).
Post about my experience implementing the book [writing-a-c-compiler-in-clojure](https://shagunagrawal.me/posts/writing-a-c-compiler-in-clojure/).
Post on how to compile to WASM [compiling-clojure-to-webassembly](https://shagunagrawal.me/posts/compiling-clojure-to-wasm-image/).
## Prerequisites
* [Clojure](https://clojure.org)
* [GraalVM](https://www.graalvm.org) for building native binary
* [babashka](https://github.com/babashka/babashka#installation)
Only Linux and Mac OS is supported. For Windows, run through WSL.
## Tasks
To see all available tasks in the project, run `bb tasks`:
``` sh
bb tasks
The following tasks are available:
clean Removes target folder.
nrepl Starts a nrepl session.
storm Starts a nrepl session with storm debugger.
lib:run:main Run's main only for cljcc library.
lib:build:jar Builds uberjar only for cljcc lib.
lib:build:wasm Builds native WASM image.
cli:run:main Run's main CLI function.
cli:build:jar Builds uberjar for CLI.
cli:run:jar Runs CLI jar.
cli:build:wasm Builds native image for WASM.
cli:build:native Builds native image for CLI.
```
## Build
To build native image, run:
``` sh
bb cli:build:native
```
This produces a binary `cljcc-cli` at `/target/cli`. Pass the path to the C file.
``` sh
./target/cli/cljcc-cli "path/to/file.c"
```
## Run Jar
``` sh
bb cli:run:jar
```
## References
Some talks / projects which helped in implementation.
* [What's So Hard About Writing A Compiler, Anyway? Oh - Ramsey Nasser](https://www.youtube.com/watch?v=_7sncBhluXI)
* [Clojure Lexer implementation by Vikasg7](https://github.com/ThePrimeagen/ts-rust-zig-deez/tree/master/clj)
|
