tobogganSe connecter

louise

Clone avec HTTPS, un jeton personnel en mot de passe, ou avec SSH, une clé ajoutée dans vos paramètres.

89 lignes · 4821 octetsBrut · Historique

Louise v0: release notes

At v0 the language was named tilcayo: the compiler was tilc and source files ended in .til. These notes use the current names (ADR 0021).

v0 is the first complete vertical slice of the language: a typed, effectful language with OTP actors and inline HTML. It compiles to C and has no garbage collector.

Its definition of done is a supervised HTTP server that:

  • renders pages on the server;
  • hashes passwords with argon2, linked from C;
  • uses effect handlers for logging and data access;
  • is edited with a working language server.

That is examples/http_demo, and it is tested end to end in CI.

What is in v0

Language:

  • Syntax: braces, expression-oriented, Gleam's use and |>.
  • Inline HTML literals: typed, with components (ADR 0009).
  • Types (ADR 0007):
    • Hindley–Milner inference, with required signatures on pub functions;
    • algebraic data types and records;
    • single-parameter traits with coherence, and @derive;
    • exhaustive pattern matching.
  • Effects:
    • typed algebraic effects with row polymorphism (ADR 0008);
    • fn, ctl (one-shot resume) and final ctl operations;
    • lexically scoped handlers (ADR 0010).
  • Memory: no GC. Perceus reference counting, and mutable references scoped to regions so cycles cannot leak (ADR 0002).
  • Tail calls: guaranteed in constant stack.
  • Tests: @test and @should_panic next to the code.

Runtime and backends:

  • The reference interpreter runs everything.

  • The native backend emits C with Perceus dup/drop:

    • musttail for every tail call;
    • exact unwinding for panics and final ctl;
    • ctl by stack switching.

    Every tests/run program prints the same thing on both backends and leaves 0 live blocks, also under ASan and UBSan.

  • Actors (ADR 0004):

    • preemptive scheduling, typed subjects;
    • links, monitors, trapped exits;
    • gen_server-style actors and supervisors.
  • Native dependencies (ADR 0005):

    • C sources, static libraries, pkg-config, and Rust crates;
    • blocking externs on a thread pool;
    • resources with finalizers;
    • an argon2 binding package.
  • Networking: TCP on a reactor, an HTTP/1.1 server, and persistent maps.

Tooling:

  • louise commands: check, run (--native), build, test (--native), fmt, lsp.
  • Language server: diagnostics, hover with effects, go to definition, references, document symbols, completion, inlay hints for inferred signatures, formatting, and a quick fix that inserts a signature.
  • VS Code extension: packaged with npm run package.

Known limitations

These are deliberate cuts for v0. Each is recorded where it was decided.

  • One scheduler thread. Actors are preemptive but share one OS thread, so messages are moved rather than copied.
    • The multi-threaded, work-stealing scheduler and move/share/copy sending of ADR 0004 Revision 1 are the next runtime milestone.
    • They need the runtime's own context switch in place of corosensei.
    • blocking externs already run on other threads.
  • Unwinding in C uses yield checks, not unwinding tables: one predicted branch after each call that may unwind. Zero-overhead unwinding conflicts with musttail in C (ADR 0003, Revision 2, proposed).
  • Performance:
    • Arithmetic through traits builds a dictionary at each use. There is no specialisation or monomorphisation yet.
    • Perceus has no borrow inference or reuse analysis yet.
    • Code is correct, not yet fast.
  • No Bytes type. Network reads replace invalid UTF-8, and HTTP has no keep-alive and no chunked encoding.
  • Interpreter-only gaps:
    • networking and native dependencies need the native backend;
    • escaped continuations (resume called after their handler finished) panic natively, while the interpreter accepts them.
  • Effects: a function that calls a callback inside its own handler needs the callback's type declared. Inference does not invent capability parameters (ADR 0010).
  • No package registry: dependencies are paths only.
  • Not yet supported:
    • #line directives in generated C;
    • higher-kinded types, traits with several parameters, user-defined derives;
    • a client-side HTML target;
    • callbacks from C into Louise.

Decisions to review

The project owner reviewed and accepted ADRs 0001–0009 and the runtime ABI (issue #2).

Still proposed:

  • ADR 0010 (lexically scoped handlers);
  • ADR 0003 Revision 2 (unwinding in C);
  • ADR 0005 Revision 1 (the extern convention).