]> git.netwichtig.de Git - user/henk/code/ruby/rbot.git/blob - lib/rbot/load-gettext.rb
added a warning message if retrieving gettext info fails
[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     if !instance_methods.include?('orig_bound_targets')
16       alias :orig_bound_targets :bound_targets
17     end
18     def bound_targets(*a)  # :nodoc:
19       orig_bound_targets(*a) rescue orig_bound_targets(Object)
20     end
21   end
22
23   begin
24     gettext_info = StringIO.new
25     current_textdomain_info(:out=>gettext_info) # fails sometimes
26     debug 'using ruby-gettext'
27     gettext_info.string.each_line {|l| debug l}
28   rescue Exception
29     warn "ruby-gettext was loaded but appears to be non-functional. maybe an mo file doesn't exist for your locale."
30   end
31
32 rescue LoadError
33   warn 'ruby-gettext package not available; translations are disabled'
34
35   # dummy functions that return msg_id without translation
36   def _(s)
37     s
38   end
39
40   def N_(s)
41     s
42   end
43
44   def n_(s_single, s_plural, n)
45     n > 1 ? s_plural : s_single
46   end
47
48   def Nn_(s_single, s_plural)
49     n_(s_single, s_plural)
50   end
51
52   def s_(*args)
53     args[0]
54   end
55
56   # the following extension to String#% is from ruby-gettext's string.rb file.
57   # it needs to be included in the fallback since the source already use this form
58
59 =begin
60   string.rb - Extension for String.
61
62   Copyright (C) 2005,2006 Masao Mutoh
63
64   You may redistribute it and/or modify it under the same
65   license terms as Ruby.
66 =end
67
68   # Extension for String class.
69   #
70   # String#% method which accept "named argument". The translator can know
71   # the meaning of the msgids using "named argument" instead of %s/%d style.
72   class String
73     alias :_old_format_m :% # :nodoc:
74
75     # call-seq:
76     #  %(arg)
77     #  %(hash)
78     #
79     # Format - Uses str as a format specification, and returns the result of applying it to arg.
80     # If the format specification contains more than one substitution, then arg must be
81     # an Array containing the values to be substituted. See Kernel::sprintf for details of the
82     # format string. This is the default behavior of the String class.
83     # * arg: an Array or other class except Hash.
84     # * Returns: formatted String
85     #
86     #  (e.g.) "%s, %s" % ["Masao", "Mutoh"]
87     #
88     # Also you can use a Hash as the "named argument". This is recommanded way for Ruby-GetText
89     # because the translators can understand the meanings of the msgids easily.
90     # * hash: {:key1 => value1, :key2 => value2, ... }
91     # * Returns: formatted String
92     #
93     #  (e.g.) "%{firstname}, %{familyname}" % {:firstname => "Masao", :familyname => "Mutoh"}
94     def %(args)
95       if args.kind_of?(Hash)
96         ret = dup
97         args.each {|key, value|
98           ret.gsub!(/\%\{#{key}\}/, value.to_s)
99         }
100         ret
101       else
102         ret = gsub(/%\{/, '%%{')
103         begin
104     ret._old_format_m(args)
105         rescue ArgumentError
106     $stderr.puts "  The string:#{ret}"
107     $stderr.puts "  args:#{args.inspect}"
108         end
109       end
110     end
111   end
112 end