← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/i18n.py

  • Committer: Vincent Ladeuil
  • Date: 2012-03-13 17:25:29 UTC
  • mfrom: (6499 +trunk)
  • mto: This revision was merged to the branch mainline in revision 6501.
  • Revision ID: v.ladeuil+lp@free.fr-20120313172529-i0suyjnepsor25i7
Merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/i18n.py
22
22
 
23
23
"""i18n and l10n support for Bazaar."""
24
24
 
 
25
from __future__ import absolute_import
 
26
 
25
27
import gettext as _gettext
26
28
import os
27
29
import sys
28
30
 
 
31
 
29
32
_translations = None
30
33
 
31
34
 
34
37
    
35
38
    :returns: translated message as unicode.
36
39
    """
 
40
    install()
37
41
    return _translations.ugettext(message)
38
42
 
39
43
 
46
50
 
47
51
    :returns: translated message as unicode.
48
52
    """
 
53
    install()
49
54
    return _translations.ungettext(singular, plural, number)
50
55
 
51
56
 
59
64
 
60
65
    :returns: concatenated translated message as unicode.
61
66
    """
 
67
    install()
62
68
    paragraphs = message.split(u'\n\n')
63
69
    ugettext = _translations.ugettext
64
70
    # Be careful not to translate the empty string -- it holds the
66
72
    return u'\n\n'.join(ugettext(p) if p else u'' for p in paragraphs)
67
73
 
68
74
 
 
75
def disable_i18n():
 
76
    """Do not allow i18n to be enabled.  Useful for third party users
 
77
    of bzrlib."""
 
78
    global _translations
 
79
    _translations = _gettext.NullTranslations()
 
80
 
 
81
 
69
82
def installed():
 
83
    """Returns whether translations are in use or not."""
70
84
    return _translations is not None
71
85
 
72
86
 
73
87
def install(lang=None):
 
88
    """Enables gettext translations in bzr."""
74
89
    global _translations
 
90
    if installed():
 
91
        return
 
92
    _translations = install_translations(lang)
 
93
 
 
94
 
 
95
def install_translations(lang=None, domain='bzr', locale_base=None):
 
96
    """Create a gettext translation object.
 
97
    
 
98
    :param lang: language to install.
 
99
    :param domain: translation domain to install.
 
100
    :param locale_base: plugins can specify their own directory.
 
101
 
 
102
    :returns: a gettext translations object to use
 
103
    """
75
104
    if lang is None:
76
105
        lang = _get_current_locale()
77
106
    if lang is not None:
78
107
        languages = lang.split(':')
79
108
    else:
80
109
        languages = None
81
 
    _translations = _gettext.translation(
82
 
            'bzr',
83
 
            localedir=_get_locale_dir(),
 
110
    translation = _gettext.translation(
 
111
            domain,
 
112
            localedir=_get_locale_dir(locale_base),
84
113
            languages=languages,
85
114
            fallback=True)
 
115
    return translation
 
116
 
 
117
 
 
118
def add_fallback(fallback):
 
119
    """
 
120
    Add a fallback translations object.  Typically used by plugins.
 
121
 
 
122
    :param fallback: gettext.GNUTranslations object
 
123
    """
 
124
    install()
 
125
    _translations.add_fallback(fallback)
86
126
 
87
127
 
88
128
def uninstall():
 
129
    """Disables gettext translations."""
89
130
    global _translations
90
131
    _translations = None
91
132
 
92
133
 
93
 
def _get_locale_dir():
 
134
def _get_locale_dir(base):
 
135
    """Returns directory to find .mo translations file in, either local or system
 
136
 
 
137
    :param base: plugins can specify their own local directory
 
138
    """
94
139
    if hasattr(sys, 'frozen'):
95
 
        base = os.path.dirname(
 
140
        if base is None:
 
141
            base = os.path.dirname(
96
142
                unicode(sys.executable, sys.getfilesystemencoding()))
97
143
        return os.path.join(base, u'locale')
98
144
    else:
99
 
        base = os.path.dirname(unicode(__file__, sys.getfilesystemencoding()))
 
145
        if base is None:
 
146
            base = os.path.dirname(unicode(__file__, sys.getfilesystemencoding()))
100
147
        dirpath = os.path.realpath(os.path.join(base, u'locale'))
101
148
        if os.path.exists(dirpath):
102
149
            return dirpath
134
181
def _get_current_locale():
135
182
    if not os.environ.get('LANGUAGE'):
136
183
        from bzrlib import config
137
 
        lang = config.GlobalConfig().get_user_option('language')
 
184
        lang = config.GlobalStack().get('language')
138
185
        if lang:
139
186
            os.environ['LANGUAGE'] = lang
140
187
            return lang
145
192
        if lang:
146
193
            return lang
147
194
    return None
 
195
 
 
196
 
 
197
def load_plugin_translations(domain):
 
198
    """Load the translations for a specific plugin.
 
199
 
 
200
    :param domain: Gettext domain name (usually 'bzr-PLUGINNAME')
 
201
    """
 
202
    locale_base = os.path.dirname(
 
203
        unicode(__file__, sys.getfilesystemencoding()))
 
204
    translation = install_translations(domain=domain,
 
205
        locale_base=locale_base)
 
206
    add_fallback(translation)
 
207
    return translation