dbfdg 3 ³Gêg‘ã6@sªdZddlZddlZddlZddlZddlmZddlmZm Z ddl mZddlm Z mZmZmZmZmZmZddlmZddlmZdd lmZmZmZmZmZejd ejƒZ ejdejƒZ!dd „Z"dd„Z#dd„Z$dd„Z%dŽdd„Z&dd„Z'dd„Z(e#ddd„ƒZ)dd„Z*dd„Z+ejd ej,d!Z-e#dd#d$„ƒZ.d%d&„Z/d'd(„Z0d‘d+d,„Z1e$d’d-d.„ƒZ2e$d“d/d0„ƒZ3d1d2„Z4e$d”d3d4„ƒZ5e$d•d5d6„ƒZ6d–d8d9„Z7e#d—d:d;„ƒZ8d˜d=d>„Z9e$d?d@„ƒZ:e$dAdB„ƒZ;e"dCdD„ƒZe#d›dIdJ„ƒZ?dœdLdM„Z@e$ddPdQ„ƒZAe$dždSdT„ƒZBdUdV„ZCdŸdXdY„ZDd d[d\„ZEd]d^„ZFd_d`„ZGdadb„ZHd¡dcdd„ZId¢dedf„ZJd£dhdi„ZKedjdkdlgƒZLeMjNeL_NeMjOeL_Oe$dmdn„ƒZPe$d¤dodp„ƒZQdqdr„ZRdsdt„ZSdudv„ZTdwdx„ZUe$dydz„ƒZVe"d{d|„ƒZWe"d}d~„ƒZXe"dd€„ƒZYe"dd‚„ƒZZe"dƒd„„ƒZ[e#d¥d…d†„ƒZ\d‡dˆ„Z]d‰dŠ„Z^d‹dŒ„Z_e`eVeJe/e9eae7e7e1eee=e:eEe'eFePe@eDe8e;eaeRe+eWe5e6e>eHsz#make_attrgetter..Ú.cs.xˆD]}ˆj||ƒ}qWˆdk r*ˆ|ƒ}|S)N)Úgetitem)ÚitemÚpart)Ú attributeÚenvironmentÚpostprocessrrÚ attrgetterLs z#make_attrgetter..attrgetter)rrÚsplit)r(r'r)r*r)r'r(r)rÚmake_attrgetter?s r,cCst|dƒr|jƒ}tt|ƒƒS)zCEnforce HTML escaping. This will probably double escape variables.Ú__html__)Úhasattrr-rr)rrrrÚdo_forceescapeXs r/cCshd}t|tƒrt|ƒ}n,t|tƒsDyt|ƒ}Wntk rBYnX|dkrTt|ƒSdjdd„|DƒƒS)zªEscape strings for use in URLs (uses UTF-8 encoding). It accepts both dictionaries and regular strings as well as pairwise iterables. .. versionadded:: 2.7 Nú&css*|]"\}}t|ƒdt|ddVqdS)ú=T)Zfor_qsN)r)r ÚkÚvrrrú oszdo_urlencode..)rÚdictrrÚiterÚ TypeErrorrÚjoin)rZitemiterrrrÚdo_urlencode_s r9cCst|dkrd}|js,t|ƒjt|ƒt|ƒ|ƒSt|dƒsLt|dƒrVt|dƒrVt|ƒ}nt|ƒ}|jt|ƒt|ƒ|ƒS)aüReturn a copy of the value with all occurrences of a substring replaced with a new one. The first argument is the substring that should be replaced, the second is the replacement string. If the optional third argument ``count`` is given, only the first ``count`` occurrences are replaced: .. sourcecode:: jinja {{ "Hello World"|replace("Hello", "Goodbye") }} -> Goodbye World {{ "aaaaargh"|replace("a", "d'oh, ", 2) }} -> d'oh, d'oh, aaargh Nér-éÿÿÿÿ)Ú autoescaperÚreplacer.rr )Úeval_ctxÚsÚoldÚnewÚcountrrrÚ do_replacets rCcCst|ƒjƒS)zConvert a value to uppercase.)r Úupper)r?rrrÚdo_uppersrEcCst|ƒjƒS)zConvert a value to lowercase.)r r)r?rrrÚdo_lower•srFz[\s/>=])ÚflagsTcCs”g}xb|jƒD]V\}}|dkst|tƒr*qtj|ƒdk rFtd|›ƒ‚|jt|ƒ›dt|ƒ›dƒqWdj|ƒ}|r‚|r‚d|}|j rt |ƒ}|S)aÍCreate an SGML/XML attribute string based on the items in a dict. **Values** that are neither ``none`` nor ``undefined`` are automatically escaped, safely allowing untrusted user input. User input should not be used as **keys** to this filter. If any key contains a space, ``/`` solidus, ``>`` greater-than sign, or ``=`` equals sign, this fails with a ``ValueError``. Regardless of this, user input should never be used as keys to this filter, or must be separately validated first. .. sourcecode:: html+jinja ... Results in something like this: .. sourcecode:: html

... As you can see it automatically prepends a space in front of the item if the filter returned something unless the second parameter is false. Nz%Invalid character in attribute name: z="ú"ú )Úitemsrr Ú_attr_key_reÚsearchÚ ValueErrorÚappendrr8r<r)Z _eval_ctxÚdZ autospacerJÚkeyrÚrvrrrÚ do_xmlattrŸs" rRcCst|ƒjƒS)zYCapitalize a value. The first character will be uppercase, all others lowercase. )r Ú capitalize)r?rrrÚ do_capitalizeÒsrTcCsdjdd„tjt|ƒƒDƒƒS)zˆReturn a titlecased version of the value. I.e. words will start with uppercase letters, all remaining characters are lowercase. ÚcSs,g|]$}|r|djƒ|dd…jƒ‘qS)rr:N)rDr)r r%rrrr"Þszdo_title..)r8Ú_word_beginning_split_rer+r )r?rrrÚdo_titleÙsrWFrPcsD|dkrd‰n|dkrd‰ntdƒ‚‡‡fdd„}t|jƒ||dS) afSort a dict and yield (key, value) pairs. Because python dicts are unsorted you may want to use this function to order them by either key or value: .. sourcecode:: jinja {% for item in mydict|dictsort %} sort the dict by key, case insensitive {% for item in mydict|dictsort(reverse=true) %} sort the dict by key, case insensitive, reverse order {% for item in mydict|dictsort(true) %} sort the dict by key, case sensitive {% for item in mydict|dictsort(false, 'value') %} sort the dict by value, case insensitive rPrrr:z,You can only sort by either "key" or "value"cs|ˆ}ˆst|ƒ}|S)N)r)r%r)Úcase_sensitiveÚposrrÚ sort_funcÿszdo_dictsort..sort_func)rPÚreverse)rÚsortedrJ)rrXZbyr[rZr)rXrYrÚdo_dictsortãsr]cCs$t|||stndd}t|||dS)aÚSort an iterable. Per default it sorts ascending, if you pass it true as first argument it will reverse the sorting. If the iterable is made of strings the third parameter can be used to control the case sensitiveness of the comparison which is disabled by default. .. sourcecode:: jinja {% for item in iterable|sort %} ... {% endfor %} It is also possible to sort by an attribute (for example to sort by the date of an object) by specifying the `attribute` parameter: .. sourcecode:: jinja {% for item in iterable|sort(attribute='date') %} ... {% endfor %} .. versionchanged:: 2.6 The `attribute` parameter was added. N)r))rPr[)r,rr\)r(rr[rXr'Úkey_funcrrrÚdo_sort sr_ccsNt|||stndd}tƒ}x,|D]$}||ƒ}||kr"|j|ƒ|Vq"WdS)aÌReturns a list of unique items from the the given iterable. .. sourcecode:: jinja {{ ['foo', 'bar', 'foobar', 'FooBar']|unique }} -> ['foo', 'bar', 'foobar'] The unique items are yielded in the same order as their first occurrence in the iterable passed to the filter. :param case_sensitive: Treat upper and lower case strings as distinct. :param attribute: Filter objects with unique values for this attribute. N)r))r,rÚsetÚadd)r(rrXr'ÚgetterÚseenr%rPrrrÚ do_unique.s rdcCsXt|ƒ}yt|ƒ}Wntk r.|jdƒSXt|||s>tndƒ}|t|g|ƒ|dS)Nz'No aggregated item, sequence was empty.)rP)r6ÚnextÚ StopIterationÚ undefinedr,rr)r(rÚfuncrXr'ÚitÚfirstr^rrrÚ_min_or_maxKsrkcCst||t||ƒS)aReturn the smallest item from the sequence. .. sourcecode:: jinja {{ [1, 2, 3]|min }} -> 1 :param case_sensitive: Treat upper and lower case strings as distinct. :param attribute: Get the object with the max value of this attribute. )rkÚmin)r(rrXr'rrrÚdo_minZsrmcCst||t||ƒS)aReturn the largest item from the sequence. .. sourcecode:: jinja {{ [1, 2, 3]|max }} -> 3 :param case_sensitive: Treat upper and lower case strings as distinct. :param attribute: Get the object with the max value of this attribute. )rkÚmax)r(rrXr'rrrÚdo_maxisrorUcCst|tƒs|r|r|S|S)aIf the value is undefined it will return the passed default value, otherwise the value of the variable: .. sourcecode:: jinja {{ my_variable|default('my_variable is not defined') }} This will output the value of ``my_variable`` if the variable was defined, otherwise ``'my_variable is not defined'``. If you want to use default with variables that evaluate to false you have to set the second parameter to `true`: .. sourcecode:: jinja {{ ''|default('the string was empty', true) }} )rr )rZ default_valueZbooleanrrrÚ do_defaultxsrpcCs°|dk rtt|j|ƒ|ƒ}|js4t|ƒjtt|ƒƒSt|dƒsœt|ƒ}d}x0t|ƒD]$\}}t|dƒrld}qTt|ƒ||<qTW|rŠt |ƒ}nt|ƒ}|j|ƒSt |ƒjtt |ƒƒS)a#Return a string which is the concatenation of the strings in the sequence. The separator between elements is an empty string per default, you can define it with the optional parameter: .. sourcecode:: jinja {{ [1, 2, 3]|join('|') }} -> 1|2|3 {{ [1, 2, 3]|join }} -> 123 It is also possible to join certain attributes of an object: .. sourcecode:: jinja {{ users|join(', ', attribute='username') }} .. versionadded:: 2.6 The `attribute` parameter was added. Nr-FT)rr,r(r<rr8r.ÚlistÚ enumeraterr )r>rrOr'Z do_escapeÚidxr%rrrÚdo_joinŽs rtéPcCst|ƒj|ƒS)z.Centers the value in a field of a given width.)rÚcenter)rÚwidthrrrÚ do_centerÀsrxcCs,ytt|ƒƒStk r&|jdƒSXdS)z$Return the first item of a sequence.z"No first item, sequence was empty.N)rer6rfrg)r(ÚseqrrrÚdo_firstÅsrzcCs0yttt|ƒƒƒStk r*|jdƒSXdS)z#Return the last item of a sequence.z!No last item, sequence was empty.N)rer6Úreversedrfrg)r(ryrrrÚdo_lastÎsr|cCs,y tj|ƒStk r&|jjdƒSXdS)z'Return a random item from the sequence.z#No random item, sequence was empty.N)ÚrandomZchoiceÚ IndexErrorr(rg)ÚcontextryrrrÚ do_random×s r€cCsÚt|ƒ}|rdpd}|rdpd|r&dp(d|r0dp2d|r:d p`` tag: .. sourcecode:: jinja {{ mytext|urlize(40, target='_blank') }} .. versionchanged:: 2.8+ The *target* parameter was added. rUÚnofollowz urlize.relNz urlize.targetrI)ÚrelÚtarget)r(Úpoliciesr`r+raÚupdater8r\r r<r)r>rZtrim_url_limitr‹rrŒrŽrQrrrÚ do_urlizes récsŒ|dk rtjtdƒdd|}|d7}d|‰|rFdˆj|jƒƒ}n6|jƒ}|jdƒ}|r||ddj‡fdd „|Dƒƒ7}|rˆˆ|}|S) a¬Return a copy of the string with each line indented by 4 spaces. The first line and blank lines are not indented by default. :param width: Number of spaces to indent by. :param first: Don't skip indenting the first line. :param blank: Don't skip indenting empty lines. .. versionchanged:: 2.10 Blank lines are not indented by default. Rename the ``indentfirst`` argument to ``first``. Nz1The "indentfirst" argument is renamed to "first".r)Ú stacklevelÚ rIrc3s|]}|rˆ|n|VqdS)Nr)r Úline)Ú indentionrrr4Mszdo_indent..)ÚwarningsÚwarnÚDeprecationWarningr8Ú splitlinesÚpop)r?rwrjZblankZindentfirstrQÚlinesr)r•rÚ do_indent-s" rœéÿú...cCsž|dkr|jd}|t|ƒks2tdt|ƒ|fƒ‚|dksFtd|ƒ‚t|ƒ||krZ|S|rv|d|t|ƒ…|S|d|t|ƒ…jddƒd}||S)aíReturn a truncated copy of the string. The length is specified with the first parameter which defaults to ``255``. If the second parameter is ``true`` the filter will cut the text at length. Otherwise it will discard the last word. If the text was in fact truncated it will append an ellipsis sign (``"..."``). If you want a different ellipsis sign than ``"..."`` you can specify it using the third parameter. Strings that only exceed the length by the tolerance margin given in the fourth parameter will not be truncated. .. sourcecode:: jinja {{ "foo bar baz qux"|truncate(9) }} -> "foo..." {{ "foo bar baz qux"|truncate(9, True) }} -> "foo ba..." {{ "foo bar baz qux"|truncate(11) }} -> "foo bar baz qux" {{ "foo bar baz qux"|truncate(11, False, '...', 0) }} -> "foo bar..." The default leeway on newer Jinja2 versions is 5 and was 0 before but can be reconfigured globally. Nztruncate.leewayzexpected length >= %s, got %srzexpected leeway >= 0, got %srIr:)rŽÚlenÚAssertionErrorÚrsplit)Úenvr?ÚlengthZ killwordsÚendZleewayÚresultrrrÚdo_truncateVs r¦éOcCs,|s |j}ddl}|j|j||dd|dƒS)añ Return a copy of the string passed to the filter wrapped after ``79`` characters. You can override this default using the first parameter. If you set the second parameter to `false` Jinja will not split words apart if they are longer than `width`. By default, the newlines will be the default newlines for the environment, but this can be changed using the wrapstring keyword argument. .. versionadded:: 2.7 Added support for the `wrapstring` parameter. rNF)rwZexpand_tabsZreplace_whitespaceÚbreak_long_words)Znewline_sequenceÚtextwrapr8Zwrap)r(r?rwr¨Z wrapstringr©rrrÚdo_wordwrap{srªcCsttj|ƒƒS)zCount the words in that string.)rŸÚ_word_reÚfindall)r?rrrÚdo_wordcount‘sré cCs`yt|tƒrt||ƒSt|ƒSttfk rZytt|ƒƒSttfk rT|SXYnXdS)aConvert the value into an integer. If the conversion doesn't work it will return ``0``. You can override this default using the first parameter. You can also override the default base (10) in the second parameter, which handles input with prefixes such as 0b, 0o and 0x for bases 2, 8 and 16 respectively. The base is ignored for decimal numbers and non-string values. N)rrrr7rMr‚)rÚdefaultr„rrrÚdo_int–s r°çcCs&yt|ƒSttfk r |SXdS)z¬Convert the value into a floating point number. If the conversion doesn't work it will return ``0.0``. You can override this default using the first parameter. N)r‚r7rM)rr¯rrrÚdo_float«sr²cOs |r|rtdƒ‚t|ƒ|p|S)z Apply python string formatting on an object: .. sourcecode:: jinja {{ "%s - %s"|format("Hello?", "Foo!") }} -> Hello? - Foo! z>can't handle positional and keyword arguments at the same time)rr )rÚargsÚkwargsrrrÚ do_format¶s rµcCst|ƒjƒS)z&Strip leading and trailing whitespace.)r Ústrip)rrrrÚdo_trimÅsr·cCs"t|dƒr|jƒ}tt|ƒƒjƒS)zFStrip SGML/XML tags and replace adjacent whitespace by one space. r-)r.r-rrÚ striptags)rrrrÚdo_striptagsÊs r¹ccs’t|ƒ}t|ƒ}||}||}d}xht|ƒD]\}|||} ||krN|d7}||d|} || | …}|dk r„||kr„|j|ƒ|Vq.WdS)aESlice an iterator and return a list of lists containing those items. Useful if you want to create a div containing three ul tags that represent columns: .. sourcecode:: html+jinja

{%- for column in items|slice(3) %}

{{ item }}

{%- endfor %}

If you pass it a second argument it's used to fill missing values on the last iteration. rr:N)rqrŸÚrangerN)rZslicesÚ fill_withryr£Zitems_per_sliceZslices_with_extraÚoffsetZslice_numberÚstartr¤ÚtmprrrÚdo_sliceÒs r¿ccsjg}x,|D]$}t|ƒ|kr$|Vg}|j|ƒq W|rf|dk r`t|ƒ|kr`||g|t|ƒ7}|VdS)a A filter that batches items. It works pretty much like `slice` just the other way round. It returns a list of lists with the given number of items. If you provide a second parameter this is used to fill up missing items. See this example: .. sourcecode:: html+jinja {%- for row in items|batch(3, ' ') %} {%- for column in row %} {%- endfor %} {%- endfor %}

N)rŸrN)rZ linecountr»r¾r%rrrÚdo_batchös rÀÚcommoncCsD|dkrtdƒ‚|dkr"t||ƒStt|ƒ}||d|ƒd|S)aŒRound the number to a given precision. The first parameter specifies the precision (default is ``0``), the second the rounding method: - ``'common'`` rounds either up or down - ``'ceil'`` always rounds up - ``'floor'`` always rounds down If you don't specify a method ``'common'`` is used. .. sourcecode:: jinja {{ 42.55|round }} -> 43.0 {{ 42.55|round(1, 'floor') }} -> 42.5 Note that even if rounded to 0 precision, a float is returned. If you need a real integer, pipe it through `int`: .. sourcecode:: jinja {{ 42.55|round|int }} -> 43 rÁÚceilÚfloorz$method must be common, ceil or floorr®)rÁrÂrÃ)rÚroundÚgetattrÚmath)rZ precisionÚmethodrhrrrÚdo_rounds rÈÚ_GroupTupleZgrouperrqcCs&t||ƒ}dd„tt||d|ƒDƒS)aŒGroup a sequence of objects by a common attribute. If you for example have a list of dicts or objects that represent persons with `gender`, `first_name` and `last_name` attributes and you want to group all users by genders you can do something like the following snippet: .. sourcecode:: html+jinja

{{ group.grouper }}
- {{ person.first_name }} {{ person.last_name }}

Additionally it's possible to use tuple unpacking for the grouper and list: .. sourcecode:: html+jinja

{% for grouper, list in persons|groupby('gender') %} ... {% endfor %} As you can see the item we're grouping by is stored in the `grouper` attribute and the `list` contains all the objects that have this grouper in common. .. versionchanged:: 2.6 It's now possible to use dotted notation to group by the child attribute of another attribute. cSsg|]\}}t|t|ƒƒ‘qSr)rÉrq)r rPÚvaluesrrrr"hszdo_groupby..)rP)r,rr\)r(rr'ÚexprrrrÚ do_groupby@s' rÌcCs"|dk rtt||ƒ|ƒ}t||ƒS)aÒReturns the sum of a sequence of numbers plus the value of parameter 'start' (which defaults to 0). When the sequence is empty it returns start. It is also possible to sum up only certain attributes: .. sourcecode:: jinja Total: {{ items|sum(attribute='price') }} .. versionchanged:: 2.6 The `attribute` parameter was added to allow suming up over attributes. Also the `start` parameter was moved on to the right. N)rr,Úsum)r(Úiterabler'r½rrrÚdo_sumlsrÏcCst|ƒS)zkConvert the value into a list. If it was a string the returned list will be a list of characters. )rq)rrrrÚdo_listsrÐcCst|ƒS)z…Mark the value as safe which means that in an environment with automatic escaping enabled this variable will not be escaped. )r)rrrrÚdo_mark_safeˆsrÑcCst|ƒS)zHMark a value as unsafe. This is the reverse operation for :func:`safe`.)r)rrrrÚdo_mark_unsafesrÒcCslt|tƒr|ddd…Syt|ƒStk rfyt|ƒ}|jƒ|Stk r`tdƒ‚YnXYnXdS)z\Reverse the object or return an iterator that iterates over it the other way round. Nr:zargument must be iterabler;)rrr{r7rqr[r)rrQrrrÚ do_reverse”s rÓcCsHyt||ƒWn,tk r:t||ƒs6|j||dSYnX|j||ƒS)a Get an attribute of an object. ``foo|attr("bar")`` works like ``foo.bar``, but returns undefined instead of falling back to ``foo["bar"]`` if the attribute doesn't exist. See :ref:`Notes on subscriptions ` for more details. )ÚobjÚname)rÚAttributeErrorr.rgrÅ)r(rÔrÕrrrÚdo_attr¥s r×cos.t||ƒ\}}|r*x|D]}||ƒVqWdS)aïApplies a filter on a sequence of objects or looks up an attribute. This is useful when dealing with lists of objects but you are really only interested in a certain value of it. The basic usage is mapping on an attribute. Imagine you have a list of users but you are only interested in a list of usernames: .. sourcecode:: jinja Users on this page: {{ users|map(attribute='username')|join(', ') }} Alternatively you can let it invoke a filter by passing the name of the filter and the arguments afterwards. A good example would be applying a text conversion filter on a sequence: .. sourcecode:: jinja Users on this page: {{ titles|map('lower')|join(', ') }} .. versionadded:: 2.7 N)Úprepare_map)r³r´ryrhr%rrrÚdo_map·s rÙcOst||dd„dƒS)aïFilters a sequence of objects by applying a test to each object, and only selecting the objects with the test succeeding. If no test is specified, each object will be evaluated as a boolean. Example usage: .. sourcecode:: jinja {{ numbers|select("odd") }} {{ numbers|select("odd") }} {{ numbers|select("divisibleby", 3) }} {{ numbers|select("lessthan", 42) }} {{ strings|select("equalto", "mystring") }} .. versionadded:: 2.7 cSs|S)Nr)r!rrrÚçszdo_select..F)Úselect_or_reject)r³r´rrrÚ do_selectÔsrÜcOst||dd„dƒS)a6Filters a sequence of objects by applying a test to each object, and rejecting the objects with the test succeeding. If no test is specified, each object will be evaluated as a boolean. Example usage: .. sourcecode:: jinja {{ numbers|reject("odd") }} .. versionadded:: 2.7 cSs|S)Nr)r!rrrrÚùszdo_reject..F)rÛ)r³r´rrrÚ do_rejectêsrÝcOst||dd„dƒS)a Filters a sequence of objects by applying a test to the specified attribute of each object, and only selecting the objects with the test succeeding. If no test is specified, the attribute's value will be evaluated as a boolean. Example usage: .. sourcecode:: jinja {{ users|selectattr("is_active") }} {{ users|selectattr("email", "none") }} .. versionadded:: 2.7 cSs|S)Nr)r!rrrrÚszdo_selectattr..T)rÛ)r³r´rrrÚ do_selectattrüsrÞcOst||dd„dƒS)a‡Filters a sequence of objects by applying a test to the specified attribute of each object, and rejecting the objects with the test succeeding. If no test is specified, the attribute's value will be evaluated as a boolean. .. sourcecode:: jinja {{ users|rejectattr("is_active") }} {{ users|rejectattr("email", "none") }} .. versionadded:: 2.7 cSs|S)Nr)r!rrrrÚ!szdo_rejectattr..T)rÛ)r³r´rrrÚ do_rejectattrsrßcCsD|jj}|d}|d}|dk r0t|ƒ}||d<t|fd|i|—ŽS)aœDumps a structure to JSON so that it's safe to use in ``