https://github.com/erdos/uclj

Small, quick, native Clojure interpreter
https://github.com/erdos/uclj

clojure clojure-cli clojure-repl interpreter

Last synced: 2 months ago
JSON representation

Small, quick, native Clojure interpreter

• Host: GitHub
• URL: https://github.com/erdos/uclj
• Owner: erdos
• License: other
• Created: 2021-12-21T20:52:06.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2023-06-03T19:38:06.000Z (over 1 year ago)
• Last Synced: 2024-08-03T13:04:53.595Z (6 months ago)
• Topics: clojure, clojure-cli, clojure-repl, interpreter
• Language: Clojure
• Homepage:
• Size: 107 KB
• Stars: 150
• Watchers: 7
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# uclj

A small, quick-starting, native Clojure interpreter.

It is built on top of the Clojure JVM runtime, but the parts that need dynamic class loading have been reimplemented in Clojure so that it could be compiled into a native application.

**Features**

- Starts quickly (it is compiled with GraalVM native-image)

- Small (<1K SLOC)

- Out of the Box [core.async](https://github.com/clojure/core.async) support and also [many other core libraries](https://github.com/erdos/uclj/blob/master/src/uclj/core.clj#L10)

## Usage

Download the binary from the [Release page](https://github.com/erdos/uclj/releases) and run the `uclj` command:

- call `uclj` without parameters to get a REPL

- call `uclj filename.clj` to load a file

- call `uclj filename.clj --test` to load a file and then run all test cases in it

- call `uclj '(...)'` to evaluate a Clojure expression. (It must start with a `(` character.)

### Build

You can also build the binary yourself. You will need [Leiningen](https://leiningen.org/) and [GraalVM](https://www.graalvm.org/downloads/) to build the application. Set the `GRAALVM_HOME` environment variable and run the `build-graal.sh` script.

## License

Copyright © 2022 Janos Erdos

This program and the accompanying materials are made available under the

terms of the Eclipse Public License 2.0 which is available at

http://www.eclipse.org/legal/epl-2.0.

This Source Code may also be made available under the following Secondary

Licenses when the conditions for such availability set forth in the Eclipse

Public License, v. 2.0 are satisfied: GNU General Public License as published by

the Free Software Foundation, either version 2 of the License, or (at your

option) any later version, with the GNU Classpath Exception which is available

at https://www.gnu.org/software/classpath/license.html.