Python t-strings के साथ
पूरे संदेशों का अनुवाद¶

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 वर्कफ़्लो अपनाना चाहते हैं; और आपको नामित placeholders वाला t-string सिंटैक्स चाहिए जिनकी जाँच रेंडर होने से पहले हो जाए।

अभी उपयुक्त नहीं है जब आपको Python 3.13 या पुराना चाहिए; आपको स्थिर Python API चाहिए — यह एक alpha है, और विनिर्देश ही इसका वह हिस्सा है जो ठहर चुका है; या आपका लगभग सारा अनुवाद-योग्य टेक्स्ट Python स्रोत के बजाय किसी टेम्पलेट भाषा में रहता है।

पहले से कैटलॉग हैं? वे चलते रहेंगे। _("Hello {name}").format(name=name) और tr(t"Hello {name}") एक ही msgid बनाते हैं, इसलिए मौजूदा अनुवाद इस बदलाव के बाद भी बचे रहते हैं — माइग्रेशन पूरी प्रक्रिया समझाता है।

कैटलॉग क्या कह सकता है¶

कोई अनुवाद उस संदेश की संरचना नहीं बदल सकता जिसका वह अनुवाद कर रहा है। पूरा वादा यही है, और इस साइट का बाक़ी सब कुछ इसी से निकलता है। अनुवाद {name} का क्रम बदल सकता है या उसे दोहरा सकता है, और उसके आसपास का हर दूसरा शब्द फिर से लिख सकता है। लेकिन वह placeholder को छोड़ नहीं सकता, नया गढ़ नहीं सकता, उसके ज़रिए आपके ऑब्जेक्ट्स तक नहीं पहुँच सकता, और अपनी ओर से फ़ॉर्मैटिंग नहीं जोड़ सकता।

लाइब्रेरी इसकी जाँच अंदर आते समय करती है — जब कैटलॉग कंपाइल होते हैं — और फिर रेंडर के समय भी, और यही वह अंतर है जो समीक्षा में पकड़ी गई ग़लती और उपयोगकर्ता द्वारा पकड़ी गई ग़लती के बीच है।

यह जिस समस्या को हल करती है¶

कोई f-string किसी भी लाइब्रेरी तक पहुँचने से पहले ही इंटरपोलेट हो चुका होता है — f"Hello {name}" तब तक "Hello Ada" बन चुका है, और value के आसपास के टुकड़ों का अनुवाद अधिकांश भाषाओं का व्याकरण तोड़ देता है। एक t-string (PEP 750) स्थिर टेक्स्ट, मूल्यांकित values, स्रोत एक्सप्रेशन, कन्वर्ज़न और फ़ॉर्मैट स्पेक को अलग-अलग रखता है — और यही वह विभाजन है जिसकी संदेश कैटलॉग को ज़रूरत होती है। %(name)s, .format() और $-strings की तुलना में इससे क्या बदलता है।

पर gettext या Babel में कहीं नहीं लिखा कि t-string संदेश कैसे बनता है। यह लाइब्रेरी वह चुनाव करती है, उसे एक संस्करणित विनिर्देश के रूप में दर्ज करती है, और उसकी जाँच के लिए कन्फ़ॉर्मन्स सुइट भी देती है।

डिज़ाइन के नियम¶

• हमेशा पूरे संदेशों का अनुवाद, वाक्य के टुकड़ों का कभी नहीं।
• केवल {name} जैसे सरल वेरिएबल नाम स्वीकार किए जाते हैं।
• !r और :.2f एप्लिकेशन के नियंत्रण में रहते हैं, कैटलॉग से बाहर।
• अनुवादों को ज्ञात placeholders का क्रम बदलने और उन्हें दोहराने की छूट, पर attributes तक पहुँचने या फ़ॉर्मैटिंग जोड़ने से रोक।
• साधारण POT, PO और MO फ़ाइलें, और उन्हें पहले से पढ़ने वाले टूल, ज्यों के त्यों पुन: उपयोग होते हैं।

और उसी के साथ वह सूची जिसे यह जान-बूझकर नहीं छूती: यह संख्याओं, मुद्राओं या तिथियों का स्थानीयकरण नहीं करती — उन्हें पहले फ़ॉर्मैट करें, Babel के साथ; यह रेंडर किए गए आउटपुट को HTML, शेल या टर्मिनल के लिए एस्केप नहीं करती; और यह नहीं आँक सकती कि कोई अनुवाद सही है या नहीं, केवल यह कि उसके placeholders बरकरार हैं या नहीं।

इंस्टॉल¶

python -m pip install gettext-tstrings

Python 3.14 या नया चाहिए। रेंडरिंग की कोई निर्भरता नहीं है — वह मानक लाइब्रेरी के gettext का उपयोग करती है, और कुछ नहीं।

एक्सट्रैक्शन और कैटलॉग सत्यापन Babel के ज़रिए चलते हैं, इसलिए यह extra वहाँ इंस्टॉल करें जहाँ pybabel चलता है — आम तौर पर विकास या CI परिवेश, प्रोडक्शन इमेज नहीं:

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

आगे कहाँ जाएँ¶

यहाँ से शुरू करें — gettext का कोई अनुभव अपेक्षित नहीं:

इसका उपयोग — कामकाजी संदर्भ:

इसे समझना — इतिहास से क्रियान्वयन तक:

संदर्भ — अनुबंध:

स्थिति¶

यह एक alpha है। अनुबंध जान-बूझकर छोटा रखा गया है और विनिर्देश उसका स्थिर हिस्सा है; Python API अभी बदल सकती है। स्थिर रिलीज़ से पहले इसे और भाषाओं के fixtures, निरंतर प्रदर्शन ट्रैकिंग, gettext और Babel के गंभीर उपयोगकर्ताओं से API समीक्षा, और हर समर्थित Python तथा Babel रिलीज़ पर संगतता परीक्षण चाहिए।

Issues और pull requests का स्वागत है — alpha ही वह समय है जब इंटरफ़ेस पर बहस करना सार्थक होता है।

समुदाय से जुड़ें¶

• किसी सीमित योगदान के लिए एक good first issue चुनें।
• उपयोग से जुड़े प्रश्न Q&A Discussions में पूछें।
• प्रोडक्शन के gettext वर्कफ़्लो और API सुझाव Ideas Discussions में लाएँ।
• Pull request खोलने से पहले योगदान गाइड पढ़ें।