+ h/'csJRt^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[^>]*\?>cs]tRt^tRtRtR#) ClassNotFoundzCRaised if one of the lookup functions didn't find a matching class.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r>/usr/lib/python3.14/site-packages/pip/_vendor/pygments/util.pyrrsMr rcs]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 r r r "sr r c sVPW4pV'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, )getlowerr ZformatjoinZmapstr)optionsoptnameZalloweddefaultZnormcasestrings&&&&& r get_choice_optr(sZ [[ *F AHHRVR[R[\_`cel\mRnopp Mr csjVPW4p\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 )Z1ZyesZtrueZon)Z0ZnoZfalseZoff)r isinstanceZboolintrr rrrrr&&& r get_bool_optr5s[[ *F&$ FC F|  $ $M&<yI<<= = 5 5 6 6N6*L J<<= =r csVPW4p\V4# \d\RT: RT R24h\d\RT: RT R24hi;i)z?As :func:`get_bool_opt`, but interpret the value as an integer.rrz ; you must give an integer valuer)r r TypeErrorr ValueErrorrrr get_int_optr Rs~ [[ *F86{ 8M&<yI778 8 8N6*L J778 88s &AAcsVPW4p\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. rrz; you must give a list value)r rrsplitZlistZtupler )rrrZvalrr get_list_optr"^sj ++g 'C#syy{ C$ ' 'CyM# WIF334 4r csFVP'gR#.pVPP4P4FApVP4'd)VPRVP4,4KAM RP V4P 4#)Z )rstripZ splitlinesappendrZlstrip)ZobjZresZline& r docstring_headliner'nsq ;;; C !!#..0 ::<< JJsTZZ\) *  1 773<    r csHaV3RlpSPVn\V4#)zAReturn a static text analyser function that returns float values.c s<S!V4pT'gR#\R\R\T444# \dR#i;i \\ 3dR#i;i)gg?) ExceptionZminZmaxZfloatrr)textrvfs& r text_analyseZ%make_analysator..text_analyse|sb 4B sCU2Y/0 0    I&  s 5A AAAA)rZ staticmethod)r+r,sf r make_analysatorr-zs! 99L  %%r cs 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#!:iNNZ-FZ^z(\.(exe|cmd|bat|bin))?$T) ZfindrZ startswith split_path_rer!r$Z IndexErrorrecompile IGNORECASEsearch)r)regexZindexZ first_lineZxZfounds&& r shebang_matchesr6s8 IIdOE z&5\'') ZZ\ T""  - 3 3JrN4H4H4J K5 K1"#,,s"3Q K5579E aw&=> N <<  * 5  s0,C> C9C9)C9/ C>9C>> D  D cs\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_rer4Zgroupr1r2Imatchr$)r)r5mZdoctypes&& r doctype_matchesr;sT   &AyggajG ::eRTT " ( ( 9 EEr cs\VR4#)z3Check if the file looks like it has a html doctype.Zhtml)r;)r)&r html_doctype_matchesr=s 4 ))r cs\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_rer9Zhash_looks_like_xml_cacheZKeyErrorr7r4tag_re)r)Zkeyr:r*s& r looks_like_xmlrAs} t*C$S))   $ $T * = ]]4; 't 3%'c" s 7$B )B  B csBRV^ , ,RVR,,3#)zgGiven a unicode character code with length greater than 16 bits, return the two 16 bit surrogate pair. iiir)Zcr<r surrogatepairrBs! a2g 1u9!5 77r cs.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 = (Z,Z"NZ)r.ir/)r%Zreprr) Zvar_nameZseqZrawZ indent_levelZlinesZ base_indentZ inner_indentiZrs &&&& r format_linesrDs E $q(K,*+a/L LL'&01 A LL)C/ 0AQW A LL#2.26< = LLs"# 99U r cs.p\4pVF3pWC9gWA9dKVPV4VPV4K5 V#)zU Returns a list with duplicates removed from the iterable `it`. Order is preserved. )Zsetr%Zadd)ZitZ already_seenZlstZseenrCs&& r duplicates_removedrEsD C 5D  9)  1    Jr cs*a]tRtRtoRtRtRtVtR#)Futurei z{Generic class to defer some work. Handled specially in RegexLexerMeta, to support regex string construction at first use. cs\hN)ZNotImplementedErrorZselfr<r r Z Future.gets!!r rN)rrrrrr r __classdictcell__Z __classdict__@r rFrF s ""r rFcsVPR4pVR3# \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-8NZlatin1)decodeUnicodeDecodeErrorlocalegetpreferredencodingZ LookupError)r)rNZ prefencodingr&r guess_decoderPs "{{7#W} " " !668L;;=D% %"K0 ";;x(D> ! " "s, A;&A  A; &A72A;6A77A;cs\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)getattrrLrQrMrP)r)terms&&r guess_decode_from_terminalrT(sXtZ&& ';;t}}-D& &   "   sA AAcsh\VRR4'd VP#^RIpVP4#)z7Return our best guess of encoding for the given *term*.rQN)rRrQrNrO)rSrNs& r terminal_encodingrU9s-tZ&&}}  & & ((r cs&a]tRtRtoRtRtVtR#)UnclosingTextIOWrapperiAcs&VP4R#rG)ZflushrHr<r closeZUnclosingTextIOWrapper.closeCs  r rN)rrrrrWr rIrJrKr rVrVAsr rV)NFrG)Fi)r)%rr1Ziorr2r0ZDOTALLZ MULTILINEZVERBOSEr7r3r@r8r>rrr(r rrr r"r'r-r6r;r=r?rArBrDrErFrPrTrUrVrr r rXs  9% JJ YY *, /MMBII- < >jj-rtt4 NJN) =: 8 4 !&"*Z F*   8&  """*")]r