Set the current locale

Globally

If no value is set, the value of the Rosetta.default_locale macro will be used. This macro will look at the Rosetta::DefaultLocale annotation which has :en as the default value.

Defining the current locale is done as follows:

Rosetta.locale = :es

This property accepts a String or a Symbol. But note that the getter variant of this property will always return a string:

Rosetta.locale = :nl
Rosetta.locale
# => "nl"

If the given locale identifier is not present in the array returned by the Rosetta.available_locales macro, the value of the Rosetta.default_locale macro will be used instead:

# Considering
@[Rosetta::DefaultLocale(:es)]
module Rosetta; end

# ...
Rosetta.locale = :xx
Rosetta.locale
# => "es"

Locally

Sometimes you may want to use a different locale for a specific part of your code. In that case, use the Rosetta.with_locale method:

Rosetta.find("user.first_name").t
# => First name

Rosetta.with_locale(:nl) do
  Rosetta.find("user.first_name").t
  # => "Voornaam"
end

Rosetta.find("user.first_name").t
# => First name