B `;@sddlZddlZddlmZmZddlmZddlmZddlmZddl m Z m Z m Z ddl mZeZeZdd ZGd d d Zd d ZddZddZddZddZGdddejZGdddZdS)N) Pluralizer Translator)TranslationString)TranslationStringFactory)reify)ILocaleNegotiator ILocalizerITranslationDirectories)get_current_registrycCs t|dkS)N)int)nrT/home/kop/projects/devel/pgwui/test_venv/lib/python3.7/site-packages/pyramid/i18n.pyrc@s,eZdZdZddZd ddZd ddZdS) Localizerz An object providing translation and pluralizations related to the current request's locale name. A :class:`pyramid.i18n.Localizer` object is created using the :func:`pyramid.i18n.get_localizer` function. cCs||_||_d|_d|_dS)N) locale_name translations pluralizer translator)selfrrrrr__init__szLocalizer.__init__NcCs&|jdkrt|j|_|j|||dS)a@ Translate a :term:`translation string` to the current language and interpolate any *replacement markers* in the result. The ``translate`` method accepts three arguments: ``tstring`` (required), ``domain`` (optional) and ``mapping`` (optional). When called, it will translate the ``tstring`` translation string using the current locale. If the current locale could not be determined, the result of interpolation of the default value is returned. The optional ``domain`` argument can be used to specify or override the domain of the ``tstring`` (useful when ``tstring`` is a normal string rather than a translation string). The optional ``mapping`` argument can specify or override the ``tstring`` interpolation mapping, useful when the ``tstring`` argument is a simple string instead of a translation string. Example:: from pyramid.i18n import TranslationString ts = TranslationString('Add ${item}', domain='mypackage', mapping={'item':'Item'}) translated = localizer.translate(ts) Example:: translated = localizer.translate('Add ${item}', domain='mypackage', mapping={'item':'Item'}) N)domainmapping)rrr)rZtstringrrrrr translate#s  zLocalizer.translatecCs*|jdkrt|j|_|j|||||dS)a Return a string translation by using two :term:`message identifier` objects as a singular/plural pair and an ``n`` value representing the number that appears in the message using gettext plural forms support. The ``singular`` and ``plural`` objects should be strings. There is no reason to use translation string objects as arguments as all metadata is ignored. ``n`` represents the number of elements. ``domain`` is the translation domain to use to do the pluralization, and ``mapping`` is the interpolation mapping that should be used on the result. If the ``domain`` is not supplied, a default domain is used (usually ``messages``). Example:: num = 1 translated = localizer.pluralize('Add ${num} item', 'Add ${num} items', num, mapping={'num':num}) If using the gettext plural support, which is required for languages that have pluralisation rules other than n != 1, the ``singular`` argument must be the message_id defined in the translation file. The plural argument is not used in this case. Example:: num = 1 translated = localizer.pluralize('item_plural', '', num, mapping={'num':num}) N)rr)rrr)rsingularpluralr rrrrr pluralizeDs'  zLocalizer.pluralize)NN)NN)__name__ __module__ __qualname____doc__rrrrrrrrs !rcCs<d}t||d}|dkr8|j|}|dkr8|j|}|S)aThe default :term:`locale negotiator`. Returns a locale name or ``None``. - First, the negotiator looks for the ``_LOCALE_`` attribute of the request object (possibly set by a view or a listener for an :term:`event`). If the attribute exists and it is not ``None``, its value will be used. - Then it looks for the ``request.params['_LOCALE_']`` value. - Then it looks for the ``request.cookies['_LOCALE_']`` value. - Finally, the negotiator returns ``None`` if the locale could not be determined via any of the previous checks (when a locale negotiator returns ``None``, it signifies that the :term:`default locale name` should be used.) Z_LOCALE_N)getattrparamsgetcookies)requestnamerrrrdefault_locale_negotiatorrs   r)cCs^y |j}Wntk r$t}YnX|jttd}||}|dkrZ|jpLi}|dd}|S)zUNegotiate and return the :term:`locale name` associated with the current request.)defaultNZdefault_locale_nameen)registryAttributeErrorr queryUtilityrr)settingsr%)r'r,Z negotiatorrr/rrrnegotiate_locale_names     r0cCs|jS)z .. deprecated:: 1.5 Use :attr:`pyramid.request.Request.locale_name` directly instead. Return the :term:`locale name` associated with the current request. )r)r'rrrget_locale_namesr1c Cs2t}i|_g}d|kr(|ddg}||x|D]}g}x8|D]0}tjtj||}tj|rF||qFWx|D]}tj|d} tjtj| sqxtt | D]f} tjtj| | } | drtj | rt | d&} | dd} t| | }| |WdQRXqWqWq8Wt||dS) zCreate a :class:`pyramid.i18n.Localizer` object corresponding to the provided locale name from the translations found in the list of translation directories._r LC_MESSAGESz.morbN)rr) Translations_catalogsplitappendospathrealpathjoinisdirlistdirendswithisfileopenaddr)current_locale_nameZtranslation_directoriesrZlocales_to_tryZtdirZ locale_dirslnameZldirZ locale_dirZ messages_dirmofileZmopathZmofprZdtransrrrmake_localizers2        rGcCs|jS)z .. deprecated:: 1.5 Use the :attr:`pyramid.request.Request.localizer` attribute directly instead. Retrieve a :class:`pyramid.i18n.Localizer` object corresponding to the current request's locale name. ) localizer)r'rrr get_localizersrIc@seZdZdZdZdefddZeddefddZdd Zdd d Z d dZ ddZ ddZ ddZ ddZddZddZdS)r6z>An extended translation catalog class (ripped off from Babel) messagesNcCs@t|_tjj||dttdt|ddg|_||_ i|_ dS)zInitialize the translations catalog. :param fileobj: the file-like object the translation should be read from )fpNr() DEFAULT_PLURALrgettextGNUTranslationsrlistfilterr#filesr_domains)rfileobjrrrrrs zTranslations.__init__c Csp|dk r*t|ttfs|g}dd|D}|s4|j}t|||}|sNtSt|d}|||dSQRXdS)aLoad translations from the given directory. :param dirname: the directory containing the ``MO`` files :param locales: the list of locales in order of preference (items in this list can be either `Locale` objects or locale strings) :param domain: the message domain :return: the loaded catalog, or a ``NullTranslations`` instance if no matching translations were found :rtype: `Translations` NcSsg|] }t|qSr)str).0localerrr sz%Translations.load..r4)rSr) isinstancerOtupleDEFAULT_DOMAINrMfindNullTranslationsrB)clsdirnameZlocalesrfilenamerKrrrloads  zTranslations.loadcCsdt|j|jdfS)Nz <%s: "%s">zproject-id-version)typer_infor%)rrrr__repr__szTranslations.__repr__TcCs~t|d|j}||jkr*|jtkr*|j|_|rB||jkrB||S|j|}|rf|dk rf||n||||j|<|S)aAdd the given translations to the catalog. If the domain of the translations is different than that of the current catalog, they are added as a catalog that is only accessible by the various ``d*gettext`` functions. :param translations: the `Translations` instance with the messages to add :param merge: whether translations for message domains that have already been added should be merged with the existing translations :return: the `Translations` instance (``self``) so that `merge` calls can be easily chained :rtype: `Translations` rN) r#rZrrLrmergerRr% add_fallback)rrrdrexistingrrrrCs      zTranslations.addcCs6t|tjr2|j|jt|tr2|j|j|S)aMerge the given translations into the catalog. Message translations in the specified catalog override any messages with the same identifier in the existing catalog. :param translations: the `Translations` instance with the messages to merge :return: the `Translations` instance (``self``) so that `merge` calls can be easily chained :rtype: `Translations` )rXrMrNr7updater6rQextend)rrrrrrd9s  zTranslations.mergecCs|j|||S)zULike ``gettext()``, but look the message up in the specified domain. )rRr%rM)rrmessagerrrdgettextLszTranslations.dgettextcCs|j|||S)zVLike ``lgettext()``, but look the message up in the specified domain. )rRr%lgettext)rrrirrr ldgettextRszTranslations.ldgettextcCs|j|||S)zVLike ``ugettext()``, but look the message up in the specified domain. )rRr%rM)rrrirrr dugettextXszTranslations.dugettextcCs|j|||||S)zVLike ``ngettext()``, but look the message up in the specified domain. )rRr%ngettext)rrrrnumrrr dngettext^szTranslations.dngettextcCs|j|||||S)zWLike ``lngettext()``, but look the message up in the specified domain. )rRr% lngettext)rrrrrorrr ldngettextdszTranslations.ldngettextcCs|j|||||S)zVLike ``ungettext()`` but look the message up in the specified domain. )rRr%rn)rrrrrorrr dungettextjszTranslations.dungettext)T)rr r!r"rZr classmethodr`rcrCrdrjrlrmrprrrsrrrrr6s r6c@s$eZdZeddZeddZdS)LocalizerRequestMixincCsN|j}|j}|jt|d}|dkrJ|jtgd}t||}|j|t|d|S)z, Convenience property to return a localizer )r(N)r*)r,rr.rr rGZregisterUtility)rr,rDrHZtdirsrrrrHrs  zLocalizerRequestMixin.localizercCs t|}|S)N)r0)rrrrrrsz!LocalizerRequestMixin.locale_nameN)rr r!rrHrrrrrruqs ru)rMr:ZtranslationstringrrrrZpyramid.decoratorrZpyramid.interfacesrrr Zpyramid.threadlocalr rLrr)r0r1rGrIrNr6rurrrrs&    ] ,