K ii p d dl mZ d dlZd dlZd dlZd dlZd dlZd dlmZmZm Z m
Z
d dl m Z d dl
mZ d dlZd dlZdZ e e Zi Z ej( d Zd d Zd!d
Zej0 G d d Z ed
Z G d dej6 Z G d dej6 Z G d dee Z d"d#dZ d$dZ d% d&dZ! d'dZ"ej0 G d d Z# G d d Z$d(d Z%d Z&d)d Z'e& d* d+d Z(y), ) annotationsN)GenericTypeVarCallableIterable)Template)StringIOa {% if not embed %}
{% endif %}
{% if not head %}
{% else %}
{{ head | safe }}
{% endif %}
{% if not embed %}
{% endif %}
{{ body | safe }}
{% for diagram in diagrams %}
{{ diagram.title }}
{{ diagram.text }}
{{ diagram.svg }}
{% endfor %}
{% if not embed %}
{% endif %}
)startc | t v r t | S t j dd| }|dd j sd| }|j j d }| dt
t dxt | < }|S )zK
Converts a string into a valid HTML bookmark (ID or anchor name).
z[^a-zA-Z0-9-]+-Nr
z04d)_bookmark_lookupresubisalphalowerstripnext
_bookmark_ids)sbookmarks `/mnt/ssd/data/python-lab/Trading/venv/lib/python3.12/site-packages/pyparsing/diagram/__init__.py_make_bookmarkr ? s "" vv'a0H BQ< !xj> ~~ %%c*H(0z4
3Fs2K%LLQ( O c d| vr| S t j d j j | }t j
dd| }|S )N
z#.*$z\s*\n\s* ) pyparsingRegexsuppresstransform_stringr r ) regex_str collapseds r _collapse_verbose_regexr& U sJ 9 (113DDYOI{B 2I r c D e Zd ZU dZded< ded< dZded< ed Zy)
NamedDiagramzK
A simple structure for associating a name with a railroad diagram
strnameintindexNzrailroad.DiagramItemdiagramc 0 t | j }|S N)r r* )selfr s r r zNamedDiagram.bookmarkg s !$)),r )__name__
__module__ __qualname____doc____annotations__r- propertyr r r r( r( ] s0 I J$(G
!(
r r( Tc ( e Zd ZdZdZd fd Z xZS )EachItema$
Custom railroad item to compose a:
- :class:`railroad.Group` containing a
- :class:`railroad.OneOrMore` containing a
- :class:`railroad.Choice` of the elements in the
:class:`railroad.Each`
with the group label indicating that all must be matched
z[ALL]c t j t | dz
g| }t j | }t | || j y )Nr
item)label)railroadChoicelen OneOrMoresuper__init__ all_label)r0 items choice_itemone_or_more_item __class__s r rD zEachItem.__init__ sF ooc%j1n=u= #--;?
) @r )returnNone)r1 r2 r3 r4 rE rD
__classcell__rI s @r r: r: p s IA Ar r: c $ e Zd ZdZd fd Z xZS )
AnnotatedItemzC
Simple subclass of Group that creates an annotation label
c D t | ||r d| d y d y )N[]r r= r> )rC rD )r0 r> r= rI s r rD zAnnotatedItem.__init__ s'
d%AeWA,HRHr )r> r) rJ rK )r1 r2 r3 r4 rD rL rM s @r rO rO s I Ir rO c B e Zd ZdZddZedd Zed Zd dZ y)
EditablePartialz
Acts like a functools.partial, but can be edited. In other words, it represents a type that hasn't yet been
constructed.
c . || _ || _ || _ y r/ funcargskwargs)r0 rX rY rZ s r rD zEditablePartial.__init__ s r c 0 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)``
rW )rU list)clsrX rY rZ s r from_callzEditablePartial.from_call s DtDz&IIr c | j d S )Nr* )rZ r0 s r r* zEditablePartial.name s {{6""r c 8 | j j }| j j }t j | j
}|j | j v r ||j |j z
} | j
|i |S )z<
Evaluate the partial and return the result
)rY copyrZ inspectgetfullargspecrX varargspop)r0 rY rZ arg_specs r __call__zEditablePartial.__call__ s} yy~~ !!# ))$))4 t{{ * FJJx / /0 0Dtyy$)&))r N)rX Callable[..., T]rY r\ rZ dictrJ rK )rX ri rJ EditablePartial[T])rJ r8 )
r1 r2 r3 r4 rD classmethodr^ r6 r* rh r7 r r rU rU s;
J J # #
*r rU c g }| D ] }|j t } |j d }|j j |j | |j }|j dk( r|dz
}|j |d|j |j d t j d||d|S # t
$ r( |j j
|j Y w xY w) z
Given a list of :class:`NamedDiagram`, produce a single HTML string
that visualises those diagrams.
:params kwargs: kwargs to be passed in to the template
css)rn r z (root)r )titletextsvgr )diagramsembedr7 )r- r getwriteStandalonewriteAttributeErrorwriteSvgr* r, appendgetvaluer templaterender)rr rs rZ datar- iorn ro s r railroad_to_htmlr s D
?? "
Z /**U#C OO + +BHH# + > ==A Y E 2;;=gN^N^
$ ?? @D @ @@ / OO $ $RXX . /s 8C .C10C1c ~ t | t r;t | j | _ t | j | _ | S t | t
r| D cg c]
}t | c}S t | t r-| j D ci c] \ }}|t | c}}S | S c c}w c c}}w )zS
Recursively resolves a collection of Partials into whatever type they are
)
isinstancerU resolve_partialrY rZ r\ rj rF )partialxkeys r r r s '?+&w||4 ( 8y GT ",34q"44 GT "6=mmoFFC_Q''FF 5Fs B4B9c t |xs i }t | |d|||| t | }||v r-| j s
d|| _ || j ||d t
|j j }t | dkD rt } g }
|D ]Z } | j dk( r| j | j | vs/| j | j |
j | \ |
D cg c]
} t | }
} n|D cg c]
} t | }
} t |
d
S c c} w c c} w ) aG
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 :meth:`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
:param show_hidden: bool to indicate whether internal elements that are
typically hidden should be shown
)diagram_kwargsN)lookupparentverticalshow_results_names show_groups show_hiddenr T)forcer
z...c | j S r/ r, )diags r z to_railroad..( s
TZZ r )r )ConverterState_to_diagram_elementid
customNamer* mark_for_extractionr\ rr valuesrA setaddry r sorted)elementr r r r r r root_iddiagsseen
deduped_diagsdr resolveds r to_railroadr sA : >+?R
@F- kG&!!#%F7O w++GV4+H
'') *E
5zA~u
(Avvvv!affD&8 $$Q'
( =JJOG,JJ =BBOG,BB ( 7 88 K Cs ?D:D?c 6 | yt t | | k\ S )zF
Returns true if we should return a vertical list of elements
F)rA _visible_exprs)
specificationexprss r _should_verticalr + s" >%()]::r c e Zd ZU dZded< ded< ded< ded< d Zd
ed < d Zd ed
< dZded< dZded< d ddZ y ) ElementStatez<
State recorded for an individual pyparsing Element
pyparsing.ParserElementr rU convertedr r+ numberNr) r* ztyping.Optional[int] parent_indexFboolextractcompletec d| _ | j sC|r|| _ n9| j j r | j j | _ nd| _ |s!| j r(t | j r|j
| yyy)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
Tr N)r r* r r r _worth_extractingextract_into_diagram)r0 el_idstater* r s r r z ElementState.mark_for_extractionN sp yy (( LL 3 3
T]]'8 'F & &u - (G]r )NF)r r+ r r r* r) r r )
r1 r2 r3 r4 r5 r* r r r r r7 r r r r 7 su
%$ KD#)-L&-GTHd RW..!/.7:.JN.r r c Z e Zd ZdZd d
dZddZddZddZddZd dZ dd Z
dd
Z dd Z y)r zR
Stores some state that persists between recursions into the element tree
Nc p i | _ i | _ d| _ d| _ |xs i | _ t | _ y )Nr
r )_element_diagram_statesrr
unnamed_indexr, r r extracted_diagram_names)r0 r s r rD zConverterState.__init__q s7 @B$BD
"#
$2$8b14$r c " || j |< y r/ r )r0 r values r __setitem__zConverterState.__setitem__~ s ,1$$S)r c | j | S r/ r r0 r s r __getitem__zConverterState.__getitem__ s ++C00r c | j |= y r/ r r s r __delitem__zConverterState.__delitem__ s ( ( -r c || j v S r/ r r s r __contains__zConverterState.__contains__ s d2222r c 0 | | S # t $ r |cY S w xY wr/ )KeyError)r0 r defaults r rt zConverterState.get s% 9 N s c D | xj dz
c_ | j S )zT
Generate a number used in the name of an otherwise unnamed diagram
r
)r r` s r generate_unnamedz ConverterState.generate_unnamed s!
a !!!r c D | xj dz
c_ | j S )z;
Generate a number used to index a diagram
r
r r` s r generate_indexz ConverterState.generate_index s
a
zzr c | | }|j rdt |j }t j 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 j t |j t j t
j |fi | j |j | j |< | |= y)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
#rp hrefr= rF )r* r- r, N)r r r* rU r^ r? NonTerminalrZ r r rX Groupr( Diagramr r rr )r0 r positionr retcontents r r z#ConverterState.extract_into_diagram sA ; ??~hmm456D!++H,@,@x}}[_+`C ///14&&v.HOO 2 22IL&&w/0E0EF " "hnn 4 ((//7G ((G . 8 8 #-- '-1-@-@ //
9
e
Kr r/ )r typing.Optional[dict]rJ rK )r r+ r r )r r+ rJ r )r r+ )rJ r+ )r r+ )
r1 r2 r3 r4 rD r r r r rt r r r r7 r r r r l s4 721.3 " r r c F | j }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 | ] }|j y wr/ )recurse).0childs r z$_worth_extracting.. s 55u}}5s )r any)r childrens r r r s!
H 5H5 55r c J d d 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)
c | |||||||| } |rS| Q| j }
|
rC| j rdnd} t j t j
| t
|
| } | S )Nr *rS ) resultsName modalResultsrU r^ r? r repr)
r r r r r, name_hintr r r r element_results_name modal_tagfns
r _innerz0_apply_diagram_item_enhancements.._inner s
#/#*#6#6 #")"6"6BC %// NN !"6 7 8 D 0
r NNr NFFFr r r typing.Optional[EditablePartial]r r r r+ r, r+ r r) r r r r r r rJ r r7 )r r s ` r _apply_diagram_item_enhancementsr s "& #( ! !#(#0# # #
#
# !# # #
*#J Mr c t j t j t j j f}| D cg c] }t || s| c}S c c}w r/ )r ParseElementEnhance
PositionTokenAnd
_ErrorStopr )r non_diagramming_exprses r r r sV %%
! 23
s Ac t | j } |xs# | j xs t | j }
t | } | j
} | j s^t
| t j t j f r4| r2| d j s|
}
nd}
t | j |||||
||| S t | r|j | }|rj|j ^|j | || dt! |j }t" j% t& j( |j | }|S | |j* v rP|j* | j, d }t" j% t& j( |dt! | }|S | j. s|syt
| t j0 r| syt3 t5 d | D d k( rHt3 | d
kD r:t" j% t& j6 d t9 t3 | }nt; || r't" j% t& j< g
}nVt" j% t& j> g
}n/t
| t j@ t jB f r^| syt; || r(t" j% t& jD dg
}nt" j% t& jF g
}nt
| t jH r | syt" j% tJ g
}nmt
| t jL r t" j% tN dd }n5t
| t jP r t" j% tN dd }nt
| t jR r t" j% tN dd }nt
| t jT rH|r t" j% tN d d }nt" j% t& jT d| }nct
| t jV rmt | j jY }|dk( r't" j% t& j> g
}nt" j% tN |d }nt
| t jZ r't" j% t& j\ d }nt
| t j6 r| j^ T||||||||g}t | j^ j | j z d ja | j g| S t" j% t& j6 d }nt
| t jb r| j^ T||||||||g}t | j^ j | j z d ja | j g| S t" j% t& jb d }nYt
| t jd r| j sd}n/t
| t jf r&t" j% t& j> g
}nt3 | dkD r)| s't" j% t& jT d |
}nt
| t jh r:tk | jl }t" j% t& jn | }ndt3 | dkD r&t" j% t& j> g
}n0t" j% t& jn | jp }|}|yts | ||||ju || < | j r || j | || j d}| D ] }d|j, v r |j, d jw |d t |||||||| }|Ed|j, v r||j, d< cd|j, v sr||j, d |< |d z
}d|j, v s|j, d |= |rjd|j, v rt3 |j, d dk( s d|j, v r3|j, d $t" j% t& jn |
}| |v r
d|| _< | |v r|| jz rr|| jx rc|j} | |P|j* | j, d }dt! | }t" j% t& j( || }|S ) a
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
:param show_groups: bool flag indicating whether to show groups using bounding box
:param show_hidden: bool flag indicating whether to show elements that are typically hidden
:returns: The converted version of the input element, but as a Partial that hasn't yet been constructed
r N)r r r r, r r r r )r* r r r* c 3 L K | ] }|j |j f y wr/ )r* r )r r s r r z&_to_diagram_element..g s :qAFFAMM*:s "$r
r )r= repeat)rF NOT)r> r= LOOKAHEAD
LOOKBEHINDrS tokenconverterr< )r
..)r r r r r rF )r r r r, r r r r= T)?r r typer1 r r r r ForwardLocatedr exprr rt r* r r rU r^ r? r rr rZ show_in_diagramr rA r rB r) r StackSequenceOr
MatchFirstr@ HorizontalChoiceEachr: NotAnyrO
FollowedBy
PrecededByr TokenConverterr OptOptional not_enderset_name
ZeroOrMoreEmptyr r! r& patternTerminal defaultNamer r insertr r r )r r r r r, r r r r r r* r r propagated_name looked_upr r rp r> rY collapsed_pattterminalir r= s r r r sN 4
OO E D** Dd7m.D.DD
wKE".. !!!!
Qx**&*O&*O*LL!! % -'9 + +
!JJu% 3
) )%i ) H~inn567D!++H,@,@y~~\`+aCJ
foo
% ??5)008D!++$$4.:N9O6P , C J " ";'9==) s:E:: ;q @SZRS^!++""CE
O , C h
.!++HNN"+EC!++H,=,=R+HC GillI,@,@ A B He ,!++HOOQb+IC!++H,E,ER+PC GY^^ , '''; GY - - . ''
U'L GY 1 1 2 ''
[r'R GY 1 1 2 ''
\PR'S GY__ - !++M"+MC!++T1E , C
GY 5 5 6W
&&,,. $ $!++H,=,=R+HC!++MR+PC GY]] + ''(9(9'C GY 0 0 1 (" D '##(((7<<7@II',,W
''(:(:'F GY 1 1 2 (" D '##(((7<<7=FFw||T
''(;(;"'E GY__ -g6H6H GY : : ; ''(9(9'D Ua 4 ''Rt'L GY__ -0 A ''(9(9>J Ua ''(9(9'D",,X->->@S@ST
{ !$$& F5M u
))%9K9KL A ' cjj JJw & &q$ /" 1##
#%)
6"CJJ&)-
7#A&Q
"
7#A&5': CJJ 3szz'':#;q#@ cjj SZZ%7%? ''(9(94@
!%u
6%=00VE]5K5K##E* ???5)008D~d+,-D!++$$4d , C Jr )r r) rJ r) )r$ r) rJ r) )F)rr list[NamedDiagram]rJ r) )r rk rJ r8 )N FFF)r r r r r r+ r r r r r r rJ r )r r+ r !Iterable[pyparsing.ParserElement]rJ r )r r rJ r )r r r r ))
__future__r itertoolsr? r dataclassestypingr r r r jinja2r r~ r rc r jinja2_template_sourcer{ r countr r r& dataclassr( r8 r r: rO rU r r r r r r r r r r r7 r r r( s# "
" H * + a(
,
CLAx~~ A,IHNN I(*gaj (*VA:
$ -1 $
A9
$A9)A9 A9 A9
A9
A9 A9H ; ; @ ; ;
1. 1. 1.hR Rj6,^
" " $ y
$y ,y
y y
y
y y y y &y "yr