+ i/'JRt^RIt^RIHt]P!R4t]P!R]P ]P,]P,4t ]P!R]P]P ,]P,4t ]P!R]P4t !RR]4t!R R ]4tRR ltR R ltR R ltR RltRtRtRtRtRt/tRtRtR!RltR"Rlt!RR4t Rt!Rt"Rt#!RR]4t$R#)#z pygments.util ~~~~~~~~~~~~~ Utility functions. :copyright: Copyright 2006-2025 by the Pygments team, see AUTHORS. :license: BSD, see LICENSE for details. N) TextIOWrapperz[/\\ ]z ]*> z<(.+?)(\s.*?)?>.*?z\s*<\?xml[^>]*\?>c]tRt^tRtRtR#) ClassNotFoundzCRaised if one of the lookup functions didn't find a matching class.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r`/home/wkmabra/.openclaw/workspace/venv/lib/python3.14/site-packages/pip/_vendor/pygments/util.pyrrsMr rc]tRt^"tRtRtR#) OptionErrorzw This exception will be raised by all option processing functions if the type or value of the argument is not correct. rNrrr rrr"sr rc VPW4pV'dVP4pWR9d9\RPVRP \ \ V4444hV#)zq If the key `optname` from the dictionary is not in the sequence `allowed`, raise an error, otherwise return it. z%Value for option {} must be one of {}z, )getlowerrformatjoinmapstr)optionsoptnamealloweddefaultnormcasestrings&&&&& rget_choice_optr(sZ [[ *F AHHRVR[R[\_`cel\mRnopp Mr cjVPW4p\V\4'dV#\V\4'd \V4#\V\4'g\ RV: RV R24hVP 4R9dR#VP 4R9dR#\ RV: RV R24h) a Intuitively, this is `options.get(optname, default)`, but restricted to Boolean value. The Booleans can be represented as string, in order to accept Boolean value from the command line arguments. If the key `optname` is present in the dictionary `options` and is not associated with a Boolean, raise an `OptionError`. If it is absent, `default` is returned instead. The valid string values for ``True`` are ``1``, ``yes``, ``true`` and ``on``, the ones for ``False`` are ``0``, ``no``, ``false`` and ``off`` (matched case-insensitively). Invalid type for option z%; use 1/0, yes/no, true/false, on/offTFInvalid value )1yestrueon)0nofalseoff)r isinstanceboolintrrrrrrrs&&& r get_bool_optr/5s[[ *F&$ FC F|  $ $M&<yI<<= = 5 5 6 6N6*L J<<= =r cVPW4p\V4# \d\RT: RT R24h\d\RT: RT R24hi;i)z?As :func:`get_bool_opt`, but interpret the value as an integer.r r!z ; you must give an integer valuer")rr- TypeErrorr ValueErrorr.s&&& r get_int_optr3Rs~ [[ *F86{ 8M&<yI778 8 8N6*L J778 88s &AAcVPW4p\V\4'dVP4#\V\\ 34'd \ V4#\ RV: RV R24h)z If the key `optname` from the dictionary `options` is a string, split it at whitespace and return it. If it is already a list or a tuple, it is returned as a list. r r!z; you must give a list value)rr+rsplitlisttupler)rrrvals&&& r get_list_optr9^sj ++g 'C#syy{ C$ ' 'CyM# WIF334 4r cFVP'gR#.pVPP4P4FApVP4'd)VPRVP4,4KAM RP V4P 4#) )r strip splitlinesappendrlstrip)objreslines& rdocstring_headlinerDnsq ;;; C !!#..0 ::<< JJsTZZ\) *  1 773<    r cHaV3RlpSPVn\V4#)zAReturn a static text analyser function that returns float values.c <S!V4pT'gR#\R\R\T444# \dR#i;i \\ 3dR#i;i)gg?) Exceptionminmaxfloatr2r1)textrvfs& r text_analyse%make_analysator..text_analyse|sb 4B sCU2Y/0 0    I&  s 5A AAAA)r staticmethod)rMrNsf rmake_analysatorrQzs! 99L  %%r c VPR4pV^8dVRVP4pMVP4pVPR4'd\P VR,P 44Uu.uF(pV'gK VPR4'dK&VNK* upR ,p\P!RT R2\P4pTPT4eR #R#uupi \ dR#i;i) aCheck if the given regular expression matches the last part of the shebang if one exists. >>> from pygments.util import shebang_matches >>> shebang_matches('#!/usr/bin/env python', r'python(2\.\d)?') True >>> shebang_matches('#!/usr/bin/python2.4', r'python(2\.\d)?') True >>> shebang_matches('#!/usr/bin/python-ruby', r'python(2\.\d)?') False >>> shebang_matches('#!/usr/bin/python/ruby', r'python(2\.\d)?') False >>> shebang_matches('#!/usr/bin/startsomethingwith python', ... r'python(2\.\d)?') True It also checks for common windows executable file extensions:: >>> shebang_matches('#!C:\\Python2.4\\Python.exe', r'python(2\.\d)?') True Parameters (``'-f'`` or ``'--foo'`` are ignored so ``'perl'`` does the same as ``'perl -e'``) Note that this method automatically searches the whole string (eg: the regular expression is wrapped in ``'^$'``)  Nz#!:NN-F^z(\.(exe|cmd|bat|bin))?$T) findr startswith split_path_rer5r= IndexErrorrecompile IGNORECASEsearch)rKregexindex first_linexfounds&& rshebang_matchesres8 IIdOE z&5\'') ZZ\ T""  - 3 3JrN4H4H4J K5 K1"#,,s"3Q K5579E aw&=> N <<  * 5  s0,C> C9C9)C9/ C>9C>> D  D c\PV4pVfR#VP^4p\P!V\P 4P VP44RJ#)zCheck if the doctype matches a regular expression (if present). Note that this method only checks the first part of a DOCTYPE. eg: 'html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"' NF)doctype_lookup_rer_groupr\r]Imatchr=)rKr`mdoctypes&& rdoctype_matchesrmsT   &AyggajG ::eRTT " ( ( 9 EEr c\VR4#)z3Check if the file looks like it has a html doctype.html)rm)rKs&rhtml_doctype_matchesrps 4 ))r c\PV4'dR#\V4p\V,# \dI\ P T4pTeR#\P TR,4RJpT\T&Tu#i;i)z2Check if a doctype exists or if we have some tags.TN:NiN) xml_decl_rerjhash_looks_like_xml_cacheKeyErrorrgr_tag_re)rKkeyrkrLs& rlooks_like_xmlrxs} t*C$S))   $ $T * = ]]4; 't 3%'c" s 7$B )B  B cBRV^ , ,RVR,,3#)zgGiven a unicode character code with length greater than 16 bits, return the two 16 bit surrogate pair. iiir)cs&r surrogatepairr{s! a2g 1u9!5 77r c.pRV,^,pRV^,,^,pVPWP,R,4V'd)VF!pVPWg,R,4K# MJVFDp\VR,4pVPWhRR,VR ,,R,4KF VPVR,4RPV4#) z)Formats a sequence of strings for output.r<z = (,"N)rSrW)r?reprr) var_nameseqraw indent_levellines base_indent inner_indentirs &&&& r format_linesrs E $q(K,*+a/L LL'&01 A LL)C/ 0AQW A LL#2.26< = LLs"# 99U r c.p\4pVF3pWC9gWA9dKVPV4VPV4K5 V#)zU Returns a list with duplicates removed from the iterable `it`. Order is preserved. )setr?add)it already_seenlstseenrs&& rduplicates_removedrsD C 5D  9)  1    Jr c*a]tRtRtoRtRtRtVtR#)Futurei z{Generic class to defer some work. Handled specially in RegexLexerMeta, to support regex string construction at first use. c\hN)NotImplementedErrorselfs&rr Future.gets!!r rN)rrr r r rr __classdictcell__ __classdict__s@rrr s ""r rcVPR4pVR3# \dZ^RIpTP4pTP4pY3u# \\3dTPR4pTR3uu#i;ii;i)zDecode *text* with guessed encoding. First try UTF-8; this should fail for non-UTF-8 encodings. Then try the preferred locale encoding. Fall back to latin-1, which always works. zutf-8Nlatin1)decodeUnicodeDecodeErrorlocalegetpreferredencoding LookupError)rKr prefencodings& r guess_decoders "{{7#W} " " !668L;;=D% %"K0 ";;x(D> ! " "s, A;&A  A; &A72A;6A77A;c\VRR4'd*VPVP4pWP3#\ V4# \dLi;i)zDecode *text* coming from terminal *term*. First try the terminal encoding, if given. Then try UTF-8. Then try the preferred locale encoding. Fall back to latin-1, which always works. encodingN)getattrrrrr)rKterms&&rguess_decode_from_terminalr(sXtZ&& ';;t}}-D& &   "   sA AAch\VRR4'd VP#^RIpVP4#)z7Return our best guess of encoding for the given *term*.rN)rrrr)rrs& rterminal_encodingr9s-tZ&&}}  & & ((r c&a]tRtRtoRtRtVtR#)UnclosingTextIOWrapperiAc&VP4R#r)flushrs&rcloseUnclosingTextIOWrapper.closeCs  r rN)rrr r rr rrs@rrrAsr r)NFr)F)r)%r r\iorr]rZDOTALL MULTILINEVERBOSErgr^rvrirrr2rrGrrr/r3r9rDrQrermrprtrxr{rrrrrrrrr rrs  9% JJ YY *, /MMBII- < >jj-rtt4 NJN) =: 8 4 !&"*Z F*   8&  """*")]r