Gecko [ theprintave.ca ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-03-13 06:20
__init__.py	2.15 KB	-rw-r--r--	2021-11-09 20:25
_identifier.py	1.73 KB	-rw-r--r--	2020-02-17 17:14
async_utils.py	1.9 KB	-rw-r--r--	2021-11-09 17:17
bccache.py	12.37 KB	-rw-r--r--	2021-10-04 20:41
compiler.py	70.87 KB	-rw-r--r--	2025-03-10 16:56
constants.py	1.4 KB	-rw-r--r--	2021-04-05 17:47
debug.py	8.29 KB	-rw-r--r--	2021-11-09 17:17
defaults.py	1.24 KB	-rw-r--r--	2021-05-10 13:52
environment.py	59.55 KB	-rw-r--r--	2021-11-09 18:10
exceptions.py	4.95 KB	-rw-r--r--	2021-05-10 13:52
ext.py	31.37 KB	-rw-r--r--	2021-05-14 01:01
filters.py	52.46 KB	-rw-r--r--	2025-03-10 16:56
idtracking.py	10.47 KB	-rw-r--r--	2021-08-10 13:34
lexer.py	29.29 KB	-rw-r--r--	2025-03-10 16:56
loaders.py	22.22 KB	-rw-r--r--	2021-11-09 20:21
meta.py	4.29 KB	-rw-r--r--	2021-05-10 13:52
nativetypes.py	3.88 KB	-rw-r--r--	2021-11-09 17:17
nodes.py	33.81 KB	-rw-r--r--	2025-03-10 16:56
optimizer.py	1.61 KB	-rw-r--r--	2021-05-10 13:52
parser.py	38.83 KB	-rw-r--r--	2021-05-14 01:01
py.typed	0 B	-rw-r--r--	2021-05-10 13:52
runtime.py	34.23 KB	-rw-r--r--	2021-08-10 13:34
sandbox.py	14.69 KB	-rw-r--r--	2025-03-10 16:56
tests.py	5.77 KB	-rw-r--r--	2021-04-10 17:20
utils.py	26.4 KB	-rw-r--r--	2025-03-10 16:56
visitor.py	3.49 KB	-rw-r--r--	2021-05-10 13:52

Rename

"""Built-in template tests used with the ``is`` operator."""
import operator
import typing as t
from collections import abc
from numbers import Number

from .runtime import Undefined
from .utils import pass_environment

if t.TYPE_CHECKING:
    from .environment import Environment

def test_odd(value: int) -> bool:
    """Return true if the variable is odd."""
    return value % 2 == 1

def test_even(value: int) -> bool:
    """Return true if the variable is even."""
    return value % 2 == 0

def test_divisibleby(value: int, num: int) -> bool:
    """Check if a variable is divisible by a number."""
    return value % num == 0

def test_defined(value: t.Any) -> bool:
    """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: t.Any) -> bool:
    """Like :func:`defined` but the other way round."""
    return isinstance(value, Undefined)

@pass_environment
def test_filter(env: "Environment", value: str) -> bool:
    """Check if a filter exists by name. Useful if a filter may be
    optionally available.

.. code-block:: jinja

{% if 'markdown' is filter %}
            {{ value | markdown }}
        {% else %}
            {{ value }}
        {% endif %}

.. versionadded:: 3.0
    """
    return value in env.filters

@pass_environment
def test_test(env: "Environment", value: str) -> bool:
    """Check if a test exists by name. Useful if a test may be
    optionally available.

.. code-block:: jinja

{% if 'loud' is test %}
            {% if value is loud %}
                {{ value|upper }}
            {% else %}
                {{ value|lower }}
            {% endif %}
        {% else %}
            {{ value }}
        {% endif %}

.. versionadded:: 3.0
    """
    return value in env.tests

def test_none(value: t.Any) -> bool:
    """Return true if the variable is none."""
    return value is None

def test_boolean(value: t.Any) -> bool:
    """Return true if the object is a boolean value.

.. versionadded:: 2.11
    """
    return value is True or value is False

def test_false(value: t.Any) -> bool:
    """Return true if the object is False.

.. versionadded:: 2.11
    """
    return value is False

def test_true(value: t.Any) -> bool:
    """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: t.Any) -> bool:
    """Return true if the object is an integer.

.. versionadded:: 2.11
    """
    return isinstance(value, int) and value is not True and value is not False

# NOTE: The existing 'number' test matches booleans and integers
def test_float(value: t.Any) -> bool:
    """Return true if the object is a float.

.. versionadded:: 2.11
    """
    return isinstance(value, float)

def test_lower(value: str) -> bool:
    """Return true if the variable is lowercased."""
    return str(value).islower()

def test_upper(value: str) -> bool:
    """Return true if the variable is uppercased."""
    return str(value).isupper()

def test_string(value: t.Any) -> bool:
    """Return true if the object is a string."""
    return isinstance(value, str)

def test_mapping(value: t.Any) -> bool:
    """Return true if the object is a mapping (dict etc.).

.. versionadded:: 2.6
    """
    return isinstance(value, abc.Mapping)

def test_number(value: t.Any) -> bool:
    """Return true if the variable is a number."""
    return isinstance(value, Number)

def test_sequence(value: t.Any) -> bool:
    """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: t.Any, other: t.Any) -> bool:
    """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: t.Any) -> bool:
    """Check if it's possible to iterate over an object."""
    try:
        iter(value)
    except TypeError:
        return False

return True

def test_escaped(value: t.Any) -> bool:
    """Check if the value is escaped."""
    return hasattr(value, "__html__")

def test_in(value: t.Any, seq: t.Container) -> bool:
    """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,
    "filter": test_filter,
    "test": test_test,
    "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": 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,
}