NEWS

---

plu 0.3.0 (2023-09-23)

• plu_ral() now accepts vectors for arguments n and pl.
  • e.g. plu_ral(c("word", "phrase"), n = c(1, 2)) returns c("word", "phrases").
• Fixed an error where the plural forms of "octopus" and "platypus" were mixed up.
• The plu_ral() argument n_fn is now deprecated.
• plu_stick() is now defunct.

plu 0.2.3 (2022-08-12)

• Added staticexport of plu_ralize().
  • This allows you to include plu_ralize() in your package without depending on plu, using the staticimports package.
• Update Roxygen version to avoid CRAN NOTE.

plu 0.2.2 (2022-06-07)

• Modest speed improvements to plu_ralize().
  • This propagates to plu_ral() and plu_more(), which use plu_ralize() internally.
• Deprecated plu_stick() in favor of knitr::combine_words() or glue::glue_collapse().

plu 0.2.1 (2021-04-07)

New features

• plu_ral() now supports arbitrary delimiters for special sequences.
  • plu_ral("attorney [general]", open = "[", close = "]") produces "attorneys general".
• plu_ral() now supports {braced|pipe} sequences of indefinite length.
  • plu_ral("{one|two|three|more}", n = 3) produces "three".
  • plu_ral("{one|two|three|more}", n = 50) produces "more".
  • The delimiters of these sequences can be changed with open and close.

Patches

• Modest speed improvements to plu_ralize().
  • This propagates to plu_ral() and plu_more(), which use plu_ralize() internally.
• plu_ral() now correctly handles {braced} strings that contain sentence breaks.
  • Previously, sentence breaks would break the {braced} string and apply normal pluralization to its contents.
• plu_ral() now correctly handles {braced|pipe} sequences when pl is set to FALSE.
  • plu_ral("{singular|plural}", pl = FALSE) now returns "singular" instead of incorrectly returning "plural".
• plu_ralize() now correctly handles ALL-CAPS words where their lowercase equivalent has an irregular plural.
  • plu_ralize("CHILD") now returns "CHILDs" instead of incorrectly returning "Children".
• is_capital(strict = TRUE) now correctly handles non-character inputs.
  • is_capital(1, strict = TRUE) no returns FALSE instead of incorrectly returning NA.

Miscellaneous

• Error messages now use crayon if it is installed.
• Deprecated arguments to plu::stick() now produce errors.
• Removed dependencies on rlang and stringi.
• Gained dependency on backports.

plu 0.2.0 (2021-01-11)

New features

• plu::more() limits a vector to the first n elements with a message for remaining elements.

  • This can be useful for providing messages to users without an overwhelming amount of detail.
  • plu::more(letters, max = 2) yields c("a", "b", "24 more characters").

• The convenience function get_fun() finds a function using a character string or unquoted function name, with or without colons.

• plu::ral() now ensures that the capitalization of a phrase stays the same after pluralizing.

  • plu::ral("A sentence.") now results in "Sentences." rather than "sentences."

• Convenience functions around capitalization have been added:

  • is_capital() tests if a character (or string of characters) is capital or lowercase.
  • is_capitalized() tests if the first alphabetic character in a string is capital.
  • capitalize() converts the first alphabetic character in a string to capital.
    • Unlike tools::toTitleCase() or stringr::str_to_sentence(), this does not change the capitalization of any subsequent characters.

Patches

• plu::stick()'s oxford now defaults to FALSE rather than depending on the user's environment.

Deprecations

• plu::stick()'s syndeton is now deprecated in favor of explicitly setting sep and conj.
• plu::stick()'s fn and ... are now deprecated in favor of applying a function to x before passing it into plu::stick().

Miscellaneous

• Added a pkgdown site.
• Added an ORCID to DESCRIPTION.

plu 0.1.1 (2020-09-03)

• Allow braces to be used within words.
  • "cact{us|i}" -> "cactus", "cacti"
  • "antenna{|e}" -> "antenna", "antennae"
• Remove cross-reference to glue to avoid CRAN NOTE.
• Add AGID copyright information to package documentation (?plu).
• Minor speed improvements to regular pluralization rules.
• Bug fixes when calling plu::ral() from inside other functions.

plu 0.1.0 (2020-06-09)

• Initial release.