Skip to the content
Diaspar

Decision D032 · accepted

Repository layout and file size

A record of the language's design, as it stood on 2026-11-18: written for the people who build Diaspar, and kept as it was written. Its code is a sketch, not a program of the site, and an older record may show syntax that a later one changed. It names files of the language's source, which is not public yet.

Status: accepted (2026-11-16)

Amended 2026-11-18 by D037: a package may have examples/ and scripts/.

Amended 2026-11-18: the bootstrap interpreter, bootstrap/, is deleted (stage C, tag last-rust-interpreter); seed/ holds the compiler's own C, generated, which builds it with a C compiler alone.

Layout

std/            the standard library of the language (was bootstrap/std/)
  lang/         the language's own tools: reader, syntax objects, indentation, formatter
tests/          tests of the language, run compiled and by the compiler's harness (was bootstrap/tests/cases …)
examples/       programs written in Diaspar, such as jt (was bootstrap/examples/)
compiler/       the compiler package, split by pipeline layer: front/, middle/, back/, eval/, tools/, cli/
runtime/        the C runtime, split by concern
seed/           the compiler's own C, generated (docs/design/self-hosting.md 5)
docs/  reports/  research_notes/
  • std/ belongs to the language, not the interpreter. The interpreter was deleted at stage C (D003, D012); the standard library stays.
  • std.lang holds the language's tools that programs may use: the reader and syntax objects (already reached through read-string and std.meta.read-syntax), the indentation rule shared by the formatter and the REPL's editor, and the formatter (D031). Go keeps go/parser, go/ast and go/format in its standard library the same way, and Python ast and tokenize. The expander, analysis, passes and code generation are the compiler's internals and stay in its package, as Go's cmd/compile.
  • The language's tests are shared: the cases that the differential harness runs through both tools (D003) are not the interpreter's.

File size

  • Soft limit 1,500 lines, hard limit 2,000, for every source file (Diaspar, C, shell). Past the soft limit mise run check warns; past the hard limit it fails. A file that grows past the limit is split into submodules.