Le=BdZddlmZddlZddlZddlZddlm Z m Z m Z ddl m Z ddlmZdd lmZd Zd ZGd d ejZedZGddZGddeZGddeZdS)a The magics offered by the HoloViews IPython extension are powerful and support rich, compositional specifications. To avoid the the brittle, convoluted code that results from trying to support the syntax in pure Python, this file defines suitable parsers using pyparsing that are cleaner and easier to understand. Pyparsing is required by matplotlib and will therefore be available if HoloViews is being used in conjunction with matplotlib. )groupbyN)CycleOptionsPalette)merge_option_dicts) Compositor)dimABCDEFGHIJKLMNOPQRSTUVWXYZz\0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!#$%&\()*+,-./:;<=>?@\\^_`{|}~ceZdZdS) ParserWarningN)__name__ __module__ __qualname__5lib/python3.11/site-packages/holoviews/util/parser.pyrrsrrWarning)namec~eZdZdZeeeedZdZ e dZ e dZ e dZ e d d ZdS) Parserza Base class for magic line parsers, designed for forgiving parsing of keyword lists. )nprrr Fcb|ddkr |ddn|}|ddkr |ddn|S)z4Strip out any leading/training commas from the token,Nrr r)clskws r _strip_commaszParser._strip_commas+s?2 RWWAr!""vv+rcg}|D]g}t|tr;fd|D}|d|zR||hd|zS)Ncvg|]5}t|tr|n|gD]}|6Sr) isinstancelist recurse_token).0tsrinners r z(Parser.recurse_token..6sb>>>)!T22>a1>>>>r)r"r#appendjoin)rtokenr(recursedtoknew_toks` ` rr$zParser.recurse_token1s % %C#t$$ %>>>>>c>>>(8(8 89999$$$$rwwx((((rcJ|dkrdnd}|gSg}|D]}}t|tr%|||}|d|z|d<<|dkrU|||~|S)zN Collect the tokens from a (potentially) nested parse result. parensz(%s)z[%s]Nrr)asListr"r#r$stripr+r)r parseresultmoder(tokensr-s rcollect_tokenszParser.collect_tokens>s ..f  r  '')) 8 8E%&& 8))%77#BZ%/r ;;==C'' c//667777 rr2Nc |i}gi}}|||}t|dD]s}|\}} |dur|t| z }|durRt| } td| Drdnd} |dxx| | | zz cc<t|D]} d D]\} }| | |}  |td | d t|j fi|Y#t$r;|j rtd | d }t|| zYwxYw|S)a Helper function to return dictionary given the parse results from a pyparsing.nestedExpr object (containing keywords). The ns is a dynamic namespace (typically the IPython Notebook namespace) used to update the class-level namespace. Nc d|vS)N=r)els rzParser.todict..^s r rTFc3&K|] }d|vpd|vV dS))}Nrr%r<s r z Parser.todict..fsC"6"6&(%(2I#=3"9"6"6"6"6"6"6rrr*r))z(,()z{,{)z=,r;)z,::)z:,rE)z,,r)z,..zdict(r?zCould not evaluate keyword: z2Ignoring keyword pair that fails to evaluate: '%s')r8rr#anyr,replaceupdateevaldict namespace Exceptionabort_on_eval_failure SyntaxError parsewarningwarning)rr5r6nsgroupedkwargsr7groupvalitemselementsjoinerkeywordfstsndmsgs rtodictz Parser.todictPs :Bb##K66V%9%9:: > >E LS%d{{4;;&e||u++""6"6,4"6"6"666>ss;= v H(=(===  4 4G+ 4 4 S"//#s33 4 d#57#5#5#5#' #<#<#<#<>>???? 4 4 4,R%&PW&P&PQQQJ$$S7]33333  4  s7C??AEE)r2N)rrr__doc__rrrr rLrN classmethodrr$r8r^rrrrr s EgcJJI!,,[,  ) )[ )[")))[)))rrc eZdZdZejddejejeej z  dZ ejddejejeej z  dZ e e zZ ejdd d  d Zejd d d  d ZeezZejddd  dZejddd  dZeezZejdejDZejejedejejdzzZeez dZejeejeeje zejezzZejeZ dddddddddd d! Z!gZ"e#d"Z$e#d#Z%e#d$Z&e#d'd%Z'e#d'd&Z(d S)(OptsSpeca. An OptsSpec is a string specification that describes an OptionTree. It is a list of tree path specifications (using dotted syntax) separated by keyword lists for any of the style, plotting or normalization options. These keyword lists are denoted 'plot(..)', 'style(...)' and 'norm(...)' respectively. These three groups may be specified even more concisely using keyword lists delimited by square brackets, parentheses and braces respectively. All these sets are optional and may be supplied in any order. For instance, the following string: Image (interpolation=None) plot(show_title=False) Curve style(color='r') Would specify an OptionTree where Image has "interpolation=None" for style and 'show_title=False' for plot options. The Curve has a style set such that color='r'. The parser is fairly forgiving; commas between keywords are optional and additional spaces are often allowed. The only restriction is that keywords *must* be immediately followed by the '=' sign (no space). [])content plot_optionszplot[)openercloserrerCr?Nrgrh ignoreExpr style_optionszstyle(rDr@ norm_optionsznorm{cNg|]"}|j tj|j#Sr)rUppLiteralrAs rr)zOptsSpec.s+KKK""(KBH  KKKrr )exactz._pathspechspacevspacez fig_alpha fig_bounds fig_inches fig_latex fig_rcparamsfig_sizexaxisyaxis) horizontal_spacingvertical_spacing figure_alpha figure_bounds figure_inches figure_latexfigure_rcparams figure_size show_xaxis show_yaxiscd|vrdS|ddgkrdSgdD]-}|dkrtd|z.tfdDs%tdd d d g}|D]>}tfd |Dr!td |dd|d?t dkr&ddr d}dvrdnd}nIt dkr&ddr d}dvrdnd}ndvrdnd}dvrdnd}t||S)z Given a normalization parse group (i.e. the contents of the braces), validate the option list and compute the appropriate integer value for the normalization plotting option. rlNr) +framewise -framewise +axiswise -axiswiser z8Normalization specification must not contain repeated %rc3 K|]}|vV dSNr)r%optoptionss rrBz1OptsSpec.process_normalization..s'22c3'>222222rz Normalization option not one of z, )rr)rrc3 K|]}|vV dSrr)r%excludeoptss rrBz1OptsSpec.process_normalization..s'77w7d?777777rz0Normalization specification cannot contain both z and framewiseFrTaxiswiser)rr)r3countrOallr,lenendswithrK) r parse_groupnormoptexcludedpairrrrrs @@rprocess_normalizationzOptsSpec.process_normalizations. + - -tt>*1-4466 2::ddHHH D DGzz'""Q&&!#9;B#CDDD'2222T22222 WU7ASASUUVV V02LM L LD7777$77777 L!#K377#K#KAEa#K#KLLL L t99>>d1g..{;;>H , 4 4%II YY!^^Q 0 0 < <^I*d22ttHH*d22ttH , 4 4%IX'))) )rc#Kt}|D]?}||dd|vpd|vpd|v}|r||fVt}@|r|ifVdSdS)a9 Given a parsed options specification as a list of groups, combine groups without options with the first subsequent group which has options. A line of the form 'A B C [opts] D E [opts_2]' results in [({A, B, C}, [opts]), ({D, E}, [opts_2])] rqrlrfrkN)setadd)rline_parse_resultactive_pathspecsrU has_optionss r_group_paths_without_optionsz%OptsSpec._group_paths_without_optionss55& ) )E  z!2 3 3 3%')%')5(   )&----#&55  '"B& & & & & & ' 'rc |d}d}|jD]c\}}|d|krRt|||d|g|ddzcSd|S)zGConvert any potentially deprecated paths and issue appropriate warningsrFz,Element {old} deprecated. Use {new} instead.r)oldnewr N)split deprecationsrPrQformatr,)rpathrr]rrs rapply_deprecationszOptsSpec.apply_deprecations#s 3<( 3 3HCQx3$$SZZCSZ%A%ABBBxxabb 122222 rc|i}dj|D}t|dkrtd|dd}|d|}||krtd||dj|}i}|D]\}} i} | } | | | d<d | vrI| d d} | d | } fd | D| d <d| vrI| dd}|d| } fd| D| d<|D])}t| |i| ||<*fd| DS)z Parse an options specification, returning a dictionary with path keys and {'plot':, 'style':} values. Ncg|]}|Srrr%ps rr)z"OptsSpec.parse..7s===1===rr Invalid specification syntax.rr%Failed to parse remainder of string: normrfbracketsrRcNi|]!\}}j|||"Sraliasesgetr%kvrs r z"OptsSpec.parse..Ls/"R"R"Rca3;??1Q#7#7"R"R"Rrplotrkr2cNi|]!\}}j|||"Srrrs rrz"OptsSpec.parse..Qs/#S#S#SsqCKOOAa$8$8#S#S#Srstyleczi|]7\}}|d|D8S)c.i|]\}}|tdi|S)r)r)r% option_type option_pairss rrz-OptsSpec.parse...Ws<+++-KW44|44+++r)rrW)r%rrrs rrz"OptsSpec.parse..Vsa   g  " "4 ( (++18+++   r) opts_spec scanStringrrOr4r parseStringrr^rWrr)rlinerRparsese processed grouped_pathsparse pathspecsrUr normalizationplotoptsr styleoptsrqs` rrzOptsSpec.parse/s* :B==cm66t<<=== v;;!  =>> >q ! ARaRI!!TZZ\\11!"V$qrr("V"VWWW889R9RSW9X9XYY  - W W IuG55e<>"R"R"R"RTZZ\\"R"R"R%''!/215 zz)X"z==#S#S#S#Sdjjll#S#S#S % W W"4UYYx5L5Lg"V"Vh W    "'     rc.|i}|||}g}t|D]U}||}i}|D]}t |jfi|}|t|fi|V|S)zr Similar to parse but returns a list of Options objects instead of the dictionary format. Nr)rsortedkeysvaluesrKrTr+r) rrrRparsed options_listspecrmergedrUs r parse_optionszOptsSpec.parse_options^s :B4B'' 6;;==)) 9 9DTlGF )) 6 6el55f55    7 7 7 7 8 8 8 8rr))rrrr_rn nestedExpr OneOrMoreWordallowed quotedStringsetResultsNameplot_options_shortplot_options_longrfstyle_options_shortstyle_options_longrknorm_options_shortnorm_options_longrl MatchFirstr definitionscompositor_opsCombineascii_uppercase alphanums dotted_pathrqGroupOptional spec_grouprrrr`rrrrrrrrrbrb~si2's'*/;r|GBGG$B$B ')::L'"-s/237&&&'5n_&E&E 'h.126%%%&4^O%D%D )+==M'c.126%%%&4^N%C%C & W-015$$$%3N>$B$B ')::L"R]KK (>KKKMMN"*gbgoQ??? ' T(9 : :;<.sCCC1CCCrr rrrrci|] }|j| Sr)r)r%rs rrz(CompositorSpec.parse..s@@@BR@@@rr6)datadisplayz.Either data or display mode must be specified.r rz4Operation %s not available for use with compositors.rrrr) compositor_specrrrOr4r operationsrr,r3r^strr+)rrrRrrrropmaprUr6rT operationr definitions rrzCompositorSpec.parses :B CCc1<> >q ! ARaRI!!TZZ\\11!"V$qrr("V"VWWW@@**?@@@(44T:: + +Ee##f =P(P(P!"RSSS=DFeDk*I88E&M00221566Dd 5((!"X$)$K#0111&&E-$8$;ZBOO#CIIy#eGn:M:Mt^^W]^^J   z * * * *rr)rrrr_rnralphasnumsrr6rr overlay_specrrrrrrr`rrrrrrss{ 2729RW$S( ) ) 8 8 @ @D 27"3& ' ' 6 6t < r su   2222222222******"""""". i .----E'---}),,, ZZZZZZZZ|pppppvpppjIIIIIVIIIIIr