File: //usr/lib/python3/dist-packages/sphinx/ext/__pycache__/ifconfig.cpython-310.pyc
o
�$�a?
� @ s� d Z ddlmZmZmZ ddlmZ ddlmZ ddl Z ddl
m Z ddl m
Z
ddlmZ dd lmZ G d
d � d ej�ZG d d
� d
e
�Zde dejdeddfdd�Zde deeef fdd�ZdS )a�
sphinx.ext.ifconfig
~~~~~~~~~~~~~~~~~~~
Provides the ``ifconfig`` directive that allows to write documentation
that is included depending on configuration variables.
Usage::
.. ifconfig:: releaselevel in ('alpha', 'beta', 'rc')
This stuff is only included in the built docs for unstable versions.
The argument for ``ifconfig`` is a plain Python expression, evaluated in the
namespace of the project configuration (that is, all variables from
``conf.py`` are available.)
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�Any�Dict�List)�nodes)�NodeN)�Sphinx)�SphinxDirective)�nested_parse_with_titles)�
OptionSpecc @ s e Zd ZdS )�ifconfigN)�__name__�
__module__� __qualname__� r r �5/usr/lib/python3/dist-packages/sphinx/ext/ifconfig.pyr " s r c @ s< e Zd ZU dZdZdZdZi Zee d< de
e fdd�Z dS ) �IfConfigT� r � option_spec�returnc C s> t � }| jj|_| �|� | jd |d< t| j| j|� |gS )Nr �expr)r �state�document�set_source_info� argumentsr �content)�self�noder r r �run. s
z IfConfig.runN)
r r
r � has_content�required_arguments�optional_arguments�final_argument_whitespacer r
�__annotations__r r r r r r r r & s
r �app�doctree�docnamer c
C s� dd� | j D �}|�| j j�� � | jj|d< |�t�D ]J}z t|d |�}W n0 t yW } z$ddl
m } d� ||j
|��}|jjd| |d �} |�| � W Y d }~q d }~ww |s`|�g � q |�|j� q d S )
Nc S s i | ]}|j |j�qS r )�name�value)�.0�confvalr r r �
<dictcomp>8 s z*process_ifconfig_nodes.<locals>.<dictcomp>�builderr r )�format_exception_only� z.Exception occurred in ifconfig expression:
%s)� base_node)�config�update�__dict__�copyr+ r& �traverser �eval� Exception� tracebackr, �join� __class__�reporter�error� replace_self�children)
r# r$ r% �nsr �res�errr, �msg�newnoder r r �process_ifconfig_nodes7 s* ���� �rB c C s. | � t� | �dt� | �dt� tjdd�S )Nr zdoctree-resolvedT)�version�parallel_read_safe)�add_noder �
add_directiver �connectrB �sphinx�__display_version__)r# r r r �setupM s
rJ )�__doc__�typingr r r �docutilsr �docutils.nodesr rH �sphinx.applicationr �sphinx.util.docutilsr �sphinx.util.nodesr �sphinx.util.typingr
�Elementr r r �strrB rJ r r r r �<module> s