WP56: Generators whose memory stays flat: a string builder, and a scope per file

State: Proposed · Done: 0 of 6 · Design note: docs/wp56-flat-memory-generators.md

Stages

  • S0: the baseline, a 25 MB spec, a generator written two ways, and peak memory at 1,000 to 8,000 files
  • S1: the patterns with today's tools, a guide page, cookbook entries, file I/O inside a region tested
  • S2: builder() from nish:string, whose bytes live outside the arena and whose appends keep a loop's scope
  • S3: files from a builder, writeFileSync of a builder and a write handle that flushes
  • S4: the diagnostics name the builder, and the flat-memory gate runs in CI
  • S5: an object graph made inside a using arena() block belongs to the block, so constructors and methods that store into it are admitted

Next

S0, the baseline: §8 The proof. The design is accepted and every open question is decided (§10).

Not planned

A rope string, appending in place to the arena, a collector. Deferred: S5's analysis for parallel bodies and scope() tasks.

All work packages