jinja2.runtime.Context

class documentation

class Context:

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 parent must not happen and modifications on vars are allowed from generated template code only. Template filters and global functions marked as pass_context 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 resolve method that doesn't fail with a KeyError but returns an Undefined object for missing variables.

Method	`call`	No summary
Method	`get`	Look up a variable by name, or return a default if the key is not found.
Method	`get_all`	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.
Method	`get_exported`	Get a new dict with the exported variables.
Method	`resolve`	Look up a variable by name, or return an `Undefined` object if the key is not found.
Method	`resolve_or_missing`	Look up a variable by name, or return a `missing` sentinel if the key is not found.
Instance Variable	`blocks`	Undocumented
Instance Variable	`environment`	Undocumented
Instance Variable	`eval_ctx`	Undocumented
Instance Variable	`exported_vars`	Undocumented
Instance Variable	`name`	Undocumented
Instance Variable	`parent`	Undocumented
Instance Variable	`vars`	Undocumented
Method	`__contains__`	Undocumented
Method	`__getitem__`	Look up a variable by name with `[]` syntax, or raise a `KeyError` if the key is not found.
Method	`__init__`	Undocumented
Method	`__init_subclass__`	Undocumented
Method	`__repr__`	Undocumented
Method	`derived`	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.
Method	`super`	Render a parent block.
Class Variable	`_legacy_resolve_mode`	Undocumented
Class Variable	`items`	Undocumented
Class Variable	`keys`	Undocumented
Class Variable	`values`	Undocumented
Instance Variable	`globals_keys`	Undocumented

@internalcode
def call(__self, __obj, *args, **kwargs):

Call the callable with the arguments and keyword arguments provided but inject the active context or environment as first argument if the callable has pass_context or pass_environment.

Parameters
__self	Undocumented
__obj:`t.Callable`	Undocumented
*args:`t.Any`	Undocumented
**kwargs:`t.Any`	Undocumented
Returns
`t.Union[t.Any, Undefined]`	Undocumented

def get(self, key, default=None):

Look up a variable by name, or return a default if the key is not found.

Parameters
key:`str`	The variable name to look up.
default:`t.Any`	The value to return if the key is not found.
Returns
`t.Any`	Undocumented

def get_all(self):

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.

Returns
`t.Dict[str, t.Any]`	Undocumented

def get_exported(self):

Get a new dict with the exported variables.

Returns
`t.Dict[str, t.Any]`	Undocumented

def resolve(self, key):

Look up a variable by name, or return an Undefined object if the key is not found.

If you need to add custom behavior, override resolve_or_missing, not this method. The various lookup functions use that method, not this one.

Parameters
key:`str`	The variable name to look up.
Returns
`t.Union[t.Any, Undefined]`	Undocumented

def resolve_or_missing(self, key):

Look up a variable by name, or return a missing sentinel if the key is not found.

Override this method to add custom lookup behavior. resolve, get, and __getitem__ use this method. Don't call this method directly.

Parameters
key:`str`	The variable name to look up.
Returns
`t.Any`	Undocumented

blocks =

Undocumented

environment: Environment =

Undocumented

eval_ctx =

Undocumented

exported_vars: t.Set[str] =

Undocumented

name =

Undocumented

parent =

Undocumented

vars: t.Dict[str, t.Any] =

Undocumented

def __contains__(self, name):

Undocumented

Parameters
name:`str`	Undocumented
Returns
`bool`	Undocumented

def __getitem__(self, key):

Look up a variable by name with [] syntax, or raise a KeyError if the key is not found.

Parameters
key:`str`	Undocumented
Returns
`t.Any`	Undocumented

def __init__(self, environment, parent, name, blocks, globals=None):

Undocumented

Parameters
environment:`Environment`	Undocumented
parent:`t.Dict[str, t.Any]`	Undocumented
name:`t.Optional[str]`	Undocumented
blocks:`t.Dict[str, t.Callable[[Context], t.Iterator[str]]]`	Undocumented
globals:`t.Optional[t.MutableMapping[str, t.Any]]`	Undocumented

def __init_subclass__(cls):

Undocumented

def __repr__(self):

Undocumented

Returns
`str`	Undocumented

def derived(self, locals=None):

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.

Parameters
locals:`t.Optional[t.Dict[str, t.Any]]`	Undocumented
Returns
`Context`	Undocumented

def super(self, name, current):

Render a parent block.

Parameters
name:`str`	Undocumented
current:`t.Callable[[Context], t.Iterator[str]]`	Undocumented
Returns
`t.Union[BlockReference, Undefined]`	Undocumented

_legacy_resolve_mode: t.ClassVar[bool] =

Undocumented

items =

Undocumented

keys =

Undocumented

values =

Undocumented

globals_keys =

Undocumented