+ TBi4^RIHt^RIHtHtHt^RIHt^RIH t H t ^RI H t ]].]3,]] .]3,]] ] .]3,]]] ] .]3,3,t!RR4tRR ltR R ltR R ltRRlt]!4]nRRRllt] !R]4t] !R]4t] !R]4t] !R]4t] !R]4tR#)) annotations)UnionCallableAny)ParseException)colreplaced_by_pep8) ParseResultsc8]tRt^tRtRRltRRltRtRtR#) OnlyOncez| Wrapper for parse actions, to ensure they are only called once. Note: parse action signature must include all 3 arguments. c V^8dQhRRRR/#) method_callz'Callable[[str, int, ParseResults], Any]returnNone)formats"6/usr/lib/python3.14/site-packages/pyparsing/actions.py __annotate__OnlyOnce.__annotate__s$KPTc :^RIHpV!V4VnRVnR#)) _trim_arityFN)corercallablecalled)selfrrs&& r__init__OnlyOnce.__init__s%#K0  rc(V^8dQhRRRRRRRR/#)rsstrlinttr rr)rs"rrrs.UU#U#U,U<Urc tVP'gVPWV4pRVnV#\WR4h)Tz.OnlyOnce obj called multiple times w/out reset)rrr)rr"r$r&resultss&&&& r__call__OnlyOnce.__call__s5{{{mmA!,GDKNQ#STTrc RVnR#)z; Allow the associated parse action to be called once more. FN)r)rs&rresetOnlyOnce.reset&s  r)rrN) __name__ __module__ __qualname____firstlineno____doc__rr)r,__static_attributes__rrrr r s  Urr c V^8dQhRRRR/#)rnr%r ParseActionr)rs"rrr.s    rcaRV3RllpV#)zh Helper method for defining parse actions that require matching at a specific column in the input text. c(V^8dQhRRRRRRRR/#) rstrgr#locnr%toksr rrr)rs"rr'match_only_at_col..__annotate__4s.QQQCQ|QQrcF<\W4S8wd\WRS 24hR#)zmatched token not at column N)rr)r9r:r;r5s&&&r verify_col%match_only_at_col..verify_col4s) t?a  /KA3-OP P rr)r5r>sf rmatch_only_at_colr@.s QQ rc V^8dQhRRRR/#)rrepl_strrrr6r)rs"rrr;s&&3&;&rcaV3Rl#)a Helper method for common parse actions that simply return a literal value. Especially useful when used with :meth:`~ParserElement.transform_string`. Example: .. doctest:: >>> num = Word(nums).set_parse_action(lambda toks: int(toks[0])) >>> na = one_of("N/A NA").set_parse_action(replace_with(math.nan)) >>> term = na | num >>> term[1, ...].parse_string("324 234 N/A 234") ParseResults([324, 234, nan, 234], {}) c <S.#)Nr)r"r$r&rBs&&&rreplace_with..LsH:rr)rBsfr replace_withrG;s " &%rc(V^8dQhRRRRRRRR/#) rr"r#r$r%r&r rrr)rs"rrrOs(SS\crcV^,^R#)a Helper parse action for removing quotation marks from parsed quoted strings, that use a single character for quoting. For parsing strings that may have multiple characters, use the :class:`QuotedString` class. Example: .. doctest:: >>> # by default, quotation marks are included in parsed results >>> quoted_string.parse_string("'Now is the Winter of our Discontent'") ParseResults(["'Now is the Winter of our Discontent'"], {}) >>> # use remove_quotes to strip quotation marks from parsed results >>> dequoted = quoted_string().set_parse_action(remove_quotes) >>> dequoted.parse_string("'Now is the Winter of our Discontent'") ParseResults(['Now is the Winter of our Discontent'], {}) r)r"r$r&s&&&r remove_quotesrKOs( Q4":rc V^8dQhRRRR/#)rargsztuple[str, str]rr6r)rs"rrrfsZZ/Z;Zrca.oV'dSPV4MSPVP44RV3RllpV#)a# Helper to create a validating parse action to be used with start tags created with :class:`make_xml_tags` or :class:`make_html_tags`. Use ``with_attribute`` to qualify a starting tag with a required attribute value, to avoid false matches on common tags such as ```` or ``
``. Call ``with_attribute`` with a series of attribute names and values. Specify the list of filter attributes names and values as: - keyword arguments, as in ``(align="right")``, or - as an explicit dict with ``**`` operator, when an attribute name is also a Python reserved word, as in ``**{"class":"Customer", "align":"right"}`` - a list of name-value tuples, as in ``(("ns1:class", "Customer"), ("ns2:align", "right"))`` For attribute names with a namespace prefix, you must use the second form. Attribute names are matched insensitive to upper/lower case. If just testing for ``class`` (with or without a namespace), use :class:`with_class`. To verify that the attribute exists, but without specifying a value, pass ``with_attribute.ANY_VALUE`` as the value. The next two examples use the following input data and tag parsers: .. testcode:: html = '''
Some text
1 4 0 1 0
1,3 2,3 1,1
this has no type
''' div,div_end = make_html_tags("div") Only match div tag having a type attribute with value "grid": .. testcode:: div_grid = div().set_parse_action(with_attribute(type="grid")) grid_expr = div_grid + SkipTo(div | div_end)("body") for grid_header in grid_expr.search_string(html): print(grid_header.body) prints: .. testoutput:: 1 4 0 1 0 Construct a match with any div tag having a type attribute, regardless of the value: .. testcode:: div_any_type = div().set_parse_action( with_attribute(type=with_attribute.ANY_VALUE) ) div_expr = div_any_type + SkipTo(div | div_end)("body") for div_header in div_expr.search_string(html): print(div_header.body) prints: .. testoutput:: 1 4 0 1 0 1,3 2,3 1,1 c(V^8dQhRRRRRRRR/#) rr"r#r$r%tokensr rrr)rs"rr$with_attribute..__annotate__s(  c c < D rc <SFawr4W29d\WRV,4hV\P8wgK5W#,V8wgKD\VVRV: RW#,: RV: 24h R#)zno matching attribute z attribute z has value z , must be N)rwith_attribute ANY_VALUE)r"r$rPattrName attrValue attrs_lists&&& rpawith_attribute..pasp#- H%$Q+Ch+NOON4449IY9V$  K8H7K:V_Ubc $.r)extenditems)rM attr_dictrXrWs*, @rrSrSfsBR)+J $)//+,   Irc$V^8dQhRRRRRR/#)r classnamer# namespacerr6r)rs"rrrs!7474#74#74{74rc8V'dV R2MRp\R/W /B#)ay Simplified version of :meth:`with_attribute` when matching on a div class - made difficult because ``class`` is a reserved word in Python. Using similar input data to the :meth:`with_attribute` examples: .. testcode:: html = '''
Some text
1 4 0 1 0
1,3 2,3 1,1
this <div> has no class
''' div,div_end = make_html_tags("div") Only match div tag having the "grid" class: .. testcode:: div_grid = div().set_parse_action(with_class("grid")) grid_expr = div_grid + SkipTo(div | div_end)("body") for grid_header in grid_expr.search_string(html): print(grid_header.body) prints: .. testoutput:: 1 4 0 1 0 Construct a match with any div tag having a class attribute, regardless of the value: .. testcode:: div_any_type = div().set_parse_action( with_class(withAttribute.ANY_VALUE) ) div_expr = div_any_type + SkipTo(div | div_end)("body") for div_header in div_expr.search_string(html): print(div_header.body) prints: .. testoutput:: 1 4 0 1 0 1,3 2,3 1,1 z:classclassr)rS)r^r_ classattrs&& r with_classrcs&l)29+V$wI  3Y2 33r replaceWith removeQuotes withAttribute withClassmatchOnlyAtColN)) __future__rtypingrrr exceptionsrutilrr r(r r%r#r6r r@rGrKrSobjectrTrcrdrerfrgrhrrrros"''&'! RW l^S ! c< # %& c3 %s *+- 6 &(.Zz"874x}l;  >  .A [* 5 !"24EFr