o 6Wj@sddlmZddlmZmZmZddlmZddlm Z m Z ddl m Z eegefee gefee e gefeee e geffZGdddZd)d dZd*ddZd+ddZd,ddZee_ d-d.d!d"Ze d#eZe d$eZe d%eZe d&eZe d'eZd(S)/) annotations)UnionCallableAny)ParseException)colreplaced_by_pep8) ParseResultsc@s,eZdZdZdddZdddZddZdS)OnlyOncez Wrapper for parse actions, to ensure they are only called once. Note: parse action signature must include all 3 arguments. method_call'Callable[[str, int, ParseResults], Any]returnNonecCs ddlm}|||_d|_dS)Nr) _trim_arityF)corercallablecalled)selfr rr`/home/esfera/Documents/content_generation/venv/lib/python3.10/site-packages/pyparsing/actions.py__init__s   zOnlyOnce.__init__sstrlinttr cCs*|js||||}d|_|St||d)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&s zOnlyOnce.resetN)r r rr)rrrrrr rr )__name__ __module__ __qualname____doc__rrrrrrrr s    r nrr ParseActioncsd fd d }|S) zt Helper method for defining parse actions that require matching at a specific column in the input text. strgrlocnrtoksr rrcs$t||krt||ddS)Nzmatched token not at column )rr)r&r'r(r$rr verify_col4sz%match_only_at_col..verify_colN)r&rr'rr(r rrr)r$r*rr)rmatch_only_at_col.sr+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,rrLszreplace_with..rr.rr.r replace_with;s r0rrrrr cCs|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_quotesOsr2argstuple[str, str]cs4g|r |n|d fd d }|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 rrrrtokensr rrc sdD]-\}}||vrt||d||tjkr/|||kr/t||d|d||d|qdS)Nzno matching attribute z attribute z has value z , must be )rwith_attribute ANY_VALUE)rrr5attrName attrValue attrs_listrrpas zwith_attribute..paN)rrrrr5r rr)extenditems)r3 attr_dictr<rr:rr6fs I  r6 classname namespacecCs$|r|dnd}tdi||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:classclassNr)r6)rArB classattrrrr with_classs6rE replaceWith removeQuotes withAttribute withClassmatchOnlyAtColN)r$rrr%)r,rrr%)rrrrrr rr)r3r4rr%)r@)rArrBrrr%) __future__rtypingrrr exceptionsrutilrr rr rrr%r r+r0r2r6objectr7rErFrGrHrIrJrrrrs2        ]  <