grosser-gettext 2.0.0

data/lib/gettext.rb

@@ -0,0 +1,263 @@
+gem 'locale', '>=0.9'
+require 'locale'
+
+require 'gettext/version'
+require 'gettext/textdomain_manager'
+
+module GetText
+
+  def self.included(mod)  #:nodoc:
+    mod.extend self
+  end
+
+  module_function
+  # bindtextdomain(domainname, options = {})
+  #
+  # Bind a textdomain(%{path}/%{locale}/LC_MESSAGES/%{domainname}.mo) to 
+  # your program.
+  # Normally, the texdomain scope becomes the class/module(and parent 
+  # classes/included modules).
+  #
+  # * domainname: the textdomain name.
+  # * options: options as an Hash.
+  #   * :path - the path to the mo-files. When the value is nil, it will search default paths such as 
+  #     /usr/share/locale, /usr/local/share/locale)
+  #   * :supported_language_tags - an Array of the supported language tags for this textdomain.
+  #   * :output_charset - The output charset. Same with GetText.set_output_charset. Usually, L10n
+  #     library doesn't use this option. Application may use this once.
+  # * Returns: the GetText::TextDomainManager.
+  #
+  def bindtextdomain(domainname, *args)
+    if args[0].kind_of? Hash
+      options = args[0]
+    else
+      # for backward compatibility.
+      options = {}
+      options[:path] = args[0] if args[0]
+      options[:output_charset] = args[2] if args[2]
+    end
+    TextDomainManager.bind_to(self, domainname, options)
+  end
+
+  # Includes GetText module and bind a textdomain to a class.
+  # * klass: the target ruby class.
+  # * domainname: the textdomain name.
+  # * options: options as an Hash. See GetText.bindtextdomain.
+  def bindtextdomain_to(klass, domainname, options = {}) 
+    ret = nil
+    klass.module_eval {
+      include GetText
+      ret = bindtextdomain(domainname, options)
+    }
+    ret
+  end
+
+  def textdomain(domainname) #:nodoc:
+    warn "GetText.textdomain is deprecated. Call bindtextdomain instead."
+    bindtextdomain(domainname)
+  end
+
+  # call-seq:
+  #   gettext(msgid)
+  #   _(msgid)
+  #
+  # Translates msgid and return the message.
+  # This doesn't make a copy of the message. 
+  #
+  # You need to use String#dup if you want to modify the return value 
+  # with destructive functions. 
+  #
+  # (e.g.1) _("Hello ").dup << "world"
+  # 
+  # But e.g.1 should be rewrite to:
+  #
+  # (e.g.2) _("Hello %{val}") % {:val => "world"}
+  #
+  # Because the translator may want to change the position of "world".
+  #
+  # * msgid: the message id.
+  # * Returns: localized text by msgid. If there are not binded mo-file, it will return msgid.
+  def gettext(msgid)
+    TextDomainManager.get(self).translate_singluar_message(self, msgid)
+  end
+
+  # call-seq:
+  #   sgettext(msgid, div = '|')
+  #   s_(msgid, div = '|')
+  #
+  # Translates msgid, but if there are no localized text, 
+  # it returns a last part of msgid separeted "div".
+  #
+  # * msgid: the message id.
+  # * div: separator or nil.
+  # * Returns: the localized text by msgid. If there are no localized text, 
+  #   it returns a last part of msgid separeted "div".
+  # See: http://www.gnu.org/software/gettext/manual/html_mono/gettext.html#SEC151
+  def sgettext(msgid, div = "|")
+    TextDomainManager.get(self).translate_singluar_message(self, msgid, div)
+  end
+
+  # call-seq:
+  #   pgettext(msgctxt, msgid)
+  #   p_(msgctxt, msgid)
+  #
+  # Translates msgid with msgctxt. This methods is similer with s_().
+  #  e.g.) p_("File", "New")   == s_("File|New")
+  #        p_("File", "Open")  == s_("File|Open")
+  #
+  # * msgctxt: the message context.
+  # * msgid: the message id.
+  # * Returns: the localized text by msgid. If there are no localized text, 
+  #   it returns msgid.
+  # See: http://www.gnu.org/software/autoconf/manual/gettext/Contexts.html
+  def pgettext(msgctxt, msgid)
+    TextDomainManager.get(self).translate_singluar_message(self, "#{msgctxt}\004#{msgid}", "\004")
+  end
+
+  # call-seq:
+  #   ngettext(msgid, msgid_plural, n)
+  #   ngettext(msgids, n)  # msgids = [msgid, msgid_plural]
+  #   n_(msgid, msgid_plural, n)
+  #   n_(msgids, n)  # msgids = [msgid, msgid_plural]
+  #
+  # The ngettext is similar to the gettext function as it finds the message catalogs in the same way. 
+  # But it takes two extra arguments for plural form.
+  #
+  # * msgid: the singular form.
+  # * msgid_plural: the plural form.
+  # * n: a number used to determine the plural form.
+  # * Returns: the localized text which key is msgid_plural if n is plural(follow plural-rule) or msgid.
+  #   "plural-rule" is defined in po-file.
+  def ngettext(arg1, arg2, arg3 = nil)
+    TextDomainManager.get(self).translate_plural_message(self, arg1, arg2, arg3)
+  end
+
+  # call-seq:
+  #   nsgettext(msgid, msgid_plural, n, div = "|")
+  #   nsgettext(msgids, n, div = "|")  # msgids = [msgid, msgid_plural]
+  #   n_(msgid, msgid_plural, n, div = "|")
+  #   n_(msgids, n, div = "|")  # msgids = [msgid, msgid_plural]
+  #
+  # The nsgettext is similar to the ngettext.
+  # But if there are no localized text, 
+  # it returns a last part of msgid separeted "div".
+  #
+  # * msgid: the singular form with "div". (e.g. "Special|An apple")
+  # * msgid_plural: the plural form. (e.g. "%{num} Apples")
+  # * n: a number used to determine the plural form.
+  # * Returns: the localized text which key is msgid_plural if n is plural(follow plural-rule) or msgid.
+  #   "plural-rule" is defined in po-file.
+  def nsgettext(arg1, arg2, arg3 = "|", arg4 = "|")
+    TextDomainManager.get(self).translate_plural_message(self, arg1, arg2, arg3, arg4)
+  end
+
+  # call-seq:
+  #   npgettext(msgctxt, msgid, msgid_plural, n)
+  #   npgettext(msgctxt, msgids, n)  # msgids = [msgid, msgid_plural]
+  #   np_(msgctxt, msgid, msgid_plural, n)
+  #   np_(msgctxt, msgids, n)  # msgids = [msgid, msgid_plural]
+  #
+  # The npgettext is similar to the nsgettext function.
+  #   e.g.) np_("Special", "An apple", "%{num} Apples", num) == ns_("Special|An apple", "%{num} Apples", num)
+  # * msgctxt: the message context.
+  # * msgid: the singular form.
+  # * msgid_plural: the plural form.
+  # * n: a number used to determine the plural form.
+  # * Returns: the localized text which key is msgid_plural if n is plural(follow plural-rule) or msgid.
+  #   "plural-rule" is defined in po-file.
+  def npgettext(msgctxt, arg1, arg2 = nil, arg3 = nil)
+     if arg1.kind_of?(Array)
+      msgid = arg1[0]
+      msgid_ctxt = "#{msgctxt}\004#{msgid}"
+      msgid_plural = arg1[1]
+      opt1 = arg2
+      opt2 = arg3
+    else
+      msgid = arg1
+      msgid_ctxt = "#{msgctxt}\004#{msgid}"
+      msgid_plural = arg2
+      opt1 = arg3
+      opt2 = nil
+    end
+    ret = TextDomainManager.get(self).translate_plural_message(self, msgid_ctxt, msgid_plural, opt1, opt2)
+    
+    if ret == msgid_ctxt
+      ret = msgid
+    end
+    ret   
+  end
+  
+  # This function does nothing. But it is required in order to recognize the msgid by rgettext.
+  # * msgid: the message id.
+  # * Returns: msgid.
+  def N_(msgid)
+    msgid
+  end
+
+  # This is same function as N_ but for ngettext. 
+  # * msgid: the message id.
+  # * msgid_plural: the plural message id.
+  # * Returns: msgid.
+  def Nn_(msgid, msgid_plural)
+    [msgid, msgid_plural]
+  end
+
+  # Sets charset(String) such as "euc-jp", "sjis", "CP932", "utf-8", ... 
+  # You shouldn't use this in your own Libraries.
+  # * charset: an output_charset
+  # * Returns: self
+  def set_output_charset(charset)
+    TextDomainManager.output_charset = charset
+    self
+  end
+
+  # Gets the current output_charset which is set using GetText.set_output_charset.
+  # * Returns: output_charset.
+  def output_charset
+    TextDomainManager.output_charset
+  end
+
+  def set_locale(lang)
+    Locale.clear
+    Locale.current = lang
+  end
+
+  def locale
+    Locale.current[0]
+  end
+
+  alias :locale= :set_locale #:nodoc:
+  module_function :locale= #:nodoc:
+
+  alias :_ :gettext   #:nodoc:
+  module_function :_ #:nodoc:
+
+  alias :n_ :ngettext #:nodoc:
+  module_function :n_ #:nodoc:
+
+  alias :s_ :sgettext #:nodoc:
+  module_function :s_ #:nodoc:
+
+  alias :ns_ :nsgettext #:nodoc:
+  module_function :ns_ #:nodoc:
+
+  alias :np_ :npgettext #:nodoc:
+  module_function :np_ #:nodoc:
+
+  alias :output_charset= :set_output_charset #:nodoc:
+  module_function :output_charset= #:nodoc:
+
+unless defined? XX
+  # This is the workaround to conflict p_ methods with the xx("double x") library.
+  # http://rubyforge.org/projects/codeforpeople/
+  alias :p_ :pgettext #:nodoc:
+  module_function :p_
+end
+
+  # for backward compatibility
+  alias :set_locale_all :set_locale #:nodoc:
+  alias :set_locale_all :set_locale #:nodoc:
+  module_function :set_locale_all #:nodoc:
+  alias :setlocale :set_locale #:nodoc:
+  module_function :setlocale #:nodoc:
+end

data/lib/gettext/cgi.rb

@@ -0,0 +1,40 @@
+=begin
+  gettext/cgi.rb - GetText for CGI
+
+  Copyright (C) 2005-2009  Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+
+  $Id$
+=end
+
+require 'cgi'
+require 'gettext'
+
+Locale.init(:driver => :cgi)
+
+module GetText
+  module_function
+
+  # Sets a CGI object.
+  # * cgi_: CGI object
+  # * Returns: self
+  def set_cgi(cgi_)
+    Locale.set_cgi(cgi_)
+  end
+
+  # Same as GetText.set_cgi.
+  # * cgi_: CGI object
+  # * Returns: cgi_
+  def cgi=(cgi_)
+    set_cgi(cgi_)
+    cgi_
+  end
+
+  # Gets the CGI object. If it is nil, returns new CGI object.
+  # * Returns: the CGI object
+  def cgi
+    Locale.cgi
+  end
+end

data/lib/gettext/class_info.rb

@@ -0,0 +1,55 @@
+require 'locale/util/memoizable'
+
+module GetText
+  module ClassInfo
+    include Locale::Util::Memoizable
+
+    module_function
+    # normalize the klass name
+    def normalize_class(klass)
+      ret = (klass.kind_of? Module) ? klass : klass.class
+      if ret.name =~ /^\#<|^$/ or ret == GetText
+        ret = Object
+      end
+      ret
+    end
+
+    # Internal method for related_classes.
+    def related_classes_internal(klass, all_classes = [], analyzed_classes = [] )
+      ret = []
+      klass = normalize_class(klass)
+
+      return [Object] if [Object, Kernel].include? klass
+
+      ary = klass.name.split(/::/)
+      while(v = ary.shift)
+        ret.unshift(((ret.size == 0) ? Object.const_get(v) : ret[0].const_get(v)))
+      end
+      ret -= analyzed_classes
+      if ret.size > 1
+        ret += related_classes_internal(ret[1], all_classes, analyzed_classes)
+        ret.uniq!
+      end
+      analyzed_classes << klass unless analyzed_classes.include? klass
+      klass.ancestors[1..-1].each do |v|
+        ret += related_classes_internal(v, all_classes, analyzed_classes)
+        ret.uniq!
+      end
+
+      if all_classes.size > 0
+        ((ret - [Kernel]) & all_classes).uniq 
+      else
+        (ret - [Kernel]).uniq
+      end
+    end
+
+    # Returns the classes which related to klass 
+    # (klass's ancestors, included modules and nested modules)
+    def related_classes(klass, all_classes = [])
+      ret = related_classes_internal(klass, all_classes)
+      (ret + [Object]).uniq
+    end
+    memoize :related_classes
+  end
+end
+

data/lib/gettext/core_ext/iconv.rb

@@ -0,0 +1,109 @@
+=begin
+  iconv.rb - Pseudo Iconv class. Supports Iconv.iconv, Iconv.conv.
+
+  For Matz Ruby:
+  If you don't have iconv but glib2, this library uses glib2 iconv functions.
+
+  For JRuby:
+  Use Java String class to convert strings.
+
+  Copyright (C) 2004-2007  Masao Mutoh
+
+  You may redistribute it and/or modify it under the same
+  license terms as Ruby.
+
+  $Id: iconv.rb,v 1.6 2007/11/08 14:21:22 mutoh Exp $
+=end
+
+begin
+  require 'iconv.so'
+rescue LoadError
+  # Pseudo Iconv class
+  # 
+  # Provides Iconv.iconv which uses Ruby/GLib(1) functions. This library also required from 'gettext'.
+  # If you require 'gettext/iconv', Iconv.iconv try to call Ruby/GLib function 
+  # when it doesn't find original Iconv class(iconv.so).
+  #
+  # (1) Ruby/GLib is a module which is provided from Ruby-GNOME2 Project. 
+  # You can get binaries for Win32(One-Click Ruby Installer).
+  # <URL: http://ruby-gnome2.sourceforge.jp/>
+  class Iconv
+    module Failure; end
+    class InvalidEncoding < ArgumentError;  include Failure; end
+    class IllegalSequence < ArgumentError;  include Failure; end
+    class InvalidCharacter < ArgumentError; include Failure; end
+
+    if RUBY_PLATFORM =~ /java/
+      def self.conv(to, from, str)
+        raise InvalidCharacter, "the 3rd argument is nil" unless str
+        begin
+          str = java.lang.String.new(str.unpack("C*").to_java(:byte), from)
+          str.getBytes(to).to_ary.pack("C*")
+        rescue java.io.UnsupportedEncodingException
+          raise InvalidEncoding
+        end
+      end
+    else
+      begin
+        require 'glib2'
+      
+        def self.check_glib_version?(major, minor, micro) # :nodoc:
+          (GLib::BINDING_VERSION[0] > major ||
+           (GLib::BINDING_VERSION[0] == major && 
+            GLib::BINDING_VERSION[1] > minor) ||
+           (GLib::BINDING_VERSION[0] == major && 
+            GLib::BINDING_VERSION[1] == minor &&
+            GLib::BINDING_VERSION[2] >= micro))
+        end
+        
+        if check_glib_version?(0, 11, 0)
+          # This is a function equivalent of Iconv.iconv.
+          # * to: encoding name for destination
+          # * from: encoding name for source
+          # * str: strings to be converted
+          # * Returns: Returns an Array of converted strings.
+          def self.conv(to, from, str)
+            begin
+              GLib.convert(str, to, from)
+            rescue GLib::ConvertError => e
+              case e.code
+              when GLib::ConvertError::NO_CONVERSION
+                raise InvalidEncoding.new(str)
+              when GLib::ConvertError::ILLEGAL_SEQUENCE
+                raise IllegalSequence.new(str)
+              else
+                raise InvalidCharacter.new(str)
+              end
+            end
+          end
+        else
+          def self.conv(to, from, str) # :nodoc:
+            begin
+              GLib.convert(str, to, from)
+            rescue
+              raise IllegalSequence.new(str)
+            end
+          end
+        end
+      rescue LoadError
+        def self.conv(to, from, str) # :nodoc:
+          warn "Iconv was not found." if $DEBUG
+          str
+        end
+      end
+    end
+    def self.iconv(to, from, str)
+      conv(to, from, str).split(//)
+    end
+  end
+end
+
+if __FILE__ == $0
+  puts Iconv.iconv("EUC-JP", "UTF-8", "ほげ").join
+  begin
+    puts Iconv.iconv("EUC-JP", "EUC-JP", "ほげ").join
+  rescue Iconv::Failure
+    puts $!
+    puts $!.class
+  end
+end