Μεταφράστε πλήρη μηνύματα
με t-strings της Python¶

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 — αυτή είναι έκδοση alpha, και η προδιαγραφή είναι το μέρος της που έχει σταθεροποιηθεί· ή σχεδόν όλο το μεταφράσιμο κείμενό σας ζει σε μια γλώσσα προτύπων και όχι σε πηγαίο κώδικα 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· δεν κάνει escape την αποδιδόμενη έξοδο για HTML, για ένα κέλυφος ή για ένα τερματικό· και δεν μπορεί να κρίνει αν μια μετάφραση είναι σωστή, παρά μόνο αν τα σύμβολα κράτησης θέσης της είναι ανέπαφα.

Εγκατάσταση¶

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 σε περισσότερες γλώσσες, συνεχής παρακολούθηση επιδόσεων, αναθεώρηση του API από ανθρώπους που χρησιμοποιούν στα σοβαρά τα gettext και Babel, και δοκιμές συμβατότητας με κάθε υποστηριζόμενη έκδοση Python και Babel.

Τα Issues και τα Pull Requests είναι ευπρόσδεκτα — μια έκδοση alpha είναι ακριβώς η στιγμή που αξίζει ακόμη να συζητηθεί η διεπαφή.

Γίνετε μέλος της κοινότητας¶

• Διαλέξτε ένα good first issue για μια οριοθετημένη συνεισφορά.
• Κάντε ερωτήσεις χρήσης στα Q&A Discussions.
• Φέρτε ροές εργασίας gettext από την παραγωγή και ιδέες για το API στα Ideas Discussions.
• Διαβάστε τον οδηγό συνεισφοράς πριν ανοίξετε ένα Pull Request.