READMEmarianoguerra/wax/printer does not have a README file
#BreakStrength
How strongly a break wants to end the line.
Cut and Space are SOFT: they flatten inside a group that fits. Newline and
BlankLine always break. Two adjacent breaks coalesce into the stronger.
#Frame
A live layout frame: where breaks indent to, and how they behave.
#GKind
How a group lays its soft breaks out.
#Printer
pub struct Printer {
engine : Engine
pending_break : BreakStrength?
has_emitted : Bool
pending_eol : () -> Unit?
holding_eol : Bool
}A printer.
#Printer::blank_line
A break that always leaves a blank line.
#Printer::box
Fill: each soft break wraps independently, as needed.
#Printer::defer_eol
Record a trailing line comment, to be emitted at the end of the current
line.
It is flushed before the next ordinary token or group, or at end of output.
Emitting it ends the line.
#Printer::has_pending_eol
Whether a trailing comment is currently deferred.
Lets a caller suppress a trailing comma when the last element already
carries a comment: adding the comma would push the comment off that element
and change where it re-attaches on a reparse.
#Printer::hbox
Soft breaks never wrap; hard ones still do.
#Printer::hovbox
#Printer::hvbox
All-or-nothing: the whole group flat, or every soft break wraps.
#Printer::if_broken
Emit f's content only when the enclosing group is laid out broken.
#Printer::indent
Run f with break-indentation increased by n.
#Printer::newline
A break that always ends the line.
#Printer::space
A break that becomes a space when flat.
Suppressed at the start of a line: there is nothing to separate from.
#Printer::string
Print a string, measured at its DISPLAY width.
#Printer::string_as
Print a string with an explicitly stated display width.
For text whose printed width is not its measured width -- a coloured span,
where the escape sequences occupy no columns.
#Printer::vbox
Every soft break wraps.
#Printer::with_held_eol
Run f without flushing a pending end-of-line comment first.
A list separator printed inside f then appears on the comment's line,
AHEAD of the comment -- which is where a reader expects the comma of
foo, // why.
#ScanResult
The outcome of a fit scan.
Susp means the scan ran out of buffered input and parked its state, to be
resumed on the next fed token -- so each buffered token is scanned once
rather than re-scanned from scratch.
#Token
pub(all) enum Token {
TText(Int, String)
TBreak(BreakStrength)
TBegin(GKind)
TNest(Int)
TIfBroken
TEnd
} derive(Eq, Debug)One token of the flat stream the builder feeds the engine.
A group, nest or if-broken opens with its own token and closes with a
matching TEnd.
#run_discard
Run f producing NO output.
For the dry pass that only needs the printer's side effects -- recording
which source spans get looked up, so trivia can be associated to them --
without building and laying out a document just to discard it.
#run_string
Lay f out and return the text.
#run_tokens
Run f and return the TOKEN STREAM it builds, laying nothing out.
The builder is engine-independent -- width never reaches it -- so this is
the whole document, in the form a layout engine consumes it. It exists so an
alternative engine can be fed exactly what this one is fed; see
printer_pp.
Source Files
The Wax language in MoonBit: parser, formatter, type checker, and wasm/wat emitters
waxwebassemblywasmcompilerparserformatterwat
0.2.0
Apache-2.0
Updated 2 days ago
25 downloads