A compiled template that can be rendered. Use the methods on :class:`Environment` to create or load templates. The environment is used to configure how templates are compiled and behave. It is also possible to create a template object directly. This is not usually recommended. The constructor takes most of the same arguments as :class:`Environment`. All templates created with the same environment arguments share the same ephemeral ``Environment`` instance behind the scenes. A template object should be considered immutable. Modifications on the object are not supported.
Class Method | from |
Creates a template object from compiled code and the globals. This is used by the loaders and environment to create a template object. |
Class Method | from |
Creates a template object from a module. This is used by the module loader to create a template object. |
Method | __new__ |
Undocumented |
Method | __repr__ |
Undocumented |
Method | generate |
For very large templates it can be useful to not render the whole template at once but evaluate each statement after another and yield piece for piece. This method basically does exactly that and returns a generator that yields one item after another as strings. |
Async Method | generate |
An async version of :meth:`generate`. Works very similarly but returns an async iterator instead. |
Method | get |
Return the source line number of a line number in the generated bytecode as they are not in sync. |
Method | make |
This method works like the :attr:`module` attribute when called without arguments but it will evaluate the template on every call rather than caching it. It's also possible to provide a dict which is then used as context... |
Async Method | make |
As template module creation can invoke template code for asynchronous executions this method must be used instead of the normal :meth:`make_module` one. Likewise the module attribute becomes unavailable in async mode. |
Method | new |
Create a new :class:`Context` for this template. The vars provided will be passed to the template. Per default the globals are added to the context. If shared is set to `True` the data is passed as is to the context without adding the globals. |
Method | render |
This method accepts the same arguments as the `dict` constructor: A dict, a dict subclass or some keyword arguments. If no arguments are given the context will be empty. These two calls do the same::... |
Async Method | render |
This works similar to :meth:`render` but returns a coroutine that when awaited returns the entire rendered template string. This requires the async feature to be enabled. |
Method | stream |
Works exactly like :meth:`generate` but returns a :class:`TemplateStream`. |
Class Variable | blocks |
Undocumented |
Class Variable | environment |
Undocumented |
Class Variable | filename |
Undocumented |
Class Variable | globals |
Undocumented |
Class Variable | name |
Undocumented |
Class Variable | root |
Undocumented |
Property | debug |
The debug info mapping. |
Property | is |
If this variable is `False` there is a newer version available. |
Property | module |
The template as module. This is used for imports in the template runtime but is also useful if one wants to access exported template variables from the Python layer: |
Class Method | _from |
Undocumented |
Method | _get |
If a context is passed in, this means that the template was imported. Imported templates have access to the current template's globals by default, but they can only be accessed via the context during runtime. |
Async Method | _get |
Undocumented |
Class Variable | _debug |
Undocumented |
Class Variable | _uptodate |
Undocumented |
Instance Variable | _module |
Undocumented |
Creates a template object from compiled code and the globals. This is used by the loaders and environment to create a template object.
Parameters | |
environment:Environment | Undocumented |
code:CodeType | Undocumented |
globals:t.MutableMapping[ | Undocumented |
uptodate:t.Optional[ | Undocumented |
Returns | |
Template | Undocumented |
Creates a template object from a module. This is used by the module loader to create a template object. .. versionadded:: 2.4
Parameters | |
environment:Environment | Undocumented |
modulet.MutableMapping[ | Undocumented |
globals:t.MutableMapping[ | Undocumented |
Returns | |
Template | Undocumented |
Undocumented
Parameters | |
source:t.Union[ | Undocumented |
blockstr | Undocumented |
blockstr | Undocumented |
variablestr | Undocumented |
variablestr | Undocumented |
commentstr | Undocumented |
commentstr | Undocumented |
linet.Optional[ | Undocumented |
linet.Optional[ | Undocumented |
trimbool | Undocumented |
lstripbool | Undocumented |
newlinete.Literal[ | Undocumented |
keepbool | Undocumented |
extensions:t.Sequence[ | Undocumented |
optimized:bool | Undocumented |
undefined:t.Type[ | Undocumented |
finalize:t.Optional[ | Undocumented |
autoescape:t.Union[ | Undocumented |
enablebool | Undocumented |
Returns | |
t.Any | Undocumented |
For very large templates it can be useful to not render the whole template at once but evaluate each statement after another and yield piece for piece. This method basically does exactly that and returns a generator that yields one item after another as strings. It accepts the same arguments as :meth:`render`.
Parameters | |
*args:t.Any | Undocumented |
**kwargs:t.Any | Undocumented |
Returns | |
t.Iterator[ | Undocumented |
An async version of :meth:`generate`. Works very similarly but returns an async iterator instead.
Parameters | |
*args:t.Any | Undocumented |
**kwargs:t.Any | Undocumented |
Returns | |
t.AsyncIterator[ | Undocumented |
This method works like the :attr:`module` attribute when called without arguments but it will evaluate the template on every call rather than caching it. It's also possible to provide a dict which is then used as context. The arguments are the same as for the :meth:`new_context` method.
Parameters | |
vars:t.Optional[ | Undocumented |
shared:bool | Undocumented |
locals:t.Optional[ | Undocumented |
Returns | |
TemplateModule | Undocumented |
As template module creation can invoke template code for asynchronous executions this method must be used instead of the normal :meth:`make_module` one. Likewise the module attribute becomes unavailable in async mode.
Parameters | |
vars:t.Optional[ | Undocumented |
shared:bool | Undocumented |
locals:t.Optional[ | Undocumented |
Returns | |
TemplateModule | Undocumented |
Create a new :class:`Context` for this template. The vars provided will be passed to the template. Per default the globals are added to the context. If shared is set to `True` the data is passed as is to the context without adding the globals. `locals` can be a dict of local variables for internal usage.
Parameters | |
vars:t.Optional[ | Undocumented |
shared:bool | Undocumented |
locals:t.Optional[ | Undocumented |
Returns | |
Context | Undocumented |
jinja2.nativetypes.NativeTemplate
This method accepts the same arguments as the `dict` constructor: A dict, a dict subclass or some keyword arguments. If no arguments are given the context will be empty. These two calls do the same:: template.render(knights='that say nih') template.render({'knights': 'that say nih'}) This will return the rendered template as a string.
Parameters | |
*args:t.Any | Undocumented |
**kwargs:t.Any | Undocumented |
Returns | |
str | Undocumented |
jinja2.nativetypes.NativeTemplate
This works similar to :meth:`render` but returns a coroutine that when awaited returns the entire rendered template string. This requires the async feature to be enabled. Example usage:: await template.render_async(knights='that say nih; asynchronously')
Parameters | |
*args:t.Any | Undocumented |
**kwargs:t.Any | Undocumented |
Returns | |
str | Undocumented |
Works exactly like :meth:`generate` but returns a :class:`TemplateStream`.
Parameters | |
*args:t.Any | Undocumented |
**kwargs:t.Any | Undocumented |
Returns | |
TemplateStream | Undocumented |
The template as module. This is used for imports in the template runtime but is also useful if one wants to access exported template variables from the Python layer: >>> t = Template('{% macro foo() %}42{% endmacro %}23') >>> str(t.module) '23' >>> t.module.foo() == u'42' True This attribute is not available if async mode is enabled.
Undocumented
Parameters | |
environment:Environment | Undocumented |
namespace:t.MutableMapping[ | Undocumented |
globals:t.MutableMapping[ | Undocumented |
Returns | |
Template | Undocumented |
If a context is passed in, this means that the template was imported. Imported templates have access to the current template's globals by default, but they can only be accessed via the context during runtime. If there are new globals, we need to create a new module because the cached module is already rendered and will not have access to globals from the current context. This new module is not cached because the template can be imported elsewhere, and it should have access to only the current template's globals.
Parameters | |
ctx:t.Optional[ | Undocumented |
Returns | |
TemplateModule | Undocumented |