Version 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.

Version 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.

Version 0.2.0

New features

• 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().

Bug fixes

• 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.

Miscellaneous

• Implemented a custom function to convert decimals to fractions.
  This removes the previous previous dependency on {MASS}.

• Added package documentation page at ?nombre

Version 0.1.0

• Initial CRAN release