bgt\ d dl Z d dlZd dlZd dlmZmZmZmZmZmZm Z m
Z
d dl m Z d dl
mZ d dlZdZ e e Z eddefdej e j fd efg Z ed
Z G d d e j Z G d
de j Z G d dee Zdee defdZ dddefdZ d-dej dej e ded e d e dee f d Z!d ed e
ej de fd!Z" G d" d# Z# G d$ d% Z$dej de fd&Z%d' Z&d e
ej fd(Z'e& d.dej d)ej e d*e$ded ed+ed e d e dej e fd, Z(dS )/ N)List
NamedTupleGenericTypeVarDictCallableSetIterable)Template)StringIOaM
{% if not head %}
{% else %}
{{ head | safe }}
{% endif %}
{{ body | safe }}
{% for diagram in diagrams %}
{{ diagram.title }}
{{ diagram.text }}
{{ diagram.svg }}
{% endfor %}
NamedDiagramnamediagramindexTc & e Zd ZdZdZ fdZ xZS )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 t j t | dz
g|R }t j | }t || j d S )N item)label)railroadChoicelen OneOrMoresuper__init__ all_label)selfitems choice_itemone_or_more_item __class__s k/builddir/build/BUILD/cloudlinux-venv-1.0.7/venv/lib/python3.11/site-packages/pyparsing/diagram/__init__.pyr zEachItem.__init__I s^ oc%jj1n=u=== #-;???
) @@@@@ )__name__
__module__ __qualname____doc__r r
__classcell__r$ s @r% r r > sR IA A A A A A A A Ar& r c ( e Zd ZdZdef fd Z xZS )
AnnotatedItemzC
Simple subclass of Group that creates an annotation label
r c | t ||rd | n| d S )Nz[{}]r r )r r format)r r r r$ s r% r zAnnotatedItem.__init__T s<
d%*R&--*>*>*>USSSSSr& )r' r( r) r* strr r+ r, s @r% r. r. O sY Tc T T T T T T T T T Tr& r. c e Zd ZdZdedef dedefdZe dedef ddfd Z
e d
Z defd Z
d S )
EditablePartialz
Acts like a functools.partial, but can be edited. In other words, it represents a type that hasn't yet been
constructed.
func.argskwargsc 0 || _ || _ || _ d S Nr5 r6 r7 )r r5 r6 r7 s r% r zEditablePartial.__init__a s r& returnEditablePartial[T]c @ t |t | | 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)
r: )r4 list)clsr5 r6 r7 s r% from_callzEditablePartial.from_callf s DtDzz&IIIIr& c | j d S )Nr )r7 r s r% r zEditablePartial.namen s {6""r& c | j }| j }t j | j }|j | j v r || |j z
} | j |i |S )z<
Evaluate the partial and return the result
)r6 copyr7 inspectgetfullargspecr5 varargspop)r r6 r7 arg_specs r% __call__zEditablePartial.__call__r s| y~~ !!## )$)44 t{ * * FJJx /00 0Dty$)&)))r& N)r' r( r) r* r r r> dictr classmethodr@ propertyr rJ r& r% r4 r4 X s Xc1f - T 4
JXc1f - JCW J J J [J # # X#
*!
*
*
*
*
*
*r& r4 diagramsr; c $ g }| D ]y}|j
t }|j |j |j }|j dk r|dz
}| |d| d zt j 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) )titletextsvgrO rN )
r r writeSvgwriter r appendgetvaluetemplaterender)rO r7 datar iorR s r% railroad_to_htmlr] s
D H H ? "
ZZ *** =A Y E eR
FFGGGG ? 3 3D 3F 3 33r& partialr< c P t | t rz#resolve_partial.. s 444q""444r& c 4 i | ]\ }}|t | S rN ra )rc keyrd s r%
z#resolve_partial.. s& FFFFC_Q''FFFr& )
isinstancer4 rb r6 r7 r> rK r! )r^ s r% rb rb s '?++ &w|44 ( 88wyy GT " " 44G4444 GT " " FFgmmooFFFFr& Felementdiagram_kwargsverticalshow_results_names show_groupsc b t |pi }t | |d||| t | }||v r2| j s
d|| _ || ||d t
|j }t | dk rmt }g } |D ]M}
|
j dk r|
j 8|
j |vr/| |
j | |
Nd | D } n d
|D } t | 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
)rl N)lookupparentrm rn ro rQ T)forcer z...c , g | ]}t | S rN ra rc r^ s r% re z to_railroad.. s JJJOG,,JJJr& c , g | ]}t | S rN ra ru s r% re z to_railroad.. s BBBOG,,BBBr& c | j S r9 r )diags r% z to_railroad.. s TZ r& )rg )ConverterState_to_diagram_elementid
customNamer mark_for_extractionr> rO valuesr setaddrW sorted) rk rl rm rn ro rq root_iddiagsseen
deduped_diagsdresolveds r% to_railroadr sf ( >+?R
@
@
@F-
kkG&! &#%F7O w++GV4+HHH
'')) * *E
5zzA~~uu
( (Avv!afD&8&8 $$Q'''JJMJJJ CBEBBB ( 7 7 8 8 88r&
specificationexprsc J | dS t t | | k S )zF
Returns true if we should return a vertical list of elements
NF)r _visible_exprs)r r s r% _should_verticalr s* u>%(())]::r& c t e Zd ZdZ ddej dedededede j
e f d Z dd ed d
dede fdZ
dS ) ElementStatez<
State recorded for an individual pyparsing Element
Nrk convertedrr numberr parent_indexc v || _ || _ || _ || _ || _ || _ d| _ d| _ d S NF)rk r r rr r r extractcomplete)r rk r rr r r r s r% r zElementState.__init__ sA 18 *. *3'- ! 2> " #
r& Fel_idstater{ rs c d| _ | j s/|r|| _ n%| j j r| j j | _ nd| _ |s| j r+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
TrQ N)r r rk r~ r _worth_extractingextract_into_diagram)r r r r rs s r% r z ElementState.mark_for_extraction s y
(
L 3
.T] .'8 'F'F . & &u - - - - - . . . .r& )NNr )r' r( r) r* pyparsing
ParserElementr4 intr2 typingOptionalr boolr rN r& r% r r s -1$ $($ #$ $
$
$ oc*$ $ $ $6 TY. ..!1.9<.LP. . . . . .r& r c e Zd ZdZddej e fdZdede fdZ
dede fd Z defd
Z defd Z
defd Zdefd
ZdefdZdS )r{ zR
Stores some state that persists between recursions into the element tree
Nrl c v i | _ i | _ d| _ d| _ |pi | _ t | _ d S )Nr r )_element_diagram_statesrO
unnamed_indexr rl r extracted_diagram_names)r rl s r% r zConverterState.__init__. s? @B$BD
"#
$2$8b14$$$r& rg valuec || j |< d S r9 r )r rg r s r% __setitem__zConverterState.__setitem__; s ,1$S)))r& r; c | j | S r9 r r rg s r% __getitem__zConverterState.__getitem__> s +C00r& c | j |= d S r9 r r s r% __delitem__zConverterState.__delitem__A s ( - - -r& c || j v S r9 r r s r% __contains__zConverterState.__contains__D s d222r& c 0 | xj dz
c_ | j S )zT
Generate a number used in the name of an otherwise unnamed diagram
r )r rB s r% generate_unnamedz ConverterState.generate_unnamedG s!
a !!r& c 0 | xj dz
c_ | j S )z;
Generate a number used to index a diagram
r rx rB s r% generate_indexz ConverterState.generate_indexN s
a
zr& r c | | }|j rqt t j |j }d|j j v r||j j d< n(d|j j v r||j j d |j < |j j t j
k r|j j d }n|j }t t |j t j t j |fi | j
|j | 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
rS r r! )r r r N)rr r4 r@ r NonTerminalr r7 r r r5 Groupr
Diagramrl r rO )r r positionretcontents r% r z#ConverterState.extract_into_diagramU s ; ? M!++H,@x}+UUC ///14&v..HO 222IL&w/0EF "hn 4 4 (/7GG (G . 8 8 #- ' -1-@ /
9
e
KKKr& r9 )r' r( r) r* r r rK r r r r r r r r r r rN r& r% r{ r{ ) s 7 7vt'< 7 7 7 72s 2< 2 2 2 21s 1| 1 1 1 1.s . . . .3 3 3 3 3"# " " " " # r& r{ c \ | }t d |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 3 > K | ]}| V d S r9 )recurse)rc childs r% z$_worth_extracting..} s* 555u}}555555r& )r any)rk childrens r% r r w s0
H 55H555 5 55r& c ddt j dt j t dt
dt dt d t d
t d t d t j t f fd
}|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 Frk rr rq rm r name_hintrn ro r; c
| ||||||| }|r@|>| j } | r5| | j rdndz
} t t j || }|S )NrQ *r0 ) resultsName modalResultsr4 r@ r r ) rk rr rq rm r r rn ro r element_results_namefns r% _innerz0_apply_diagram_item_enhancements.._inner s b
#/#*#6 #
$g.B(KK$%// N4H 0
r& NNr NFF) r r r r r4 r{ r r2 r )r r s ` r% _apply_diagram_item_enhancementsr s "& #( ! ( 0
!
) D Mr& c p t j t j t j j ffd| D S )Nc P g | ]"}|j |j t | |#S rN )r~ r ri )rc enon_diagramming_exprss r% re z"_visible_exprs.. sR
!"
2t t j |j |
j d }|S t
| t j r|sdS t+ t- d |D dk rCt t j d t1 t+ |
}nt3 || r(t t j g }nHt t j g }n t
| t j t j f re|sdS t3 || r)t t j dg }nt t j g }nt
| t j r'|sdS t tB g }nTt
| t j" r$t tF d d
}nt
| t j$ r$t tF dd
}nt
| t j% r$t tF dd
}nt
| t j& rO|r$t tF d d
}nZt t j& d d
}n1t
| t j' rHt tF tQ | j ) d
}nt
| t j* r(t t j+ d }nt
| t j r(t t j d }nKt
| t j, r(t t j, d }n t
| t j& r(t t j& d| }nt
| t j- r
| j sd}nt+ | dk r't t j g }nit+ | dk r*| s(t t j& d | }n,t t j. | j/ }|}|dS ta | ||||1 ||
< | j r"||
|
|| j d}|D ]}d|j v r!|j d 2 |d t ||||||| }|3d|j v r ||j d< Xd|j v r||j d |< |dz
}wd|j v r|j d |= |rbd|j v r t+ |j d dk sd|j v r2|j d %t t j. | }|
|v r
d||
_3 |
|v rm||
j4 r`||
j3 rS|5 |
|. s+ ::qAFAM*::::::r& r rQ )r repeat)r! NOT)r r LOOKAHEAD
LOOKBEHINDr r0 )rk r rr r r r! )rr rq rm r rn ro r T)6r r~ r$ r' r} r ri r Locatedr| exprr r r4 r@ r r r rO r7 r r r r r2 r StackSequenceOr
MatchFirstr HorizontalChoiceEachr NotAnyr.
FollowedBy
PrecededByr TokenConvertertypelowerOptr
ZeroOrMoreEmptyTerminal defaultNamer r insertr r r )rk rr rq rm r r rn ro r r r r propagated_name looked_upr terminalir r s r% r| r| s 0
OO E H* Hg.?.HD
wKKE". !
Qx* +&*OO&*O*L!! % -'9 + !! F?? u
I ) )%i ) H H H!++H,@y~+VVCJ
fo
%
% "++$6?5+A+H+P , C J
'9=)) : 4 s::E::::: ; ;q @ @!++"CE
OO , CC h
.
. I!++HN"+EECC!++H,=R+HHCC GilI,@ A B B - 4 He , , Q!++HOQb+IICC!++H,ER+PPCC GY^ , , & 4 ''';; GY - . . " ''
U'LL GY 1 2 2 ''
[r'RR GY 1 2 2 ''
\PR'SS GY_ - - O!++M"+MMCC!++HN"2+NNCC GY 5 6 6 '' g !7!=!=!?!?b (
GY] + + ''(9'CC GY 0 1 1 ''(:'DD GY 1 2 2 ''(;"'EE GY_ - -
'' N-A (
GY_ - - g6H Ua ''(9'DD Ua 4 ''Rt'LL",,X->@STT
{ !$$&& F5M Mu
))%9KLLL A ' ' cj Jw & &q$ / / /" 1#
##%)
6""CJ&&)-
7#A&Q
"
"
7#A& A CJ 3sz'':#;#;q#@#@ cj SZ%7%? ''(94@@
!%u
6%=0VE]5K##E*** ?!++$6?5+A+H+P , C Jr& )Nrj FFr ))r r r r r r r r r r r
jinja2r r\ r rE jinja2_template_sourcerY r2 r DiagramItemr r
r r r r. r4 r] rb r rK r r r r r{ r r r r| rN r& r% r s
: 8* + + z c]Y0D EFRUW GCLLA A A A Ax~ A A A"T T T T THN T T T'* '* '* '* '*gaj '* '* '*T4tL 1 4 4 4 4 4&
1
a
$ -1 $ 79 79
$79OD)79 79 79
79
,
79 79 79 79t ; ; ' (? @ ; ; ; ; ;;. ;. ;. ;. ;. ;. ;. ;.|K K K K K K K K\6y 6 64 6 6 6 6) ) )X
(9#:;
" " $ H H
$H OO ,H
H H
H
H H H __%H H H "!H H Hr&