o ej@sdZddlZddlmZddlmZddlmZddlmZddl m Z m Z m Z m Z ddlmZmZdd lmZmZdd lmZdd lmZmZmZmZdd lmZmZdd lmZddl m!Z!eGdddZ"dVdWddZ#GdddZ$de eeffddZ%de efddZ&de efddZ'ddZ(eddZ)de e*fd d!Z+d"d#Z,d$d%Z-dXd'd(Z.dXd)d*Z/dXd+d,Z0 - /dYd0e*fd1d2Z1d3d4Z2de*fd5d6Z3dVde*fd7d8Z4 & 9dZde*fd:d;Z5dVde*fdd?Z7Gd@dAdAe8Z9de efdBdCZ:de9fdDdEZ;de*fdFdGZde*fdJdKZ?de*fdLdMZ@de!fdNdOZAde!fdPdQZBde!fdRdSZCde!fdTdUZDdS)[u flask_babel ~~~~~~~~~~~ Implements i18n/l10n support for Flask applications based on Babel. :copyright: (c) 2013 by Armin Ronacher, Daniel Neuhäuser. :license: BSD, see LICENSE for more details. N) dataclass)SimpleNamespacedatetime)contextmanager)ListCallableOptionalUnion) TranslationsNullTranslations) current_appg)locked_cached_property)datesnumberssupportLocale)timezoneUTC) ImmutableDict) LazyStringc@sjeZdZUdZeed<eed<eed<eeed<eeed<ded<d Zee ed <d Z ee ed <d S) BabelConfigurationz-Application-specific configuration for Babel.default_localedefault_timezonedefault_domaindefault_directoriestranslation_directoriesBabelinstanceNlocale_selectortimezone_selector) __name__ __module__ __qualname____doc__str__annotations__rr r rr!r(r(DD:\Projects\ConvertPro\env\Lib\site-packages\flask_babel/__init__.pyrs   rreturncCs"|pt}t|ds i|_|jdS)N extensionsbabel)r hasattrr+)appr(r(r) get_babel*s  r/c@seZdZdZeddddddddddddddddZdddZ  dd d ZddZe de fddZ e de fddZ e defddZeddZeddeefddZdS)rzCentral controller class that can be used to configure how Flask-Babel behaves. Each application that wants to use Flask-Babel has to create, or run :meth:`init_app` on, an instance of this class after the configuration was initialized. mediumN)timedaterz time.shortz time.mediumz time.fullz time.longz date.shortz date.mediumz date.fullz date.longzdatetime.shortzdatetime.mediumz datetime.fullz datetime.longTcOs4||_||_|dur|j|g|Ri|dSdS)zCreates a new Babel instance. If an application is passed, it will be configured with the provided arguments. Otherwise, :meth:`init_app` can be used to configure the application later. N)_configure_jinja date_formatsinit_app)selfr.r4Zconfigure_jinjaargskwargsr(r(r)__init__Js zBabel.__init__enmessages translationsrc Cst|dsi|_|jd|d}t|jd||jd||jd||t||||||d|jd<|jd urA|j |_|j ro|j j jtttttttttd |j d |j jd d dd ddd dd dd Sd S)a] Initializes the Babel instance for use with this specific application. :param app: The application to configure :param default_locale: The default locale to use for this application :param default_domain: The default domain to use for this application :param default_translation_directories: The default translation directories to use for this application :param default_timezone: The default timezone to use for this application :param locale_selector: The function to use to select the locale for a request :param timezone_selector: The function to use to select the timezone for a request r+ZBABEL_TRANSLATION_DIRECTORIES;ZBABEL_DEFAULT_LOCALEZBABEL_DEFAULT_TIMEZONEZ BABEL_DOMAIN)rrrrrrr r!r,N) ZdatetimeformatZ dateformatZ timeformatZtimedeltaformatZ numberformatZ decimalformatZcurrencyformatZ percentformatZscientificformatzjinja2.ext.i18ncSs t|SNget_translationsZugettext)sr(r(r)s z Babel.init_app..cSst|||Sr>)r@ ungettext)rApnr(r(r)rBsTcSst||Sr>r@Z upgettext)crAr(r(r)rBscSst||||Sr>)r@ unpgettext)rGrArDrEr(r(r)rBs)gettextngettextZnewstylepgettext npgettext)r-r+configgetsplitrlist_resolve_directoriesr4default_date_formatscopyr3Z jinja_envfiltersupdateformat_datetime format_date format_timeformat_timedelta format_numberformat_decimalformat_currencyformat_percentformat_scientific add_extensionZinstall_gettext_callables) r6r.rrZdefault_translation_directoriesrr r! directoriesr(r(r)r5Xsh   !   zBabel.init_appcCsg}tjD]4}tj|sqt|D]%}tj||d}tj|s%qtddt|Dr9|t |qq|j |vrF||j |S)a>Returns a list of all the locales translations exist for. The list returned will be filled with actual locale objects and not just strings. .. note:: The default locale will always be returned, even if no translation files exist for it. .. versionadded:: 0.6 LC_MESSAGEScss|]}|dVqdS)z.moN)endswith).0xr(r(r) sz*Babel.list_translations..) r/rospathisdirlistdirjoinanyappendrparser)r6resultdirnamefolderZ locale_dirr(r(r)list_translationss     zBabel.list_translationsr*cCsttjS)zeThe default locale from the configuration as an instance of a `babel.Locale` object. )rrmr/rr6r(r(r)rszBabel.default_localecCs ttjS)zhThe default timezone from the configuration as an instance of a `pytz.timezone` object. )rr/rrrr(r(r)rs zBabel.default_timezonecCstjS)z=The message domain for the translations as a string. )r/rrrr(r(r)domainsz Babel.domaincCs t|jdS)z1The message domain for the translations. )rs)Domainrsrrr(r(r)domain_instances zBabel.domain_instancer`ccs>|D]}tj|r|Vq|durtj|j|VqdSr>)rfrgisabsrj root_path)r`r.rgr(r(r)rQs zBabel._resolve_directoriesNNT)r:r;r<rNNr>)r"r#r$r%rrRr9r5rqpropertyrrrrr&rsrru staticmethodrrQr(r(r(r)r1sH  W rcCs tS)zReturns the correct gettext translations that should be used for this request. This will never fail and return a dummy translation object if used outside the request or if a translation cannot be found. ) get_domainr@r(r(r(r)r@s r@cCsnt}|dur dSt|dd}|dur5t}|jdur |jj}n|}|dur-|jj}nt|}||_|S)zReturns the locale that should be used for this request as `babel.Locale` object. This returns `None` if used outside a request. N babel_locale) _get_current_contextgetattrr/r rrrrmr|)ctxlocaler,rvr(r(r) get_locales     rcCsnt}t|dd}|dur5t}|jdur|jj}n|}|dur'|jj}n t|tr0t|n|}||_ |S)zReturns the timezone that should be used for this request as a `pytz.timezone` object. This returns `None` if used outside a request. babel_tzinfoN) r}r~r/r!rr isinstancer&rr)rtzinfor,rr(r(r) get_timezones    rcCs>t}dD] }t||rt||qt|dr|j|_dSdS)aRefreshes the cached timezones and locale information. This can be used to switch a translation between a request and if you want the changes to take place immediately, not just with the next request:: user.timezone = request.form['timezone'] user.locale = request.form['locale'] refresh() flash(gettext('Language was changed')) Without that refresh, the :func:`~flask.flash` function would probably return English text and a now German page. )r|rbabel_translationsforced_babel_localeN)r}r-delattrrr|)rkeyr(r(r)refresh%s     rc cst}|dur dVdSi}dD] }t||d||<qz)t||_|j|_d|_dVWt|dr5|`|D] \}}t |||q9dSt|drM|`|D] \}}t |||qQw)aTemporarily overrides the currently selected locale. Sometimes it is useful to switch the current locale to different one, do some tasks and then revert back to the original one. For example, if the user uses German on the website, but you want to email them in English, you can use this function as a context manager:: with force_locale('en_US'): send_email(gettext('Hello!'), ...) :param locale: The locale to temporary switch to (ex: 'en_US'). N)rr|r) r}r~rrmr|rrr-itemssetattr)rrZ orig_attrsrvaluer(r(r) force_locale;s.   rcCsFt}|dur |jj|}|dvr!|jjd||f}|dur!|}|S)zmA small helper for the datetime formatting functions. Looks up format defaults for different kinds. N)Zshortr0fulllongz%s.%s)r/rr4)rformatr,rr(r(r) _get_format_s rcCs,|jdur |jtd}t}|||S)a2Convert a datetime object to the user's timezone. This automatically happens on all date formatting unless rebasing is disabled. If you need to convert a :class:`datetime.datetime` object at any time to the user's timezone (as returned by :func:`get_timezone`) this function can be used. Nr)rreplacerr normalize astimezone)rrr(r(r)to_user_timezonems  rcCs(|jdur t|}|tjddS)zwConvert a datetime object to UTC and drop tzinfo. This is the opposite operation to :func:`to_user_timezone`. Nr)rrlocalizerrrrr(r(r)to_utcys  rTcCtd|}ttj|||S)aReturn a date formatted according to the given pattern. If no :class:`~datetime.datetime` object is passed, the current time is assumed. By default, rebasing happens, which causes the object to be converted to the user's timezone (as returned by :func:`to_user_timezone`). This function formats both date and time. The format parameter can either be ``'short'``, ``'medium'``, ``'long'`` or ``'full'`` (in which case the language's default for that setting is used, or the default from the :attr:`Babel.date_formats` mapping is used) or a format string as documented by Babel. This function is also available in the template context as filter named `datetimeformat`. r)r _date_formatrrV)rrrebaser(r(r)rVs rVcCs0|r t|tr t|}td|}ttj|||S)aReturn a date formatted according to the given pattern. If no :class:`~datetime.datetime` or :class:`~datetime.date` object is passed, the current time is assumed. By default, rebasing happens, which causes the object to be converted to the users's timezone (as returned by :func:`to_user_timezone`). This function only formats the date part of a :class:`~datetime.datetime` object. The format parameter can either be ``'short'``, ``'medium'``, ``'long'`` or ``'full'`` (in which case the language's default for that setting is used, or the default from the :attr:`Babel.date_formats` mapping is used) or a format string as documented by Babel. This function is also available in the template context as filter named `dateformat`. r2)rrrrrrrW)r2rrr(r(r)rWs rWcCr)aReturn a time formatted according to the given pattern. If no :class:`~datetime.datetime` object is passed, the current time is assumed. By default, rebasing happens, which causes the object to be converted to the user's timezone (as returned by :func:`to_user_timezone`). This function formats both date and time. The format parameter can either be ``'short'``, ``'medium'``, ``'long'`` or ``'full'`` (in which case the language's default for that setting is used, or the default from the :attr:`Babel.date_formats` mapping is used) or a format string as documented by Babel. This function is also available in the template context as filter named `timeformat`. r1)rrrrX)r1rrr(r(r)rXs rXsecondF333333? granularitycCs,t|tr t|}tj||||tdS)zFormat the elapsed time from the given date to now or the given timedelta. This function is also available in the template context as filter named `timedeltaformat`. ) threshold add_directionr)rrutcnowrrYr)Zdatetime_or_timedeltarrrr(r(r)rYs  rYcKs8t}i}|tjur|rt|d<|||fd|i|S)z&Internal helper that formats the date.rr)rrrWr) formatterobjrrextrarr(r(r)rs  rcCst}tj||dS)zReturn the given number formatted for the locale in request :param number: the number to format :return: the formatted number :rtype: unicode )rrrr[)numberrr(r(r)rZsrZcCt}tj|||dS)zReturn the given decimal number formatted for the locale in the request. :param number: the number to format :param format: the format to use :return: the formatted number :rtype: unicode rrrrrrr(r(r)r[r[standardcCst}tj||||||dS)uReturn the given number formatted for the locale in the request. :param number: the number to format :param currency: the currency code :param format: the format to use :param currency_digits: use the currency’s number of decimal digits [default: True] :param format_type: the currency format type to use [default: standard] :return: the formatted number :rtype: unicode )rrcurrency_digits format_type)rrr\)rcurrencyrrrrr(r(r)r\sr\cCr)zReturn formatted percent value for the locale in the request. :param number: the number to format :param format: the format to use :return: the formatted percent number :rtype: unicode r)rrr]rr(r(r)r] rr]cCr)zReturn value formatted in scientific notation for the locale in request :param number: the number to format :param format: the format to use :return: the formatted percent number :rtype: unicode r)rrr^rr(r(r)r^rr^c@s~eZdZdZdddZddZedd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZddZddZddZdS)rtaLocalization domain. By default, it will look for translations in the Flask application directory and "messages" domain - all message catalogs should be called ``messages.mo``. Additional domains are supported passing a list of domain names to the ``domain`` argument, but note that in this case they must match a list passed to ``translation_directories``, eg:: Domain( translation_directories=[ "/path/to/translations/with/messages/domain", "/another/path/to/translations/with/another/domain", ], domains=[ "messages", "myapp", ] ) Nr;cCs,t|tr|g}||_|d|_i|_dS)Nr=)rr&_translation_directoriesrOrscache)r6rrsr(r(r)r98s   zDomain.__init__cCsd|j|jS)Nz)rrrsrrr(r(r)__repr__AszDomain.__repr__cCs|jdur|jStjSr>)rr/rrrr(r(r)rGs zDomain.translation_directoriescCs t}|dur td||_dS)z2Set this domain as default for the current requestNzNo request context)r} RuntimeError babel_domainr6rr(r(r) as_defaultMs zDomain.as_defaultcCs|jS)z6Returns dictionary-like object for translation caching)rrr(r(r)get_translations_cacheVszDomain.get_translations_cachec Cst}|dur tS||}t}z |t||jdfWStykt}t |j D],\}}t |jdkr?|jdn|j|}tj ||g|}| |t|dr[|j|_q/||t||jdf<|YSw)Nrplural)r}rr rrr&rsKeyErrorr enumeraterlenloadmerger-r) r6rrrr<indexrorscatalogr(r(r)r@Zs4     zDomain.get_translationscKs"|}||}|s |S||S)zTranslates a string with the current locale and passes in the given keyword arguments as mapping to a string formatting string. :: gettext(u'Hello World!') gettext(u'Hello %(name)s!', name='World') r?)r6string variablestrAr(r(r)rIs zDomain.gettextcKs2|d||}||||}|s|S||S)a Translates a string with the current locale and passes in the given keyword arguments as mapping to a string formatting string. The `num` parameter is used to dispatch between singular and various plural forms of the message. It is available in the format string as ``%(num)d`` or ``%(num)s``. The source language should be English or a similar language which only has one plural form. :: ngettext(u'%(num)d Apple', u'%(num)d Apples', num=len(apples)) num) setdefaultr@rC)r6singularrrrrrAr(r(r)rJs zDomain.ngettextcKs$|}|||}|s|S||S)zPLike :func:`gettext` but with a context. .. versionadded:: 0.7 rF)r6contextrrrrAr(r(r)rKs zDomain.pgettextcKs4|d||}|||||}|s|S||S)zQLike :func:`ngettext` but with a context. .. versionadded:: 0.7 r)rr@rH)r6rrrrrrrAr(r(r)rLs zDomain.npgettextcKst|j|fi|S)a-Like :func:`gettext` but the string returned is lazy which means it will be translated when it is used as an actual string. Example:: hello = lazy_gettext(u'Hello World') @app.route('/') def index(): return unicode(hello) rrI)r6rrr(r(r) lazy_gettexts zDomain.lazy_gettextcKst|j|||fi|S)aLike :func:`ngettext` but the string returned is lazy which means it will be translated when it is used as an actual string. Example:: apples = lazy_ngettext( u'%(num)d Apple', u'%(num)d Apples', num=len(apples) ) @app.route('/') def index(): return unicode(apples) rrJ)r6rrrrr(r(r) lazy_ngettextszDomain.lazy_ngettextcKst|j||fi|S)zLike :func:`pgettext` but the string returned is lazy which means it will be translated when it is used as an actual string. .. versionadded:: 0.7 rrK)r6rrrr(r(r) lazy_pgettextszDomain.lazy_pgettext)Nr;)r"r#r$r%r9rryrrrr@rIrJrKrLrrrr(r(r(r)rt#s     %    rtcCs tsdSttds tt_tjS)N _flask_babel)rr-rrr(r(r(r)r}s  r}cCsBt}|dur tSz|jWStyYnwtjj|_|jSr>)r}rtrAttributeErrorr/rru)rr(r(r)r{s  r{cOtj|i|Sr>)r{rIr7r8r(r(r)rIrIcOrr>)r{rJrr(r(r)rJrrJcOrr>)r{rKrr(r(r)rKrrKcOrr>)r{rLrr(r(r)rLrrLcOttg|Ri|Sr>rrr(r(r)rrcOrr>rrr(r(r)r rrcOrr>rrr(r(r)rrrcOrr>)rrLrr(r(r)lazy_npgettextrrr>)r*rrx)rFr)NTr)Er%rf dataclassesrtypesrr contextlibrtypingrrr r Z babel.supportr r Zflaskr rZ flask.helpersrr,rrrrZpytzrrZwerkzeug.datastructuresrZflask_babel.speaklaterrrr/rr@rrrrr&rrrrVrWrXrYrrZr[r\r]r^objectrtr}r{rI_rJrKrLrrrrr(r(r(r)sr        A #        7