Skip to main content

Fork of implements a lazy string for python useful 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

quokka-speaklater-1.3.1.tar.gz (4.0 kB view details)

Uploaded Source

File details

Details for the file quokka-speaklater-1.3.1.tar.gz.

File metadata

File hashes

Hashes for quokka-speaklater-1.3.1.tar.gz
Algorithm Hash digest
SHA256 c8344791f6ada654b205ec98d0a28e439f8c38cec8241552556787b2d7fd42f7
MD5 f530f1b29d72c402737afc97ee0afda4
BLAKE2b-256 602cfe5738399d4b1deda4fba4aa4f36525ccc2e4ea5e6418e04f73c4c2ba8cb

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page