Vega strike Python Modules doc: gettext Namespace Reference

All Data Structures Namespaces Files Functions Variables

Data Structures
class	NullTranslations

class	GNUTranslations

Functions
def	find

def	translation

def	install

def	textdomain

def	bindtextdomain

def	dgettext

def	gettext

Variables
list	__all__

tuple	_default_localedir = os.path.join(sys.prefix, 'share', 'locale')

dictionary	_translations = {}

dictionary	_localedirs = {}

string	_current_domain = 'messages'

	Catalog = translation

Detailed Description

Internationalization and localization support.

This module provides internationalization (I18N) and localization (L10N)
support for your Python programs by providing an interface to the GNU gettext
message catalog library.

I18N refers to the operation by which a program is made aware of multiple
languages.  L10N refers to the adaptation of your program, once
internationalized, to the local language and cultural habits.

Function Documentation

def gettext.bindtextdomain	(	domain,
		localedir = `None`
	)

Definition at line 271 of file gettext.py.

 
 def bindtextdomain(domain, localedir=None):
     global _localedirs
     if localedir is not None:
         _localedirs[domain] = localedir
     return _localedirs.get(domain, _default_localedir)
 

def gettext.dgettext	(	domain,
		message
	)

Definition at line 278 of file gettext.py.

References translation().

 
 def dgettext(domain, message):
     try:
         t = translation(domain, _localedirs.get(domain, None))
     except IOError:
         return message
     return t.gettext(message)
 

def gettext.find	(	domain,
		localedir = `None`,
		languages = `None`
	)

Definition at line 200 of file gettext.py.

 
 def find(domain, localedir=None, languages=None):
     # Get some reasonable defaults for arguments that were not supplied
     if localedir is None:
         localedir = _default_localedir
     if languages is None:
         languages = []
         for envar in ('LANGUAGE', 'LC_ALL', 'LC_MESSAGES', 'LANG'):
             val = os.environ.get(envar)
             if val:
                 languages = val.split(':')
                 break
         if 'C' not in languages:
             languages.append('C')
     # now normalize and expand the languages
     nelangs = []
     for lang in languages:
         for nelang in _expand_lang(lang):
             if nelang not in nelangs:
                 nelangs.append(nelang)
     # select a language
     for lang in nelangs:
         if lang == 'C':
             break
         mofile = os.path.join(localedir, lang, 'LC_MESSAGES', '%s.mo' % domain)
         if os.path.exists(mofile):
             return mofile
     return None
 
 
 
# a mapping between absolute .mo file path and Translation object

def gettext.gettext ( message)

Definition at line 286 of file gettext.py.

References dgettext().

 
 def gettext(message):
     return dgettext(_current_domain, message)
 
 
 # dcgettext() has been deemed unnecessary and is not implemented.
 
 # James Henstridge's Catalog constructor from GNOME gettext.  Documented usage
 # was:
 #
 #    import gettext
 #    cat = gettext.Catalog(PACKAGE, localedir=LOCALEDIR)
 #    _ = cat.gettext
 #    print _('Hello World')
 
 # The resulting catalog object currently don't support access through a
 # dictionary API, which was supported (but apparently unused) in GNOME
 # gettext.

def gettext.install	(	domain,
		localedir = `None`,
		unicode = `0`
	)

Definition at line 253 of file gettext.py.

References translation().

 
 def install(domain, localedir=None, unicode=0):
     translation(domain, localedir, fallback=1).install(unicode)
 
# a mapping b/w domains and locale directories

def gettext.textdomain ( domain = None)

Definition at line 264 of file gettext.py.

 
 def textdomain(domain=None):
     global _current_domain
     if domain is not None:
         _current_domain = domain
     return _current_domain
 

def gettext.translation	(	domain,
		localedir = `None`,
		languages = `None`,
		class_ = `None`,
		fallback = `0`
	)

Definition at line 234 of file gettext.py.

References smtpd.class_, find(), and aifc.open().

 
                 class_=None, fallback=0):
     if class_ is None:
         class_ = GNUTranslations
     mofile = find(domain, localedir, languages)
     if mofile is None:
         if fallback:
             return NullTranslations()
         raise IOError(ENOENT, 'No translation file found for domain', domain)
     key = os.path.abspath(mofile)
     # TBD: do we need to worry about the file pointer getting collected?
     # Avoid opening, reading, and parsing the .mo file after it's been done
     # once.
     t = _translations.get(key)
     if t is None:
         t = _translations.setdefault(key, class_(open(mofile, 'rb')))
     return t
 
 

Data Structures

Functions

Variables

Detailed Description

Function Documentation

Variable Documentation