B `a[Ny @sdZddlmZddlZddlZddlZddlmZmZddl m Z ddl m Z m Z mZmZddlmZmZmZmZmZmZmZmZmZddlmZd d d d d dddddddg ZdddddgZeddZGddde Z!ee!Gdd d e"Z#Gdd d e#Z$Gd dde%Z&Gd!d"d"e"Z'e'Z(Gd#d$d$e)Z*Gd%d&d&e"Z+d'dZ,Gd(d)d)e"Z-e-Z.d*dZ/Gd+ddZ0Gd,ddeZ1Gd-d.d.e!Z2ee2Gd/d d e#Z3Gd0d d e"Z4Gd1d d e3Z5d2d3Z6Gd4d5d5e2Z7ee7Gd6d7d7e3Z8dS)8z pygments.lexer ~~~~~~~~~~~~~~ Base lexer classes. :copyright: Copyright 2006-2017 by the Pygments team, see AUTHORS. :license: BSD, see LICENSE for details. )print_functionN) apply_filtersFilter)get_filter_by_name)ErrorTextOther _TokenType) get_bool_opt get_int_opt get_list_optmake_analysator text_type add_metaclass iteritemsFuture guess_decode) regex_optLexer RegexLexerExtendedRegexLexerDelegatingLexer LexerContextincludeinheritbygroupsusingthisdefaultwords)szutf-8)szutf-32)szutf-32be)szutf-16)szutf-16becCsdS)Ng)xr r -lib/python3.7/site-packages/pygments/lexer.py$sr#c@seZdZdZddZdS) LexerMetaz This metaclass automagically converts ``analyse_text`` methods into static methods which always return float values. cCs(d|krt|d|d<t||||S)N analyse_text)r type__new__)Zmcsnamebasesdr r r"r'-szLexerMeta.__new__N)__name__ __module__ __qualname____doc__r'r r r r"r$'sr$c@sZeZdZdZdZgZgZgZgZdZ ddZ ddZ dd Z d d Z dd dZddZdS)ra Lexer for a specific language. Basic options recognized: ``stripnl`` Strip leading and trailing newlines from the input (default: True). ``stripall`` Strip all leading and trailing whitespace from the input (default: False). ``ensurenl`` Make sure that the input ends with a newline (default: True). This is required for some lexers that consume input linewise. .. versionadded:: 1.3 ``tabsize`` If given and greater than 0, expand tabs in the input (default: 0). ``encoding`` If given, must be an encoding name. This encoding will be used to convert the input string to Unicode, if it is not already a Unicode string (default: ``'guess'``, which uses a simple UTF-8 / Locale / Latin1 detection. Can also be ``'chardet'`` to use the chardet library, if it is installed. ``inencoding`` Overrides the ``encoding`` if given. NrcKs||_t|dd|_t|dd|_t|dd|_t|dd|_|dd |_|d pZ|j|_g|_ xt |d d D]}| |qrWdS) NstripnlTstripallFensurenltabsizerencodingguessZ inencodingfiltersr ) optionsr r/r0r1r r2getr3r5r add_filter)selfr6filter_r r r"__init__bszLexer.__init__cCs(|jrd|jj|jfSd|jjSdS)Nzz)r6 __class__r+)r9r r r"__repr__ns zLexer.__repr__cKs&t|tst|f|}|j|dS)z8 Add a new stream filter to this lexer. N) isinstancerrr5append)r9r:r6r r r"r8us  zLexer.add_filtercCsdS)a~ Has to return a float between ``0`` and ``1`` that indicates if a lexer wants to highlight this text. Used by ``guess_lexer``. If this method returns ``0`` it won't highlight it in any case, if it returns ``1`` highlighting with this lexer is guaranteed. The `LexerMeta` metaclass automatically wraps this function so that it works like a static method (no ``self`` or ``cls`` parameter) and the return value is automatically converted to `float`. If the return value is an object that is boolean `False` it's the same as if the return values was ``0.0``. Nr )textr r r"r%}s zLexer.analyse_textFc sttsjdkr"t\}nʈjdkry ddl}Wntk rTtdYnXd}x4tD],\}}|r`t|d |d}Pq`W|dkr| dd} | dpd d}|n& jd rtd dnd r td d d d  d d j r4njrFd jdkr^jjrzd szd 7fdd} | } |st| j} | S)a= Return an iterable of (tokentype, value) pairs generated from `text`. If `unfiltered` is set to `True`, the filtering mechanism is bypassed even if filters are defined. Also preprocess the text, i.e. expand tabs and strip it if wanted and applies registered filters. r4chardetrNzkTo enable chardet encoding guessing, please install the chardet library from http://chardet.feedparser.org/replaceir3zutf-8uz   c3s(x"D]\}}}||fVq WdS)N)get_tokens_unprocessed)_tv)r9r@r r"streamersz"Lexer.get_tokens..streamer)r>rr3rrA ImportError _encoding_map startswithlendecodeZdetectr7rBr0stripr/r2 expandtabsr1endswithrr5) r9r@Z unfilteredrFrAZdecodedZbomr3encrIstreamr )r9r@r" get_tokenssL              zLexer.get_tokenscCstdS)z Return an iterable of (index, tokentype, value) pairs where "index" is the starting position of the token within the input text. In subclasses, implement this method as a generator to maximize effectiveness. N)NotImplementedError)r9r@r r r"rEszLexer.get_tokens_unprocessed)F)r+r,r-r.r(aliases filenamesZalias_filenamesZ mimetypesZpriorityr;r=r8r%rTrEr r r r"r3s  ;c@s$eZdZdZefddZddZdS)ra  This lexer takes two lexer as arguments. A root lexer and a language lexer. First everything is scanned using the language lexer, afterwards all ``Other`` tokens are lexed using the root lexer. The lexers from the ``template`` lexer package use this base lexer. cKs0|f||_|f||_||_tj|f|dS)N) root_lexerlanguage_lexerneedlerr;)r9Z _root_lexerZ_language_lexerZ_needler6r r r"r;s  zDelegatingLexer.__init__cCsd}g}g}xX|j|D]H\}}}||jkrR|rH|t||fg}||7}q||||fqW|r||t||ft||j|S)N)rYrErZr?rM do_insertionsrX)r9r@Zbuffered insertionsZ lng_bufferirGrHr r r"rEs  z&DelegatingLexer.get_tokens_unprocessedN)r+r,r-r.rr;rEr r r r"rs c@seZdZdZdS)rzI Indicates that a state should include rules from another state. N)r+r,r-r.r r r r"rsc@seZdZdZddZdS)_inheritzC Indicates the a state should inherit from its superclass. cCsdS)Nrr )r9r r r"r=sz_inherit.__repr__N)r+r,r-r.r=r r r r"r_sr_c@s eZdZdZddZddZdS)combinedz: Indicates a state combined from multiple states. cGs t||S)N)tupler')clsargsr r r"r'szcombined.__new__cGsdS)Nr )r9rcr r r"r;szcombined.__init__N)r+r,r-r.r'r;r r r r"r` sr`c@sFeZdZdZddZdddZdddZdd d Zd d Zd dZ dS) _PseudoMatchz: A pseudo match object constructed from a string. cCs||_||_dS)N)_text_start)r9startr@r r r"r;sz_PseudoMatch.__init__NcCs|jS)N)rf)r9argr r r"rgsz_PseudoMatch.startcCs|jt|jS)N)rfrMre)r9rhr r r"end"sz_PseudoMatch.endcCs|r td|jS)Nz No such group) IndexErrorre)r9rhr r r"group%sz_PseudoMatch.groupcCs|jfS)N)re)r9r r r"groups*sz_PseudoMatch.groupscCsiS)Nr )r9r r r" groupdict-sz_PseudoMatch.groupdict)N)N)N) r+r,r-r.r;rgrirkrlrmr r r r"rds   rdcsdfdd }|S)zL Callback that yields multiple actions for each group in the match. Nc3sxtD]\}}|dkrq q t|tkrT||d}|r||d||fVq ||d}|dk r |r~||d|_x.||t||d||D]}|r|VqWq W|r||_dS)N) enumerater&r rkrgposrdri)lexermatchctxr^actiondataitem)rcr r"callback5s" zbygroups..callback)Nr )rcrwr )rcr"r1sc@seZdZdZdS)_ThiszX Special singleton used for indicating the caller class. Used by ``using``. N)r+r,r-r.r r r r"rxKsrxc sjidkr:d}t|ttfr.|d<n d|fd<tkrTdfdd }nd fdd }|S) a Callback that processes the match with a different lexer. The keyword arguments are forwarded to the lexer, except `state` which is handled separately. `state` specifies the state that the new lexer will start in, and can be an enumerable such as ('root', 'inline', 'string') or a simple string which is assumed to be on top of the root state. Note: For that to work, `_other` must not be an `ExtendedRegexLexer`. statestackrootNc3snr|j|jf}n|}|}x0|j|fD]\}}}||||fVq>W|rj||_dS)N)updater6r<rgrErkrirp)rqrrrslxsr^rGrH) gt_kwargskwargsr r"rwis zusing..callbackc3sb|jf}|}x0|j|fD]\}}}||||fVq2W|r^||_dS)N)r|r6rgrErkrirp)rqrrrsr}r~r^rGrH)_otherrrr r"rwxs  )N)N)popr>listrar)rrr~rwr )rrrr"rSs     c@seZdZdZddZdS)rz Indicates a state or state action (e.g. #pop) to apply. For example default('#pop') is equivalent to ('', Token, '#pop') Note that state tuples may be used as well. .. versionadded:: 2.0 cCs ||_dS)N)ry)r9ryr r r"r;szdefault.__init__N)r+r,r-r.r;r r r r"rsc@s"eZdZdZdddZddZdS) rz Indicates a list of literal words that is transformed into an optimized regex that matches any of the words. .. versionadded:: 2.0 r[cCs||_||_||_dS)N)rprefixsuffix)r9rrrr r r"r;szwords.__init__cCst|j|j|jdS)N)rr)rrrr)r9r r r"r7sz words.getN)r[r[)r+r,r-r.r;r7r r r r"rs c@sJeZdZdZddZddZddZdd Zdd d Zd dZ ddZ d S)RegexLexerMetazw Metaclass for RegexLexer, creates the self._tokens attribute from self.tokens on the first instantiation. cCs t|tr|}t||jS)zBPreprocess the regular expression component of a token definition.)r>rr7recompilerr)rbregexrflagsryr r r"_process_regexs zRegexLexerMeta._process_regexcCs&t|tks"t|s"td|f|S)z5Preprocess the token component of a token definition.z2token type must be simple type or callable, not %r)r&r callableAssertionError)rbtokenr r r"_process_tokens zRegexLexerMeta._process_tokencCst|trd|dkrdS||kr$|fS|dkr0|S|dddkrRt|dd Sdsbtd|nt|trd |j}|jd 7_g}x4|D],}||kstd ||||||qW|||<|fSt|trx(|D] }||ks|d kstd |qW|Sdstd|dS)z=Preprocess the state transition action of a token definition.z#popz#pushNz#pop:Fzunknown new state %rz_tmp_%drnzcircular state ref %r)z#popz#pushzunknown new state zunknown new state def %r) r>strintrr`_tmpnameextend_process_statera)rb new_state unprocessed processedZ tmp_stateitokensZistater r r"_process_new_states6        z!RegexLexerMeta._process_new_statec Cst|tkstd||ddks0td|||kr@||Sg}||<|j}x:||D],}t|tr||kstd|||||t|q^t|trq^t|t r| |j ||}| t djd|fq^t|tkstd|y||d||}Wn<tk rF} ztd |d||| fWdd} ~ XYnX||d } t|d krjd}n| |d ||}| || |fq^W|S) z%Preprocess a single state definition.zwrong state name %rr#zinvalid state name %rzcircular state reference %rr[Nzwrong rule def %rz+uncompilable regex %r in state %r of %r: %srn)r&rrflagsr>rrrr_rrryr?rrrrrar Exception ValueErrorrrM) rbrrrytokensrZtdefrrexerrrr r r"rs>      & zRegexLexerMeta._process_stateNcCs@i}|j|<|p|j|}xt|D]}||||q&W|S)z-Preprocess a dictionary of token definitions.) _all_tokensrrr)rbr( tokendefsrryr r r"process_tokendefs zRegexLexerMeta.process_tokendefc Csi}i}x|jD]}|jdi}xt|D]\}}||}|dkr~|||<y|t}Wntk rrw,YnX|||<q,||d}|dkrq,||||d<y|t} Wntk rYq,X|| ||<q,WqW|S)a Merge tokens from superclasses in MRO order, returning a single tokendef dictionary. Any state that is not defined by a subclass will be inherited automatically. States that *are* defined by subclasses will, by default, override that state in the superclass. If a subclass wishes to inherit definitions from a superclass, it can use the special value "inherit", which will cause the superclass' state definition to be included at that point in the state. rNrn)__mro____dict__r7rindexrrr) rbrZ inheritablecZtoksryitemsZcuritemsZ inherit_ndxZ new_inh_ndxr r r" get_tokendefs s0    zRegexLexerMeta.get_tokendefscOsLd|jkr:i|_d|_t|dr(|jr(n|d||_tj |f||S)z:Instantiate cls after preprocessing its token definitions._tokensrtoken_variantsr[) rrrhasattrrrrrr&__call__)rbrckwdsr r r"r;s zRegexLexerMeta.__call__)N) r+r,r-r.rrrrrrrr r r r"rs#, 1rc@s$eZdZdZejZiZdddZdS)rz Base for simple stateful regular expression-based lexers. Simplifies the lexing process so that you need only provide a list of states and regular expressions. r{c csd}|j}t|}||d}xxz|D]\}}} |||} | r*|dk rt|tkrj||| fVnx||| D] } | VqvW| }| dk r2t| trx| D]8} | dkr|q| dkr| |dq| | qWnBt| t r|| d=n,| dkr| |dnds&t d| ||d}Pq*WyN||dkrld g}|d }|t dfV|d 7}w"|t ||fV|d 7}Wq"tk rPYq"Xq"WdS) z} Split ``text`` into (tokentype, text) pairs. ``stack`` is the inital stack (default: ``['root']``) rrNz#popz#pushFzwrong state def: %rrCr{rn)rrr&r rkrir>rarr?rrrrrj) r9r@rzrprZ statestack statetokensrexmatchrtrmrvryr r r"rEhsP              z!RegexLexer.get_tokens_unprocessedN)r) r+r,r-r.r MULTILINErrrEr r r r"rIsc@s"eZdZdZdddZddZdS)rz9 A helper object that holds lexer position data. NcCs*||_||_|pt||_|p"dg|_dS)Nr{)r@rprMrirz)r9r@rprzrir r r"r;szLexerContext.__init__cCsd|j|j|jfS)NzLexerContext(%r, %r, %r))r@rprz)r9r r r"r=szLexerContext.__repr__)NN)r+r,r-r.r;r=r r r r"rs c@seZdZdZdddZdS)rzE A RegexLexer that uses a context object to store its state. Nc cs|j}|st|d}|d}n|}||jd}|j}xܐx|D]<\}}}|||j|j} | rB|dk rt|tkr|j|| fV| |_n.x||| |D] } | VqW|s||jd}|dk r~t |t r&x|D]B} | dkr|j q| dkr|j |jdq|j | qWnJt |t r@|j|d=n0|dkr^|j |jdndsptd|||jd}PqBWyt|j|jkrP||jd krdg|_|d}|jtd fV|jd 7_w:|jt||jfV|jd 7_Wq:tk rPYq:Xq:WdS) z Split ``text`` into (tokentype, text) pairs. If ``context`` is given, use this lexer context instead. rr{rNz#popz#pushFzwrong state def: %rrCrn)rrrzr@rprir&r rkr>rarr?rrrrrj) r9r@contextrrsrrrtrrrvryr r r"rEs^            z)ExtendedRegexLexer.get_tokens_unprocessed)NN)r+r,r-r.rEr r r r"rsc cst|}yt|\}}Wn(tk r@x|D] }|Vq.WdSXd}d}x|D]\}}} |dkrf|}d} x|r|t| |kr| | ||} ||| fV|t| 7}x*|D]"\} } }|| |fV|t|7}qW||} yt|\}}Wqltk r d}PYqlXqlW||| | dfV|t| | 7}qPWxr|r|pJd}x,|D]$\}}} ||| fV|t| 7}qRWyt|\}}Wntk rd}PYnXqMetaclass for ProfilingRegexLexer, collects regex timing info.csLt|tr t|j|j|jdn|t|tjffdd }|S)N)rrcs`jdfddg}t}|||}t}|dd7<|d||7<|S)Nrrgrn) _prof_data setdefaulttimerr)r@rpendposinfoZt0ZresZt1)rbcompiledrryr r" match_func@sz:ProfilingRegexLexerMeta._process_regex..match_func) r>rrrrrrsysmaxsize)rbrrryrr )rbrrryr"r8s    z&ProfilingRegexLexerMeta._process_regexN)r+r,r-r.rr r r r"r5src@s"eZdZdZgZdZdddZdS)ProfilingRegexLexerzFDrop-in replacement for RegexLexer that does profiling of its regexes.r{c#sjjixt||D] }|VqWjj}tdd|Dfdddd}tdd|D}t t djj t ||ft d t d d t d x|D]}t d |qWt d dS)NcssN|]F\\}}\}}|t|ddddd|d|d||fVqdS)zu'z\\\NAi)reprrOrB).0r~rnrGr r r" Xsz=ProfilingRegexLexer.get_tokens_unprocessed..cs |jS)N)_prof_sort_index)r!)r9r r"r#[sz.T)keyreversecss|]}|dVqdS)Nr )rr!r r r"r]sz2Profiling result for %s lexing %d chars in %.3f mszn==============================================================================================================z$%-20s %-64s ncalls tottime percall)ryrzn--------------------------------------------------------------------------------------------------------------z%-20s %-65s %5d %8.4f %8.4f) r<rr?rrErsortedrsumprintr+rM)r9r@rztokZrawdataruZ sum_totalr*r )r9r"rERs$      z*ProfilingRegexLexer.get_tokens_unprocessedN)r)r+r,r-r.rrrEr r r r"rKsr)9r.Z __future__rrrrZpygments.filterrrZpygments.filtersrZpygments.tokenrrrr Z pygments.utilr r r r rrrrrZpygments.regexoptr__all__rK staticmethodZ_default_analyser&r$objectrrrrr_rrar`rdrrxrrrrrrrrr\rrr r r r" sX  ,    ' 2 )WE?