§
    ~ÛgN#  ã                   ó^  — d Z ddlmZ  G d„ de¦  «        Z eddddd¦  «        Zd	Zej        ZeZd
Zddl	T ddl
T ddlT ddlmZmZ ddlT ddlT ddlmZ ddlT ddlmZ ddlmZmZmZ ddlmZ ddlmZmZ d e¦   «         vreZd e¦   «         vreZd e¦   «         vreZeeez   z  Zg d¢ZdS )a  
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and
executing simple grammars, vs. the traditional lex/yacc approach, or the
use of regular expressions.  With pyparsing, you don't need to learn
a new syntax for defining grammars or matching expressions - the parsing
module provides a library of classes that you use to construct the
grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form
``"<salutation>, <addressee>!"``), built up using :class:`Word`,
:class:`Literal`, and :class:`And` elements
(the :meth:`'+'<ParserElement.__add__>` operators create :class:`And` expressions,
and the strings are auto-converted to :class:`Literal` expressions)::

    from pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print(hello, "->", greet.parse_string(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the
self-explanatory class names, and the use of :class:`'+'<And>`,
:class:`'|'<MatchFirst>`, :class:`'^'<Or>` and :class:`'&'<Each>` operators.

The :class:`ParseResults` object returned from
:class:`ParserElement.parse_string` can be
accessed as a nested list, a dictionary, or an object with named
attributes.

The pyparsing module handles some of the problems that are typically
vexing when writing text parsers:

  - extra or missing whitespace (the above program will also handle
    "Hello,World!", "Hello  ,  World  !", etc.)
  - quoted strings
  - embedded comments


Getting Started -
-----------------
Visit the classes :class:`ParserElement` and :class:`ParseResults` to
see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:

 - construct literal match expressions from :class:`Literal` and
   :class:`CaselessLiteral` classes
 - construct character word-group expressions using the :class:`Word`
   class
 - see how to create repetitive expressions using :class:`ZeroOrMore`
   and :class:`OneOrMore` classes
 - use :class:`'+'<And>`, :class:`'|'<MatchFirst>`, :class:`'^'<Or>`,
   and :class:`'&'<Each>` operators to combine simple expressions into
   more complex ones
 - associate names with your parsed results using
   :class:`ParserElement.set_results_name`
 - access the parsed data, which is returned as a :class:`ParseResults`
   object
 - find some helpful expression short-cuts like :class:`DelimitedList`
   and :class:`one_of`
 - find more useful common expressions in the :class:`pyparsing_common`
   namespace class
é    )Ú
NamedTuplec                   ód   — e Zd ZU eed<   eed<   eed<   eed<   eed<   ed„ ¦   «         Zd„ Zd„ Z	d	S )
Úversion_infoÚmajorÚminorÚmicroÚreleaselevelÚserialc                 ó®   — | j         › d| j        › d| j        › �| j        d         dk    rdnd› | j        d         › | j        › �df| j        dk             z   S )Nú.r   ÚcÚrÚ Úfinal)r   r   r   r	   r
   ©Úselfs    úH/granary/edev/quantum/lib/python3.11/site-packages/pyparsing/__init__.pyÚ__version__zversion_info.__version__j   s}   € ð ŒzÐ5Ð5˜DœJÐ5Ð5¨¬Ð5Ð5àÔ+¨AÔ.°#Ò5Ð5�3�3¸2Ðb¸tÔ?PÐQRÔ?SÐbÐUYÔU`ÐbÐbØðð Ô 7Ò*ô,ñ,ð	
ó    c                 ó4   — t           › d| j        › dt          › �S )Nú z / )Ú__name__r   Ú__version_time__r   s    r   Ú__str__zversion_info.__str__t   s"   € ÝÐDÐD˜TÔ-ÐDÐDÕ2BÐDÐDÐDr   c                 ó¦   — t           › dt          | ¦  «        j         › dd                     d„ t          | j        | ¦  «        D ¦   «         ¦  «        › d�S )Nr   ú(z, c              3   ó*   K  — | ]} d j         |Ž V — ŒdS )z{}={!r}N)Úformat)Ú.0Únvs     r   ú	<genexpr>z(version_info.__repr__.<locals>.<genexpr>x   s.   è è € Ð<uÐ<uÐWYÐ=M¸YÔ=MÈrÐ=RÐ<uÐ<uÐ<uÐ<uÐ<uÐ<ur   ú))r   ÚtypeÚjoinÚzipÚ_fieldsr   s    r   Ú__repr__zversion_info.__repr__w   sU   € ÝÐxÐx�T $™ZœZÔ0ÐxÐx°4·9²9Ð<uÐ<uÕ]`ÐaeÔamÐosÑ]tÔ]tÐ<uÑ<uÔ<uÑ3uÔ3uÐxÐxÐxÐxr   N)
r   Ú
__module__Ú__qualname__ÚintÚ__annotations__ÚstrÚpropertyr   r   r'   © r   r   r   r   c   s…   € € € € € € Ø€J€J�JØ€J€J�JØ€J€J�JØÐÐÑØ€K€K�Kàð
ð 
ñ „Xð
ðEð Eð Eðyð yð yð yð yr   r   é   é   é   r   z31 Dec 2024 20:41 UTCz+Paul McGuire <ptmcg.gm+pyparsing@gmail.com>)Ú*)Ú__diag__Ú
__compat__)Ú_builtin_exprs)Úunicode_setÚUnicodeRangeListÚpyparsing_unicode)Úpyparsing_test)Úpyparsing_commonr5   r8   r:   r9   )§r   r   Ú
__author__r4   r3   ÚAndÚAtLineStartÚAtStringStartÚCaselessKeywordÚCaselessLiteralÚ
CharsNotInÚ
CloseMatchÚCombineÚDelimitedListÚDictÚEachÚEmptyÚ
FollowedByÚForwardÚ
GoToColumnÚGroupÚIndentedBlockÚKeywordÚLineEndÚ	LineStartÚLiteralÚLocatedÚ
PrecededByÚ
MatchFirstÚNoMatchÚNotAnyÚ	OneOrMoreÚOnlyOnceÚOpAssocÚOptÚOptionalÚOrÚParseBaseExceptionÚParseElementEnhanceÚParseExceptionÚParseExpressionÚParseFatalExceptionÚParseResultsÚParseSyntaxExceptionÚParserElementÚPositionTokenÚQuotedStringÚRecursiveGrammarExceptionÚRegexÚSkipToÚ	StringEndÚStringStartÚSuppressÚTagÚTokenÚTokenConverterÚWhiteÚWordÚWordEndÚ	WordStartÚ
ZeroOrMoreÚCharÚ	alphanumsÚalphasÚ
alphas8bitÚany_close_tagÚany_open_tagÚautoname_elementsÚc_style_commentÚcolÚcommon_html_entityÚcondition_as_parse_actionÚcounted_arrayÚcpp_style_commentÚdbl_quoted_stringÚdbl_slash_commentÚdelimited_listÚdict_ofÚemptyÚhexnumsÚhtml_commentÚ
identcharsÚidentbodycharsÚinfix_notationÚjava_style_commentÚlineÚline_endÚ
line_startÚlinenoÚmake_html_tagsÚmake_xml_tagsÚmatch_only_at_colÚmatch_previous_exprÚmatch_previous_literalÚnested_exprÚnull_debug_actionÚnumsÚone_ofÚoriginal_text_forÚ
printablesÚpunc8bitr:   r9   r8   Úpython_style_commentÚquoted_stringÚremove_quotesÚreplace_withÚreplace_html_entityÚrest_of_lineÚsgl_quoted_stringÚsrangeÚ
string_endÚstring_startÚ	token_mapÚtrace_parse_actionÚungroupr6   Úunicode_stringÚwith_attributeÚ
with_classÚ__versionTime__ÚanyCloseTagÚ
anyOpenTagÚcStyleCommentÚcommonHTMLEntityÚconditionAsParseActionÚcountedArrayÚcppStyleCommentÚdblQuotedStringÚdblSlashCommentÚdelimitedListÚdictOfÚhtmlCommentÚindentedBlockÚinfixNotationÚjavaStyleCommentÚlineEndÚ	lineStartÚlocatedExprÚmakeHTMLTagsÚmakeXMLTagsÚmatchOnlyAtColÚmatchPreviousExprÚmatchPreviousLiteralÚ
nestedExprÚnullDebugActionÚoneOfÚopAssocÚoriginalTextForÚpythonStyleCommentÚquotedStringÚremoveQuotesÚreplaceHTMLEntityÚreplaceWithÚ
restOfLineÚsglQuotedStringÚ	stringEndÚstringStartÚtokenMapÚtraceParseActionÚunicodeStringÚwithAttributeÚ	withClassÚcommonÚunicodeÚtestingN)Ú__doc__Útypingr   r   Ú__version_info__r   r   r¬   r;   ÚutilÚ
exceptionsÚactionsÚcorer3   r4   Úresultsr5   Úcore_builtin_exprsÚhelpersÚhelper_builtin_exprsrØ   r6   r7   r8   rÙ   r9   r×   r:   Úcommon_builtin_exprsÚglobalsÚ__all__r.   r   r   ú<module>rè      sÒ  ðð2F€ðN Ð Ð Ð Ð Ð ðyð yð yð yð y�:ñ yô yð yð0  �<  1 a¨°!Ñ4Ô4Ð Ø*Ð ØÔ*€Ø"€Ø:€
à Ð Ð Ð Ø Ð Ð Ð Ø Ð Ð Ð Ø &Ð &Ð &Ð &Ð &Ð &Ð &Ð &Ø Ð Ð Ð Ø Ð Ð Ð Ø 6Ð 6Ð 6Ð 6Ð 6Ð 6Ø Ð Ð Ð Ø ;Ð ;Ð ;Ð ;Ð ;Ð ;à PÐ PÐ PÐ PÐ PÐ PÐ PÐ PÐ PÐ PØ .Ð .Ð .Ð .Ð .Ð .ðð ð ð ð ð ð ð ð ˜g˜g™iœiÐ'Ð'ØÐØ˜W˜W™YœYÐ&Ð&ØÐØ˜7˜7™9œ9Ð$Ð$Ø€Nà Ð*Ð-AÑAÑ AÐ ðið ið i€€€r   