File: //usr/lib/python3/dist-packages/sphinx/locale/__pycache__/__init__.cpython-310.pyc
o
�$�a�" �
@ s� U d Z ddlZddlZddlmZmZ ddlmZ ddlmZm Z m
Z
m Z m Z m
Z
mZmZ G dd� de�Zee�ae
eeef ef ed<
d0d e e
e d e
e d
ededeeef f
dd�Zd1dedeee e f ddfdd�Zded
edeeef fdd�Zd0d
ededefdd�Zd0d
ededefdd �Zd
eded edefd d �Zd2d
edede fd d!�Z e d �Z e d d"�Z e d#�e d$�e d%�e d&�e d'�e d(�e d)�e d*�e d+�e d,�d-�
Z i Z e
eef ed.< i Z!e
eef ed/< dS )3z�
sphinx.locale
~~~~~~~~~~~~~
Locale utilities.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
UserString� defaultdict)�NullTranslations)�Any�Callable�Dict�Iterable�List�Optional�Tuple�Unionc @ sn e Zd ZdZdZdededefdd�Zde e fdd �Z
dededd
fd d �Z e defd
d��Z
d1dededefdd�Zdee fdd�Zdefdd�Zdedefdd�Zdedefdd�Zdedefd d �Zdedefd d �Zdedefd d!�Zdedefd"d#�Zd$edefd%d&�Zde ee ed'f f fd(d)�Zd*e ee e f dd
fd+d,�Z d2d-d.�Z defd/d0�Z d
S )3�_TranslationProxya
Class for proxy strings from gettext translations. This is a helper for the
lazy_* functions from this module.
The proxy implementation attempts to be as complete as possible, so that
the lazy objects should mostly work as expected, for example for sorting.
This inherits from UserString because some docutils versions use UserString
for their Text nodes, which then checks its argument for being either a
basestring or UserString, otherwise calls str() -- not unicode() -- on it.
��_func�_args�func�args�returnc G s |st |�S t�| �S �N)�str�object�__new__)�clsr r � r �8/usr/lib/python3/dist-packages/sphinx/locale/__init__.pyr s
z_TranslationProxy.__new__c C s | j f| j S r r ��selfr r r �__getnewargs__& s z _TranslationProxy.__getnewargs__Nc G s || _ || _d S r r )r r r r r r �__init__) s
z_TranslationProxy.__init__c C s | j | j� S r r r r r r �data- s z_TranslationProxy.data�encoding�errorsc C s, |r|r | j �||�S | j �|�S | j �� S r )r �encode)r r r! r r r r" 4 s
z_TranslationProxy.encodec C s t t�S r )�dirr r r r r �__dir__= s z_TranslationProxy.__dir__c C s
t | j�S r )r r r r r r �__str__@ �
z_TranslationProxy.__str__�otherc C s
| j | S r �r �r r' r r r �__add__C r& z_TranslationProxy.__add__c C s
|| j S r r( r) r r r �__radd__F r& z_TranslationProxy.__radd__c C s
| j | S r r( r) r r r �__mod__I r& z_TranslationProxy.__mod__c C s
|| j S r r( r) r r r �__rmod__L r& z_TranslationProxy.__rmod__c C s
| j | S r r( r) r r r �__mul__O r& z_TranslationProxy.__mul__c C s
|| j S r r( r) r r r �__rmul__R r& z_TranslationProxy.__rmul__�namec C s |dkr| � � S t| j|�S )N� __members__)r$ �getattrr )r r0 r r r � __getattr__U s z _TranslationProxy.__getattr__.c C s | j | jfS r r r r r r � __getstate__Z � z _TranslationProxy.__getstate__�tupc C s |\| _ | _d S r r )r r6 r r r � __setstate__] s z _TranslationProxy.__setstate__c C s | S r r r r r r �__copy__` s z_TranslationProxy.__copy__c C s4 z
dt t| j�� W S ty d| jj Y S w )N�iz <%s broken>)�reprr r � Exception� __class__�__name__r r r r �__repr__c s
�z_TranslationProxy.__repr__)NN)r r
) r= �
__module__� __qualname__�__doc__� __slots__r r r r r r r �propertyr �bytesr" r r$ r% r* r+ r, r- r r. r/ r3 r4 r7 r8 r> r r r r r
s,
r
� translators�sphinx�general� locale_dirs�language�catalog� namespacer c C s� t �||f�}|jtu rd}d}|r d|v r ||�d�d g}n|r&|g}nd}| D ]!}ztj|||d�}|du r<|}n|�|� W q* tyK Y q*w |du rUt� }d}|t ||f< ||fS )a Look for message catalogs in `locale_dirs` and *ensure* that there is at
least a NullTranslations catalog set in `translators`. If called multiple
times or if several ``.mo`` files are found, their contents are merged
together (thus making ``init`` reentrant).
NT�_r )� localedir� languagesF) rE �getr< r �split�gettext� translation� add_fallbackr; ) rH rI rJ rK �
translator�has_translationrN �dir_�transr r r �initm s0
� � rX �category�valuec C s* z t �| |� W dS t jy Y dS w )a� Update locale settings.
This does not throw any exception even if update fails.
This is workaround for Python's bug.
For more details:
* https://github.com/sphinx-doc/sphinx/issues/5724
* https://bugs.python.org/issue18378#msg215215
.. note:: Only for internal use. Please don't call this method from extensions.
This will be removed in future.
N)�locale� setlocale�Error)rY rZ r r r r\ � s
�r\ �
locale_dirc C s< z
t �t j�\}}W n ty d}Y nw t| g||d�S )z>Initialize locale for console.
.. versionadded:: 1.8
N�console)r[ � getlocale� LC_MESSAGES�AttributeErrorrX )r^ rJ rI rL r r r � init_console� s �rc c C s t || f S r �rE �rJ rK r r r �get_translator� r5 rf c C s || ft v S r rd re r r r �is_translator_registered� r5 rg �messagec C s t | |�}|�|�S )zcUsed instead of _ when creating TranslationProxy, because _ is
not bound yet at that time.
)rf rQ )rJ rK rh rT r r r �_lazy_translate� s
ri c s dt dtdt f� �fdd� }|S )aA Get a translation function based on the *catalog* and *namespace*.
The extension can use this API to translate the messages on the
extension::
import os
from sphinx.locale import get_translation
MESSAGE_CATALOG_NAME = 'myextension' # name of *.pot, *.po and *.mo files
_ = get_translation(MESSAGE_CATALOG_NAME)
text = _('Hello Sphinx!')
def setup(app):
package_dir = os.path.abspath(os.path.dirname(__file__))
locale_dir = os.path.join(package_dir, 'locales')
app.add_message_catalog(MESSAGE_CATALOG_NAME, locale_dir)
With this code, sphinx searches a message catalog from
``${package_dir}/locales/${language}/LC_MESSAGES/myextension.mo``.
The :confval:`language` is used for the searching.
.. versionadded:: 1.8
rh r r c sN t � ��s tt� �| �S t� ��}t|�dkr |�| �S |�| |d |d �S )N� r )rg r
ri rf �lenrQ �ngettext)rh r rT re r r rQ � s
z get_translation.<locals>.gettext)r r )rJ rK rQ r re r �get_translation� s rm r_ � Attention�Caution�Dangerr] �Hint� Important�NotezSee also�Tip�Warning)
� attention�caution�danger�error�hint� important�note�seealso�tip�warning�
versionlabels�pairindextypes)rF rG r )rG )"rA rQ r[ � collectionsr r r �typingr r r r r r
r r r
rE r �__annotations__�boolrX �intr\ rc rf rg ri rm rL �__�admonitionlabelsr� r� r r r r �<module> sJ
( X���
�$* *
�