Enum OutputSurface 

pub enum OutputSurface {
    Human,
    Machine,
    LedgerText,
}

What kind of consumer an output surface is written for.

Decides whether thousands separators appear. The question is not “will a person read this” but does the consumer have a grammar:

• machine interchange (CSV, JSON) does not. A separator forces the field to be quoted and is then rejected by ordinary decimal parsers — Decimal(field) breaks (issue #1892). Suppressed unconditionally, and that suppression outranks any ledger or per-commodity declaration.
• ledger text (format, query --format beancount) does. Grouped numerals are part of Beancount syntax, so every conforming reader must accept them; the parser, not the file, is the machine boundary. Honors the ledger’s declaration (#1896).
• rendered tables read by a person likewise honor it.

This exists so the rule is stated ONCE. It was previously re-derived per writer, and the surfaces had already drifted apart: query --format beancount emitted separators into ledger text while format stripped them, and CSV emitted them while JSON did not.

LedgerText initially suppressed them, on the premise that ledger text has one canonical on-disk form. #1896 abandoned that premise deliberately — rledger format --ledger now GROUPS, because a ledger that asks for separators should get them in the file it owns — which put the two ledger text producers back in disagreement until this arm followed. Beancount itself groups here: grammar.py calls dcontext.set_commas(options ["render_commas"]) while parsing, and printer.py renders through that same context.

Variants

Human

A rendered table or report read by a person.

Machine

CSV/JSON consumed by another program.

LedgerText

Beancount source text.

Implementations

impl OutputSurface

pub const fn renders_thousands_separators(self) -> bool

Whether this surface renders thousands separators when the ledger asks for them.

Only Self::Machine refuses, because only its consumers lack a grammar that admits the separator.

Trait Implementations

impl Clone for OutputSurface

fn clone(&self) -> OutputSurface

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for OutputSurface

impl Debug for OutputSurface

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for OutputSurface

impl PartialEq for OutputSurface

fn eq(&self, other: &OutputSurface) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for OutputSurface