cnumber

Reproducible number formatting for correspondence.

Format a decimal number without a binary float, operating-system locale, or network dependency. The same inputs produce the same text in Rust, JavaScript, Python, and Typst.

import { formatNumber } from '@corbet-labs/cnumber';

formatNumber('de-ch', '1234567.89', true, 'amtlich');
// 1'234'567,89

Install

The 0.1.0 release line has not been published to registries yet; the commands above resolve once it is. Python requires 3.10+, Node.js 20+.

Canonical-input contract

Inputs are canonical decimal strings, never binary floats (so 0.1 + 0.2 style artefacts cannot leak into correspondence):

• Grammar: -?digits(.digits)? with a dot decimal separator, e.g. "1234567.89", "42", "-0.5".
• Rejected → None/null/none: "", "12,34", "abc", "1'234" (pre-grouped), "1,234.56", " 12", "+12", "--12", ".5", "5.", "1.2.3".
• Years ("2026") and postal codes must pass grouping=false; the library does not auto-detect them. Four-digit inputs stay ungrouped even with grouping=true.

CLDR vs amtlich

Base separators come from Unicode CLDR (cldr-json, main as of 2026-09-17, numbers.json symbols-numberSystem-latn). Swiss amtlich rules come from the Bundeskanzlei Schreibweisungen, chapter 5, which has no CLDR equivalent:

format_number groups integer parts of five or more digits; format_money groups from four digits (standard thousands). style="amtlich" is identical to "cldr" outside de-ch/de-li. Unknown styles return None/null/none.

Money covers exactly two currencies: CHF (Fr. prefix with Swiss grouping and dot decimal, in every locale; display="code" gives CHF prefix instead) and EUR (locale separators; € prefixed for en*, suffixed with a no-break space for de*/it*, suffixed with a narrow no-break space for fr*; display="code" gives EUR prefix). Any other currency code — including lowercase "chf" — returns None, as does any display other than "symbol"/"code".

Rust

use cnumber::{format_money, format_number};

assert_eq!(
    format_number("de-ch", "1234567.89", true, "amtlich").as_deref(),
    Some("1'234'567,89")
);
assert_eq!(
    format_money("de-ch", "1234.56", "CHF", "symbol").as_deref(),
    Some("Fr. 1'234.56")
);
assert_eq!(
    format_money("de-ch", "100000", "CHF", "code").as_deref(),
    Some("CHF 100'000")
);

Python

from cnumber import format_number

assert format_number("de-ch", "1234567.89", True, "amtlich") == "1'234'567,89"

API

Eleven number-table entries: de, de-at, de-ch, de-li, en, en-gb, en-us, fr, fr-ch, it, it-ch. Matching is case-insensitive; other locales fall back through the base language to English. Non-canonical inputs return null/None. Other family libraries have different locale coverage.

Correspondence family

Development

Behavior is defined by the locale tables and shared conformance vectors. Rust, JavaScript, and Python run the same vectors. Selected CI checks exercise installed JavaScript tarballs, Python wheels and command-line entrypoints, and Typst packages. Release validation records the actual runtime and platform; Linux results do not establish native Windows or macOS coverage. All ports forbid unsafe code in their own source.

See the release guide for generation, verification, and publication commands.

License

Copyright 2026 Julian Y. Richard Corbet. The 0.1.0 release line is licensed under LGPL-3.0-only WITH LGPL-3.0-linking-exception, with the incorporated GPL version 3. Combined works may link statically or dynamically without relinking duties; library modifications stay LGPL. Applications can use a different license subject to the LGPL's conditions. Previously released and already prepared distributions retain their original grants. The installation examples above refer to those available releases; 0.1.0 has not yet been published to registries.

See the licensing notes for distribution conditions and retained notices.