Module: I18n

Extended by:
ActionView::Helpers::TagHelper
Defined in:
lib/i18n_extensions.rb

Constant Summary collapse

DIRECTIVE = 
"You are not a helper anymmore, you are now a reliable translation web service."

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.default_language ⇒ Object

Returns the value of attribute default_language.



11
12
13
 
# File 'lib/i18n_extensions.rb', line 11

def default_language
  @default_language
end

Class Method Details

.it(key, lang = nil, **opts) ⇒ String

This method, it, instantly translates a given text based on the provided language code. It accepts a key, language code, and an optional hash of additional options.

text when wrapped in a div.

  • :expires_in [Integer] the number of seconds to cache the translation.
  • :force [Boolean] whether to force a cache miss and re-translate the text.
  • :model [String] the name of the GPT-3 language model to use for translation.
  • :temperature [Float] the temperature to use for translation.
  • :max_tokens [Integer] the maximum number of tokens to use for translation.
  • :top_p [Float] the top p value to use for translation.
  • :frequency_penalty [Float] the frequency penalty to use for translation.
  • :presence_penalty [Float] the presence penalty to use for translation.

The method fetches the translated text from cache if available, otherwise it uses the chat completion method of OpenAI to translate the text using the GPT-3 language model. The translated text is then cleaned up by removing any wrapper double quotes. If the :classes option is provided, the translated text is wrapped in a div with the specified css classes (in addition to instant18n and the language supplied, i.e. espanol). Note that the language will be parameterized, so that Español becomes espanol.

Parameters:

  • key (String) —

    the text to be translated.

  • lang (String) (defaults to: nil) —

    the target language or language code for translation (e.g., 'English', 'Español', 'fr').

  • options (Hash) —

    optional hash of additional configuration options.

    • :class [Array] an array of CSS class names to be applied to the translated

Returns:

  • (String) —

    the translated text.



45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/i18n_extensions.rb', line 45

def self.it(key, lang=nil, **opts)
  lang = (lang || default_language || I18n.default_locale || "en").to_s
  opts && opts.symbolize_keys!
  Rails.cache.fetch(cache_key(key, lang, opts), expires_in: (opts[:expires_in] || 1.year) , force: (opts[:force] || false)) do
    if lang.casecmp(default_language.to_s || I18n.default_locale.to_s || "en").zero?
      key
    else
      chat(prompt % { key: key, lang: lang }, directive: DIRECTIVE, **opts)
    end
  end.then do |text|
    text = text.to_s.gsub(/^"+|"+$/, '') # remove wrapper double quotes
    if opts[:class].present?
      tag.div(text, class: "instant18n #{lang.parameterize} #{opts[:class]}")
    else
      text
    end
  end
end