NEWS

---

transltr 0.1.0 (2025-02-14)

Breaking Changes

• The package's lifecycle is set back to experimental.
  • All features are still well tested and documented, but they may change again in a near future. I am thinking about introducing many small changes to the interface of classes Text and Translator.
• R >= 4.3.0 is now required. This is necessary to
  • leverage native UTF-8 support on Windows,
  • use function shorthands (\(...)) and
  • use the native pipe operator |> and related placeholders _.
• Package stringi is now required at runtime.
  • This package dramatically increases the performance of normalize().
  • Its usage within the package will gradually increase over time.
• Option transltr.default.path is renamed to transltr.path.
• constant() is removed. While it technically was an unexported function, it was used to pass default values to many function arguments.
• find_source() loses argument strict. It is replaced by new argument interface.
• as_text.call() loses arguments strict and validate following the new interface mechanism of find_source(). It was rewritten accordingly.
• translate() is removed and replaced by the new interface mechanism of find_source(). See the documentation of the latter for more information.

New Features

• find_source() now detects calls to method Translator$translate() by default. Users may change this default behavior by passing a custom interface (a wrapper function) to find_source(). Since this work on a lexical basis, the function does not have to be defined at the time find_source() is called.
  • Users may migrate to the new mechanism by binding deprecated symbol translate to a function that calls method Translator$translate() in the environment of their choice (where it fits).
• New option transltr.verbose. It can be used to set all verbose arguments to either TRUE or FALSE.
• New function normalize(). The latter used to be internal but it is now exported for convenience. It documents how strings are standardized.
• New method Translator$set_default_value(). It controls what methods Translator$translate() and Translator$get_translation() return when there is no translation.
• Documentation of find_source() and class Translator is now more thorough.
• Many details were added to the package's documentation overall. It was also simplified whenever appropriate.

Bug Fixes

• export.Text() and export_translations() now wrap lines longer than 80 characters automatically via new internal function str_wrap().
  • Consequently, so does serialize() and serialize_translations().
• normalize() now handles edge cases appropriately thanks to stringi.
• format.Text() and format.Translator() now escape newline characters.
• Identifiers of serialized Location objects embedded into serialized Text objects are now much shorter.
• find_source() uses relative paths (to the project's working directory) by default.

Notes

• The official title of the package (as it appears in DESCRIPTION) is now Support Many Languages in R.
• The package now has a pkgdown website. See https://transltr.ununoctium.dev. It is not yet complete and requires more work.
• A lot of typos were corrected here and there in the documentation.
• Comments included in Translator and translations files were updated.
• In outputs, Source Text is now used (it used to be pluralized).
• The source code was (lightly) tidied.

Translations

The package is not yet translated.

transltr 0.0.1 (2025-01-24)

This is the first release of the package. While an extensive set of unit tests fully covers it, some features could be modified in the future. Treat it as a beta version until version 1.0.0 is released.