golden hour
/opt/saltstack/salt/lib/python3.10/site-packages/pip/_vendor/pyparsing/diagram/__pycache__
⬆️ Go Up
Upload
File/Folder
Size
Actions
__init__.cpython-310.pyc
16.17 KB
Del
OK
Edit: __init__.cpython-310.pyc
o �xe�\ � @ s� d dl Z d dlmZ d dlZd dlmZmZmZmZmZm Z m Z m Z d dl m Z d dlmZ d dlZdZe e�Zeddefd eje j fd efg�Z ed �ZG d d � d e j�ZG dd� de j�ZG dd� dee �Z dee defdd�Z dddefdd�Z d6d ej d eje d ed e!d e!dee f d!d"�Z"d#ed$e ej de!fd%d&�Z#G d'd(� d(�Z$G d)d*� d*�Z%d ej de!fd+d,�Z&d-d.� Z'd$e ej fd/d0�Z(e' d7d ej d1eje d2e%d ed ed3ed e!d e!deje fd4d5��Z)dS )8� N)� pyparsing)�List� NamedTuple�Generic�TypeVar�Dict�Callable�Set�Iterable)�Template)�StringIOaM <!DOCTYPE html> <html> <head> {% if not head %} <style type="text/css"> .railroad-heading { font-family: monospace; } </style> {% else %} {{ head | safe }} {% endif %} </head> <body> {{ body | safe }} {% for diagram in diagrams %} <div class="railroad-group"> <h1 class="railroad-heading">{{ diagram.title }}</h1> <div class="railroad-description">{{ diagram.text }}</div> <div class="railroad-svg"> {{ diagram.svg }} </div> </div> {% endfor %} </body> </html> � NamedDiagram�name�diagram�index�Tc s$ e Zd ZdZdZ� fdd�Z� ZS )�EachItemz� Custom railroad item to compose a: - Group containing a - OneOrMore containing a - Choice of the elements in the Each with the group label indicating that all must be matched z[ALL]c s< t jt|�d g|�R � }t j|d�}t� j|| jd� d S )N� ��item)�label)�railroad�Choice�len� OneOrMore�super�__init__� all_label)�self�itemsZ choice_itemZone_or_more_item�� __class__� �Z/opt/saltstack/salt/lib/python3.10/site-packages/pip/_vendor/pyparsing/diagram/__init__.pyr I s zEachItem.__init__)�__name__� __module__� __qualname__�__doc__r r � __classcell__r" r" r r# r > s r c s& e Zd ZdZdef� fdd� Z� ZS )� AnnotatedItemzC Simple subclass of Group that creates an annotation label r c s" t � j||r d�|�n|d� d S )Nz[{}]�r r )r r �format)r r r r r" r# r T s "zAnnotatedItem.__init__)r$ r% r& r' �strr r( r" r" r r# r) O s r) c @ sf e Zd ZdZdedef dedefdd�Ze dedef dd fd d ��Z e d d � �Z defdd�Z dS )�EditablePartialz� Acts like a functools.partial, but can be edited. In other words, it represents a type that hasn't yet been constructed. �func.�args�kwargsc C s || _ || _|| _d S �N�r. r/ r0 )r r. r/ r0 r" r" r# r a s zEditablePartial.__init__�return�EditablePartial[T]c O s t |t|�|d�S )z� If you call this function in the same way that you would call the constructor, it will store the arguments as you expect. For example EditablePartial.from_call(Fraction, 1, 3)() == Fraction(1, 3) r2 )r- �list)�clsr. r/ r0 r" r" r# � from_callf s zEditablePartial.from_callc C s | j d S )Nr )r0 �r r" r" r# r n s zEditablePartial.namec C sL | j �� }| j�� }t�| j�}|j| jv r ||�|j�7 }| j|i |��S )z< Evaluate the partial and return the result )r/ �copyr0 �inspectZgetfullargspecr. Zvarargs�pop)r r/ r0 Zarg_specr" r" r# �__call__r s zEditablePartial.__call__N)r$ r% r& r' r r r5 �dictr � classmethodr7 �propertyr r< r" r" r" r# r- X s r- �diagramsr3 c K sp g }| D ])}|j du r qt� }|j �|j� |j}|jdkr"|d7 }|�|d|�� d�� qtj dd|i|��S )z� Given a list of NamedDiagram, produce a single HTML string that visualises those diagrams :params kwargs: kwargs to be passed in to the template Nr z (root)� )�title�textZsvgr@ r" ) r r ZwriteSvg�writer r �append�getvalue�templateZrender)r@ r0 �datar �iorB r" r" r# �railroad_to_html� s rJ �partialr4 c C s` t | t�rt| j�| _t| j�| _| � S t | t�r dd� | D �S t | t�r.dd� | �� D �S | S )zS Recursively resolves a collection of Partials into whatever type they are c S � g | ]}t |��qS r" ��resolve_partial)�.0�xr" r" r# � <listcomp>� � z#resolve_partial.<locals>.<listcomp>c S s i | ] \}}|t |��qS r" rM )rO �keyrP r" r" r# � <dictcomp>� s z#resolve_partial.<locals>.<dictcomp>)� isinstancer- rN r/ r0 r5 r= r )rK r" r" r# rN � s rN � F�element�diagram_kwargs�vertical�show_results_names� show_groupsc C s� t |pi d�}t| |d|||d� t| �}||v r+| js!d|| _|| j||dd� t|j�� �}t |�dkret � }g } |D ] } | jdkrGq?| jdur\| j|vr\|� | j� | � | � q?d d � | D �} nd d � |D �} t | d d � d�S )a� Convert a pyparsing element tree into a list of diagrams. This is the recommended entrypoint to diagram creation if you want to access the Railroad tree before it is converted to HTML :param element: base element of the parser being diagrammed :param diagram_kwargs: kwargs to pass to the Diagram() constructor :param vertical: (optional) - int - limit at which number of alternatives should be shown vertically instead of horizontally :param show_results_names - bool to indicate whether results name annotations should be included in the diagram :param show_groups - bool to indicate whether groups should be highlighted with an unlabeled surrounding box )rX N)�lookup�parentrY rZ r[ rA T)�forcer z...c S rL r" rM �rO rK r" r" r# rQ � rR z to_railroad.<locals>.<listcomp>c S rL r" rM r_ r" r" r# rQ � rR c S s | j S r1 �r )Zdiagr" r" r# �<lambda>� s z to_railroad.<locals>.<lambda>)rS )�ConverterState�_to_diagram_element�id� customNamer �mark_for_extractionr5 r@ �valuesr �set�addrE �sorted) rW rX rY rZ r[ r\ Zroot_idZdiags�seenZ deduped_diags�dZresolvedr" r" r# � to_railroad� s8 � �rm � specification�exprsc C s | du rdS t t|��| kS )zF Returns true if we should return a vertical list of elements NF)r �_visible_exprs)rn ro r" r" r# �_should_vertical� s rq c @ s^ e Zd ZdZ ddejdedededede j e f d d �Z dd ed ddede fdd�Z dS )� ElementStatez< State recorded for an individual pyparsing Element NrW � convertedr] �numberr � parent_indexc C s4 || _ || _|| _|| _|| _|| _d| _d| _d S �NF)rW r rs r] rt ru �extract�complete)r rW rs r] rt r ru r" r" r# r � s zElementState.__init__F�el_id�staterb r^ c C s\ d| _ | js|r || _n | jjr| jj| _nd| _|s#| jr*t| j�r,|�|� dS dS dS )a� Called when this instance has been seen twice, and thus should eventually be extracted into a sub-diagram :param el_id: id of the element :param state: element/diagram state tracker :param name: name to use for this element's text :param force: If true, force extraction now, regardless of the state of this. Only useful for extracting the root element when we know we're finished TrA N)rw r rW re rx �_worth_extracting�extract_into_diagram)r ry rz r r^ r" r" r# rf s �z ElementState.mark_for_extraction)NNrv )r$ r% r& r' r � ParserElementr- �intr, �typing�Optionalr �boolrf r" r" r" r# rr � s6 ������ ������rr c @ s� e Zd ZdZddeje fdd�Zdede fdd �Z ded e fd d �Z defd d�Z defdd�Z d efdd�Zd efdd�Zdefdd�ZdS )rb zR Stores some state that persists between recursions into the element tree NrX c C s. i | _ i | _d| _d| _|pi | _t� | _d S )Nr r )�_element_diagram_statesr@ � unnamed_indexr rX rh Zextracted_diagram_names)r rX r" r" r# r . s zConverterState.__init__rS �valuec C s || j |< d S r1 �r� )r rS r� r" r" r# � __setitem__; s zConverterState.__setitem__r3 c C s | j | S r1 r� �r rS r" r" r# � __getitem__> � zConverterState.__getitem__c C s | j |= d S r1 r� r� r" r" r# � __delitem__A s zConverterState.__delitem__c C s || j v S r1 r� r� r" r" r# � __contains__D r� zConverterState.__contains__c C � | j d7 _ | j S )zT Generate a number used in the name of an otherwise unnamed diagram r )r� r8 r" r" r# �generate_unnamedG � z ConverterState.generate_unnamedc C r� )z; Generate a number used to index a diagram r r` r8 r" r" r# �generate_indexN r� z ConverterState.generate_indexry c C s� | | }|j r,tjtj|jd�}d|j jv r ||j jd< nd|j jv r,||j jd |j< |jj tj kr:|jjd }n|j}tjt |jtjtj |fi | j ��|jd�| j|< | |= dS )z� Used when we encounter the same token twice in the same tree. When this happens, we replace all instances of that token with a terminal, and create a new subdiagram for the token �rC r r )r r r N)r] r- r7 r � NonTerminalr r0 ru rs r. �Groupr ZDiagramrX rt r@ )r ry �position�ret�contentr" r" r# r| U s* �� � z#ConverterState.extract_into_diagramr1 )r$ r% r& r' r r� r= r r~ rr r� r� r� r� r� r� r| r" r" r" r# rb ) s rb c C s | � � }tdd� |D ��S )z� Returns true if this element is worth having its own sub-diagram. Simply, if any of its children themselves have children, then its complex enough to extract c s s � | ]}|� � V qd S r1 )�recurse)rO �childr" r" r# � <genexpr>} s � z$_worth_extracting.<locals>.<genexpr>)r� �any)rW �childrenr" r" r# r{ w s r{ c sR ddt jdtjt dtdtdtd td td td tjt f� fd d� }|S )z� decorator to ensure enhancements to a diagram item (such as results name annotations) get applied on return from _to_diagram_element (we do this since there are several returns in _to_diagram_element) Nr FrW r] r\ rY r � name_hintrZ r[ r3 c sT � | |||||||�}|r(|d ur(| j } | r(| | jr dnd7 } tjtj|| d�}|S )NrA �*r* )� resultsNameZ modalResultsr- r7 r r� ) rW r] r\ rY r r� rZ r[ r� �element_results_name��fnr" r# �_inner� s$ � �z0_apply_diagram_item_enhancements.<locals>._inner�NNr NFF) r r} r r� r- rb r~ r, r� )r� r� r" r� r# � _apply_diagram_item_enhancements� s4 ��������� �"r� c s$ t jt jt jjf� � fdd�| D �S )Nc s& g | ]}|j s|jst|� �s|�qS r" )re r� rU �rO �e�Znon_diagramming_exprsr" r# rQ � s ����z"_visible_exprs.<locals>.<listcomp>)r ZParseElementEnhanceZ PositionToken�AndZ _ErrorStop)ro r" r� r# rp � s � �rp r] r\ r� c C s | � � }|p | jp | jj} t| �} | j} | js7t| tjf�r7|r7|d js(| } nd} t | j ||||| ||d�S t | �rk| |v rV|| } | j | ||d� t jtj| jd�}|S | |jv rkt jtj|j| jd d�}|S t| tj�r�|sudS ttdd� |D ���d kr�t jtjd tt|��d �}�n-t||�r�t jtjg d �}�n t jtjg d �}�nt| tj tj f�r�|s�dS t||�r�t jtj dg d �}n�t jtj g d �}n�t| tj �r�|s�dS t jt!g d �}n�t| tj"�r�t jt#d d d�}n�t| tj$�r�t jt#dd d�}n�t| tj%��rt jt#dd d�}n�t| tj&��r,|�r"t jt#d d d�}n�t jtj&d d d�}n�t| tj'��rAt jt#t(| �j�)� d d�}n}t| tj*��rQt jtj+d d�}nmt| tj��rat jtjd d�}n]t| tj,��rqt jtj,d d�}nMt| tj&��r�t jtj&d| d�}n<t| tj-��r�| j�s�d}n.t|�d k�r�t jtjg d �}n t|�dk�r�| �s�t jtj&d | d�}n t �tj.| j/�}|}|du �r�dS t0| ||||�1� d�|| < | j�r�|| � | || j� d}|D ]N}d|jv �r�|jd �2|d� t |||||||d�}|du�r%d|jv �r||jd< �q�d|jv �r#||jd |< |d 7 }�q�d|jv �r1|jd |= �q�|�r[d|jv �rFt|jd �dk�sTd|jv �r[|jd du �r[t �tj.| �}| |v �red|| _3| |v �r�|| j4�r�|| j3�r�|�5| � |du�r�t jtj|j| jd d�}|S )ay Recursively converts a PyParsing Element to a railroad Element :param lookup: The shared converter state that keeps track of useful things :param index: The index of this element within the parent :param parent: The parent of this element in the output tree :param vertical: Controls at what point we make a list of elements vertical. If this is an integer (the default), it sets the threshold of the number of items before we go vertical. If True, always go vertical, if False, never do so :param name_hint: If provided, this will override the generated name :param show_results_names: bool flag indicating whether to add annotations for results names :returns: The converted version of the input element, but as a Partial that hasn't yet been constructed :param show_groups: bool flag indicating whether to show groups using bounding box r N)r] r\ rY r r� rZ r[ )r r� r c s s � | ] }|j |jfV qd S r1 )r r� r� r" r" r# r� s � z&_to_diagram_element.<locals>.<genexpr>r rA )r �repeat)r ZNOT)r r Z LOOKAHEADZ LOOKBEHINDr r* )rW rs r] ru rt r )r] r\ rY r rZ r[ r T)6r� re r! r$ rd r� rU r ZLocatedrc �exprr{ rf r- r7 r r� r r@ r0 r� r rh r r, rq ZStack�SequenceZOrZ MatchFirstr ZHorizontalChoiceZEachr ZNotAnyr) Z FollowedByZ PrecededByr� ZTokenConverter�type�lowerZOptr� Z ZeroOrMoreZEmptyZTerminalZ defaultNamerr r� �insertrx rw r| )rW r] r\ rY r r� rZ r[ ro r ry r� Zpropagated_nameZ looked_upr� Zterminal�ir� r r" r" r# rc � s �� � � � �� � � � � " �rc )NrV FFr� )*r Z pip._vendorr r r r r r r r r r Zjinja2r rI r r: Zjinja2_template_sourcerG r, r� Z DiagramItemr~ r r r� r r) r- rJ rN r} r= r� rm rq rr rb r{ r� rp rc r" r" r" r# �<module> s� ( � *������ �:�� � >N , ��������� �
Save