ÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂ 3 sÝ¨\klã@sdZddlZddlmZddlmZddlmZmZddl m Z mZmZm Z mZmZmZmZmZddlmZmZmZddlmZmZmZmZmZmZmZmZd d ddd dddddddddgZ eZ!dd„Z"e#ƒZ$e#ƒZ%dd„Z&dd„Z'd7dd„Z(Gdd „d e#ƒZ)dd„Z*Gd d!„d!e+ƒZ,e fd"d#„Z-Gd$d%„d%ee,ƒƒZ.ydd&l/m0Z0e0j1e.ƒWne2k rfYnXGd'd(„d(e#ƒZ3Gd)d*„d*e#ƒZ4Gd+d „d e4ƒZ5eGd,d-„d-e#ƒƒZ6Gd.d„de#ƒZ7eGd/d0„d0e#ƒƒZ8d8d1d2„Z9eGd3d4„d4e8ƒƒZ:eGd5d6„d6e8ƒƒZ;e8`%sr$cCsLg}tt|ƒ}x4|D],}|j|ƒt|dƒrtdƒjt||ƒƒSqWt|ƒS)z@Concatenation that escapes if necessary and converts to unicode.Z__html__Ú)rrÚappendÚhasattrrÚjoinrr )ÚseqZbufÚiteratorÚargr!r!r#r+s cCsttt|ƒƒS)z4Simple args to unicode conversion and concatenation.)r rr)r)r!r!r#r6sc Csl|dkri}|r|}nt|pff|Ž}|r\|r6t|ƒ}x$t|ƒD]\}} | tk r@| ||<q@W|j||||ƒS)z(Internal helper to for context creation.N)Údictrr Z context_class) ÚenvironmentZ template_nameÚblocksÚvarsZsharedÚglobalsÚlocalsÚparentÚkeyÚvaluer!r!r#Únew_context;s r5c@s(eZdZdZdd„Zdd„Zdd„ZdS) rzThe `self` in templates.cCs ||_dS)N)Ú_TemplateReference__context)ÚselfÚcontextr!r!r#Ú__init__SszTemplateReference.__init__cCs|jj|}t||j|dƒS)Nr)r6r.ÚBlockReference)r7Únamer.r!r!r#Ú__getitem__VszTemplateReference.__getitem__cCsd|jj|jjfS)Nz<%s %r>)Ú __class__Ú__name__r6r;)r7r!r!r#Ú__repr__ZszTemplateReference.__repr__N)r>Ú __module__Ú__qualname__Ú__doc__r9r<r?r!r!r!r#rPscCst|d|ƒS)NÚ__func__)Úgetattr)r"r!r!r#Ú _get_funcasrEc@seZdZdd„ZdS)ÚContextMetac Csvtj||||ƒ}|fkr|St|jƒ}ttjƒ}t|jƒ}ttjƒ}||k r\||kr\d|_n||krr||krrd|_|S)NT)ÚtypeÚ__new__rEÚresolveÚContextÚresolve_or_missingÚ_legacy_resolve_modeÚ_fast_resolve_mode) Úclsr;ÚbasesÚdÚrvrIZdefault_resolverKZdefault_resolve_or_missingr!r!r#rHgs zContextMeta.__new__N)r>r@rArHr!r!r!r#rFesrFcCs,||jkr|j|S||jkr(|j|S|S)N)r/r2)r8r3r r!r!r#rK}s rKc@s¾eZdZdZdZdZdd„Zdd„Zd$dd „Zd d„Z dd „Z dd„Zdd„Ze dd„ƒZd%dd„Zdd„ZedƒZedƒZedƒZer edƒZedƒZedƒZ[dd„Zd d!„Zd"d#„ZdS)&rJaïThe template context holds the variables of a template. It stores the values passed to the template and also the names the template exports. Creating instances is neither supported nor useful as it's created automatically at various stages of the template evaluation and should not be created by hand. The context is immutable. Modifications on :attr:`parent` **must not** happen and modifications on :attr:`vars` are allowed from generated template code only. Template filters and global functions marked as :func:`contextfunction`\s get the active context passed as first argument and are allowed to access the context read-only. The template context supports read only dict operations (`get`, `keys`, `values`, `items`, `iterkeys`, `itervalues`, `iteritems`, `__getitem__`, `__contains__`). Additionally there is a :meth:`resolve` method that doesn't fail with a `KeyError` but returns an :class:`Undefined` object for missing variables. FcCs\||_i|_||_t|j|ƒ|_tƒ|_||_tdd„t |ƒDƒƒ|_ |jrXtt |ƒ|_ dS)Ncss|]\}}||gfVqdS)Nr!)Ú.0ÚkÚvr!r!r#ú ¨sz#Context.__init__..)r2r/r-rÚeval_ctxÚsetÚ exported_varsr;r,rr.rMrrK)r7r-r2r;r.r!r!r#r9szContext.__init__c CsXy$|j|}|j|ƒd}||Wn$tk rH|jjd|ddSXt||||ƒS)zRender a parent block.éz#there is no parent block called %r.Úsuper)r;)r.ÚindexÚLookupErrorr-Ú undefinedr:)r7r;Zcurrentr.r[r!r!r#rZ¯s z Context.superNcCs"y||Stk r|SXdS)zfReturns an item from the template context, if it doesn't exist `default` is returned. N)ÚKeyError)r7r3Údefaultr!r!r#Úget»szContext.getcCs6|jrt||ƒ}n |j|ƒ}|tkr2|jj|dS|S)zŽLooks up a variable like `__getitem__` or `get` but returns an :class:`Undefined` object with the name of the name looked up. )r;)rLrKr r-r])r7r3rQr!r!r#rIÄs zContext.resolvecCs,|jr"|j|ƒ}t|tƒrt}|St||ƒS)zxResolves a variable like :meth:`resolve` but returns the special `missing` value if it cannot be found. )rLrIÚ isinstanceÚ Undefinedr rK)r7r3rQr!r!r#rKÐs zContext.resolve_or_missingcst‡fdd„ˆjDƒƒS)z+Get a new dict with the exported variables.c3s|]}|ˆj|fVqdS)N)r/)rRrS)r7r!r#rUÝsz'Context.get_exported..)r,rX)r7r!)r7r#Úget_exportedÛszContext.get_exportedcCs(|js|jS|js|jSt|jf|jŽS)z»Return the complete context as dict including the exported variables. For optimizations reasons this might not return an actual copy so be careful with using it. )r/r2r,)r7r!r!r#Úget_allßs zContext.get_allcOs²d}t|dƒr2|j}xd D]}t||ƒr|}PqWt|tƒr†t|ddƒrT|f|}n2t|ddƒrn|jf|}nt|ddƒr†|jf|}y |||ŽStk r¬|jjdƒSXdS) zðCall the callable with the arguments and keyword arguments provided but inject the active context or environment as first argument if the callable is a :func:`contextfunction` or :func:`environmentfunction`. TÚ__call__Úcontextfunctionr ÚenvironmentfunctionrzGvalue was undefined because a callable raised a StopIteration exceptionN)rfr rg) r'rerarrDrVr-Ú StopIterationr])Z_Context__selfZ _Context__objÚargsÚkwargsZ__traceback_hide__ÚfnZfn_typer!r!r#Úcallês( zContext.callcCsDt|j|ji|jƒdd|ƒ}|j|_|jjdd„t|jƒDƒƒ|S)z¹Internal helper function to create a derived context. This is used in situations where the system needs a new context in the same template that is independent. TNcss|]\}}|t|ƒfVqdS)N)Úlist)rRrSrTr!r!r#rUsz"Context.derived..)r5r-r;rdrVr.Úupdater)r7r1r8r!r!r#Úderiveds zContext.derivedcs$‡fdd„}ttˆƒj|_ˆ|_|S)Ncst|jƒˆƒƒS)N)rDrd)r7)Úmethr!r#r$szContext._all..)rDr,rBr>)rpÚproxyr!)rpr#Ú_allszContext._allÚkeysÚvaluesÚitemsÚiterkeysÚ itervaluesrcCs||jkp||jkS)N)r/r2)r7r;r!r!r#Ú__contains__(szContext.__contains__cCs|j|ƒ}|tkrt|ƒ‚|S)zTLookup a variable or raise `KeyError` if the variable is undefined. )rKr r^)r7r3Úitemr!r!r#r<+s zContext.__getitem__cCsd|jjt|jƒƒ|jfS)Nz <%s %s of %r>)r=r>Úreprrdr;)r7r!r!r#r?4s zContext.__repr__)N)N)r>r@rArBrLrMr9rZr`rIrKrcrdrrlrorrrsrtrurrvrwrrxr<r?r!r!r!r#rJ…s0 " rJ)ÚMappingc@s0eZdZdZdd„Zedd„ƒZedd„ƒZdS) r:z"One block on a template reference.cCs||_||_||_||_dS)N)r;Ú_contextÚ_stackÚ_depth)r7r;r8ÚstackÚdepthr!r!r#r9GszBlockReference.__init__cCsF|jdt|jƒkr,|jjjd|jddSt|j|j|j|jdƒS)zSuper the block.rYz#there is no parent block called %r.rZ)r;)r~Úlenr}r|r-r]r;r:)r7r!r!r#rZMszBlockReference.supercCs,t|j|j|jƒƒ}|jjjr(t|ƒ}|S)N)r r}r~r|rVÚ autoescaper)r7rQr!r!r#reWs zBlockReference.__call__N) r>r@rArBr9ÚpropertyrZrrer!r!r!r#r:Ds r:c@s¼eZdZdZeZeZeZdZ ddd„Z dd„Zdd „Ze d d„ƒZe dd„ƒZe d d„ƒZe dd„ƒZe dd„ƒZe dd„ƒZe dd„ƒZe dd„ƒZdd„Zedd„ƒZeZ[dd„ZdS)ÚLoopContextBasez%A loop context for dynamic iteration.NrcCs"||_||_d|_||_t|_dS)NrYéÿÿÿÿ)Ú _undefinedÚ_recurseÚindex0Údepth0r Ú_last_checked_value)r7r]Úrecurser‰r!r!r#r9gs zLoopContextBase.__init__cGs|stdƒ‚||jt|ƒS)z7Cycles among the arguments with the current loop index.zno items for cycling given)Ú TypeErrorrˆr)r7rir!r!r#ÚcyclenszLoopContextBase.cyclecGs|j|kr||_dSdS)z9Checks whether the value has changed since the last call.TF)rŠ)r7r4r!r!r#Úchangedts zLoopContextBase.changedcCs |jdkS)Nr)rˆ)r"r!r!r#r${szLoopContextBase.cCs |jtkS)N)Ú_afterÚ_last_iteration)r"r!r!r#r$|scCs |jdS)NrY)rˆ)r"r!r!r#r$}scCs|j|jS)N)Úlengthrˆ)r"r!r!r#r$~scCs|j|jS)N)r‘r[)r"r!r!r#r$scCs |jdS)NrY)r‰)r"r!r!r#r$€scCs|jtkr|jdƒS|jS)Nzthere is no previous item)Ú_beforeÚ_first_iterationr†)r7r!r!r#Úprevitem‚s zLoopContextBase.previtemcCs|jtkr|jdƒS|jS)Nzthere is no next item)rrr†)r7r!r!r#Únextitemˆs zLoopContextBase.nextitemcCs|jS)N)r‘)r7r!r!r#Ú__len__ŽszLoopContextBase.__len__cCs(|jdkrtdƒ‚|j||j|jdƒS)NzMTried to call non recursive loop. Maybe you forgot the 'recursive' modifier.rY)r‡rŒr‰)r7Úiterabler!r!r#Úloop‘s zLoopContextBase.loopcCsd|jj|j|jfS)Nz <%s %r/%r>)r=r>r[r‘)r7r!r!r#r?szLoopContextBase.__repr__)Nr)r>r@rArBr“r’Ú_currentrrÚ_lengthr9rrŽrƒÚfirstZlastr[ZrevindexZ revindex0r€r”r•r–rr˜rer?r!r!r!r#r„_s* r„c@s2eZdZddd„Zedd„ƒZdd„Zd d „ZdS)rNrcCsVtj||||ƒt|ƒ|_yt|ƒ|_Wnttfk rFd|_YnX|jƒ|_ dS)N) r„r9ÚiterÚ _iteratorrršrŒÚAttributeErrorÚ _safe_nextr)r7r—r]r‹r‰r!r!r#r9§s zLoopContext.__init__cCs<|jdkr6t|jƒ}t|ƒ|_|jd}t|ƒ||_|jS)Né)ršÚtuplerrœrˆr)r7r—Ziterations_doner!r!r#r‘µs zLoopContext.lengthcCst|ƒS)N)ÚLoopContextIterator)r7r!r!r#Ú__iter__ÂszLoopContext.__iter__cCs$y t|jƒStk rtSXdS)N)Únextrrhr)r7r!r!r#rŸÅs zLoopContext._safe_next)Nr)r>r@rAr9rƒr‘r£rŸr!r!r!r#r¥s c@s,eZdZdZd Zdd„Zdd„Zdd„Zd S)r¢z The iterator for a loop context.r8cCs ||_dS)N)r8)r7r8r!r!r#r9ÑszLoopContextIterator.__init__cCs|S)Nr!)r7r!r!r#r£ÔszLoopContextIterator.__iter__cCsH|j}|jd7_|jtkr$tƒ‚|j|_|j|_|jƒ|_|j|fS)NrY)r8rˆrrrhr™r’rŸ)r7Zctxr!r!r#Ú__next__×s zLoopContextIterator.__next__N)r8)r>r@rArBÚ __slots__r9r£r¥r!r!r!r#r¢Ìs r¢c@s:eZdZdZddd„Zeedd„ƒƒZdd„Zd d „Z dS)rzWraps a macro function.Nc CsV||_||_t|ƒ|_||_||_||_||_||_d|k|_ |dkrL|j }||_dS)NÚcaller)Ú_environmentÚ_funcrÚ_argument_countr;Ú argumentsÚcatch_kwargsÚ catch_varargsr§Úexplicit_callerr‚Ú_default_autoescape) r7r-Úfuncr;r«r¬rr§Zdefault_autoescaper!r!r#r9ås zMacro.__init__cOsš|r*t|dtƒr*|dj}|dd…}n|j}t|d|j…ƒ}t|ƒ}d}||jkr¼xht|jt|ƒd…ƒD]F\}}y|j |ƒ} Wnt k ržt} YnX|dkr¬d}|j| ƒqpWn|j }|jrü|rü|j ddƒ} | dkrò|jjddd} |j| ƒ|jr|j|ƒn8|rHd|kr.td|jƒ‚td |jtt|ƒƒfƒ‚|jrf|j||jd…ƒn(t|ƒ|jkrŽtd |jt|jƒfƒ‚|j||ƒS)NrrYFr§TzNo caller defined)r;zamacro %r was invoked with two values for the special caller argument. This is most likely a bug.z%macro %r takes no keyword argument %rz+macro %r takes not more than %d argument(s))rarr‚r¯rmrªrÚ enumerater«Úpopr^r r&r®r§r¨r]r¬rŒr;r¤rœrÚ_invoke)r7rirjr‚r«ZoffZfound_callerÚidxr;r4r§r!r!r#reõsJ zMacro.__call__cCs|j|Ž}|rt|ƒ}|S)z=This method is being swapped out by the async implementation.)r©r)r7r«r‚rQr!r!r#r³As z Macro._invokecCs$d|jj|jdkrdpt|jƒfS)Nz<%s %s>Z anonymous)r=r>r;rz)r7r!r!r#r?HszMacro.__repr__)N) r>r@rArBr9rr rer³r?r!r!r!r#râs Kc@sîeZdZdZdZdedefdd„Zed d „ƒZ edd„ƒZ e ZZZ ZZZZZZZZZZZZZZZZZZZ Z!Z"Z#Z$Z%d d„Z&dd„Z'dd„Z(dd„Z)dd„Z*dd„Z+dd„Z,e,Z-dd„Z.dS)rbazThe default undefined type. This undefined type can be printed and iterated over, but every other access will raise an :exc:`jinja2.exceptions.UndefinedError`: >>> foo = Undefined(name='foo') >>> str(foo) '' >>> not foo True >>> foo + 42 Traceback (most recent call last): ... jinja2.exceptions.UndefinedError: 'foo' is undefined Ú_undefined_hintÚ_undefined_objÚ_undefined_nameÚ_undefined_exceptionNcCs||_||_||_||_dS)N)rµr¶r·r¸)r7ÚhintÚobjr;Úexcr!r!r#r9aszUndefined.__init__cOsl|jdkrX|jtkr d|j}q^t|jtƒsBdt|jƒ|jf}q^dt|jƒ|jf}n|j}|j|ƒ‚dS)z{Regular callback function for undefined objects that raises an `jinja2.exceptions.UndefinedError` on call. Nz%r is undefinedz%s has no element %rz%r has no attribute %r)rµr¶r r·rarrr¸)r7rirjr¹r!r!r#Ú_fail_with_undefined_errorgs z$Undefined._fail_with_undefined_errorcCs |dd…dkrt|ƒ‚|jƒS)Nr Ú__)ržr¼)r7r;r!r!r#Ú__getattr__}szUndefined.__getattr__cCst|ƒt|ƒkS)N)rG)r7Úotherr!r!r#Ú__eq__ŠszUndefined.__eq__cCs|j|ƒS)N)rÀ)r7r¿r!r!r#Ú__ne__szUndefined.__ne__cCstt|ƒƒS)N)ÚidrG)r7r!r!r#Ú__hash__szUndefined.__hash__cCsdS)Nr%r!)r7r!r!r#Ú__str__“szUndefined.__str__cCsdS)Nrr!)r7r!r!r#r––szUndefined.__len__ccsdS)Nr!)r7r!r!r#r£™szUndefined.__iter__cCsdS)NFr!)r7r!r!r#Ú__nonzero__szUndefined.__nonzero__cCsdS)Nrbr!)r7r!r!r#r?¡szUndefined.__repr__)rµr¶r·r¸)/r>r@rArBr¦r rr9rr¼r¾Ú__add__Ú__radd__Ú__mul__Ú__rmul__Z__div__Z__rdiv__Ú__truediv__Ú__rtruediv__Ú__floordiv__Ú __rfloordiv__Ú__mod__Ú__rmod__Ú__pos__Ú__neg__rer<Ú__lt__Ú__le__Ú__gt__Ú__ge__Ú__int__Ú __float__Ú__complex__Ú__pow__Ú__rpow__Ú__sub__Ú__rsub__rÀrÁrÃrÄr–r£rÅÚ__bool__r?r!r!r!r#rbOs lrbcs`ˆdkr,ddl}|jtƒ‰ˆj|jtjƒƒˆdkr8t‰‡fdd„‰G‡‡‡fdd„dˆƒ}|S)akGiven a logger object this returns a new undefined class that will log certain failures. It will log iterations and printing. If no logger is given a default logger is created. Example:: logger = logging.getLogger(__name__) LoggingUndefined = make_logging_undefined( logger=logger, base=Undefined ) .. versionadded:: 2.8 :param logger: the logger to use. If not provided, a default logger is created. :param base: the base class to add logging functionality to. This defaults to :class:`Undefined`. Nrcsn|jdkrX|jtkr d|j}q^t|jtƒsBdt|jƒ|jf}q^dt|jƒ|jf}n|j}ˆjd|ƒdS)Nz%s is undefinedz%s has no element %sz%s has no attribute %szTemplate variable warning: %s)rµr¶r r·rarrZwarning)Zundefr¹)Úloggerr!r#Ú_log_messageÀs z,make_logging_undefined.._log_messagecsfeZdZ‡‡fdd„Z‡‡fdd„Z‡‡fdd„ZerT‡‡fdd„Z‡‡fd d „Zn‡‡fdd„Z d S)z0make_logging_undefined..LoggingUndefinedcsPyˆj|f|ž|ŽS|jk rJ}zˆjdt|ƒƒ|‚WYdd}~XnXdS)NzTemplate variable error: %s)r¼r¸ÚerrorÚstr)r7rirjÚe)ÚbaserÞr!r#r¼Òs zKmake_logging_undefined..LoggingUndefined._fail_with_undefined_errorcsˆj|ƒ}ˆ|ƒ|S)N)rÄ)r7rQ)rßrãr!r#rÄÙs z8make_logging_undefined..LoggingUndefined.__str__csˆj|ƒ}ˆ|ƒ|S)N)r£)r7rQ)rßrãr!r#r£Þs z9make_logging_undefined..LoggingUndefined.__iter__csˆj|ƒ}ˆ|ƒ|S)N)rÅ)r7rQ)rßrãr!r#rÅäs z.LoggingUndefined.__nonzero__csˆj|ƒ}ˆ|ƒ|S)N)Ú__unicode__)r7rQ)rßrãr!r#räés z.LoggingUndefined.__unicode__csˆj|ƒ}ˆ|ƒ|S)N)rÝ)r7rQ)rßrãr!r#rÝîs z9make_logging_undefined..LoggingUndefined.__bool__N) r>r@rAr¼rÄr£rrÅrärÝr!)rßrãrÞr!r#ÚLoggingUndefinedÐsrå)ÚloggingZ getLoggerr>Z addHandlerZ StreamHandlerÚsysÚstderrrb)rÞrãrærår!)rßrãrÞr#Úmake_logging_undefined¥s #réc@seZdZdZfZdd„ZdS)ÚDebugUndefinedaAn undefined that returns the debug info when printed. >>> foo = DebugUndefined(name='foo') >>> str(foo) '{{ foo }}' >>> not foo True >>> foo + 42 Traceback (most recent call last): ... jinja2.exceptions.UndefinedError: 'foo' is undefined cCs<|jdkr2|jtkrd|jSdt|jƒ|jfSd|jS)Nz{{ %s }}z{{ no such element: %s[%r] }}z!{{ undefined value printed: %s }})rµr¶r r·r)r7r!r!r#rÄs zDebugUndefined.__str__N)r>r@rArBr¦rÄr!r!r!r#rêös rêc@s6eZdZdZfZejZZZ Z ZZZ ZdS)ÚStrictUndefinedasAn undefined that barks on print and iteration as well as boolean tests and all kinds of comparisons. In other words: you can do nothing with it except checking if it's defined using the `defined` test. >>> foo = StrictUndefined(name='foo') >>> str(foo) Traceback (most recent call last): ... jinja2.exceptions.UndefinedError: 'foo' is undefined >>> not foo Traceback (most recent call last): ... jinja2.exceptions.UndefinedError: 'foo' is undefined >>> foo + 42 Traceback (most recent call last): ... jinja2.exceptions.UndefinedError: 'foo' is undefined N)r>r@rArBr¦rbr¼r£rÄr–rÅrÀrÁrÝrÃr!r!r!r#rësrë)NNNN)NN)=rBrçÚ itertoolsrÚtypesrZjinja2.nodesrrZjinja2.utilsrrrr r rrr rZjinja2.exceptionsrrrZjinja2._compatrrrrrrrrÚ__all__rr Úobjectr“rrrr5rrErGrFrKrJÚcollectionsr{ÚregisterÚImportErrorr:r„rr¢rrbrérêrër¦r!r!r!r#Ú sX,( 9F'mU Q