x/gantt
Code Issues Proposed changes
Files
1e7aa5904f209ee2bc90dc18ed2b024cb9f51b93
gantt/doc/source/devref/il8n.rst
Alex Gaynor 1bebb3feaf Remove the monkey patching of _ into the builtins 
Previous _ was monkey patched into builtins whenever
certain modules were imported. This removes that and
simply imports it when it is needed.

Change-Id: I0af2c6d8a230e94440d655d13cab9107ac20d13c
2013-07-26 07:31:17 -07:00

960 B
Raw Blame History

Internationalization

nova uses gettext so that user-facing strings such as log messages appear in the appropriate language in different locales.

To use gettext, make sure that the strings passed to the logger are wrapped in a _() function call. For example:

LOG.debug(_("block_device_mapping %s"), block_device_mapping)

Do not use locals() for formatting messages because: 1. It is not as clear as using explicit dicts. 2. It could produce hidden errors during refactoring. 3. Changing the name of a variable causes a change in the message. 4. It creates a lot of otherwise unused variables.

If you do not follow the project conventions, your code may cause the LocalizationTestCase.test_multiple_positional_format_placeholders test to fail in nova/tests/test_localization.py.

The _() function is found by doing:

from nova.openstack.common.gettextutils import _