Package gnue :: Package common :: Package base :: Module i18n
[show private | hide private]

Module gnue.common.base.i18n

Internationalization support.
Function Summary
  get_encoding()
Returns the encoding of the currently active locale.
  get_language()
Returns the language of the currently active locale.
  get_user_locale()
Try to find out which locale the user is using.
  outconv(message)
Encodes a message to encoding (the current locale's encoding).
  set_current_locale(new_locale)
Set the current locale.
  translate(message)
Translates a message and returns an 8 bit string, encoded with encoding (the current locale's encoding).
  utranslate(message)
Translates a message and returns a unicode string.
  __find_catalog(domain)
  __updateglobals()

Variable Summary
str encoding: Encoding of the current locale
str language: Language of the current locale
dict __CATALOGS = {'gnue-common-apps:en_US': None, 'gnue-comm...
dict __DOMAINS = {'gnue.common.apps.i18n': None}

Function Details

get_encoding()

Returns the encoding of the currently active locale. This can be changed with set_current_locale.
Returns:
encoding of the current locale.

get_language()

Returns the language of the currently active locale. This can be changed with set_current_locale.
Returns:
language of the current locale.

get_user_locale()

Try to find out which locale the user is using. This is always the locale of the user running the program and is not touched by set_current_locale.
Returns:
localestring of the user's locale, i.e. de_AT@euro.

outconv(message)

Encodes a message to encoding (the current locale's encoding). This function is available as the builtin function "o()".

set_current_locale(new_locale)

Set the current locale.

If it fails it tries to succeed using a more general form of the requested locale, i.e. if 'de_AT@euro' fails, 'de_AT' will be tried next. If that fails too, 'de' will be tried.
Parameters:
new_locale - string of the locale to be set, e.g. de_AT.ISO88591@euro (full blown) or 'de_AT' or 'en_AU'

translate(message)

Translates a message and returns an 8 bit string, encoded with encoding (the current locale's encoding). This function is available as the builtin function "_()".

utranslate(message)

Translates a message and returns a unicode string. This function is available as the builtin function "u_()".

__find_catalog(domain)

__updateglobals()


Variable Details

encoding

Encoding of the current locale
Type:
str
Value:
'ISO8859-1'                                                            

language

Language of the current locale
Type:
str
Value:
'en_US'                                                                

__CATALOGS

Type:
dict
Value:
{'gnue-common-apps-i18n:en_US': None,
 'gnue-common-apps:en_US': None,
 'gnue-common:en_US': None,
 'gnue:en_US': None}                                                   

__DOMAINS

Type:
dict
Value:
{'gnue.common.apps.i18n': None}                                        


GNUe Home

Private API

Developer's Corner