R`i' d Z ddlZddlmZ ej d Z ej dej ej z ej z Z ej dej ej z ej z Z ej dej Z
G d d e Z G d
d e Zd d Zd!d
Zd!dZd!dZd Zd Zd Zd Zd Zi Zd Z d Z d"dZ d#dZ G d d Z d Z!d Z"d Z# G d d e Z$y)$z
pygments.util
~~~~~~~~~~~~~
Utility functions.
:copyright: Copyright 2006-2023 by the Pygments team, see AUTHORS.
:license: BSD, see LICENSE for details.
N)
TextIOWrapperz[/\\ ]z
]*>
z<(.+?)(\s.*?)?>.*?z\s*<\?xml[^>]*\?>c e Zd ZdZy)
ClassNotFoundzCRaised if one of the lookup functions didn't find a matching class.N__name__
__module__ __qualname____doc__ /builddir/build/BUILDROOT/alt-python312-pip-23.3.1-3.el8.x86_64/opt/alt/python312/lib/python3.12/site-packages/pip/_vendor/pygments/util.pyr r s Mr r c e Zd ZdZy) OptionErrorz
This exception will be raised by all option processing functions if
the type or value of the argument is not correct.
Nr r r r
r r " s r r c | j || }|r|j }||vr.t d|ddj t t
| |S )z}
If the key `optname` from the dictionary is not in the sequence
`allowed`, raise an error, otherwise return it.
zValue for option z must be one of z, )getlowerr joinmapstr)optionsoptnamealloweddefaultnormcasestrings r
get_choice_optr ( sY
[['
*F
W "DIIc#w.?$@B C C Mr c 4 | j || }t |t r|S t |t r t | S t |t st d|d|d |j
dv ry|j
dv ryt d|d|d ) 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/off)1yestrueonT)0nofalseoffFInvalid value )r
isinstanceboolintr r r r r r r s r
get_bool_optr- 6 s [['
*F&$
FC F|
$ $g/ 0 0
5 5 6 6 $g/ 0 0r c | j || } t | S # t $ r t d|d|d t $ r t d|d|d w xY w)z?As :func:`get_bool_opt`, but interpret the value as an integer.r r z ; you must give an integer valuer( )r r+ TypeErrorr
ValueErrorr, s r
get_int_optr1 U sh
[['
*F 06{ 0 $g/ 0 0 0 $g/ 0 00s
6Ac | j || }t |t r|j S t |t t
f r t | S t
d|d|d )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)r r) r splitlisttupler )r r r vals r
get_list_optr7 c sY ++gw
'C#syy{ C$ 'Cy !7, - -r c | j syg }| j j j D ]6 }|j r#|j d|j z 6 n dj | j S )N )r
strip
splitlinesappendr lstrip)objreslines r
docstring_headlinerB t sm ;;
C !!#..0 ::< JJsTZZ\) * 1
773< r c F fd} j |_ t | S )zAReturn a static text analyser function that returns float values.c | }|sy t dt dt | S # t $ r Y yw xY w# t t
f$ r Y yw xY w)Ng g ?) Exceptionminmaxfloatr0 r/ )textrvfs r
text_analysez%make_analysator..text_analyse sb 4B sCU2Y /0 0 I& s . = ::AA)r
staticmethod)rK rL s ` r
make_analysatorrN s!
99L %%r c | j d }|dk\ r| d| j }n| j }|j d r t j |dd j D cg c] }|r|j d s| c}d }t j d |z t j }|j | y
yc c}w # t $ r Y yw xY w) a Check 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 ``'^$'``)
r Nz#! -Fz^%s(\.(exe|cmd|bat|bin))?$T) findr
startswith
split_path_rer3 r;
IndexErrorrecompile
IGNORECASEsearch)rI regexindex
first_linexfounds r
shebang_matchesra s 8
IIdOE z&5\'')
ZZ\
T" - 3 3JqrN4H4H4J K 5 K1!,,s"3 K 5579E
85@"--P << * 5 s$
(C 5 CC C C"!C"c t j | }|y|j d }t j |t j
j
|j duS )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[ grouprX rY Imatchr; )rI r\ mdoctypes r
doctype_matchesrj sT &AyggajG
::eRTT " ( ( 9 EEr c t | d S )z3Check if the file looks like it has a html doctype.html)rj )rI s r
html_doctype_matchesrm s 4 ))r c t j | ryt | } t | S # t $ rA t
j
| }|Y yt j
| dd du}|t |< |cY S w xY w)z2Check if a doctype exists or if we have some tags.TNi ) xml_decl_rerg hash_looks_like_xml_cacheKeyErrorrd r[ tag_re)rI keyrh rJ s r
looks_like_xmlru s|
t*C$S)) $ $T * =
]]4;
't
3%' c"
s , A6%A65A6c " d| dz z d| dz z fS )zoGiven a unicode character code with length greater than 16 bits,
return the two 16 bit surrogate pair.
i
i i r )cs r
surrogatepairry s!
a2g 1u9!5 77r c P g }d|z dz }d|dz z dz }|j || z dz |r |D ] }|j ||z dz n5|D ]0 }t |dz }|j ||dd z |d z dz 2 |j |d
z d j | S ) z)Formats a sequence of strings for output.r: rc z = (,"NrS )rP )r= reprr ) var_nameseqraw indent_levellines base_indent inner_indentirs r
format_linesr s E $q(K,*+a/L LLx'&01
A LL )C/ 0 AQW
A LL #2.26< =
LLs"# 99U r c g }t }| D ]- }||v s||v r |j | |j | / |S )za
Returns a list with duplicates removed from the iterable `it`.
Order is preserved.
)setr= add)it already_seenlstseenr s r
duplicates_removedr sH
C 5D
9\)
1
Jr c e Zd ZdZd Zy)FuturezGeneric class to defer some work.
Handled specially in RegexLexerMeta, to support regex string construction at
first use.
c t N)NotImplementedErrorselfs r
r z
Future.get s !!r N)r r r r
r r r r
r r s
"r r c | j d } | dfS # t $ rX ddl}|j }| j } | |fcY S # t t f$ r | j d } | dfcY cY S w xY ww xY w)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-8r Nlatin1)decodeUnicodeDecodeErrorlocalegetpreferredencoding LookupError)rI r prefencodings r
guess_decoder s "{{7#W} " " !668L;;=D % %"K0 ";;x(D> ! "
"s, A8'A A8 $A4/A83A44A8c t |dd r* | j |j } | |j fS t | S # t $ r
Y t | S w xY w)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)getattrr r r r )rI terms r
guess_decode_from_terminalr . sd tZ& ';;t}}-D & & " s A AAc \ t | dd r | j S ddl}|j S )z7Return our best guess of encoding for the given *term*.r Nr )r r r r )r r s r
terminal_encodingr ? s* tZ&}} & & ((r c e Zd Zd Zy)UnclosingTextIOWrapperc $ | j y r )flushr s r
closez UnclosingTextIOWrapper.closeI s
r N)r r r r r r r
r r G s r r )NFr )Fr )r )%r
rX ior rY rV DOTALL MULTILINEVERBOSErd rZ rs rf ro r0 r rE r r r- r1 r7 rB rN ra rj rm rq ru ry r r r r r r r r r r
r s$
9%
BJJ YY
*,
/MMBII- <
>bjj-rtt4 NJ N) 0> 0 -" !&"*Z
F*
8 &
" ""* ")] r