a h4@s(ddlmZddlmZmZmZddlmZddlm Z m Z ddl m Z eegefee gefee e gefeee e geffZGdddZd d d d d Zdd dddZdd dddddZdd dddZee_d%ddd dddZe deZe d eZe d!eZe d"eZe d#eZd$S)&) annotations)UnionCallableAny)ParseException)colreplaced_by_pep8) ParseResultsc@s<eZdZdZdddddZddd d d d d Zd dZdS)OnlyOncez Wrapper for parse actions, to ensure they are only called once. Note: parse action signature must include all 3 arguments. z'Callable[[str, int, ParseResults], Any]None) method_callreturncCs ddlm}|||_d|_dS)Nr) _trim_arityF)corercallablecalled)selfr rr^/mounts/lovelace/software/anaconda3/envs/py39/lib/python3.9/site-packages/pyparsing/actions.py__init__s  zOnlyOnce.__init__strintr sltrcCs.|js||||}d|_|St||ddS)NTz.OnlyOnce obj called multiple times w/out reset)rrr)rrrrresultsrrr__call__s zOnlyOnce.__call__cCs d|_dS)zK Allow the associated parse action to be called once more. FN)r)rrrrreset&szOnlyOnce.resetN)__name__ __module__ __qualname____doc__rrrrrrrr sr r ParseAction)nrcsdddddfdd }|S)zt Helper method for defining parse actions that require matching at a specific column in the input text. rrr r )strglocntoksrcs$t||kr t||ddS)Nzmatched token not at column )rr)r&r'r(r%rr verify_col4sz%match_only_at_col..verify_colr)r%r*rr)rmatch_only_at_col.sr+r)repl_strrcs fddS)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], {}) csgS)Nrrrrr,rrLzreplace_with..rr.rr.r replace_with;sr1rr rcCs|dddS)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'], {}) rrrr-rrr remove_quotesOsr3ztuple[str, str])argsrcs>g|r|n|dddddfdd }|S)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 rrr r )rrtokensrc sbD]X\}}||vr$t||d||tjkr|||krt||d|d||d|qdS)Nzno matching attribute z attribute z has value z , must be )rwith_attribute ANY_VALUE)rrr5ZattrNameZ attrValueZ attrs_listrrpas zwith_attribute..pa)extenditems)r4Z attr_dictr9rr8rr6fs I  r6) classname namespacercCs$|r|dnd}tfi||iS)a  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:classclass)r6)r=r>Z classattrrrr with_classs6r@ replaceWith removeQuotes withAttribute withClassmatchOnlyAtColN)r<) __future__rtypingrrr exceptionsrutilrr rr rrr$r r+r1r3r6objectr7r@rArBrCrDrErrrrs.      ]<