Skip to content
(Lispex)2.0In preparation

Search documentation

Searches the English specification

Enter a question, symbol, diagnostic code, or command.

Contents

Search the specification

Downloads

Current release 1.21.3

2.0 · Not yet released

Install

# macOS / Linux
curl -fsSL https://www.lispex.com/install.sh | sh

# Windows (PowerShell)
irm https://www.lispex.com/install.ps1 | iex

The script downloads the latest release and checks its SHA-256 checksum.

Check the version

Open a new terminal.

lispex --version
Output
lispex 1.21.3
If the command is not found
  • On macOS and Linux, add ~/.lispex/bin to PATH and restart the shell.
  • On Windows, add %LOCALAPPDATA%\Lispex\bin to the user PATH and open a new PowerShell window.

Install with npm

Node 18 or newer is required.

npm install lispex

Check the version in the project folder.

npx lispex --version
Output
1.21.3

hello.lspx

(define language "Lispex")

(list 'hello language (+ 2 3))

Run the file

npx lispex hello.lspx
Output
(hello "Lispex" 5)

Install globally

npm install -g lispex

The lispex command uses the first matching program on PATH.

Download files

PlatformFileChecksum
Linux · x86_64lispex-linux-x86_64 →25.1 MB25,118,456 bytes.sha256 →
Linux · aarch64lispex-linux-aarch64 →16.8 MB16,835,384 bytes.sha256 →
macOS · Apple siliconlispex-macos-aarch64 →20.9 MB20,946,992 bytes.sha256 →
macOS · Intellispex-macos-x86_64 →24.3 MB24,324,284 bytes.sha256 →
Windows · x86_64lispex-windows-x86_64.exe →23.1 MB23,114,752 bytes.sha256 →

Release manifest →

Release files on GitHub ↗

Checksums and signatures

Keep the executable and its .sha256 file in the same folder. A match prints OK.

# Linux
sha256sum -c lispex-linux-x86_64.sha256

# macOS
shasum -a 256 -c lispex-macos-aarch64.sha256

In Windows PowerShell, a match prints True.

$want = (Get-Content .\lispex-windows-x86_64.exe.sha256).Split(' ')[0]
(Get-FileHash .\lispex-windows-x86_64.exe).Hash -eq $want

What a download check establishes

A checksum identifies the exact bytes you downloaded.

Signed distribution and the recipient's trust policy identify the publisher and the accepted source.

Lispex Vouch records the current decision, and the receiving application authorizes any external action.

Run directly on Windows

Keep hello.lspx in the same folder as the executable.

.\lispex-windows-x86_64.exe hello.lspx

Developer components

Resource-controlled rule engine

ItemFileChecksum
WASM componentlispex-embed-evaluator.wasm →1.6 MB1,588,220 bytes.sha256 →
Manifestlispex-embed-evaluator-manifest.json →26.3 KB26,347 bytes.sha256 →
Recorded requests and resultslispex-embed-evaluator-golden-vectors.json →4.0 KB4,014 bytes.sha256 →
Redistribution packagelispex-embed-evaluator-redistribution.zip →15.0 MB14,994,343 bytes.sha256 →

Whole-language rule engine

ItemFileChecksum
WASM componentlispex-full-embed-evaluator.wasm →1.6 MB1,588,667 bytes.sha256 →
Manifestlispex-full-embed-evaluator-manifest.json →2.5 KB2,465 bytes.sha256 →
Recorded requests and resultslispex-full-embed-evaluator-provider-vectors.json →14.7 KB14,663 bytes.sha256 →
Redistribution packagelispex-full-embed-evaluator-redistribution.zip →15.1 MB15,128,596 bytes.sha256 →

Editor extension

Visual Studio Marketplace ↗

Open VSX Registry ↗