Implements a lazy string for python for use with gettext
Project description
A module that provides lazy strings for translations. Basically you get an object that appears to be a string but changes the value every time the value is evaluated based on a callable you provide.
For example you can have a global lazy_gettext function that returns a lazy string with the value of the current set language.
Example:
>>> from speaklater import make_lazy_string >>> sval = u'Hello World' >>> string = make_lazy_string(lambda: sval)
This lazy string will evaluate to the value of the sval variable.
>>> string lu'Hello World' >>> unicode(string) u'Hello World' >>> string.upper() u'HELLO WORLD'
If you change the value, the lazy string will change as well:
>>> sval = u'Hallo Welt' >>> string.upper() u'HALLO WELT'
This is especially handy when combined with a thread local and gettext translations or dicts of translatable strings:
>>> from speaklater import make_lazy_gettext >>> from threading import local >>> l = local() >>> l.translations = {u'Yes': 'Ja'} >>> lazy_gettext = make_lazy_gettext(lambda: l.translations.get) >>> yes = lazy_gettext(u'Yes') >>> print yes Ja >>> l.translations[u'Yes'] = u'Si' >>> print yes Si
Lazy strings are no real strings so if you pass this sort of string to a function that performs an instance check, it will fail. In that case you have to explicitly convert it with unicode and/or string depending on what string type the lazy string encapsulates.
To check if a string is lazy, you can use the is_lazy_string function:
>>> from speaklater import is_lazy_string >>> is_lazy_string(u'yes') False >>> is_lazy_string(yes) True
New in version 1.2: It’s now also possible to pass keyword arguments to the callback used with make_lazy_string.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for flaskpress_speaklater-1.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 74ba49cb29f0ee25c57b716c71eee31f53378c43aa0fd2b651da328aae0bb0d5 |
|
MD5 | d45d1893d5c2c4b2f2deff7022cb9c04 |
|
BLAKE2b-256 | 25e91fdb447c5ccefa9a8ee509187a2da05a5506e9a471ad3531c4b7cf47832c |