?e?ddlmZddlZddlmZmZddlmZddlm Z ddl m Z dd l m Z dd lmZmZdd lmZdd lmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3dd l4m5Z5m6Z6ddl7m8Z8m9Z9m:Z:m;Z;mZ>ddl=m?Z?ddl@mAZAmBZBGddZCGddZDGddZEGddeFZGdS))partialN)lexyacc)get_bindings_configuration) UserException)ErrorLog)instantiate_class)invalid_global_slotslot_name_detail_map) ScopedName) AccessSpecifierArgument ArgumentType ArrayArgument CachedNameClassKey CodeBlock ConstructorDocstringFormatDocstringSignature EnumBaseType GILAction IfaceFile IfaceFileTypeKwArgs MappedTypeMemberModuleOverloadPyQtMethodSpecifierPySlot Qualifier QualifierType SignatureSourceLocation SpecificationTransfer TypeHints WrappedClassWrappedException WrappedEnumWrappedEnumMember)encoded_template_namesame_template_signature)argument_as_str cached_namefind_iface_filenormalised_scoped_namesame_base_type)rules)tokens)InvalidAnnotationvalidate_annotation_valuec xeZdZdZdZdZ dLdZdZ dMdZdLd Z dNd Z dMd Z d Z d Z dZddddddddddd dZdZdOdZdZdZdZdZdZ dPdZdZdZdZdLdZdLdZdZ dQd Zd!ZdRd#Z d$Z!d%Z"d&Z#e$d'Z%d(Z&d)Z'd*Z(d+Z)d,Z*d-Z+d.Z, dSd/Z-dLd0Z.dTd2Z/e$d3Z0e$d4Z1e1j2d5Z1e$d6Z3e3j2d7Z3e$d8Z4d9Z5d:Z6d;Z7d<Z8d=Z9d>Z: dLd?Z;d@ZdCZ?dDZ@dMdEZAdFZBdGZCdHZDdIZEdJZFdKZGdS)U ParserManagerzr This object manages the actual lexer and parser objects providing them with state and utility functions. c tjt|_||j_t jt d|_||j_|jt _g|_||_ ttd| dD| ||_ |j jg|_d|_d|_d|_d|_d|_d|_d|_dg|_||_||_||_||_||_g|_g|_t?|_ g|_!d|_"d|_#g|_$d|_%g|_&dS)z Initialise the manager. )moduleF)r>debugc,g|]}t|S)int).0vs Hlib/python3.11/site-packages/sipbuild/generator/parser/parser_manager.py z*ParserManager.__init__..Qs>>>!s1vv>>>.Nr)'rr8_lexerpmrr7_parserparserclass_templatestagsr(tuplesplitspecr>modules c_bindings code_block module_state paren_depthparsing_templateparsing_virtual raw_sip_file skip_stack _hex_version _encoding_disabled_features_protected_is_public _include_dirs_template_arg_classes _scope_stackr _error_log _file_stack_pending_module_state_input_all_sip_files _sip_file _sip_files) self hex_versionencoding abi_versionrNdisabled_featuresprotected_is_public include_dirs sip_module is_stricts rE__init__zParserManager.__init__9sc gV,,,  yU;;;  |  " !>>{'8'8'='=>>>??  ()   %$  '(!"3$7!)%'""**%)"  rGc  |j}|rC|j;|jjj|jjjkr|||dn7t |jdkr|||dnd|_||jjj|}t|j ||_ | dd|_ | d}|t|j ||_| d }|t|j ||_| d d|_| d d|_| d } | | |j_||||d d} | | |_d|_||||dd} | | |_| dd|_| d|_|jr| dd|_n/|jt4j|_| dd|_t |jdkrr|jskt=t?t@j!} tEt4j| | } | |_#|j$| d|_%|j#hd}|jD]W} | j&t4jurt | j'j(dks| j'j(dj) | |_#n || }X||_#| dd|_*|j+| ddrd|_,| ddrd|_-d|_.d|_%| dd|_/|j/rd|j0j1_2dx}}|j3D]}|j4tjj6tjj7tjj8fvrd}|j4tjj9tjj:tjj;tjj<tjj=tjj>tjj?tjj@tjjAtjjBf vrd}| o|}|j3D]}|jCr |jDs|r|j4tjjEurtjjF|_48|j4tjjGurtjjH|_4]|j4tjjIurtjjJ|_4|j4tjjKurtjjL|_4|jMrd|jjN_Od|j _O|P|Q|||||jr|j|||d|S)zg Complete the definition of the class that is the current scope, pop it and return it. NzKa scoped name cannot be specified in the definition of a class/struct/unionrz4the class/struct has super-classes but no definitionT NoTypeHintFMetatype Supertype ExportDerivedMixin FileExtensionPyQtFlagsEnumsPyQt5r6 PyQtFlagsPyQtNoQMetaObject PyQtInterfaceExternalNoDefaultCtorsresult) py_signature cpp_signature Deprecated AllowNoneAbstract DelayDtor)ignorezJ/External/ classes/structs/unions can only be declared in the global scope)Rscope iface_file fq_cpp_name parser_errorlen superclasses is_opaque get_py_name base_namer2rQpy_nameget no_type_hintmetatype supertypeexport_derivedmixinfile_extension_get_plugin_annotationpyqt_flags_enums pyqt_flagspyqt_no_qmetaobjectpyqt_interfaceexternaldtorrPUBLICno_default_ctorsctorsr&rrVOIDr default_ctorappend can_createaccess_specifierrargs default_value deprecatedconvert_to_type_code handles_none is_abstract is_incomplete delay_dtorrUr>has_delayed_dtorsmemberspy_slotr#GETITEMSETITEMDELITEMSUBISUBMODIMODFLOORDIV IFLOORDIVTRUEDIVITRUEDIVPOSNEG is_numeric is_sequenceADDCONCATIADDICONCATMULREPEATIMULIREPEATin_main_modulecpp_nameused pop_scopecheck_attributes)ripsymbol annotationshas_bodyklassrrrrrr signaturector last_resort seq_mightseq_notmddefault_to_sequences rEcomplete_classzParserManager.complete_classqs    #{&#/59O9[[[%%aikkk # $ $ ) )   aJ L L L L#EO""5#3#?#I#DIw77 (__\5AA??:..  (H==ENOOK00  )$)Y??EO*FF!oogu55 $99  %.4%84zVZ//%+] v{22%+^ vz11%+] v{22%+^   &-1E  % *!%EM   a??? > bdj4   a` b b b rGNc V|||tjt||j|d||||}||_||_| ||tjur tj n tj dS)z3 Create a new class and make it the current scope. VirtualErrorHandler)virtual_error_handler type_hintsN) new_classrCLASSr4rrget_type_hints class_keyr push_scoperrPRIVATEr)rirrr scoped_namerrrs rE define_classzParserManager.define_classsq&-*=&{DJ??&1oo6K&L&L..q&+FFHH $) +4+F+F''OLb d d d d drGc||vr|}n7|dkrd}n.|drd}ndD] }||vrd}n d|vrd}nd}|S)z/ Disambiguate a token by inspecting its value. z...ELLIPSISrH FILE_PATH)/z..- DOTTED_NAMENAME) startswith)rivaluekeywords token_typemarkers rEdisambiguate_tokenz ParserManager.disambiguate_tokens H  JJ e^^#JJ   c " " ($JJ* ( (U??!,JE#%<>zJJO'z: /111  ##K000rGcT|jtjur|||d|j}|C|jtjur#|jsd|_|tj urd|_ |j j }nd}t|jrt|j}d}|||||} |tjur#| j j|||d|| _|jj| j _|| _|| _|| j j ||tjurb|jjD]U} | | ur| j jtjur | j j| j jkr;| | _|jr d| j _V| S)zJ Create a new, unannotated class and add it to the current scope. zSclasses, structs, unions and namespaces must be in the public or protected sectionsNTz/the class/struct/union has already been defined)scope_access_specifierrrrr PROTECTEDr^ is_protectedrr needs_shadowrtype_header_codeboolrSrrr NAMESPACEr>rUrrextendrQclassesrr real_classrneeded) rirrrrrrrr rnss rErzParserManager.new_classks  &/*A A A   ai k k k   *o.GGGPTPiG%)""m&999)-E& %/@  #    %[%:;;KE6?KHH -"9 9 9e>N>U>a   aE G G G "&"3":&;#%  '   - 4 45E F F F m5 5 5i' 0 0;;=%]-DDD=,0@0LLL#% &0+/BM( rGcx|jjD]B}|j|ur7|js, |j|n#t $rYnwxYw|cSCt|t|j|j j d}|r|j ||jj d||S)z^ Return a WrappedClass object for an interface file creating it if necessary. Nr) rQr rrWr`remove ValueErrorr+r2rrrinsert)rirrrs rErz)ParserManager._find_class_with_iface_files Y&  E:--,299%@@@@% .ZDIz'='GHH$PP  5  & - -e 4 4 4   E*** s; AAc:|j} ||| jjjkr|||dt |jr,t|dkr| |||d|j|||d|j } | tj ur|j r tj } t|tt j} |||| t'| | } |ddr3||||d | |||d n(|| | _n|||||| _|d dr&| j| | _n|||d || _||||| _|d d| _| tjur9||||| | _d| _| tj urd| _| | _ |dd| _!|d| _"|d| _#|| _$|| _%| >|d)|j&j's|ddrd| _(|)|||| _*| j+,| dS)z7 Create a Constructor and add it to the current scope. z3constructor doesn't have the same name as its classrNzAconstructors with arguments in C modules must specify %MethodCodezAconstructors must be in the public, protected or private sectionsrr NoDerivedFz?/NoDerived/ may not be specified with an explicit C++ signaturez>%MethodCode must also be specified if /NoDerived/ is specifiedDefaultz > >   aI K K K   YS]]a%7%7K> ?#: : :,,Q  ""DL#E ?#<<<%)"&'OOL%@@# 33 "y11 ,$  ;??3H#I#I#Q 7 0;??K^`e;f;f 0+/())!V[AA  4     rGcN|j} || jjjkr|||d| j|||dt |jr||||d|j|||d|j rI|jj tj ur|||d| |||dn|r|||d|j | _||||| _|| _| | _|| j||| j||rd | _|j st+| jd kr d | _dSdS) z" Add a dtor to the current scope. z2destructor doesn't have the same name as its classNz#destructor has already been definedz1destructors in C modules must specify %MethodCodez@destructors must be in the public, protected or private sectionsz(a union cannot have a virtual destructorz;destructors in C modules cannot specify %VirtualCatcherCodez&an abstract destructor must be virtualTr)rrrrrrr rSrrXrrUNIONrr dtor_gil_actiondtor_throw_argsdtor_virtual_catcher_code dealloc_coderrrr) rirrnamerrabstractr'r$virtual_catcher_coders rEadd_dtorzParserManager.add_dtors  5#/9 9 9   aH J J J : !   a)N O O O   I[%8   aG I I I  + 7   aV X X X   >z#x~55!!!VBDDD$/!!!VUWWW  >   a< > > >0 $ 4 4Q L L **>'  %   % %n 5 5 5  "   % %k 2 2 2  % $E    &3u'9#:#:a#?#?!%E   $@#?rGc l|jtjur|||d|r|||d|d}t j}||jj dkr|||d|dkr t j}nv|dkr t j }nc|d kr t j }nP|d kr t j }n=|d kr t j }n*||d d ||d} d} d} nt||j} t#|jt%| } t#|j|||} |||| |jrd| _d| _t/|| |jj| || |j} |jtjur|jsd| _d|j_|dd| _|dd| _|D]]\} }}|s||||j | j!"tG| || ||jrd|_^|jj$%d| dS)z4 Create a new enum and add it to the current scope. zclass enums cannot be privatez scoped enumsBaseTypeN rz4/BaseType/ is only supported for ABI v13.0 and laterEnumFlagIntEnumUIntEnumIntFlagr6z''{0}' is an invalid value of /BaseType/T)cached_fq_cpp_name is_scopedrrNoScopeFrt)rr)&rrrrcpp_onlyrrENUMrQrlFLAGINT_ENUMUNSIGNED_INT_ENUMINT_FLAGformatr4rr2strrrrrr-rUr>rr^rrno_scoperr5rrr.enumsr)rirrrrCrr base_type_s base_typerrBrw_enum m_cpp_name m_py_namem_no_type_hints rEadd_enumzParserManager.add_enumMs  &/*A A A   a)H I I I  5 MM!V^ 4 4 4"ooj11  %  "y$w..!!!VNPPPf$$(- &&(-  ))(1  **(:  ))(1 !!!QAHH +--...  K!% GG04:FFK!,TYK8H8H!I!I !$)$$X{;;==G  ! !!VW 5 5 5" $*."'# Y T5F5M#5tz333  &/*C C C, /&*#*. '%//)U;;)oolEBB6= & & 1J > A%%a@@@ N ! !%j)V)7999 : : :" &!%  q&)))))rG) constfinalrr6rrr'r$r7virtual_call_codec  |||}t||}||||| |} n|||| |||||||}t |j||| |}|jjjD],}||ur&|jjj |n -|j j ||j |_ |jtjur|jrtj|_d|_|jtjurd|j _d|_|jtjur|j t,jur d|j _| |_| |_||_|dk|_||_| |_| |_||_||_ |!|||_"|j d}||vr d|j _#|$dd|_%|$d}||&||| |_'|(||||_)|$d d|_*|$d d|_+|$d d|_,|-||||_.|jtj/ur|j0|j0tbj2ur|3|||||j |_4|j4tjj6urd|_7|j t,jur|jtjurq|j8sj|j j D]]}|j9|ur |j4tjj6ur |j:j;D]0}|j4tjj<ur|j=|j> d|j>_?1^|$dd|_@|$d|_A|$d|_B|>|$d)|jjCs|$ddrd|_D|$d|_E|$dd|_F|$ddr&|jGr|H||dnd|_I|$ddr&|jIr|H||dnd|_G|J|||j:jK|||_Ld|vrv|}|0tddN|}||j _OtttjR}|S|||d|||d|vr|S|||d|| |d|vr|S|||d|| ||S) z@ Create and return an Overload and add it to the current scope. rNT __delattr__)__getattribute__ __getattr__ __enter____exit__ __aenter__ __aexit__AbortOnExceptionFAutoGen)r5Factoryr NewThread) need_namertrrrrrNoVirtualErrorHandlerNumericz,an overload has already specified /Sequence/Sequencez+an overload has already specified /Numeric/__len__zAuto-generatedz0 sipRes = (Py_ssize_t)sipCpp->{0}(); )textr __matmul__ __imatmul__)Trr&r _find_memberr!rrUr>global_functions overloadsrrrpyqt_method_specifierrrrr^raccess_is_really_protectedr has_protectedr"SIGNALrris_const is_delattris_finalr'r(rXr7get_source_locationsource_locationhas_nonlazy_methodrabort_on_exceptionevaluate_feature_or_platformis_auto_generatedr r!factoryr new_threadr+r,rrr#CALLr"r#rNONEallow_keyword_argsrcommonrrOPTIONALrr5rrr%r&r)r*rno_virtual_error_handlerrrr!apply_common_argument_annotationsrr$rrK len_cpp_namerrSSIZE_add_auto_slot)rirrrrr-rrVrWrr6rrr'r$r7rXrrmemberoverloadmNONLAZY_METHOD_NAMESauto_genkwodarglen_method_codelen_py_signatures rE add_functionzParserManager.add_functions""8[99!hv>>>  Q 555  (MM  FM : : :""1fgxD7|--"): 2 2AF{{!(299(CCC J ' ' 1 1 1)-)I&  $(A A AdF_ A(7(>H %26H /  $(A A A&*DJ ##'F  $(> > >-1D1KKK*. '&'!&-7!"0(%6"(<%#'#;#;Av#F#F : !$ ///04 -'2oo6H''#??9--  )-)J)J1*K*+*+H &#221fkJJ&??9e<<)oolEBB)ook5AA --aEE  $O,C C C~%6;)F)F#'#4#4Q $0D$5$F$F #6;6604F- 19L9SSSX`XqvEvOYOYOX\XkYO $ 4 5 5;f44$<6;66$#'#4#955C#|v>>3CTC\ ("x304 5!, e D D'OOJ77&??955  ;??3H#I#I#Q 7 4;??K^`e;f;f 4/3,)49N)O)O&,7OO'-0-0) ??9e , , )! )!!!VFHHHH%)! ??:u - - *  *!!!VEGGGG&*" ..q&%,k ; ; ; +  # #)O&"+,<PWWX`aa#c#c#c +3 '(9K0L0LMMM    6; $&6 I I I ; & &   6;  - > > > K ' '   6;  - > > >rGc|jtjur)t|j|jx}|_|j}n|jtjur@t|jj|j|j_t|j}d}nU|jtj ur)t|j|jx}|_|j}n| ||dd}| |||tj|}|jjD]J}|j|ur?|jtjust%||jr| ||dK|jj|_t+||} t-|jt/|| _|.t-|j|d|| _|||| ||jjd| |jrd| j_| j d| j_|| dS) z; Create a new mapped type and add it to the current scope. Nzinvalid type for %MappedType)cpp_typez7the mapped type has already been defined in this modulePyNamerT)rrDEFINEDr4 definitionrrTEMPLATErr/STRUCTrr3r MAPPED_TYPErQ mapped_typesrr5rUr>rr2r1rrannotate_mapped_typerrrr) rirrrrrrrmtd mapped_types rEadd_mapped_typezParserManager.add_mapped_typeFse =L0 0 00F'1515 5K(-",HH ]l3 3 3+A'0$*,>,>H  (/0CDDKHH ]l1 1 10F'1515 5K(-",HH   a)G H H HK))!V[)H*>> 9) W WC~++= (===PXZ]ZbAcAc=%%aUWWW!-4 !X66 *49)) + +   "-diOOHh77#9#9K  !!!V[+FFF %%a555   0(,K %".+/ #(  $$$$$rGrc|jj}||||d}|a|jtjus"|tjus|j|ur7|j|kr,|||d|dSt|||||}|tjus|j sd|_ |j d|dS)z6 Create a Qualifier and add it to the current module. F)requiredNz-'{0}' has already been defined as a qualifier)ordertimelineTr)rUr>find_qualifierrr%TIMErrrKr$skippingenabled_by_default qualifiersr) rirrr5rrrr> qualifiers rE add_qualifierzParserManager.add_qualifiers")''64%'HH  ~]%7774}GY;Y;Y^g^nrx^x^x~G~PT\~\~\!!!VGNN $&&'''fdD!###  =% % %T] %+/I (  I.....rGc,|jjrN|jjD]A}|j|jkr/|||d|jB|jjxjdz c_|jj |dS)z% Add a typedef to the current scope. z'{0}' has already been definedr6N) rQrqtypedefsrrrKrUr> nr_typedefsr)rirrtypedeftds rE add_typedefzParserManager.add_typedefs 9  :i( : :>W%888%%a<CC$+$799:::  ,,1,, !!'*****rGc|dd|_|dd|_|dd|_|dd|_|dd|_|||||_|jrd|_d|_d|_||||dd }| ||_ d Sd S) z% Apply annotations to a mapped type. rFNoAssignmentOperator NoCopyCtor NoDefaultCtor NoReleaseTr|PyQt6N) rrno_assignment_operator no_copy_ctorno_default_ctor no_releaserrrr)rirrrrrs rErz"ParserManager.annotate_mapped_types$/??;#F#F  -8__&././ *#.??<#G#G  &1ooou&M&M #!,e!D!D !%!4!4Q !L!L   ! /15K .'+K $*.K '00FKW&&  !%/K " " " " !rGc|dd|_|dd|_|dd|_ |d}|,|jjj}|jjxjdzc_n|dkr|||d ||_dS#t$rYdSwxYw) zM Apply the annotations common to callable arguments and return type. rF DisallowNoneNoCopy KeepReferenceNr6rz(a /KeepReference/ key cannot be negative) r allow_none disallow_noneno_copyrUr>next_keyrkeyKeyError)rirrrrrs rErz/ParserManager.apply_common_argument_annotationss%e<<'OONEBB!ooh66  o.C{'.7!(11Q6111q!!!VBDDDCGGG    DD sAB// B=<B=c@|||||_|dn|jtjurtj|_nI|jtjurtj|_n$|jtj urtj |_|jtjuo|j tj uo|j }|rN|d}||jj}| ||_dSdS|||||_dSdS)z- Apply the annotations for an argument type. PyIntNEncoding)rrrrrSTRINGBYTESSTRINGSBYTEUSTRINGUBYTEarrayrr is_referencerUdefault_encodingconvert_encoding)rirrrrcan_be_encodedrkrs rEapply_type_annotationsz$ParserManager.apply_type_annotationss--aEE ??7 # # /yL///(- l222(. l222(. l&99xdjML^>^xgkgxcx  G"z22H#'#4#E #/ 0DIII0/!11!VXFF  G GrGc z||D]1}||vr+|||d||2dS)zp Check that all the annotations provided as a dict of name/values are valid in a given context. z!{0} is not a valid {1} annotationNrrK)rirrcontextrr5s rEcheck_annotationszParserManager.check_annotationssa fI * *D;&&!!!V;BB4 '))*** * *rGcjjsdSfd}jjD]`}|j |jjur|jjkr |d|js%|jD]}|jjkr |da|sKjjj j } d} njj} d} | D]} | jjkr || n tjtrdSjj D].} | jjur| jjkr |dn/jjD]9} | jjur| |ur| jr| jjkr |d:j1jjD]"}|j|jkr|d dS#dSjjD] }|jjkr|d dS!dS) zg Check that a Python name will not clash with another object in the same Python scope. Nc^d|dS)Nz*there is already {0} in scope called '{1}'r)thingrrrirs rEclashz-ParserManager.check_attributes..clashsA   a@GG#%% & & & & &rGzan enumzan enum memberz a functionza methodz a variableza class or namespacez an exceptionz a property)rQrqrNrrr5rCrrUr>rn isinstancer variablesr rr properties)rirrr is_functionrredemdrrrvdcdxdpds```` rErzParserManager.check_attributessy"  F & & & & & & & & )/ 0 0Bz!xtz))z'))i   < 0:00C{'722./// z!+2C$*,"  :?g--E%LLLE. dj* - -  F)%  Bxtz))z'))l###* )# . .Bxtz))V||{ z')),--- : i*  :)bjG.C.CE.)))EE   j+  7<7**E,'''EE+  rGcft|jr||||dzdSdS)z: Check that a C++ feature isn't being used in a C module. z are not allowed in a C moduleN)r rSr)rirrfeatures rErEzParserManager.cpp_onlyUsW   @   a>> @ @ @ @ @ @ @rGc||}|dkr tjS|dkr tjS|||d|tjS)z? Convert a string to the corresponding DocstringFormat member. deindentedrawz1'{0}' is not a valid value for a docstring format)r DEINDENTEDRAWrrKrirrrs rEconvert_docstring_formatz&ParserManager.convert_docstring_format\sp&  L "- - E>>"& & !VCJJ   ""rGc||}|dkr tjS|dkr tjS|dkr tjS|||d|tjS)zJ Convert a string to the corresponding DocstringSignature member. appended discarded prependedz4'{0}' is not a valid value for a docstring signature)rAPPENDED DISCARDED PREPENDEDrrKrs rEconvert_docstring_signaturez)ParserManager.convert_docstring_signaturens&  J  %. . K  %/ / K  %/ / !VFMM   "++rGc|||}|dkr tjS|dkr tjS|dkr tjS|dkr tjS|||d|tjS)z< Convert a string to the corresponding ArgumentType member. NASCIIzLatin-1NonezUTF-8z'{0}' is not a valid encoding)r ASCII_STRING LATIN1_STRINGr UTF8_STRINGrrKrrs rErzParserManager.convert_encodings =fIE G  , , I  - - F??& & G  + + !V/66u== ? ? ?  rGc|||}|dkr tjS|dkr tjS|dkr tjS|||d|tjS)z6 Convert a string to the corresponding KwArgs member. NAllrOptionalz0'{0}' is not a valid value for keyword arguments)rALLrrrrKrs rEconvert_kw_argszParserManager.convert_kw_argss =fIE E>>:  F??;  J  ? " !VBII   rGc|j\}}}}}}|!||j|j}|j||||||fdS)z We allow %Modules that are part of a %CompositeModule to be either %Imported or %Included. In the case of the latter we need to adjust things so that it appears like the former. N)rcpop_import_modulergrUr)risip_filerYinputlinenolexposrUs rE ensure_importzParserManager.ensure_imports GKFVFZFZF\F\C,vv|      / / /,L < M O O O O OrGcV|||}||||}|dS|jtjur|j|jv}n\|jtjur|jjsdS|j|j v}n,| ||d |dS|r| }|S)z+ Evaluate a feature or platform qualifier. NFTz@'{0}' is a %Timeline qualifier which can only be used in a range) rrr%FEATUREr5r]PLATFORMrQrqrNrrK)rirrr5invertedqualrs rEr{z*ParserManager.evaluate_feature_or_platforms <V9D""1fd33 <5 9 - - -IT%<rrKrr[rrr%rr5rN) rir symbol_lower symbol_upper lower_name lower_qual upper_name upper_qualr>rrs rEevaluate_timelinezParserManager.evaluate_timelines|_  66q,GGJ!u"J|_  66q,GGJ!u"J  *"4   aG I I I5  !j&< (999Z=PT^Tg=g=g!!!\MTTU_akllnnnuZ''!!!\FHHHu*"222!!!\DKKJXbcceeeu  !&F!*HH&F!*H a<<%$*;j>N*N*Nu%$*;z?O*O*Ou4%  DyM...4=H3L3LQUQZ^b^gQgQg)dj:;K.K.K 55)djJr$r%rrrK) rirrr5rr>rpartsrpartrs rErzParserManager.find_qualifier&sl  F)  9$$KKKKK% ??6 " " !JJsOOABB'E5zzA~~%jj1nnLL%%%%jj1nn!D!&!s4yy 8% "zz*1%fdM4F#%%% !((333   C   a4;;DAA C C Cts0C CCc |dS#t$rYnwxYw|}|jjD]B}|ddkr4|d}||r|t |d}C||jvr|dz }|S)z0 Return a valid Python name given a C/C++ name. rrREMOVE_LEADINGr6Nr)rrUauto_py_name_rulesrr_PYTHON_KEYWORDS)rirrrruleleadings rErzParserManager.get_py_nameOs x( (    D %8 5 5DAw***q'%%g..5%c'llmm4G d+ + + sNGs  ch|dd}|dd}|dd}d}|r|s|rnAtj}n4|r|s|rn-tj}n |r|s|rntj}n tj}|#|||dtj}|S)z9 Return the a Transfer value from a dict of annotations. r)F TransferBack TransferThisNz-Only one transfer annotation may be specified)rr)TRANSFER TRANSFER_BACK TRANSFER_THISrr)rirrr has_transferhas_transfer_backhas_transfer_thisr,s rEr+zParserManager.get_transferhs#z599 'OONEBB'OONEBB  %  -$5 -#,  % 20 2#1  % 20 2#1}H     aC E E E}HrGc|d}|d}|d}|d}||}n||||ddS||}n||||ddS|||=|d|||d t|||SdS) zr Return a TypeHints object constructed from a dict of annotations or None if none were specified. TypeHint TypeHintIn TypeHintOut TypeHintValueNz4'TypeHint' and 'TypeHintIn' cannot both be specifiedz5'TypeHint' and 'TypeHintOut' cannot both be specifiedrtz1'NoTypeHint' cannot be specified with a type hint)rrr*)rirrrthth_inth_outth_values rErzParserManager.get_type_hintss __Z ( ( --//???33 =EE ^   aJ L L L4 >FF ^   aK M M M4   2h6J|,,8!!!VKMMMUFH55 5trGc2|jj|jjuS)zn Set if the current module is the main one, ie. the one for which code will be generated for. )rUr>rQris rErzParserManager.in_main_modules  '49+;;;rGc |jD]G\}} | jj|j|jrt ||jrnHdSt||||| ||||| dS)zX Try and instantiate a class template and return True if one was found. )rFT) rMrrmatchesrrr0typesr ) rirrrtemplater no_type_namer tmpl_names proto_classs rEinstantiate_class_templatez(ParserManager.instantiate_class_templates(,';   #J %199(:KSWS]9^^ cz|FHPHVdWdW 5!V[*k'<D B B BtrGc |j|t|j|j||jdS)z$ Record an error caused by a token. linecolumnN)rblogr'rgr_get_column_from_lexposr )ritrjs rE lexer_errorzParserManager.lexer_errors_ Dt~AH#;;AHEEGGG H H H H HrGc6|}tj|}t|jj||_ |j| |||j dn$#t$r| YnwxYw| |jt!|j|j_|jjd|jjdd|jD}t-|jjD]/}|j|vr$tjj|0t-|jjD]/}|j|vr$tjj|0t-|jjD]/}|j|vr$tjj|0|D]E}|jj||jj|jF|jD]!}|jj|"|j|j|jfS)z Parse a .sip file and return a 3-tuple of a Specification object, a list of Module objects and a list of the .sip files that specify the module to be generated. A UserException is raised if there was an error. T)lexertrackingc|jSN)rks rEz%ParserManager.parse..samrG)rc|jjSrO)rr5rPs rErRz%ParserManager.parse..s qy~rGcg|]\}}|SrArA)rCrrQs rErFz'ParserManager.parse..s???$!QA???rG) ospathabspath ModuleStaterQr>rUrKparse_readrI UnexpectedEOF_unexpected_eof_error _handle_eomrb as_exceptionr rSrsortrrMlistrNrrr  iface_filesrr`rRrh)rirrYtemplate_classesenumrvariablers rErYzParserManager.parses 7??8,,' (8(CC ) L  tzz(LAA+  6 6 6 6 ) ) )  & & ( ( ( ( ( )  $$&&&#DO44  $;$;<<<   %=%= >>>@?$*>???)) - -Dz--- &&t,,,DI.// 3 3G} 000 "))'222TY011 5 5H~!111 #**8444% ; ;E I  $ $U + + + I ! ( ()9 : : : :/ , ,E I  $ $U + + + +y$,77s6A99BBcd|j||||dS)z5 Record an error caused by a symbol in a production. N)rbrGrw)rirrrjs rErzParserManager.parser_errors2 D$":":1f"E"EFFFFFrGc|j\|_|_|_|j_}|_|j|j||j_ dS)z Restore the current .sip file from the stack and make it current. An IndexError is raised if the stack is empty. N) rcrrgrYrerIrrdrr )rir s rEpop_filezParserManager.pop_file ssrvrBrFrFrHrHn)4; 8JFTXTn $+&&&# rGc|jdS||jj|jj|j_|jj|jj|j_|j|_d|_dS)z# Restore the current module state. N)rdr]rrUcall_super_initr:s rEpop_module_statezParserManager.pop_module_states{  % - F   % 6 >:>:K:\D & 7  % 5 =9=9J9ZD & 6 6%)"""rGc8|jdS)z Pop the current scope. N)rarr:s rErzParserManager.pop_scope+s rGcl|||}|}|dtj}tj|rnd}tj|stj|jg}||j |D]E} tj | |} tj| r| }nF|.|s*| ||d |dS|x}}tj |}|jD];} | d|kr-| ||d |dS<||jvrdS|r|j} ||nd} |j|j|j|j|jj|jj| fd|j_|j|||dS)z Push the current .sip file onto the stack and make the new one current. The new .sip file may be part of a new module (ie. %Import rather than %Include). Nrz'{0}' could not be foundrz'{0}' is being read recursivelyr6)replacerUseprVisfileisabsdirnamergr r_joinrrKrWrcrfrUrrrYrerIrr rrZ) rirrr new_moduleoptionalrYfoundinc_dirsinc_dirfndetailold_module_states rE push_filezParserManager.push_file0sa  yH ##C00 7>>( # # , E7==** GOODN;;< 2333'Ggx88Bw~~b)) "}M%%a6==lKKMMM', +L87??8,,&  FayH$$!!!V9@@JJLLL% t* * * F  $#0     ) ) ) ) $  !2DK *DK,>(* + + +   $**X|<<=====rGcV|jt||dS)z Push a new scope. N)rar ScopeStaterirrs rErzParserManager.push_scopeys,   E3C!D!DEEEEErGINITIALc:|j|dS)z Set the lexer state. N)rIbegin)ristates rEset_lexer_statezParserManager.set_lexer_state~s  %     rGcL |jdjS#t$rYnwxYwdS)z The current scope if any. rN)rar IndexErrorr:s rErzParserManager.scopes? $R(. .    D ts  !!cZt|jdkrdn|jdjS)z The current access specifier. rNr)rrarr:s rErz$ParserManager.scope_access_specifiers.4,--22tt8I"8M8^^rGc*||jd_dS)z# Set the current access specifier. rN)rar)rirs rErz$ParserManager.scope_access_specifiers2B"...rGcZt|jdkrdn|jdjS)z The current method specifier. rNr)rrarpr:s rErz)ParserManager.scope_pyqt_method_specifiers.4,--22tt8I"8M8ccrGc*||jd_dS)z# Set the current method specifier. rN)rarp)rirps rErz)ParserManager.scope_pyqt_method_specifiers7L"333rGc|jdS)z. True if symbols are currently being skipped. r)rZr:s rErzParserManager.skippingsr""rGc t||||||}nB#t$r5}|||t||j}Yd}~nd}~wwxYw|S)z_ Validate an annotation and its value and return a valid version of the value. N)r:r9rrLuse)rirrres rEvalidate_annotationz!ParserManager.validate_annotations|  -dAvqyEE       aQ 0 0 0EEEEEEE  s A+AAct|j||}t|j||}|j|jr |dn |d|jrB|jj}|jtj ust|j dkr |d|j r)|d|jtjur |d|j |d|jr|j|jr |d nl|jr |d |jr |d |j |d |j |d |j |d|jr |d|jr|jt4jur |dn=|j|j r/|jjD]"}|jt4jur |dn#|j j!r|j"|ddSdSdS)z Validate a completed function. Nz1abstract non-member functions cannot be specifiedzstruct/union member functionsrz4/NewThread/ may only be specified for void functionsz static struct/union data memberszsignals cannot be staticrzJ/VirtualErrorHandler/ and /NoVirtualErrorHandler/ cannot both be specifiedzG/AbortOnException/ cannot be specified for non-virtual member functionsz@/NewThread/ cannot be specified for non-virtual member functionszE%VirtualCallCode cannot be specified for non-virtual member functionszH%VirtualCatcherCode cannot be specified for non-virtual member functionszJ/VirtualErrorHandler/ cannot be specified for non-virtual member functionszL/NoVirtualErrorHandler/ cannot be specified for non-virtual member functionsz5/TransferBack/ and /Factory/ cannot both be specifiedzJ/TransferThis/ may only be specified for constructors and member functionsz=%MethodCode must be specified when /NoArgParser/ is specified)#rrErrrr~rrrrrrderefs is_staticrpr"rsr( is_virtualrrrzrXr7r}r,r)r+rrrr,r no_arg_parserr$)rirrrrEerrorrrs rEvalidate_functionzParserManager.validate_functions4=!V44)1f55  $ ,# KIJJJ H4 5 5 5   N+2F{,"333s6=7I7IQ7N7NLMMM   2 H7 8 8 8-1D1KKK0111   * H\ " " "   f-9h>_9bccc* a_```" ZXYYY)5]^^^,8`aaa-9bccc0 fdeee    H$:::MNNN  ( 0H4F 0,1  <8#999EfgggE: ? ( SX-A-I EQ R R R R R S S-I-IrGcN|jjdkrV|jduo d|jjv}|jduo d|jjv}||kr|||d|p||_dS|j|||d|j|||ddSdS)z# Validate a completed mapped type. r;N sipUserStatezLboth %ConvertToTypeCode and %ReleaseCode must use user state or neither mustz4%MappedType must have a %ConvertToTypeCode directivez6%MappedType must have a %ConvertFromTypeCode directive)rQrlrrj release_coderneeds_user_stateconvert_from_type_code)rirrr convert_to_us release_uss rEvalidate_mapped_typez"ParserManager.validate_mapped_types  9 G + +'%AccessCode cannot be specified for non-static class variablesz9%AccessCode cannot be specified with %GetCode or %SetCodez=%GetCode or %SetCode cannot be specified for global variablesT)rrCAPSULErrrrrrE access_codeget_codeset_coderrrr rr)rirrrdrs rEvalidate_variablezParserManager.validate_variables~ = !5 5 5   a= ? ? ? 6  ''===!!!VGIII! Z a)IJJJJ%1!!!VXZZZ   (H,=,I#/!!!VSUUUz!!!!VWYYY : !dj&;&@MD[&[&[!%H  a)9:::::rGc|||||j||}ttj|||||} |j&|jjj | dS|jj | dS)z& Add an automatically generated slot. )r$N) rmrr!rrrrUr>ror) rirrrrrrr$rrs rErzParserManager._add_auto_slot3s""1fg|7H[**O2FG|FFF :    $ . 5 5h ? ? ? ? ? J ' ' 1 1 1 1 1rGcd}|jD]k}|jtjur3t d|_|r|||ddSd}H|r!|j|||ddSldS)z$ Check any ellipsis in a signature. Fz*argsz '...' may only be specified onceTNz4'...' must be at the end of the positional arguments)rrrrrr5rr)rirrr seen_ellipsisrs rErzParserManager._check_ellipsisBs >  Cx<000&g.. %%a>@@@EE $  3#4#<!!!VNPPP!  rGc jfd}tjjj||||jS)zn Return an interface file for a fully qualified C/C++ name and type creating it if necessary. c6|dSrO)r)rjrrirs rE error_loggerz3ParserManager.find_iface_file..error_logger_s!   a . . . . .rG)rr)r3rQrUr>r)rirrrrrrs``` rEr3zParserManager.find_iface_fileYs[  / / / / / / /ty$*;*B_lXj""" "rGctj|}|d}n|\}} } | r*|(|d|| dkr|j>| dz } t |r*|||d|t |} | | kr+|||d| | |tjur/|j rdt|j |_ tj }d}||||d |d d } |j|jjj} d}nK|jjjt*jur ||jjj} |jj}n|jj} d}| D]2}|jj|kr |jr|||d nl3t7|jjt|j |}||_| |_||_|j r d|j_ | d||S) z> Return (creating if necessary) the member for a Python name. Nz'{0}' requires %MethodCoderr6z-'{0}' cannot be specified at the module levelz-{0} arguments are needed but {1} are providedT __setattr__)r NoArgParserFzKan overloaded member function has already been specified with /NoArgParser/)r rrrKrr rr#DELATTRrr2rQrSETATTRrrrUr>rnrrrr rrr5rrnamespace_iface_filerr)rirrrrrr$ slot_detailrneeds_method_codenr_args_needednr_argsrrrrs rErmzParserManager._find_memberfs +.w77  GG9D 6G&  P[%8!!">"E"Eg"N"NOOO"".6"a'N+733a))!V O V VW^ _ _aaad))!W,,%%aKRR$2G==>>> &.((&@;?K 7338 .' adCCC$ u== : '.?G#' Z " '=+B B BwGZ'.?G#':#8 j(G#'  & &F~"g--'k%%aikkk.D-4 73355F*>F '#0F $FN" +&*# NN1f % % % rGc||}||||}|dS|jtjur,|||d|dS|S)z( Return an optional timeline qualifier. Nz"'{0}' is not a %Timeline qualifier)rrr%rrrK)rirrr5rs rErz&ParserManager._find_timeline_qualifiersxy""1fd33 <4 9M. . .   a8??EE G G G4 rGcP|jdd|dz}||z dzS)z^ Return the column within the current line corresponding to a lexer position.  rr6)rerfind)rir  line_starts rErHz%ParserManager._get_column_from_lexposs2 [&&tQ77!;  "Q&&rGc|dd}|dd}|r%|r|||dtjS|r tjStjS)z? Return an appropriate GILAction according to the annotations. HoldGILF ReleaseGILz3/HoldGIL/ and /ReleaseGIL' cannot both be specified)rrrHOLDRELEASEDEFAULT)rirrrholdreleases rEr zParserManager._get_gil_actionsy%00//,66  " O!!!VMOOO> !  %$ $  rG)#FalserTrueandasassertasyncawaitbreakclasscontinuedefdelelifelseexceptfinallyforfromglobalifimportinislambdanonlocalnotorpassraisereturntrywhilewithyieldc|d}|||||}n |jj}t |jdkr*|jdjtjur tj }|tj urNd}|jD]6}|tj ur|j |j |s|jr d|j _d}7|r tj }|S)z& Return the keyword argument support. KeywordArgsNrrTF)rrrUr#rrrrrrrrrr5rr) rirrrrrer#no_namers rEr"zParserManager._get_kw_argss//-00  **1fg>>GG'/G y~   " "y~b'9'>,BW'W'WkG &+ % %G ~ $ $fo--#2C2K8' -D$7-(, #G & +rGc||}|9||jjvr+|||d|||S)z: Return an annotation that is only supported by a plugin. Nz/{0}/ is only supported for {1})rrQpluginsrrK)rirrrr5pluginannos rErz$ParserManager._get_plugin_annotation sct$$  di.? ? ?   a5< fq_py_namerbrGr'rgr ri)rirUr>s rEr]zParserManager._handle_eomsb( $   $ O   @"4>22 4 4 4"&l&B!C!CrGc|jj}t}|j||jjj|_t |||_t|jj d||j \}}|D]%}||j vr|j |&|D]%}||j vr|j |&|j |dS)zv Create a new Module object and corresponding ModuleState object for a .sip file and make it current. rN)rUr>r rRrdefault_exceptionrXrrQrlr_rNr]imports)ririmporting_fromr>mod_tags mod_disabledtagrs rErzParserManager._import_module*s *1 F####'#4#;#M '99"< %a((D4F"H"H, & &C$)##   %%%# 8 8Gd555'..w777 %%f-----rGc t||j5}||_dddn #1swxYwYnt#t$r#t d|t$r<}t d||jt|d}~wwxYw||_ ||_ |j ||j r|j ||jS)z/ Return the contents of the current .sip file. )rkNzunable to read '{0}'z.'{0}' doesn't appear to use the '{1}' encoding)ry)openr\readreFileNotFoundErrorrrKUnicodeDecodeErrorrLrYrgrfrrrh)rirrYfrs rErZzParserManager._readFsZ #h888 'Affhh  ' ' ' ' ' ' ' ' ' ' ' ' ' ' '  I I I 6 = =h G GHH H! # # #DKK$dn66q66### # # )! ""8,,,   - O " "8 , , ,{s7A > A AA AA 5B;?7B66B;c`|jdt|jdS)z. Record an error caused by an unexpected EOF. zunexpected end of fileN)rbrGr'rgr:s rEr\z#ParserManager._unexpected_eof_error]s8 4t~.. 0 0 0 0 0rGrO)F)NN)rr)FN)NF)T)NFF)r)H__name__ __module__ __qualname____doc__rrrrrrrrrr.r8rUrrrrrrrrrrErrrrr r{rrrr+rpropertyrrBrJrYrrgrjrr{rrrrsetterrrrrrrrrr3rmrrHr r$r"rrwr]rrZr\rArGrEr<r<4sr666p[[[| d d d d<####%%%%P48>>>>@8P!P!P!d2&2&2&hI*I*I*X%D5$t4" lllll\7%7%7%r////8 + + +000*0GGG6 * * *@EWWWWr@@@###$,,,,!!!!0, O O O<@:F"F"F"P''''R2   D"""H<<X<&HHH585858nGGG $ $ $***&   >CG>G>G>G>RFFFF !!!! X__X_ "BB#"B ddXd !'LL('L ##X#   >S>S>S@RRR,!;!;!;F 2 2 20 " " " "PPPd '''!!!&@   GGG D D D...8.00000rGr<ceZdZdZdZdS)rXz4 Encapsulate the parser-related state for a module. c||_||_d|_g|_d|_d|_t j|_d|_ dS) Initialise the state. FNr) r>rr)r#rirrrr# nr_timelines)rir>rs rErrzModuleState.__init__gsI   &+#"$# ${ rGNrrrrrrrArGrErXrXds)>>     rGrXceZdZdZdZdS)r}z3 Encapsulate the parser-related state for a scope. c0||_||_d|_dS)rN)rrrpr~s rErrzScopeState.__init__xs! 0%)"""rGNrrArGrEr}r}us)==*****rGr}ceZdZdZdS)r[z= This is raised by p_error() when an unexpected EOF is seen. N)rrrrrArGrEr[r[sGGGGrGr[)H functoolsrrUplyrrbindings_configurationrrr error_logr instantiationsr python_slotsr r rr specificationrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r. templatesr/r0utilsr1r2r3r4r5rr7r8rr9r:r<rXr} Exceptionr[rArGrErs_0 @@@@@@'''''' ......DDDDDDDD$$$$$$::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::GFFFFFFF00000000000000EEEEEEEEm 0m 0m 0m 0m 0m 0m 0m 0`A"********HHHHHIHHHHHrG