Mercurial/Python - What Does The Underscore Function Do?

Question

In Mercurial, many of the extensions wrap their help/syntax string in a call to an underscore function, like so:

 _(\'[OPTION] [QUEUE]\')

T

Answer 1

_ (a function name of a single underscore) is often associated with internationalization, due to the precedent of gettext, a GNU approach that has also found a place in Python's standard library (same architecture, completely different implementation) -- per the module's docs,

gettext.install(domain[, localedir[, unicode[, codeset[, names]]]])

This installs the function _() in Python’s builtins namespace, based on domain, localedir, and codeset which are passed to the function translation(). The unicode flag is passed to the resulting translation object’s install() method.

For the names parameter, please see the description of the translation object’s install() method.

As seen below, you usually mark the strings in your application that are candidates for translation, by wrapping them in a call to the _() function, like this:

print _('This string will be translated.') 

For convenience, you want the _() function to be installed in Python’s builtins namespace, so it is easily accessible in all modules of your application.

As @ptomato mentions, Mercurial has followed this tradition by naming _ the equivalent function of their own that they use for the same internationalization purposes.

There is also a separate tradition to use _ as the "I don't care" identifier, as in

fee, fie, _, _, foo, _, fum = thesevenitemstuple

but of course you'd better not be using both traditions at once in the same code;-)

Answer 2

Look on line 45:

from mercurial.i18n import _

This is the usual abbreviation in the internationalization package gettext, and possibly other packages too, for the function that returns a translation of its argument to the language the program is currently running in. It's abbreviated to _ for convenience, since it's used for just about every message displayed to the user.

Looks like Mercurial wraps it in their own module. ("i18n" stands for "internationalization" because there are 18 letters in between "i" and "n".)