# Tests Reference

URL: /docs/reference/tests/
Section: reference
Tags: reference, tests

--------------------------------------------------------------------------------

Tests Reference Tests are boolean predicates used with is in conditionals. Usage &#123;% if value is test %&#125; &#123;% if value is test(arg) %&#125; &#123;% if value is not test %&#125; Type Tests defined Value is not None. &#123;% if user is defined %&#125; {{ user.name }} &#123;% end %&#125; undefined Value is None. &#123;% if user is undefined %&#125; &lt;p&gt;Not logged in&lt;/p&gt; &#123;% end %&#125; none Value is None (alias for undefined). &#123;% if value is none %&#125; string Value is a string. &#123;% if value is string %&#125; {{ value | upper }} &#123;% end %&#125; number Value is int or float (not bool). &#123;% if value is number %&#125; {{ value * 2 }} &#123;% end %&#125; sequence Value is list, tuple, or string. &#123;% if items is sequence %&#125; {{ items | length }} items &#123;% end %&#125; mapping Value is a dict. &#123;% if data is mapping %&#125; {{ data.keys() | list }} &#123;% end %&#125; iterable Value supports iteration. &#123;% if items is iterable %&#125; &#123;% for item in items %&#125;...&#123;% end %&#125; &#123;% end %&#125; callable Value is callable. &#123;% if func is callable %&#125; {{ func() }} &#123;% end %&#125; Boolean Tests true Value is exactly True. &#123;% if flag is true %&#125; Enabled &#123;% end %&#125; false Value is exactly False. &#123;% if flag is false %&#125; Disabled &#123;% end %&#125; Number Tests odd Integer is odd. &#123;% if loop.index is odd %&#125; &lt;tr class=&quot;odd&quot;&gt; &#123;% end %&#125; even Integer is even. &#123;% if loop.index is even %&#125; &lt;tr class=&quot;even&quot;&gt; &#123;% end %&#125; divisibleby Integer is divisible by N. &#123;% if count is divisibleby(3) %&#125; Multiple of 3 &#123;% end %&#125; Comparison Tests eq / equalto Equal to value. &#123;% if status is eq(&quot;active&quot;) %&#125; &#123;% if count is equalto(0) %&#125; ne Not equal to value. &#123;% if status is ne(&quot;deleted&quot;) %&#125; lt / lessthan Less than value. &#123;% if count is lt(10) %&#125; &#123;% if age is lessthan(18) %&#125; le Less than or equal. &#123;% if score is le(100) %&#125; gt / greaterthan Greater than value. &#123;% if count is gt(0) %&#125; &#123;% if age is greaterthan(21) %&#125; ge Greater than or equal. &#123;% if level is ge(5) %&#125; sameas Identity comparison (is). &#123;% if a is sameas(b) %&#125; Same object &#123;% end %&#125; in Value is in sequence. &#123;% if role is in([&quot;admin&quot;, &quot;moderator&quot;]) %&#125; Has permissions &#123;% end %&#125; String Tests lower String is all lowercase. &#123;% if text is lower %&#125; Already lowercase &#123;% end %&#125; upper String is all uppercase. &#123;% if text is upper %&#125; Already uppercase &#123;% end %&#125; match String matches regex pattern. &#123;% if email is match(&quot;.*@.*\\..*&quot;) %&#125; Valid email format &#123;% end %&#125; Negation Use is not to negate any test: &#123;% if value is not defined %&#125; &#123;% if count is not even %&#125; &#123;% if user is not none %&#125; &#123;% if status is not eq(&quot;active&quot;) %&#125; Examples Type Checking &#123;% if data is mapping %&#125; &#123;% for key, value in data.items() %&#125; {{ key }}: {{ value }} &#123;% end %&#125; &#123;% elif data is sequence %&#125; &#123;% for item in data %&#125; {{ item }} &#123;% end %&#125; &#123;% elif data is string %&#125; {{ data }} &#123;% end %&#125; Loop Styling &lt;table&gt; &#123;% for row in data %&#125; &lt;tr class=&quot;&#123;% if loop.index is odd %&#125;odd&#123;% else %&#125;even&#123;% end %&#125;&quot;&gt; &lt;td&gt;{{ row.name }}&lt;/td&gt; &lt;/tr&gt; &#123;% end %&#125; &lt;/table&gt; Permission Checks &#123;% if user is defined %&#125; &#123;% if user.role is in([&quot;admin&quot;, &quot;moderator&quot;]) %&#125; &#123;% include &quot;admin-toolbar.html&quot; %&#125; &#123;% end %&#125; &#123;% end %&#125; Pagination &#123;% if page is gt(1) %&#125; &lt;a href=&quot;?page={{ page - 1 }}&quot;&gt;Previous&lt;/a&gt; &#123;% end %&#125; &#123;% if page is lt(total_pages) %&#125; &lt;a href=&quot;?page={{ page + 1 }}&quot;&gt;Next&lt;/a&gt; &#123;% end %&#125; See Also Control Flow — Conditionals and loops Custom Tests — Create tests

--------------------------------------------------------------------------------

Metadata:
- Word Count: 640
- Reading Time: 3 minutes