리스펙스 설치

리스펙스를 실행하는 길은 세 가지이며, 모두 같은 레퍼런스 인터프리터를 씁니다.

1. 플레이그라운드 (설치 불필요)

가장 빠른 방법은 사이트 안의 플레이그라운드입니다. 인터프리터가 WebAssembly로 컴파일되어 브라우저에서 그대로 돌아갑니다. 코드를 쓰면 결과가 바로 나오고 따로 설치할 것이 없습니다.

2. npm (크로스플랫폼, Node 필요)

Node 18 이상이 있으면 npm에서 CLI를 설치합니다.

npm install -g lispex

그 다음 파일을 실행하거나 소스를 파이프로 넘깁니다.

lispex run hello.lispx
echo '(+ 1 2 3)' | lispex
lispex --version

플레이그라운드와 같은 WebAssembly 코어를 Node용으로 감싼 것이라, Node가 도는 어떤 OS에서도 동작합니다.

3. 네이티브 바이너리 (단독 실행, Node 불필요)

자기완결적인 단일 실행 파일입니다. 원라이너를 쓰거나 직접 내려받으세요.

원라이너 설치

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

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

스크립트가 OS와 아키텍처에 맞는 바이너리를 내려받고 SHA-256 체크섬을 검증한 뒤 ~/.lispex/bin(윈도우는 %LOCALAPPDATA%\Lispex\bin)에 설치합니다. 그 폴더가 PATH에 없으면 추가한 다음 lispex --version을 실행하세요.

직접 내려받기

다운로드 페이지에서 바이너리를 받으세요. 빌드는 Linux x86_64/aarch64, macOS Apple 실리콘/인텔, Windows x86_64를 제공합니다.

# macOS / Linux: 실행 권한을 주고 PATH에 두기
chmod +x lispex-macos-aarch64
mkdir -p ~/.lispex/bin
mv lispex-macos-aarch64 ~/.lispex/bin/lispex
export PATH="$HOME/.lispex/bin:$PATH"   # 셸 프로파일에 추가하세요
lispex --version

체크섬 검증

각 바이너리에는 .sha256 사이드카가 함께 옵니다.

# macOS / Linux
shasum -a 256 lispex-macos-aarch64
# 출력값을 lispex-macos-aarch64.sha256 내용과 비교하세요

# Windows
Get-FileHash lispex-windows-x86_64.exe -Algorithm SHA256
# lispex-windows-x86_64.exe.sha256 과 비교하세요

서명되지 않은 바이너리 (첫 실행)

v1 바이너리는 아직 코드 서명이 되어 있지 않아 처음 실행할 때 OS가 경고할 수 있습니다.

# macOS: 브라우저나 curl이 설정한 격리 플래그 제거
xattr -d com.apple.quarantine ~/.lispex/bin/lispex

윈도우에서는 SmartScreen이 "Windows의 PC 보호" 화면을 띄울 수 있습니다. 추가 정보를 누른 뒤 실행을 선택하세요. 코드 서명은 계획돼 있습니다.

어느 것을 써야 하나요

스니펫을 빠르게 시험하려면 플레이그라운드, 이미 Node 환경이면 npm, 서버나 스크립트에서 의존성 없는 CLI가 필요하면 네이티브 바이너리를 쓰세요. 셋 다 같은 인터프리터라 평가 결과가 똑같습니다.