https://github.com/borkdude/clojure-rust-graalvm
An example of Clojure program calling a Rust library, all combined into one executable using GraalVM.
https://github.com/borkdude/clojure-rust-graalvm
clojure graal-native graalvm jni rust rust-lang
Last synced: about 1 month ago
JSON representation
An example of Clojure program calling a Rust library, all combined into one executable using GraalVM.
- Host: GitHub
- URL: https://github.com/borkdude/clojure-rust-graalvm
- Owner: borkdude
- License: epl-1.0
- Created: 2020-02-22T22:54:58.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-03-02T13:42:25.000Z (about 5 years ago)
- Last Synced: 2025-03-28T13:38:37.178Z (about 2 months ago)
- Topics: clojure, graal-native, graalvm, jni, rust, rust-lang
- Language: Rust
- Homepage:
- Size: 23.4 KB
- Stars: 138
- Watchers: 9
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# clojure-rust-graalvm
An example of Clojure program calling a Rust library, all combined into one executable using GraalVM.
It gets the amount of free memory via the
[heim-rs](https://github.com/heim-rs/heim) library and prints it in EDN format.
This repo is an adapted example of what is described in the README of the Rust
[jni](https://docs.rs/jni/0.14.0/jni/) library.
In `clojure/src-java` there is a Java static method which calls a Rust function
via JNI. We call this static method from Clojure.
## Usage
``` shell
$ time ./clojure-rust megabyte
{:memory/free [:megabyte "1210"]}
./clojure-rust megabyte 0.01s user 0.01s system 34% cpu 0.027 total
```
Accepted options: `byte`, `megabyte`, `gigabyte`.
## Build
Prerequisites:
- Download [GraalVM](https://www.graalvm.org/downloads/) and set `GRAALVM_HOME`
- Install [lein](https://github.com/technomancy/leiningen)
- Install [cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html)
Run `script/compile` to build the Rust lib, the Clojure uberjar and the GraalVM executable.
Finally, run the executable:
``` shell
$ target/clojure-rust
{:memory/free [:byte "896126976"]}
```
## License
Copyright © 2020 Michiel Borkent
Distributed under the EPL License, same as Clojure. See LICENSE.