NEWS.md
In rossellhayes/nombre: Number Names

nombre 0.4.1

Non-finite inputs (NA, Inf, and NaN) no longer produce an error.
Inf is handled like a normal number. nom_card(Inf) produces "infinity" and nom_ord(Inf) produces "infinitieth".
NA and NaN propagate through functions. All functions return NA for NA and "NaN" for NaN.
The logic in ordinal() has been simplified and now runs slightly faster.

nombre 0.4.0

Added ratio(), which generates ratios.
ratio("0.5") generates "one in two".
ratio("1.5", sep = "to") generates "three to two".
Removed pkgconfig interface for setting default options.
Options should now be set within function calls or by creating helper functions with different defaults.

nombre 0.3.0

Added uncardinal(), which takes a character vector and attempts to convert it to a numeric.
uncardinal("twenty-five") produces 25.
Currently, uncardinal() only works with cardinal integers and the result of other nombre functions.
nombre outputs are now part of the S3 class nombre.
This allows nombres to go through mathematical transformations while preserving their characteristics.
cardinal(25) + cardinal(2) produces "twenty-seven".
adverbial(3) / 3 produces "once".
as.numeric(ordinal(9)) produces 9.
Default arguments are now handled with pkgconfig rather than options().
This allows packages that import nombre to set defaults without affecting the user or other packages.
Denominators that begin with "one" now omit the leading "one".
cardinal(3/100) now produces "three hundredths" rather than "three one-hundredths".
denominator(1) still produces "whole".
collective() gains the arguments of_the, all_n, and cardinal.
collective(3, all_n = FALSE) becomes "all" rather than "all three".
collective(0:3, of_the = TRUE) becomes c("none of the", "the", "both of the", "all three of the") rather than c("no", "the", "both", "all three").
collective(3, cardinal = FALSE) becomes "all 3" rather than "all three".
The defaults can be changed with set_config("nombre::all_n", "nombre::of_the", "nombre::coll_cardinal").
cardinal() loses the argument numerator.
Numerators should now be produced using numerator()/nom_numer().
Decimals are now converted to fractions with fracture. This allows cardinal() to generate fractional components in roughly one tenth the time of the R implementation of decimal_to_fraction().
Arguments are passed to fracture::frac_mat() with ....
Added a pkgdown site.

nombre 0.2.0

cardinal() gains the argument max_n, which stops numbers greater that max_n from being cardinalized. This is useful when you want to print small numbers in words but larger numbers numerically. Refactorization means this argument can be used by all functions.
options("nombre.max_n") sets a default value.
adverbial() and nom_adv() generate adverbials, e.g. "once", "twice", "three times".
thrice = TRUE or options("nombre.thrice" = TRUE) convert 3 to "thrice" instead of "three times".
All functions now pass ... to lower level functions. ordinal() and adverbial() pass to cardinal(). denominator() passes to ordinal(). This allows cardinal()'s max_n and negative to be used by all functions and ordinal()'s cardinal to be used by denominator().

ordinal() now handles uncardinalized numeric vectors with different numbers of digits correctly. Previously, dashes would be appended to the start of the shorter numbers. nom_ord(c(9, 10), cardinal = FALSE) now produces "9th, 10th" as expected, instead of "-9th, 10th" as it did previously.

Implemented a custom function to convert decimals to fractions. This removes the previous previous dependency on {MASS}.
Added package documentation page at ?nombre