]> git.netwichtig.de Git - user/henk/code/ruby/rbot.git/blob - lib/rbot/load-gettext.rb
integrated ruby-gettext
[user/henk/code/ruby/rbot.git] / lib / rbot / load-gettext.rb
1 # load gettext module and provide fallback in case of failure
2
3 require 'stringio'
4
5 # try to load gettext, or provide fake getttext functions
6 begin
7   require 'gettext'
8   include GetText
9   bindtextdomain 'rbot'
10
11   module GetText
12     # patch for ruby-gettext 1.9.0 to cope with anonymous modules used by rbot
13     # FIXME remove the patch when ruby-gettext is fixed, or rbot switches to named modules
14   # fix for module names that are not constant names
15     def bound_targets(klass)  # :nodoc:
16       ret = []
17       ary = klass.name.split(/::/)
18       while(v = ary.shift)
19         begin
20           ret.unshift(((ret.size == 0) ?
21             Object.const_get(v) : ret[0].const_get(v)))
22         rescue NameError
23           # when an anonymous module is encountered, only the previous modules
24           # are returned
25           break
26         end
27       end
28       ((ret + klass.ancestors + [GetText]) & @@__textdomainmanagers.keys).uniq
29     end
30   end
31
32   debug 'using ruby-gettext'
33   gettext_info = StringIO.new
34   current_textdomain_info(:out=>gettext_info)
35   gettext_info.string.each_line {|l| debug l}
36
37 rescue LoadError
38   warn 'ruby-gettext package not available; translations are disabled'
39
40   # dummy functions that return msg_id without translation
41   def _(s)
42     s
43   end
44
45   def N_(s)
46     s
47   end
48
49   def n_(s_single, s_plural, n)
50     n > 1 ? s_plural : s_single
51   end
52
53   def s_(*args)
54     args[0]
55   end
56
57   # the following extension to String#% is from ruby-gettext's string.rb file.
58   # it needs to be included in the fallback since the source already use this form
59
60 =begin
61   string.rb - Extension for String.
62
63   Copyright (C) 2005,2006 Masao Mutoh
64
65   You may redistribute it and/or modify it under the same
66   license terms as Ruby.
67 =end
68
69   # Extension for String class.
70   #
71   # String#% method which accept "named argument". The translator can know
72   # the meaning of the msgids using "named argument" instead of %s/%d style.
73   class String
74     alias :_old_format_m :% # :nodoc:
75
76     # call-seq:
77     #  %(arg)
78     #  %(hash)
79     #
80     # Format - Uses str as a format specification, and returns the result of applying it to arg.
81     # If the format specification contains more than one substitution, then arg must be
82     # an Array containing the values to be substituted. See Kernel::sprintf for details of the
83     # format string. This is the default behavior of the String class.
84     # * arg: an Array or other class except Hash.
85     # * Returns: formatted String
86     #
87     #  (e.g.) "%s, %s" % ["Masao", "Mutoh"]
88     #
89     # Also you can use a Hash as the "named argument". This is recommanded way for Ruby-GetText
90     # because the translators can understand the meanings of the msgids easily.
91     # * hash: {:key1 => value1, :key2 => value2, ... }
92     # * Returns: formatted String
93     #
94     #  (e.g.) "%{firstname}, %{familyname}" % {:firstname => "Masao", :familyname => "Mutoh"}
95     def %(args)
96       if args.kind_of?(Hash)
97         ret = dup
98         args.each {|key, value|
99           ret.gsub!(/\%\{#{key}\}/, value.to_s)
100         }
101         ret
102       else
103         ret = gsub(/%\{/, '%%{')
104         begin
105     ret._old_format_m(args)
106         rescue ArgumentError
107     $stderr.puts "  The string:#{ret}"
108     $stderr.puts "  args:#{args.inspect}"
109         end
110       end
111     end
112   end
113 end