Skip to content
eucalypt
v0.15.0

Quick Start

If you use Homebrew, you can install using:

Terminal window
brew install curvelogic/homebrew-tap/eucalypt

Alternatively, install the latest release binary directly:

Terminal window
curl -sSf https://raw.githubusercontent.com/curvelogic/eucalypt/master/install.sh | sh

This installs to ~/.local/bin. Set EUCALYPT_INSTALL_DIR to override the install location.

Otherwise binaries for macOS are available on the releases page.

x86_64 and aarch64 binaries built in CI are available on the releases page.

Sorry, haven’t got there yet. But you could try installing from source.

You will need a Rust installation and cargo.

Build and install should be as simple as:

Terminal window
cargo install --path .
Terminal window
eu --version

…prints the version, e.g.:

eu - Eucalypt v0.12.1

…and…

Terminal window
eu --help

…shows command line help:

A functional language for structured data
Usage: eu [OPTIONS] [FILES]... [COMMAND]
Commands:
run Evaluate eucalypt code (default)
test Run tests
dump Dump intermediate representations
version Show version information
explain Explain what would be executed
list-targets List targets defined in the source
fmt Format eucalypt source files
lsp Start the Language Server Protocol server
check Check type annotations in eucalypt source files
doc Extract documentation from eucalypt source files
help Print this message or the help of the given subcommand(s)
Arguments:
[FILES]... Files to process (used when no subcommand specified)
Options:
--source-prelude Force source-prelude pipeline even when pre-compiled blob is available
-h, --help Print help
-V, --version Print version

Most of the options familiar from older versions (-L, -Q, -d, -S, --statistics-file, and many more) now live under the run subcommand — see eu run --help or the CLI Reference for the full list.

Use eu <command> --help for detailed help on each subcommand.

Create a file called hello.eu:

greeting: "Hello, World!"

Run it:

Terminal window
eu hello.eu

Output:

greeting: Hello, World!

Try JSON output:

Terminal window
eu hello.eu -j
{"greeting": "Hello, World!"}