to_lang.rb

require "to_lang/connector"
require "to_lang/translatable"

$KCODE = 'u' unless RUBY_VERSION >= "1.9"

# {ToLang} is a Ruby library that adds language translation methods to strings and arrays, backed by the Google Translate API.
#
# @author Jimmy Cuadra
# @see https://github.com/jimmycuadra/to_lang Source on GitHub
#
module ToLang
  class << self
    # A {ToLang::Connector} object to use for translation requests.
    #
    # @return [ToLang::Constructor, NilClass] An initialized {ToLang::Connector connector} or nil.
    #
    attr_reader :connector

    # Initializes {ToLang}, after which the translation methods will be available from strings and arrays.
    #
    # @param [String] key A Google Translate API key.
    #
    # @return [Class, Boolean] @Array@ if initialization succeeded, @false@ if this method has already been called successfully.
    #
    def start(key)
      return false if defined?(@connector) && !@connector.nil?
      @connector = Connector.new key
      String.send :include, Translatable
      Array.send :include, Translatable
    end
  end
end