tobogganSe connecter

louise

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

95 lignes · 6528 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.

Unreleased after v0.18.0

  • Breaking std/file/std/net effect-row migration (ADR 0084, Proposed): file operations now require / <fs>; host resolution and socket opening require / <net>, with real runtime roots and lexical fakes. Listener/socket accept/read/write/peer/close and std/io.Stream remain handle-mediated / <io>: http.serve on an existing listener and TLS over an existing connection do not demand unrelated resolver access. http.listen and tls.dial do open, so they migrate (dial retains io too). Function names, arguments and Result shapes are unchanged; annotated callers and dependent actor/HTTP/SSE/web callback rows must migrate together. dist.start/connect, fetch worker internals and PostgreSQL opening/pool/cancel paths advertise net; pure helpers and existing-connection queries do not.
  • Runtime ABI stays at 12: TL_ROOT_NET = 4 and NET_OPS = [resolve, listen_at, connect_to] are appended without changing existing root/fs discriminants or old net primitive argument order. Every program actor currently receives the same five roots, not fine-grained per-actor grants; remote-provenance actors and descendants are denied real fs/net before path/DNS/socket work on both backends. TLS CA/cert/key reads, OS powers, FFI and distribution transport remain explicit exclusions, not sandboxed or transparently faked. Interpreter real net keeps its native-only error; only lexical negative/opening fakes are provided, never forged successful socket Resources.
  • This is one v0-series breaking change, not a scheduled v1/v2 defaulting transition. See capabilities. ADR 0084 remains Proposed and linked to the #44 engineering review.

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).