speaklater
~~~~~~~~~~
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, text_type
>>> sval = u'Hello World'
>>> string = make_lazy_string(lambda: sval)
This lazy string will evaluate to the value of the `sval` variable.
>>> string
l'Hello World'
>>> text_type(string) == u'Hello World'
True
>>> string.upper() == u'HELLO WORLD'
True
If you change the value, the lazy string will change as well:
>>> sval = u'Hallo Welt'
>>> string.upper() == u'HALLO WELT'
True
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.4: python >= 3.3 (and also 2.6 and 2.7) support,
repr(lazystring) is l"foo" on py2 and py3 - no "u" on py2!
New in version 1.2: It's now also possible to pass keyword arguments to
the callback used with `make_lazy_string`.
Raw data
{
"_id": null,
"home_page": "https://github.com/ThomasWaldmann/speaklater",
"name": "speaklater3",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Armin Ronacher, Thomas Waldmann",
"author_email": "armin.ronacher@active-4.com, tw@waldmann-edv.de",
"download_url": "https://files.pythonhosted.org/packages/03/47/eaa6a52849915456aa144fea9e41332ae9b1a246a899095a231c995aab7e/speaklater3-1.4.tar.gz",
"platform": "",
"description": "speaklater\n~~~~~~~~~~\n\nA module that provides lazy strings for translations. Basically you\nget an object that appears to be a string but changes the value every\ntime the value is evaluated based on a callable you provide.\n\nFor example you can have a global `lazy_gettext` function that returns\na lazy string with the value of the current set language.\n\nExample:\n\n>>> from speaklater import make_lazy_string, text_type\n>>> sval = u'Hello World'\n>>> string = make_lazy_string(lambda: sval)\n\nThis lazy string will evaluate to the value of the `sval` variable.\n\n>>> string\nl'Hello World'\n>>> text_type(string) == u'Hello World'\nTrue\n>>> string.upper() == u'HELLO WORLD'\nTrue\n\nIf you change the value, the lazy string will change as well:\n\n>>> sval = u'Hallo Welt'\n>>> string.upper() == u'HALLO WELT'\nTrue\n\nThis is especially handy when combined with a thread local and gettext\ntranslations or dicts of translatable strings:\n\n>>> from speaklater import make_lazy_gettext\n>>> from threading import local\n>>> l = local()\n>>> l.translations = {u'Yes': 'Ja'}\n>>> lazy_gettext = make_lazy_gettext(lambda: l.translations.get)\n>>> yes = lazy_gettext(u'Yes')\n>>> print(yes)\nJa\n>>> l.translations[u'Yes'] = u'Si'\n>>> print(yes)\nSi\n\nLazy strings are no real strings so if you pass this sort of string to\na function that performs an instance check, it will fail. In that case\nyou have to explicitly convert it with `unicode` and/or `string` depending\non what string type the lazy string encapsulates.\n\nTo check if a string is lazy, you can use the `is_lazy_string` function:\n\n>>> from speaklater import is_lazy_string\n>>> is_lazy_string(u'yes')\nFalse\n>>> is_lazy_string(yes)\nTrue\n\nNew in version 1.4: python >= 3.3 (and also 2.6 and 2.7) support,\n repr(lazystring) is l\"foo\" on py2 and py3 - no \"u\" on py2!\n\nNew in version 1.2: It's now also possible to pass keyword arguments to\nthe callback used with `make_lazy_string`.\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Implements a lazy string for python useful for use with gettext. This version is compatible with Python 3",
"version": "1.4",
"project_urls": {
"Homepage": "https://github.com/ThomasWaldmann/speaklater"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4e9b855943d6227ed912fa14c0def339cdffe67c8221f1c97d658f7bfd1d0066",
"md5": "e11f9d2abc5ba25f73cd62f7318fc486",
"sha256": "5a48a40ad5bf0835af6aa9d3c52120fe19dc92857b78caacfcb49110002f8863"
},
"downloads": -1,
"filename": "speaklater3-1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e11f9d2abc5ba25f73cd62f7318fc486",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5937,
"upload_time": "2017-09-08T06:31:08",
"upload_time_iso_8601": "2017-09-08T06:31:08.106385Z",
"url": "https://files.pythonhosted.org/packages/4e/9b/855943d6227ed912fa14c0def339cdffe67c8221f1c97d658f7bfd1d0066/speaklater3-1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0347eaa6a52849915456aa144fea9e41332ae9b1a246a899095a231c995aab7e",
"md5": "33f9a5da54a38692c85a440c93e073eb",
"sha256": "c9261d4b6b5a304672312d1eb0899be028fac91760190a80feccd31d3a3b5042"
},
"downloads": -1,
"filename": "speaklater3-1.4.tar.gz",
"has_sig": false,
"md5_digest": "33f9a5da54a38692c85a440c93e073eb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4309,
"upload_time": "2017-09-08T06:31:09",
"upload_time_iso_8601": "2017-09-08T06:31:09.767863Z",
"url": "https://files.pythonhosted.org/packages/03/47/eaa6a52849915456aa144fea9e41332ae9b1a246a899095a231c995aab7e/speaklater3-1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2017-09-08 06:31:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ThomasWaldmann",
"github_project": "speaklater",
"github_not_found": true,
"lcname": "speaklater3"
}
JSON
