Skip to content

Getting Started

0x4171341 edited this page Jul 23, 2026 · 4 revisions

Getting Started

Install

Release installers are intended to let end users install L++ without installing Rust:

curl -fsSL https://raw.githubusercontent.com/samarnever-droid/lplusplus/master/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/samarnever-droid/lplusplus/master/install.ps1 | iex

For source development, install a current Rust toolchain and build:

cargo build --release

First program

Create hello.lpp:

def main():
    print("Hello, L++")

Check it without writing artifacts:

lpp check hello.lpp

Emit C explicitly:

lpp emit hello.lpp

Emit C plus Cranelift object output:

lpp emit hello.lpp --aot

Packages

A package has an lpp.toml manifest and source entry point. Use:

lpp build
lpp run

On Linux x86-64, LPP_LINKER=direct lpp build selects the direct ELF linker where the package only uses its supported runtime-free/direct-runtime subset.

Do not use legacy lpp file.lpp as an implicit build command; it prints guidance to use check, emit, or build explicitly.

v0.1.3 current-status note

This page is maintained with the project, but current support claims are centralized in Current Capabilities.

Use LppData/build/release and LppData/cache for package artifacts.
Use host-linked AOT for filesystem/networking work.
Do not assume direct ELF supports files, networking, JSON, or threads.
Do not claim language-wide Rust-equivalent safety outside the verified AOT subset.

Clone this wiki locally