Python کی t-string کے ساتھ
مکمل پیغامات کا ترجمہ¶

import gettext

from gettext_tstrings import Translator

_ = Translator(gettext.translation("messages", localedir="locales"))
name = "Ada"
print(_(t"Hello {name}"))  # with a Japanese catalog: こんにちは Ada

کیا یہ آپ کے لیے ہے؟¶

آج موزوں ہے جب آپ کی ایپلی کیشن Python 3.14 یا اس سے نئے پر چلتی ہو؛ آپ پہلے ہی gettext اور Babel استعمال کرتے ہوں، یا ان کا PO/MO ورک فلو اپنانا چاہتے ہوں؛ اور آپ نامزد پلیس ہولڈرز والی t-string نحو چاہتے ہوں جو رینڈر ہونے سے پہلے جانچ لی جائے۔

ابھی موزوں نہیں جب آپ کو Python 3.13 یا اس سے پرانا درکار ہو؛ آپ کو مستحکم Python API چاہیے ہو — یہ ایک الفا ہے، اور اس کا جو حصہ ٹھہر چکا ہے وہ تصریح ہے؛ یا آپ کا تقریباً سارا قابلِ ترجمہ متن Python ماخذ کے بجائے کسی ٹیمپلیٹ زبان میں ہو۔

پہلے سے کیٹلاگ موجود ہیں؟ وہ چلتے رہیں گے۔ _("Hello {name}").format(name=name) اور tr(t"Hello {name}") ایک ہی msgid پیدا کرتے ہیں، لہٰذا موجودہ ترجمے اس تبدیلی سے بچ نکلتے ہیں — منتقلی پورا سفر طے کراتی ہے۔

کیٹلاگ کیا کہہ سکتا ہے¶

کوئی ترجمہ اُس پیغام کی ساخت نہیں بدل سکتا جس کا وہ ترجمہ کر رہا ہے۔ یہی پورا وعدہ ہے، اور اس سائٹ کی باقی ساری باتیں اسی سے نکلتی ہیں۔ ترجمہ {name} کو دوسری جگہ لے جا سکتا ہے یا دہرا سکتا ہے، اور اس کے اردگرد کا ہر لفظ نئے سرے سے لکھ سکتا ہے۔ وہ پلیس ہولڈر حذف نہیں کر سکتا، نیا ایجاد نہیں کر سکتا، اس کے راستے آپ کے آبجیکٹس تک نہیں پہنچ سکتا، اور اپنی طرف سے کوئی فارمیٹنگ نہیں جوڑ سکتا۔

لائبریری اسے اندر آتے وقت جانچتی ہے — جب کیٹلاگ کمپائل ہوتے ہیں — اور رینڈر کے وقت دوبارہ، اور یہی وہ فرق ہے جو جائزے میں پکڑی جانے والی غلطی اور کسی صارف کے ہاتھ لگنے والی غلطی کے درمیان ہے۔

یہ کون سا مسئلہ حل کرتی ہے¶

f-string اُس وقت تک انٹرپولیٹ ہو چکی ہوتی ہے جب کوئی لائبریری اسے دیکھتی بھی ہے — f"Hello {name}" "Hello Ada" بن چکی ہوتی ہے، اور کسی قدر کے اردگرد کے ٹکڑوں کا ترجمہ زیادہ تر زبانوں کی گرامر توڑ دیتا ہے۔ t-string (PEP 750) ثابت متن، ارزیابی شدہ قدروں، ماخذ اظہاریوں، کنورژنوں اور فارمیٹ اسپیک کو الگ الگ رکھتی ہے — اور یہ بالکل وہی تقسیم ہے جو ایک پیغام کیٹلاگ کو درکار ہے۔ %(name)s، .format() اور $-سٹرنگز کے مقابلے میں اس سے کیا فرق پڑتا ہے۔

تاہم gettext یا Babel میں کہیں یہ نہیں لکھا کہ t-string پیغام کیسے بنے۔ یہ لائبریری وہ فیصلہ کرتی ہے، اسے ایک ورژن والی تصریح کی صورت میں لکھ دیتی ہے، اور اس کی جانچ کے لیے مطابقت سویٹ بھی فراہم کرتی ہے۔

ڈیزائن کے قواعد¶

• مکمل پیغامات کا ترجمہ، جملے کے ٹکڑوں کا کبھی نہیں۔
• صرف سادہ متغیر نام قبول کرنا، جیسے {name}۔
• !r اور :.2f کو ایپلی کیشن کے قابو میں، کیٹلاگ سے باہر رکھنا۔
• ترجموں کو معلوم پلیس ہولڈرز کی ترتیب بدلنے اور انہیں دہرانے کی اجازت دینا، جبکہ انہیں خصوصیات تک پہنچنے یا فارمیٹنگ جوڑنے سے روکنا۔
• عام POT، PO اور MO فائلوں کا، اور ان اوزاروں کا جو انہیں پہلے ہی پڑھتے ہیں، دوبارہ استعمال۔

اور اس کے مقابل وہ فہرست جسے یہ جان بوجھ کر چھوڑ دیتی ہے: یہ اعداد، کرنسیوں یا تاریخوں کو مقامی نہیں بناتی — انہیں پہلے Babel سے فارمیٹ کر لیجیے؛ یہ رینڈر شدہ آؤٹ پٹ کو HTML، شیل یا ٹرمینل کے لیے ایسکیپ نہیں کرتی؛ اور یہ فیصلہ نہیں کر سکتی کہ کوئی ترجمہ درست ہے یا نہیں، صرف یہ کہ اس کے پلیس ہولڈر سالم ہیں یا نہیں۔

تنصیب¶

python -m pip install gettext-tstrings

Python 3.14 یا اس سے نیا۔ رینڈرنگ کا کوئی انحصار نہیں — یہ صرف معیاری لائبریری کے gettext کو استعمال کرتی ہے اور بس۔

استخراج اور کیٹلاگ کی توثیق Babel کے ذریعے چلتی ہے، لہٰذا وہ اضافی جزو وہاں نصب کیجیے جہاں pybabel چلتا ہے — جو عموماً ڈویلپمنٹ یا CI کا ماحول ہوتا ہے، نہ کہ پروڈکشن امیج:

python -m pip install "gettext-tstrings[babel]"

آگے کہاں جائیں¶

یہاں سے شروع کیجیے — gettext کا کوئی تجربہ فرض نہیں کیا گیا:

استعمال کیجیے — کام کے حوالہ جات:

سمجھیے — تاریخ سے نفاذ تک:

حوالہ — معاہدے:

حالت¶

ایک الفا۔ معاہدہ جان بوجھ کر چھوٹا رکھا گیا ہے اور تصریح اس کا مستحکم حصہ ہے؛ Python API میں اب بھی تبدیلی ہو سکتی ہے۔ مستحکم ریلیز سے پہلے اسے وسیع تر زبانی فکسچرز، کارکردگی کی مسلسل نگرانی، ان لوگوں کی طرف سے API کا جائزہ جو gettext اور Babel کو سنجیدگی سے برتتے ہیں، اور ہر معاون Python اور Babel ریلیز کے ساتھ مطابقت کی جانچ درکار ہے۔

ایشوز اور پل ریکویسٹ خوش آمدید — الفا ہی وہ وقت ہے جب انٹرفیس پر بحث کرنا اب بھی سود مند ہے۔

کمیونٹی میں شامل ہوں¶

• محدود دائرے کے تعاون کے لیے کوئی good first issue چن لیجیے۔
• استعمال سے متعلق سوالات Q&A Discussions میں پوچھیے۔
• پروڈکشن کے gettext ورک فلو اور API کے خیالات Ideas Discussions میں لائیے۔
• پل ریکویسٹ کھولنے سے پہلے تعاون کا رہنما پڑھ لیجیے۔