123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215 |
- # -*- coding: utf-8 -*-
- """Built-in template tests used with the ``is`` operator."""
- import decimal
- import operator
- import re
- from ._compat import abc
- from ._compat import integer_types
- from ._compat import string_types
- from ._compat import text_type
- from .runtime import Undefined
- number_re = re.compile(r"^-?\d+(\.\d+)?$")
- regex_type = type(number_re)
- test_callable = callable
- def test_odd(value):
- """Return true if the variable is odd."""
- return value % 2 == 1
- def test_even(value):
- """Return true if the variable is even."""
- return value % 2 == 0
- def test_divisibleby(value, num):
- """Check if a variable is divisible by a number."""
- return value % num == 0
- def test_defined(value):
- """Return true if the variable is defined:
- .. sourcecode:: jinja
- {% if variable is defined %}
- value of variable: {{ variable }}
- {% else %}
- variable is not defined
- {% endif %}
- See the :func:`default` filter for a simple way to set undefined
- variables.
- """
- return not isinstance(value, Undefined)
- def test_undefined(value):
- """Like :func:`defined` but the other way round."""
- return isinstance(value, Undefined)
- def test_none(value):
- """Return true if the variable is none."""
- return value is None
- def test_boolean(value):
- """Return true if the object is a boolean value.
- .. versionadded:: 2.11
- """
- return value is True or value is False
- def test_false(value):
- """Return true if the object is False.
- .. versionadded:: 2.11
- """
- return value is False
- def test_true(value):
- """Return true if the object is True.
- .. versionadded:: 2.11
- """
- return value is True
- # NOTE: The existing 'number' test matches booleans and floats
- def test_integer(value):
- """Return true if the object is an integer.
- .. versionadded:: 2.11
- """
- return isinstance(value, integer_types) and value is not True and value is not False
- # NOTE: The existing 'number' test matches booleans and integers
- def test_float(value):
- """Return true if the object is a float.
- .. versionadded:: 2.11
- """
- return isinstance(value, float)
- def test_lower(value):
- """Return true if the variable is lowercased."""
- return text_type(value).islower()
- def test_upper(value):
- """Return true if the variable is uppercased."""
- return text_type(value).isupper()
- def test_string(value):
- """Return true if the object is a string."""
- return isinstance(value, string_types)
- def test_mapping(value):
- """Return true if the object is a mapping (dict etc.).
- .. versionadded:: 2.6
- """
- return isinstance(value, abc.Mapping)
- def test_number(value):
- """Return true if the variable is a number."""
- return isinstance(value, integer_types + (float, complex, decimal.Decimal))
- def test_sequence(value):
- """Return true if the variable is a sequence. Sequences are variables
- that are iterable.
- """
- try:
- len(value)
- value.__getitem__
- except Exception:
- return False
- return True
- def test_sameas(value, other):
- """Check if an object points to the same memory address than another
- object:
- .. sourcecode:: jinja
- {% if foo.attribute is sameas false %}
- the foo attribute really is the `False` singleton
- {% endif %}
- """
- return value is other
- def test_iterable(value):
- """Check if it's possible to iterate over an object."""
- try:
- iter(value)
- except TypeError:
- return False
- return True
- def test_escaped(value):
- """Check if the value is escaped."""
- return hasattr(value, "__html__")
- def test_in(value, seq):
- """Check if value is in seq.
- .. versionadded:: 2.10
- """
- return value in seq
- TESTS = {
- "odd": test_odd,
- "even": test_even,
- "divisibleby": test_divisibleby,
- "defined": test_defined,
- "undefined": test_undefined,
- "none": test_none,
- "boolean": test_boolean,
- "false": test_false,
- "true": test_true,
- "integer": test_integer,
- "float": test_float,
- "lower": test_lower,
- "upper": test_upper,
- "string": test_string,
- "mapping": test_mapping,
- "number": test_number,
- "sequence": test_sequence,
- "iterable": test_iterable,
- "callable": test_callable,
- "sameas": test_sameas,
- "escaped": test_escaped,
- "in": test_in,
- "==": operator.eq,
- "eq": operator.eq,
- "equalto": operator.eq,
- "!=": operator.ne,
- "ne": operator.ne,
- ">": operator.gt,
- "gt": operator.gt,
- "greaterthan": operator.gt,
- "ge": operator.ge,
- ">=": operator.ge,
- "<": operator.lt,
- "lt": operator.lt,
- "lessthan": operator.lt,
- "<=": operator.le,
- "le": operator.le,
- }
|