প্রোডাকশনে¶

টিউটোরিয়াল লুপটি একবার চালায়, একা, একটিমাত্র বার্তাওয়ালা একটি প্রোগ্রামে। সত্যিকারের প্রকল্পে লুপটি ঘুরতেই থাকে: বার্তা অনূদিত হওয়ার পরেও বদলায়, অনুবাদক কাজ করেন অন্য কোথাও আর নিজের সময়সূচিতে, আর প্রতিটি রিলিজের সঙ্গে একটি কম্পাইল করা ক্যাটালগ পাঠানো হয়। এই পৃষ্ঠা সেই চর্চাটাই — কী রিপোজিটরিতে থাকে, কী যাতায়াত করে, CI-কে কী গেট করতেই হবে, আর রানটাইম কোথায় একটি ভাষা বাঁধে।

সব মিলিয়ে দাঁড়ায় ছয়টি যাচাইয়ে, তাই সেগুলিই আগে দেওয়া হল; নিচের প্রতিটি অংশ তার একটি করে সাজিয়ে দেয়।

• pybabel update --check পাশ করে — ক্যাটালগ না জেনে কোনও বার্তা বদলায়নি।
• pybabel compile তার exit স্ট্যাটাসের উপর বিল্ডটিকে গেট করে।
• বাকি থাকা fuzzy এন্ট্রিগুলি ইচ্ছাকৃত — কোনও অনুবাদক নিশ্চিত না করা পর্যন্ত প্রতিটি উৎস টেক্সট হিসেবেই রেন্ডার হয়।
• টেস্ট সুইট পাঠানো প্রতিটি ভাষা একবার করে strict=True দিয়ে রেন্ডার করে।
• প্রোডাকশন আর্টিফ্যাক্টে .mo ফাইল থাকে, Babel থাকে না।
• gettext_tstrings লগারটি মনিটরিংয়ে পাঠানো হয়।

একটি প্রকল্পের আকৃতি¶

myapp/
├── babel.cfg
├── pyproject.toml
├── src/
│   └── myapp/
└── locales/
    ├── messages.pot
    ├── ja/LC_MESSAGES/messages.po
    └── de/LC_MESSAGES/messages.po

babel.cfg, .pot টেমপ্লেট আর প্রতিটি .po কমিট করুন — এগুলিই অনুবাদ বিল্ডের উৎস, আর এদের diff দেখেই আপনি অনুবাদের বদল রিভিউ করেন। কম্পাইল করা .mo ফাইলগুলি বিল্ড আর্টিফ্যাক্ট: সেগুলি কমিট না করে CI-তে বা প্যাকেজিংয়ের সময় তৈরি করুন, যাতে কী পাঠানো হচ্ছে তা নিয়ে একটি .po আর তার .mo কখনও দ্বিমত হতে না পারে।

একটি ফাইলের দুই দিকেই ভূমিকা আছে: .pot আপনার বার্তাগুলিকে বাইরে নিয়ে যায় অনুবাদকদের কাছে, আর .po ফাইলগুলি অনুবাদ ফিরিয়ে আনে। এই পৃষ্ঠার বাকিটা হল ওই দুইয়ের মধ্যে যা যাতায়াত করে।

flowchart LR
  code["সোর্স কোড<br>t-string কল-সাইট"] -->|"pybabel extract"| pot["messages.pot"]
  pot -->|"pybabel update"| po["প্রতি ভাষায় একটি .po"]
  po --> tr["অনুবাদক<br>বা প্ল্যাটফর্ম"]
  tr --> po
  po -->|"pybabel compile (CI)"| mo[".mo ফাইল"]
  mo --> app["অ্যাপ্লিকেশন<br>রানটাইমে"]

প্রথম অনুবাদের পরের চক্র¶

টিউটোরিয়ালের pybabel init সচরাচর একবারই চলে, যখন একটি ভাষা যোগ হয়। তারপর থেকে কাজের চক্র হল extract → update → translate → compile, আর তার কেন্দ্রে pybabel update, যে নতুন টেমপ্লেটটিকে বিদ্যমান ক্যাটালগে ভাঁজ করে নেয়, সেখানে ইতিমধ্যেই থাকা অনুবাদ ফেলে না দিয়ে।

ধরুন Hello {name} অভিবাদনটি — যার অনুবাদ ইতিমধ্যেই こんにちは {name} — কোডে নতুন ভাষায় লেখা হল Welcome back, {name}। এক্সট্র্যাক্ট ও আপডেট করুন:

$ pybabel extract -F babel.cfg -c "Translators:" -o locales/messages.pot .
extracting messages from app.py (encoding="utf-8")
writing PO template file to locales/messages.pot
$ pybabel update -i locales/messages.pot -d locales
updating catalog locales/ja/LC_MESSAGES/messages.po based on locales/messages.pot

জাপানি ক্যাটালগে এখন আছে:

#. gettext-tstrings
#: app.py:4
#, fuzzy, python-brace-format
msgid "Welcome back, {name}"
msgstr "こんにちは {name}"

Babel লক্ষ করল নতুন msgid-টি সরিয়ে ফেলা একটির সঙ্গে মিলে যায়, আর তাকে পুরনো অনুবাদের সঙ্গে জোড়া বাঁধল — কিন্তু জোড়াটিকে fuzzy চিহ্ন দিল: মানুষের অপেক্ষায় থাকা যন্ত্রের একটি আন্দাজ। এই ফ্ল্যাগ বদলে দেয় কী কম্পাইল হবে। pybabel compile fuzzy এন্ট্রিগুলিকে .mo থেকে বাদ দেয়, তাই কোনও অনুবাদক জোড়াটি নিশ্চিত না করা পর্যন্ত অ্যাপ্লিকেশন পুরনো জাপানি নয়, নতুন ইংরেজি টেক্সটই রেন্ডার করে:

$ pybabel compile -d locales
compiling catalog locales/ja/LC_MESSAGES/messages.po to locales/ja/LC_MESSAGES/messages.mo
$ python app.py
Welcome back, Ada

কাজেই বদলে যাওয়া একটি বার্তা ঠিক সেভাবেই নেমে আসে যেভাবে ভাঙা একটি বার্তা আসে — উৎস ভাষায়, কখনও সেকেলে কোনও অনুবাদে নয়। চক্রে অনুবাদকের ভাগটুকু হল msgstr সংশোধন করা আর fuzzy ফ্ল্যাগ মুছে দেওয়া; পরের কম্পাইল এন্ট্রিটি তুলে নেয়।

CI কী গেট করে¶

তিনটি ব্যর্থতা লাল বিল্ডের যোগ্য: ক্যাটালগ কোডের পিছনে পড়ে গেছে, কোনও অনুবাদ একটি placeholder ভেঙেছে, বা কোনও ভাঙা এন্ট্রি রানটাইম পর্যন্ত গলে গেছে। প্রতিটি ব্যর্থতার জন্য একটি করে ধাপ:

- run: pybabel extract -F babel.cfg -c "Translators:" -o locales/messages.pot .
- run: pybabel update -i locales/messages.pot -d locales --check
- run: pybabel compile -d locales
- run: pytest

pybabel update --check কিছুই নতুন করে লেখে না, আর সদ্য এক্সট্র্যাক্ট করা টেমপ্লেটের তুলনায় কোনও ক্যাটালগ পুরনো হলে non-zero দিয়ে বেরোয় — এটিই সেই পাহারা, যা এমন কোড মার্জ করা আটকায় যার বার্তা কেউ আবার এক্সট্র্যাক্ট করেনি। pybabel compile Babel আর এই প্যাকেজের নিবন্ধিত চেকার — দুইয়েরই placeholder যাচাই চালায়।

শেষ লাইনটি আপনার সাধারণ টেস্ট সুইট, সঙ্গে একটি অভ্যাস যোগ করা: তার কোথাও, প্রতিটি পাঠানো ভাষার অন্তত একটি বার্তা একটি strict translator দিয়ে রেন্ডার করুন —

import gettext

from gettext_tstrings import Translator


def test_catalogs_render(language: str) -> None:
    translations = gettext.translation("messages", localedir="locales", languages=[language])
    _ = Translator(translations, strict=True)
    name = "Ada"
    assert _(t"Welcome back, {name}")

— কারণ strict=True সেখানে এক্সেপশন তোলে যেখানে প্রোডাকশন নীরবে ফলব্যাক করত, আর রানটাইমে একবার রেন্ডার করাই একমাত্র যাচাই যা ক্যাটালগটিকে হুবহু সেভাবেই দেখে যেভাবে অ্যাপ্লিকেশন দেখবে, .mo ও সবকিছুসহ।

অনুবাদক ও প্ল্যাটফর্মের সঙ্গে কাজ¶

.po ফাইল গোটা gettext জগতের বিনিময় ফরম্যাট, আর সেই কারণেই এই লাইব্রেরি তাকে পুনর্ব্যবহার করে: অনুবাদ হস্তান্তর করার অর্থ একটি ফাইল হস্তান্তর করা, প্রাপক PO এডিটরওয়ালা কোনও সহকর্মী হোন বা Weblate কিংবা Crowdin-এর মতো কোনও প্ল্যাটফর্ম। তিনটি জিনিস এই হস্তান্তরকে ভালোভাবে কাজ করায়:

বার্তাটি কীসের জন্য তা বলুন। কোডে লেখা একটি মন্তব্য বার্তার সঙ্গে যাতায়াত করে — -c "Translators:" ফ্ল্যাগ সেটিই জড়ো করে:

from gettext_tstrings import tr

name = "Ada"
# Translators: shown on the dashboard right after sign-in
print(tr(t"Welcome back, {name}"))

#. Translators: shown on the dashboard right after sign-in
#. gettext-tstrings
#: app.py:5
#, python-brace-format
msgid "Welcome back, {name}"
msgstr ""

একজন অনুবাদক পৃথিবীর অন্য প্রান্তে বসে নিজের এডিটরে, বার্তাটির পাশেই ওই মন্তব্য দেখতে পান। গোটা ওয়ার্কফ্লোয় এটিই সবচেয়ে সস্তা গুণমান-লিভার। যে শব্দ নিজেই নিজের সমোচ্চারিত রূপ — বোতাম হিসেবে "Open" বনাম অবস্থা হিসেবে "Open" — তার জন্য pgettext দিয়ে বার্তাটিকে একটি context দিন, যা ক্যাটালগে দৃশ্যমান msgctxt হয়ে ওঠে।

প্ল্যাটফর্মকে placeholder যাচাই করতে দিন। t-string থেকে এক্সট্র্যাক্ট করা প্রতিটি বার্তা python-brace-format ফ্ল্যাগ বহন করে, আর ওই একটি লাইনই আপনার নিয়ন্ত্রণের বাইরে থাকা টুলে placeholder QA চালু করে দেয় — Weblate যাচাইটি নথিভুক্ত করে, বাণিজ্যিক প্ল্যাটফর্মগুলি নিজেদেরটি ওই একই ফ্ল্যাগে বাঁধে, আর msgfmt --check-format যেকোনও GNU পাইপলাইনে তা প্রয়োগ করে। খুঁটিনাটি, আর সঙ্গে দেওয়া চেকার এদের বাইরে আর কী ধরে, তা আছে এক্সট্র্যাকশন পৃষ্ঠায়।

সুরক্ষা-জালকে ঠিক যতটুকু সে যায় ততটুকুই বিশ্বাস করুন। প্ল্যাটফর্ম থেকে যা ফেরে তা আপনার বিল্ডে ঢোকা ডেটাই; উপরের CI গেটগুলিই "প্ল্যাটফর্ম সম্ভবত এটি যাচাই করেছে"-কে "এটি ভাঙা অবস্থায় পাঠানো যাবে না"-তে বদলে দেয়।

রানটাইমে একটি ভাষা বাঁধা¶

এতক্ষণের সবটাই ক্যাটালগ তৈরি করে। বাকি সিদ্ধান্তটি হল অ্যাপ্লিকেশন কোথায় একটি ক্যাটালগ বাছবে। প্রতি ভাষার পরিসরে একবার করে বাঁধুন — CLI-এর জন্য প্রসেস, ওয়েব সার্ভিসের জন্য request।

import gettext

from gettext_tstrings import Translator

_ = Translator(gettext.translation("messages", localedir="locales", fallback=True))

name = "Ada"
print(_(t"Welcome back, {name}"))

import gettext

from flask import Flask, request

from gettext_tstrings import set_translations, tr

LANGUAGES = ("en", "ja", "de")
CATALOGS = {
    language: gettext.translation(
        "messages", localedir="locales", languages=[language], fallback=True
    )
    for language in LANGUAGES
}

app = Flask(__name__)


@app.before_request
def bind_language() -> None:
    language = request.accept_languages.best_match(LANGUAGES) or "en"
    set_translations(CATALOGS[language])


@app.get("/")
def home() -> str:
    name = "Ada"
    return tr(t"Welcome back, {name}")

import gettext

from fastapi import FastAPI, Request

from gettext_tstrings import tr, use_translations

LANGUAGES = ("en", "ja", "de")
CATALOGS = {
    language: gettext.translation(
        "messages", localedir="locales", languages=[language], fallback=True
    )
    for language in LANGUAGES
}

app = FastAPI()


@app.middleware("http")
async def bind_language(request: Request, call_next):
    language = negotiate_language(request.headers.get("accept-language"), LANGUAGES)
    with use_translations(CATALOGS[language]):
        return await call_next(request)

দুটি রানটাইম অভ্যাস ছবিটি সম্পূর্ণ করে। import-সময়ে তৈরি স্ট্রিং — একটি ফর্ম লেবেল, একটি enum-এর প্রদর্শন নাম — import-এর সময় যে ভাষা সক্রিয় ছিল তাকে ধরে রাখতে পারে না; সেগুলি lazy_gettext দিয়ে সংজ্ঞায়িত করুন, তাহলে তারা ব্যবহারের সময় সক্রিয় ভাষাতেই রেন্ডার হবে। আর gettext_tstrings লগারটিকে এমন কোথাও পাঠান যেখানে মানুষ তাকায়: তার সতর্কবার্তাগুলিই শিথিল মোডের রিপোর্ট, প্রতিটি গেট এড়িয়ে যাওয়া কোনও অনুবাদ নিয়ে, প্রতি রেন্ডারে নয়, প্রতি ভাঙা বার্তায় একটি করে লাইন।

পাঠানো¶

প্রোডাকশনের দরকার প্যাকেজটি, .mo ফাইলগুলি, আর কিছুই নয়। Babel একটি ডেভেলপমেন্ট ও CI নির্ভরতা — gettext-tstrings[babel]-কে প্রোডাকশন ইমেজের বাইরে রাখুন আর সেখানে খালি প্যাকেজটিই ইনস্টল করুন; রেন্ডারিং কেবল স্ট্যান্ডার্ড লাইব্রেরিতেই চলে। যে বিল্ড আপনার ডিপ্লয় করা আর্টিফ্যাক্টটি তৈরি করে সেখানেই ক্যাটালগ কম্পাইল করুন, যাতে তার ভিতরের .mo ফাইলগুলি হুবহু সেই রিভিউ করা .po ফাইলই হয়, আর কারও ল্যাপটপে কম্পাইল করা কিছু কখনও পাঠানো না হয়।

এগুলি কীভাবে যাত্রা করে তা নির্ভর করে আপনি কী ডিপ্লয় করছেন তার উপর। একটি wheel এগুলিকে প্যাকেজ ডেটা হিসেবে বয়ে নেয়, অর্থাৎ ক্যাটালগগুলিকে প্যাকেজ ডিরেক্টরির ভিতরে থাকতে হবে — src/myapp/locales/, উপরের স্তরের locales/ নয় — আর বিল্ড ব্যাকএন্ডকে বলে দিতে হবে যে .gitignore সচরাচর যে ফাইলগুলি আড়াল করে সেগুলিও অন্তর্ভুক্ত করতে হবে:

[tool.hatch.build]
# .mo files are build output, so they are gitignored; name them or the
# wheel ships without a single translation.
artifacts = ["src/myapp/locales/**/*.mo"]

[tool.setuptools.package-data]
myapp = ["locales/*/LC_MESSAGES/*.mo"]

সোর্স ট্রি-সাপেক্ষ কোনও পথ দিয়ে নয়, প্যাকেজটির মধ্য দিয়েই এগুলি ফিরে পড়ুন — wheel ইনস্টল হওয়ার মুহূর্তেই সেই পথটির আর অস্তিত্ব থাকে না:

import gettext
from importlib.resources import as_file, files

with as_file(files("myapp") / "locales") as localedir:
    translations = gettext.translation("messages", localedir=localedir, languages=["ja"])

কন্টেইনার ইমেজের কাজটি সহজতর: বিল্ড স্টেজে কম্পাইল করুন আর ফলাফলটি কপি করুন, Babel-কে সেই স্টেজেই ফেলে রেখে।

FROM python:3.14-slim AS build
COPY . /src
RUN cd /src && python -m pip install ".[babel]" \
    && pybabel compile -d src/myapp/locales

FROM python:3.14-slim
COPY --from=build /src /src
RUN python -m pip install /src   # no [babel]: rendering needs the stdlib only

রিলিজের আগে এই পৃষ্ঠাটি যে চেকলিস্টে দাঁড়ায়:

• pybabel update --check পাশ করে — ক্যাটালগ না জেনে কোনও বার্তা বদলায়নি।
• pybabel compile তার exit status-এর উপর বিল্ডকে গেট করে।
• বাকি থাকা fuzzy এন্ট্রিগুলি ইচ্ছাকৃত — কোনও অনুবাদক নিশ্চিত না করা পর্যন্ত প্রতিটিই উৎস টেক্সট হিসেবে রেন্ডার হয়।
• টেস্ট সুইট প্রতিটি পাঠানো ভাষা একবার করে strict=True দিয়ে রেন্ডার করে।
• প্রোডাকশন আর্টিফ্যাক্টে .mo ফাইল আছে, Babel নেই।
• gettext_tstrings লগার মনিটরিংয়ে পাঠানো আছে।

এরপর কোথায়¶

• এক্সট্র্যাকশন — এই পৃষ্ঠার টুলিং-অর্ধেকটির রেফারেন্স: ম্যাপিং অপশন, নিজস্ব ফাংশন নাম, কড়া মোড, আর প্রতিটি চেকার।
• গাইড — রানটাইম-অর্ধেক: বহুবচন, context, deferred স্ট্রিং, আর ব্যর্থতার ধরনগুলি খুঁটিয়ে।
• এটি কীভাবে কাজ করে — msgid কেন দেখতে এমন, আর যাচাই আসলে কী দেখে।