Hvers vegna t-strings¶

Fjórar leiðir til að koma gildi inn í þýðanleg skilaboð, bornar saman á sömu skilaboðunum. Allar fjórar nefna staðgengla sína og leyfa þýðanda að endurraða þeim; þær greinast í því hvað gerist þegar þýðing er röng, í því hversu mikið af forritinu þínu þýðingaskráin nær til, og í því hvað upptaka þeirra kostar.

Töflurnar koma fyrst, svo að þú getir fundið línuna sem skiptir þig máli og lesið aðeins kaflann á bak við hana.

Hlið við hlið¶

Þegar þýðanda verða á mistök. Þýðingaskrá fer um margar hendur og flest sem aflaga fer í henni er óviljandi:

Hvaða vald þýðingaskráin hefur. Þýðing eru gögn utan úr geymslunni þinni og hver stíll réttir henni ólíkt mikið vald:

Hvað samþætting kostar. Allt hér að ofan er ókeypis ef tólakeðjan passar; hér er staðurinn þar sem hún gæti ekki gert það:

Um athugunina við birtingu: skilaboð í eintölu eru athuguð með kröfu um nákvæma samsvörun staðgengla. Fleirtöluskilaboð eru einnig athuguð, gagnvart sammengis-/sniðmengisreglunni sem leyfir fleirtölumyndum markmálsins að vera frábrugðnar myndum frumtextans; strangari athugunin fyrir hverja mynd keyrir þegar þýðingaskrár eru vistþýddar (Útdráttur).

Línan um sniðflaggið snýst um staðgengilsmeðvitaða staðfestingu, ekki um samhæfni þýðingaskráa. ekkert merkir að stöðluð gettext-tól lesa og vistþýða skilaboðin eftir sem áður, en msgfmt --check-format hefur enga $-staðgengilsmálfræði til að beita.

Samhæfni og þroski¶

Fyrstu tvær línur síðustu töflunnar eru þær sem ráða upptöku, svo það er þess virði að segja þær berum orðum fremur en sem reiti.

%-snið og .format() eru innbyggð í Python og þarfnast engrar viðbótar. flufl.i18n er þroskaður pakki, gefinn út og í rekstrarnotkun, sem keyrir á Python 3.10 og nýrri. gettext-tstrings er alfa og krefst Python 3.14 eða nýrri, því t-strengir eru ný málskipan í 3.14 — það er engin bakfærsla til og getur ekki verið. Forskriftin er stöðugi hluti safnsins; Python-viðmótið gæti enn hreyfst fyrir 1.0.

Það sem ekkert þeirra kostar er samhæfni þýðingaskráa. Allar fjórar framleiða venjulegar POT/PO/MO-skrár sem hver PO-ritill, þýðingavettvangur og GNU-gettext-tól les nú þegar, svo valið hér að neðan er afturkræft á hátt sem það væri ekki ef sniði þýðingaskránna væri breytt. Yfirfærsla fjallar um að færa verkefni sem er þegar til.

Kaflarnir hér að neðan sýna hverja málamiðlun í smáatriðum, eina aðferð í einu.

%-snið¶

_("Hello %(name)s") % {"name": name}

Hvað getur farið úrskeiðis: skemmdur staðgengill verður að undantekningu við keyrslu, nema staðfesting þýðingaskránna grípi hann fyrst.

Strengurinn í þýðingaskránni ber printf-málskipan, þar með talinn tegundarstaf í enda — s-ið í %(name)s — sem er auðvelt að yfirsjást og auðvelt að skemma:

>>> "Hello %(name)" % {"name": "Ada"}  # the trailing "s" was deleted
Traceback (most recent call last):
  ...
ValueError: incomplete format

Breyting á einum staf í PO-ritli verður að fráviki á keyrslutíma nema staðfesting þýðingaskrárinnar grípi það fyrst. GNU msgfmt --check-format grípur þetta vissulega, en aðeins fyrir skilaboð sem eru merkt python-format, og aðeins ef þýðingaskráin fer raunverulega gegnum msgfmt á leið sinni í forritið þitt.

str.format¶

_("Hello {name}").format(name=name)

Það losar okkur við tegundarstafinn í endanum en heldur staðgengli sem hefur nafn og má víxla frjálst. Það sem getur farið úrskeiðis færist yfir á hina hlið viðskiptanna: þýðingin fær vald yfir hlutunum þínum.

str.format er lítið segðamál, og að kalla á það á streng þýðir að rétta þeim streng réttinn til að nota það:

>>> "{name.__class__.__mro__}".format(name="Ada")
"(<class 'str'>, <class 'object'>)"
>>> settings.api_key = "sk-live-…"
>>> "{conf.api_key}".format(conf=settings)
'sk-live-…'

Settu nú hvað sem _() skilar í stað þessara föstu strengja. Ef þýðing á Hello {name} kemur til baka sem {conf.api_key}, þá prentar birting hennar API-lykilinn þinn — þýðingaskráin, ekki kóðinn þinn, réð því hvað var lesið. Þýðingaskrá er ekki kóði, en hún ferðast eins og gögn: út á þýðingavettvang, gegnum margar hendur, til baka sem .po, vistþýdd í .mo, stundum fengin að láni algjörlega utan verkefnisins þíns. .format() gefur hverju skrefi þeirrar ferðar aðgang að eigindum hlutanna sem þú réttir inn.

$-strengir og flufl.i18n¶

from flufl.i18n import initialize

_ = initialize("example")

name = "Ada"
print(_("Hello $name"))  # Hello Ada — the value came from the caller's locals

string.Template úr staðalsafninu leggur til innskeytingarmálið $name, en er ekki sjálft þýðingar-API. flufl.i18n sameinar þann stíl við uppflettingu í gettext-þýðingaskrá. Taktu eftir að gildið er aldrei rétt inn: flufl.i18n byggir nafnrými útskiptinganna úr altækum og staðværum breytum kallandans — hvaða breytur sem eru til á kallstaðnum standa skilaboðunum til boða. Valfrjáls extras-vörpun gengur framar hvoru tveggja. Málskipanin sem þýðandinn sér hefur hvorki tegundarstaf í enda né sniðlýsingu, og staðgengla má áfram víxla frjálst.

Útskipting sem ekki er til varpar engu. Með name = "Ada" og engan nombre í nafnrými kallandans birtist þýðing þýðingaskrárinnar á Hello $nombre sem Hello $nombre: óleysti staðgengillinn stendur eftir sýnilegur. Sú skjalfesta hegðun varðveitir afganginn af þýddu skilaboðunum í stað þess að fella kallið. Frávörp sem verpast við að leysa eigindi eða umbreyta gildi geta þó enn borist upp.

flufl.i18n getur meira en ber string.Template á einn hátt sem skiptir máli hér. Hið sérsniðna Template tekur við punktuðum staðgenglum á borð við $settings.api_key, og þýðandinn leysir þær slóðir upp gagnvart gildum kallandans. Þýddur staðgengill má nefna hvaða staðværu eða altæku breytu kallandans sem er og, með punktaðri ritmynd, ferðast um eigindi hennar. Það er þægilegt þegar skilaboð þurfa á eigindi að halda, en gerir um leið ramma kallandans að hluta af nafnrými útskiptinganna í þýðingaskránni. Samanburðurinn hér lýsir flufl.i18n 6.0.0, ekki hverri mögulegri notkun á string.Template.

Það svarar líka spurningu sem hinir tveir sniðstílarnir skilja alfarið eftir hjá forritinu: hvaða tungumál er virkt, og hvernig því er skipt. Forritshlutur heldur utan um stafla af tungumálum, _.push(code) og _.pop() hreyfa hann, with _.using(code): má hreiðra, og stefna finnur þýðingaskrána fyrir tiltekinn tungumálakóða, svo að forritið handleiki aldrei sjálft hluti með þýðingaskrám. Þjónn sem þarf að framleiða texta á fleiri en einu tungumáli innan sömu vinnueiningar — síðu fyrir lesandann, tilkynningu til einhvers sem hefur annað tungumál stillt — er einmitt tilvikið sem þetta er til fyrir.

Staflinn býr á þessum forritshlut, sem allt ferlið deilir. Tvær beiðnir sem skarast deila því einum stafla, og blokkir sem eru ekki stranglega hreiðraðar í tíma rétta hvor annarri rangt tungumál:

async def greet(code, delay):
    with _.using(code):
        await asyncio.sleep(delay)
        return _("Hello $name")


async def main():
    return await asyncio.gather(greet("fr", 0.01), greet("ja", 0.02))

>>> asyncio.run(main())  # "fr" entered first and left first, so it read "ja" off the top
['こんにちは Ada', 'Bonjour Ada']

Þetta safn heldur sömu getunni — bindingar hreiðrast og rakna upp á sama hátt — en geymir hana í ContextVar í stað sameiginlegs stafla, svo að fléttan hér að ofan leysist fyrir hvert verk um sig. Samsvarandi dæmi eru á Mörg tungumál í einu. Það sem safnið leggur ekki til er uppflettingin úr tungumálakóða í þýðingaskrá: þú réttir inn hlut með þýðingunum, sem í venjulega tilvikinu er eitt kall á gettext.translation(), og staðalsafnið heldur þáttuðu þýðingaskránni í skyndiminni.

t-strengir¶

tr(t"Hello {name}")

Þýðingaskráin sér áfram Hello {name} og er áfram venjuleg PO/MO-skrá. Munurinn liggur í því hvað þýðing má segja, og hver athugar það.

Þetta safn athugar hverja þýðingu gagnvart staðgenglum frumskilaboðanna áður en það birtir hana, og það tekur við berum nöfnum og engu öðru. Gagnvart t"Hello {name}":

Hafnað þýðir ekki hrunið: sjálfgefið skráir safnið viðvörun og birtir frumtextaskilaboðin, svo að léleg þýðingaskrá fellir aldrei forritið — sami samningur og gettext sjálft heldur.

Sniðið helst þar sem það var skrifað, í kóðanum:

amount = 1234.5
tr(t"Total: {amount:,.2f}")  # msgid is "Total: {amount}"

:,.2f kemst aldrei í þýðingaskrána, svo engin þýðing getur breytt því og enginn þýðandi þarf að líta á það. Það er þó fast snið, ekki staðfært — að velja tölustafi og skiltákn eftir tungumáli er verk Babel, á undan kallinu.

Enn einn munurinn er tólastuðningur: t-strengir eru ný málskipan, svo að draga þá út í .pot krefst sem stendur útdráttartóls sem kann á t-strengi, eins og þess sem þessi pakki leggur til fyrir Babel.

Kostnaður takmörkunarinnar¶

Fyrir utan Python-kröfuna er verðið fyrir allt þetta ein regla: innskeyting verður að vera bert nafn.

tr(t"Hello {user.name}")  # raises InvalidTemplateError at the call site

name = user.name  # compute it first
tr(t"Hello {name}")

Það er raunveruleg hömlun, og hún er sama hömlunin og framkallar ábyrgðirnar hér að ofan. Ásamt bindingu gilda á hlið frumtextans og athugun staðgengla á keyrslutíma kemur hún í veg fyrir að strengir í þýðingaskrá reikni út segðir, og heldur nöfnum staðgengla merkingarbærum fyrir þann sem þýðir þau.

F-streng er alls ekki hægt að nota svona — um leið og nokkurt safn sér hann er hann þegar fullgerður strengur, svo að þýða hann þýðir að þýða brot. T-strengir (PEP 750) halda föstum textanum og gildunum aðskildum en halda um leið málskipan sem líkist f-strengjum og skýrri bindingu gilda.

Hvernig Python rataði hingað — tveir PEP-ar með tíu ára millibili, og umræðan í staðalsafninu sem lokaðist án svars — er sagt með heimildum á Bakgrunnur.