File: //usr/lib/python3/dist-packages/sphinx/builders/__pycache__/gettext.cpython-310.pyc
o
u�a�, � @ sT d Z ddlmZ ddlmZmZ ddlmZmZmZ ddl m
Z
m Z m Z ddl
m
Z
ddlmZmZmZmZmZmZmZmZmZ ddlmZ dd lmZ dd
l m Z dd l m Z m Z dd l!m"Z" dd
l#m$Z$ ddl%m&Z& ddl'm(Z( ddl)m*Z* ddl+m,Z,m-Z-m.Z. ddl/m0Z0 ddl1m2Z2m3Z3 ddl4m5Z5m6Z6 ddl7m8Z8m9Z9m:Z: ddl;m<Z< ddl=m>Z> e,�?e@�ZAG dd� d�ZBG dd� d�ZCG d d � d �ZDG d d � d e>�ZEG d d!� d!e<�ZFG d"d#� d#e$�ZGe
� ZHe�IeH�e�JeH� ZKe
d$�ZLeLd%ur�eMeL�ZHed�ZKG d&d'� d'e�ZNeN� ZOd(ePd)ePd*eQfd+d,�ZRG d-d.� d.eG�ZSd/e"d*eePef fd0d1�ZTd%S )2z�
sphinx.builders.gettext
~~~~~~~~~~~~~~~~~~~~~~~
The MessageCatalogBuilder class.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�open)� OrderedDict� defaultdict)�datetime� timedelta�tzinfo)�getenv�path�walk)�time) �Any� DefaultDict�Dict� Generator�Iterable�List�Set�Tuple�Union)�uuid4)�nodes)�Element)�addnodes� package_dir)�Sphinx)�Builder)�pairindextypes)�
ThemeError)�__)�logging�split_index_msg�status_iterator)�bold)� CatalogInfo�docname_to_domain)�extract_messages�traverse_translatable_index)�
canon_path� ensuredir�relpath)�Tags)�SphinxRendererc @ s6 e Zd ZdZdedeeeef dee fdd�ZdS )�Messagez!An entry of translatable message.�text� locations�uuidsc C s || _ || _|| _d S �N)r- r. r/ )�selfr- r. r/ � r2 �9/usr/lib/python3/dist-packages/sphinx/builders/gettext.py�__init__) s
zMessage.__init__N) �__name__�
__module__� __qualname__�__doc__�strr r �intr4 r2 r2 r2 r3 r, ' s *r, c @ sP e Zd ZdZd
dd�Zdedeedf ddfd d
�Zde e
ddf fd d �Z dS )�Catalogz!Catalog of translatable messages.�returnNc C s g | _ t� | _d S r0 )�messagesr �metadata�r1 r2 r2 r3 r4 2 s zCatalog.__init__�msg�origin� MsgOriginc C sN t |d�sd S || jvr| j�|� g | j|< | j| �|j|j|jf� d S )N�uid)�hasattrr> r= �append�source�linerC )r1 r@ rA r2 r2 r3 �add8 s
z Catalog.addc c sH � | j D ] }dd� | j| D �}dd� | j| D �}t|||�V qd S )Nc S s g | ] \}}}||f�qS r2 r2 ��.0rF rG �uuidr2 r2 r3 �
<listcomp>D s z$Catalog.__iter__.<locals>.<listcomp>c S s g | ]\}}}|�qS r2 r2 rI r2 r2 r3 rL E s )r= r> r, )r1 �message� positionsr/ r2 r2 r3 �__iter__B s �
�zCatalog.__iter__�r< N) r5 r6 r7 r8 r4 r9 r r rH r r, rO r2 r2 r2 r3 r; / s
r; c @ s& e Zd ZdZdededdfdd�ZdS )rB z3
Origin holder for Catalog message origin.
rF rG r< Nc C s || _ || _t� j| _d S r0 )rF rG r �hexrC )r1 rF rG r2 r2 r3 r4 N s zMsgOrigin.__init__)r5 r6 r7 r8 r9 r: r4 r2 r2 r2 r3 rB I s rB c sF e Zd Zd dededdf� fdd�
Zdededef� fd d
� Z� ZS ) �GettextRendererN�
template_path�outdirr< c sV || _ |d u rt�tdd�}t� �|� dtdtfdd�}|| jjd< || jjd< d S ) N� templates�gettext�sr< c S s$ | � dd�} | � dd�} | � dd�S )N�\z\\�"z\"�
z\n"
")�replace�rW r2 r2 r3 �escape[ s z(GettextRenderer.__init__.<locals>.escape�er] ) rT r �joinr �superr4 r9 �env�filters)r1 rS rT r] �� __class__r2 r3 r4 U s zGettextRenderer.__init__�filename�contextc s, dt dt f� fdd� }||d< t� �||�S )NrW r< c s t t| � j��S r0 )r' r) rT r\ r? r2 r3 �_relpathe s z(GettextRenderer.render.<locals>._relpathr) )r9 r` �render)r1 re rf rg rc r? r3 rh d s zGettextRenderer.render)NN)r5 r6 r7 r9 r4 r rh �
__classcell__r2 r2 rc r3 rR T s "rR c @ s" e Zd ZdZdedefdd�ZdS )�I18nTagsz�Dummy tags module for I18nBuilder.
To translate all text inside of only nodes, this class
always returns True value even if no tags are defined.
� conditionr< c C � dS )NTr2 )r1 rk r2 r2 r3 �eval_conditionr � zI18nTags.eval_conditionN)r5 r6 r7 r8 r �boolrm r2 r2 r2 r3 rj l s rj c s� e Zd ZU dZdZdZdZeed< dZ d� fdd � Z
dd
e d e de fd d
�Z de
e fdd�Zde
e ddfdd�Zde
e de ddfdd�Zd
e dejddfdd�Z� ZS ) � I18nBuilderz
General i18n builder.
�i18nr- N�versioning_compareFr< c s6 t � �� | j�| j| jjj� t� | _t t
�| _ d S r0 ) r` �initra �set_versioning_method�versioning_method�config� gettext_uuidrj �tagsr r; �catalogsr? rc r2 r3 rs s
�zI18nBuilder.init�docname�typc C rl )N� r2 )r1 rz r{ r2 r2 r3 �get_target_uri� rn zI18nBuilder.get_target_uric C s | j jS r0 )ra �
found_docsr? r2 r2 r3 �get_outdated_docs� � z I18nBuilder.get_outdated_docs�docnamesc C � d S r0 r2 )r1 r� r2 r2 r3 �prepare_writing� rn zI18nBuilder.prepare_writingry rM c C r� r0 r2 )r1 ry rM r2 r2 r3 �compile_catalogs� rn z I18nBuilder.compile_catalogs�doctreec
C s� | j t|| jj� }| jj| �tj�D ]}t |�D ]
\}}d|_
|� ||� qqt |�D ]
\}}|� ||� q-d| jjj v rkt
|�D ])\}}|D ] \}}} }
} t||�D ]} |dkrb| t�� v rbqU|� | |� qUqIqCd S d S )Nr| �index�pair)ry r$ rv �gettext_compactra �tocs�traverser �toctreer% rC rH �gettext_additional_targetsr& r r �values)
r1 rz r� �catalogr� �noder@ �entriesr{ �tid�main�key_�mr2 r2 r3 � write_doc� s& ����zI18nBuilder.write_docrP r0 )r5 r6 r7 r8 �nameru rr ro �__annotations__�use_message_catalogrs r9 r} r r r� r# r� r �documentr� ri r2 r2 rc r3 rp v s
rp �SOURCE_DATE_EPOCHNc sN e Zd Zdededdf� fdd� Zdedefdd �Zdedefd
d �Z� Z S ) �
LocalTimeZone�args�kwargsr< Nc s t � j|i |�� t| _d S r0 )r` r4 �tzdelta)r1 r� r� rc r2 r3 r4 � s
zLocalTimeZone.__init__�dtc C s | j S r0 )r� �r1 r� r2 r2 r3 � utcoffset� s zLocalTimeZone.utcoffsetc C s t d�S �Nr )r r� r2 r2 r3 �dst� r� zLocalTimeZone.dst)
r5 r6 r7 r r4 r r r� r� ri r2 r2 rc r3 r� � s r� �filepath� new_contentr< c C s� t �| �sdS zJt| dd��9}|�� }|�d�}|�d�}|�d�}|�d�}|d |� |d |� kp>||d � ||d � kW d � W S 1 sJw Y W dS ty[ Y dS w )NT�utf-8��encodingz"POT-Creation-Date:z"PO-Revision-Date:)r �existsr �readr� �
ValueError)r� r� �oldpot� old_content�old_header_index�new_header_index�old_body_index�new_body_indexr2 r2 r3 � should_write� s"
$� ��r� c s| e Zd ZdZdZed�Zd� fdd� Zdee fdd �Z
dd
d �Z dd
e e de de ddf� fdd�
Z
d� fdd� Z� ZS )�MessageCatalogBuilderz=
Builds gettext-style message catalogs (.pot files).
rV z'The message catalogs are in %(outdir)s.r< Nc s" t � �� | �� | j�| � d S r0 )r` rs �create_template_bridgerU r? rc r2 r3 rs � s
zMessageCatalogBuilder.initc C sj t � }| jjD ]+}t�| jj|�}t|�D ] \}}}|D ]}|�d�r0t t�||��}|�
|� q qq|S )Nz.html) �setrv �templates_pathr r_ �app�srcdirr
�endswithr' rH ) r1 �template_filesrS �
tmpl_abs_path�dirpath�dirs�files�fnre r2 r2 r3 �_collect_templates� s
���z(MessageCatalogBuilder._collect_templatesc C s t | �� �}|�� tjttd�| j �dd� t�td�t|�� | j j
j }t |td�dt|�| j
j�D ]K}z4t|dd�� }|�� }W d � n1 sMw Y ||�D ]\}}}t||�} | jd �|| � qVW q5 ty� }
z td
||
f �|
�d }
~
ww d S ) Nzbuilding [%s]: T)�nonlz targets for %d template fileszreading templates... �purpler� r� �sphinxz%s: %r)�listr� �sort�logger�infor" r r� �lenrU � environment�extract_translationsr! r� � verbosityr r� rB ry rH � Exceptionr ) r1 r� r� �template�frf rG �methr@ rA �excr2 r2 r3 �_extract_from_template� s*
�
�
����z,MessageCatalogBuilder._extract_from_template�updater� �summary�methodc s | � � t� �|||� d S r0 )r� r` �build)r1 r� r� r� rc r2 r3 r� s zMessageCatalogBuilder.buildc s t � �� | jj| jj| jj| jj| jjt� t
t �� d�| jj
| jjd�}t| j�� td�dt| j�| jjdd� �D ]J\}}tt�| jt�|��� t|�|d< t | jd�� d |�}t�| j|d
�}t ||�r�t |d d d
��
}|� |� W d � n1 sw Y q:d S )Nz%Y-%m-%d %H:%M%z)�version� copyright�project�last_translator�
language_team�ctime�display_location� display_uuidz writing message catalogs... � darkgreenc S s | d S r� r2 )� textdomain__r2 r2 r3 �<lambda> s z.MessageCatalogBuilder.finish.<locals>.<lambda>r= )rT z
message.pot_tz.pot�wr� r� )!r` �finishrv r� r� r� �gettext_last_translator�gettext_language_teamr �
fromtimestamp� timestamp�ltz�strftime�gettext_locationrw r! ry �itemsr r� r� r� r( r r_ rT �dirnamer� rR rh r� r �write)r1 rf �
textdomainr� �content�pofn�pofilerc r2 r3 r� s4
�
�
���z MessageCatalogBuilder.finishrP )Nr� )r5 r6 r7 r8 r� r �epilogrs r r9 r� r� r r� r� ri r2 r2 rc r3 r� � s
$r� r� c C s~ | � t� | �dddtth� | �ddd� | �ddd� | �ddd� | �d g d� | �d
d d� | �d d
d� dddd�S )Nr� TrV r� rw F�gettext_auto_buildra r� r� zFULL NAME <EMAIL@ADDRESS>r� zLANGUAGE <LL@li.org>�builtin)r� �parallel_read_safe�parallel_write_safe)� add_builderr� �add_config_valuero r9 )r� r2 r2 r3 �setup! s
�r� )Ur8 �codecsr � collectionsr r r r r �osr r r
r �typingr r
r r r r r r r rK r �docutilsr �docutils.nodesr r� r r �sphinx.applicationr �sphinx.buildersr �sphinx.domains.pythonr �
sphinx.errorsr �
sphinx.localer � sphinx.utilr r r! �sphinx.util.consoler" �sphinx.util.i18nr# r$ �sphinx.util.nodesr% r& �sphinx.util.osutilr' r( r) �sphinx.util.tagsr* �sphinx.util.templater+ � getLoggerr5 r� r, r; rB rR rj rp r� r� �utcfromtimestampr� �source_date_epoch�floatr� r� r9 ro r� r� r� r2 r2 r2 r3 �<module> sV
,
4� K