genshi/mirror: genshi/template/base.py annotate

annotate genshi/template/base.py @ 1033:348ba73df25c stable-0.6.x

Merge r1257 from trunk (fix for infinite template inlining).

author	hodgestar
date	Wed, 19 Mar 2014 13:56:46 +0000
parents	cccbcbd33e90
children

rev	line source
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	1 # -- coding: utf-8 --
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	2 #
897 64f04a2c5e66 Update changelog and copyright years. cmlenz parents: 876 diff changeset	3 # Copyright (C) 2006-2010 Edgewall Software
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	4 # All rights reserved.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	5 #
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	6 # This software is licensed as described in the file COPYING, which
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	7 # you should have received as part of this distribution. The terms
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	8 # are also available at http://genshi.edgewall.org/wiki/License.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	9 #
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	10 # This software consists of voluntary contributions made by many
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	11 # individuals. For the exact contribution history, see the revision
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	12 # history and logs, available at http://genshi.edgewall.org/log/.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	13
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	14 """Basic templating functionality."""
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	15
822 70fddd2262f5 Get rid of some Python 2.3 legacy that's no longer needed now that 2.4 is the baseline. cmlenz parents: 817 diff changeset	16 from collections import deque
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	17 import os
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	18 from StringIO import StringIO
609 6d4877844e28 Add support for Python code blocks in text templates using the new syntax. cmlenz parents: 606 diff changeset	19 import sys
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	20
636 699601cce3cc Follow-up to [751]: applying the optimization to text templates was actually slowing them down, so only do it for markup templates. cmlenz parents: 635 diff changeset	21 from genshi.core import Attrs, Stream, StreamEventKind, START, TEXT, _ensure
434 5692bc32ba5f * Better method to propogate the full path to the template file on parse errors. Supersedes r513. cmlenz parents: 427 diff changeset	22 from genshi.input import ParseError
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	23
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	24 __all__ = ['Context', 'DirectiveFactory', 'Template', 'TemplateError',
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	25 'TemplateRuntimeError', 'TemplateSyntaxError', 'BadDirectiveError']
425 073640758a42 Try to use proper reStructuredText for docstrings throughout. cmlenz parents: 420 diff changeset	26 __docformat__ = 'restructuredtext en'
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	27
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	28
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	29 class TemplateError(Exception):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	30 """Base exception class for errors related to template processing."""
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	31
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	32 def __init__(self, message, filename=None, lineno=-1, offset=-1):
438 2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	33 """Create the exception.
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	34
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	35 :param message: the error message
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	36 :param filename: the filename of the template
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	37 :param lineno: the number of line in the template at which the error
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	38 occurred
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	39 :param offset: the column number at which the error occurred
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	40 """
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	41 if filename is None:
5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	42 filename = '<string>'
438 2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	43 self.msg = message #: the error message string
407 f37d8e6acdf2 Move string interpolation code into separate module (`genshi.template.interpolation`). cmlenz parents: 405 diff changeset	44 if filename != '<string>' or lineno >= 0:
f37d8e6acdf2 Move string interpolation code into separate module (`genshi.template.interpolation`). cmlenz parents: 405 diff changeset	45 message = '%s (%s, line %d)' % (self.msg, filename, lineno)
438 2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	46 Exception.__init__(self, message)
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	47 self.filename = filename #: the name of the template file
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	48 self.lineno = lineno #: the number of the line containing the error
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	49 self.offset = offset #: the offset on the line
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	50
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	51
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	52 class TemplateSyntaxError(TemplateError):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	53 """Exception raised when an expression in a template causes a Python syntax
438 2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	54 error, or the template is not well-formed.
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	55 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	56
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	57 def __init__(self, message, filename=None, lineno=-1, offset=-1):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	58 """Create the exception
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	59
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	60 :param message: the error message
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	61 :param filename: the filename of the template
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	62 :param lineno: the number of line in the template at which the error
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	63 occurred
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	64 :param offset: the column number at which the error occurred
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	65 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	66 if isinstance(message, SyntaxError) and message.lineno is not None:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	67 message = str(message).replace(' (line %d)' % message.lineno, '')
438 2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	68 TemplateError.__init__(self, message, filename, lineno)
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	69
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	70
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	71 class BadDirectiveError(TemplateSyntaxError):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	72 """Exception raised when an unknown directive is encountered when parsing
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	73 a template.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	74
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	75 An unknown directive is any attribute using the namespace for directives,
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	76 with a local name that doesn't match any registered directive.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	77 """
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	78
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	79 def __init__(self, name, filename=None, lineno=-1):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	80 """Create the exception
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	81
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	82 :param name: the name of the directive
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	83 :param filename: the filename of the template
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	84 :param lineno: the number of line in the template at which the error
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	85 occurred
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	86 """
438 2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	87 TemplateSyntaxError.__init__(self, 'bad directive "%s"' % name,
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	88 filename, lineno)
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	89
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	90
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	91 class TemplateRuntimeError(TemplateError):
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	92 """Exception raised when an the evaluation of a Python expression in a
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	93 template causes an error.
2c38ec4e2dff Added documentation page on the builtin stream filters. cmlenz parents: 435 diff changeset	94 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	95
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	96
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	97 class Context(object):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	98 """Container for template input data.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	99
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	100 A context provides a stack of scopes (represented by dictionaries).
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	101
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	102 Template directives such as loops can push a new scope on the stack with
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	103 data that should only be available inside the loop. When the loop
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	104 terminates, that scope can get popped off the stack again.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	105
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	106 >>> ctxt = Context(one='foo', other=1)
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	107 >>> ctxt.get('one')
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	108 'foo'
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	109 >>> ctxt.get('other')
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	110 1
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	111 >>> ctxt.push(dict(one='frost'))
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	112 >>> ctxt.get('one')
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	113 'frost'
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	114 >>> ctxt.get('other')
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	115 1
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	116 >>> ctxt.pop()
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	117 {'one': 'frost'}
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	118 >>> ctxt.get('one')
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	119 'foo'
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	120 """
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	121
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	122 def __init__(self, **data):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	123 """Initialize the template context with the given keyword arguments as
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	124 data.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	125 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	126 self.frames = deque([data])
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	127 self.pop = self.frames.popleft
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	128 self.push = self.frames.appendleft
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	129 self._match_templates = []
553 489a47873950 Store state information for py:choose outside of the regular context data. cmlenz parents: 548 diff changeset	130 self._choice_stack = []
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	131
442 97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	132 # Helper functions for use in expressions
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	133 def defined(name):
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	134 """Return whether a variable with the specified name exists in the
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	135 expression scope."""
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	136 return name in self
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	137 def value_of(name, default=None):
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	138 """If a variable of the specified name is defined, return its value.
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	139 Otherwise, return the provided default value, or ``None``."""
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	140 return self.get(name, default)
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	141 data.setdefault('defined', defined)
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	142 data.setdefault('value_of', value_of)
97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	143
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	144 def __repr__(self):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	145 return repr(list(self.frames))
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	146
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	147 def __contains__(self, key):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	148 """Return whether a variable exists in any of the scopes.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	149
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	150 :param key: the name of the variable
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	151 """
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	152 return self._find(key)[1] is not None
564 aeb89e9730df Alias `__contains__` to `has_key` in `Context` class for code outside of Genshi that may expect that for some wild reason. cmlenz parents: 553 diff changeset	153 has_key = __contains__
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	154
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	155 def __delitem__(self, key):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	156 """Remove a variable from all scopes.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	157
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	158 :param key: the name of the variable
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	159 """
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	160 for frame in self.frames:
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	161 if key in frame:
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	162 del frame[key]
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	163
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	164 def __getitem__(self, key):
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	165 """Get a variables's value, starting at the current scope and going
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	166 upward.
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	167
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	168 :param key: the name of the variable
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	169 :return: the variable value
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	170 :raises KeyError: if the requested variable wasn't found in any scope
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	171 """
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	172 value, frame = self._find(key)
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	173 if frame is None:
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	174 raise KeyError(key)
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	175 return value
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	176
420 91556138dae5 Add support for `len()` to the `Context` class. cmlenz parents: 407 diff changeset	177 def __len__(self):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	178 """Return the number of distinctly named variables in the context.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	179
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	180 :return: the number of variables in the context
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	181 """
420 91556138dae5 Add support for `len()` to the `Context` class. cmlenz parents: 407 diff changeset	182 return len(self.items())
91556138dae5 Add support for `len()` to the `Context` class. cmlenz parents: 407 diff changeset	183
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	184 def __setitem__(self, key, value):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	185 """Set a variable in the current scope.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	186
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	187 :param key: the name of the variable
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	188 :param value: the variable value
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	189 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	190 self.frames[0][key] = value
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	191
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	192 def _find(self, key, default=None):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	193 """Retrieve a given variable's value and the frame it was found in.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	194
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	195 Intended primarily for internal use by directives.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	196
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	197 :param key: the name of the variable
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	198 :param default: the default value to return when the variable is not
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	199 found
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	200 """
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	201 for frame in self.frames:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	202 if key in frame:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	203 return frame[key], frame
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	204 return default, None
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	205
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	206 def get(self, key, default=None):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	207 """Get a variable's value, starting at the current scope and going
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	208 upward.
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	209
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	210 :param key: the name of the variable
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	211 :param default: the default value to return when the variable is not
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	212 found
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	213 """
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	214 for frame in self.frames:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	215 if key in frame:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	216 return frame[key]
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	217 return default
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	218
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	219 def keys(self):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	220 """Return the name of all variables in the context.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	221
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	222 :return: a list of variable names
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	223 """
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	224 keys = []
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	225 for frame in self.frames:
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	226 keys += [key for key in frame if key not in keys]
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	227 return keys
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	228
5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	229 def items(self):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	230 """Return a list of ``(name, value)`` tuples for all variables in the
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	231 context.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	232
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	233 :return: a list of variables
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	234 """
405 5340931530e2 Support for Python code blocks using the `<?python ?>` processing instruction. Closes #84. cmlenz parents: 400 diff changeset	235 return [(key, self.get(key)) for key in self.keys()]
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	236
731 01bdf155db95 Workaround for a Python 2.4 bug that broke star imports in template code blocks. Closes #221. Many thanks to Armin Ronacher for the patch. cmlenz parents: 715 diff changeset	237 def update(self, mapping):
01bdf155db95 Workaround for a Python 2.4 bug that broke star imports in template code blocks. Closes #221. Many thanks to Armin Ronacher for the patch. cmlenz parents: 715 diff changeset	238 """Update the context from the mapping provided."""
01bdf155db95 Workaround for a Python 2.4 bug that broke star imports in template code blocks. Closes #221. Many thanks to Armin Ronacher for the patch. cmlenz parents: 715 diff changeset	239 self.frames[0].update(mapping)
01bdf155db95 Workaround for a Python 2.4 bug that broke star imports in template code blocks. Closes #221. Many thanks to Armin Ronacher for the patch. cmlenz parents: 715 diff changeset	240
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	241 def push(self, data):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	242 """Push a new scope on the stack.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	243
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	244 :param data: the data dictionary to push on the context stack.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	245 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	246
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	247 def pop(self):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	248 """Pop the top-most scope from the stack."""
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	249
948 cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	250 def copy(self):
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	251 """Create a copy of this Context object."""
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	252 # required to make f_locals a dict-like object
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	253 # See http://genshi.edgewall.org/ticket/249 for
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	254 # example use case in Twisted tracebacks
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	255 ctxt = Context()
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	256 ctxt.frames.pop() # pop empty dummy context
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	257 ctxt.frames.extend(self.frames)
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	258 ctxt._match_templates.extend(self._match_templates)
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	259 ctxt._choice_stack.extend(self._choice_stack)
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	260 return ctxt
cccbcbd33e90 Merge r1172 from trunk (add .copy method to Context objects, see #249). hodgestar parents: 897 diff changeset	261
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	262
827 bebc68529176 Avoid varargs on internal functions in template processing for slightly better performance. cmlenz parents: 825 diff changeset	263 def _apply_directives(stream, directives, ctxt, vars):
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	264 """Apply the given directives to the stream.
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	265
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	266 :param stream: the stream the directives should be applied to
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	267 :param directives: the list of directives to apply
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	268 :param ctxt: the `Context`
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	269 :param vars: additional variables that should be available when Python
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	270 code is executed
435 be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	271 :return: the stream with the given directives applied
be39660919a5 More API doc enhancements. cmlenz parents: 434 diff changeset	272 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	273 if directives:
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	274 stream = directives[0](iter(stream), directives[1:], ctxt, **vars)
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	275 return stream
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	276
827 bebc68529176 Avoid varargs on internal functions in template processing for slightly better performance. cmlenz parents: 825 diff changeset	277
bebc68529176 Avoid varargs on internal functions in template processing for slightly better performance. cmlenz parents: 825 diff changeset	278 def _eval_expr(expr, ctxt, vars=None):
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	279 """Evaluate the given `Expression` object.
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	280
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	281 :param expr: the expression to evaluate
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	282 :param ctxt: the `Context`
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	283 :param vars: additional variables that should be available to the
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	284 expression
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	285 :return: the result of the evaluation
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	286 """
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	287 if vars:
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	288 ctxt.push(vars)
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	289 retval = expr.evaluate(ctxt)
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	290 if vars:
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	291 ctxt.pop()
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	292 return retval
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	293
827 bebc68529176 Avoid varargs on internal functions in template processing for slightly better performance. cmlenz parents: 825 diff changeset	294
bebc68529176 Avoid varargs on internal functions in template processing for slightly better performance. cmlenz parents: 825 diff changeset	295 def _exec_suite(suite, ctxt, vars=None):
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	296 """Execute the given `Suite` object.
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	297
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	298 :param suite: the code suite to execute
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	299 :param ctxt: the `Context`
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	300 :param vars: additional variables that should be available to the
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	301 code
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	302 """
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	303 if vars:
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	304 ctxt.push(vars)
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	305 ctxt.push({})
750 52219748e5c1 Remove some cruft for supporting Python 2.3. cmlenz parents: 731 diff changeset	306 suite.execute(ctxt)
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	307 if vars:
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	308 top = ctxt.pop()
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	309 ctxt.pop()
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	310 ctxt.frames[0].update(top)
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	311
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	312
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	313 class DirectiveFactoryMeta(type):
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	314 """Meta class for directive factories."""
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	315
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	316 def __new__(cls, name, bases, d):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	317 if 'directives' in d:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	318 d['_dir_by_name'] = dict(d['directives'])
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	319 d['_dir_order'] = [directive[1] for directive in d['directives']]
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	320
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	321 return type.__new__(cls, name, bases, d)
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	322
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	323
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	324 class DirectiveFactory(object):
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	325 """Base for classes that provide a set of template directives.
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	326
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	327 :since: version 0.6
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	328 """
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	329 __metaclass__ = DirectiveFactoryMeta
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	330
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	331 directives = []
848 c1d317c0df68 Tiny docstring fix. cmlenz parents: 847 diff changeset	332 """A list of ``(name, cls)`` tuples that define the set of directives
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	333 provided by this factory.
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	334 """
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	335
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	336 def get_directive(self, name):
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	337 """Return the directive class for the given name.
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	338
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	339 :param name: the directive name as used in the template
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	340 :return: the directive class
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	341 :see: `Directive`
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	342 """
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	343 return self._dir_by_name.get(name)
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	344
847 e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	345 def get_directive_index(self, dir_cls):
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	346 """Return a key for the given directive class that should be used to
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	347 sort it among other directives on the same `SUB` event.
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	348
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	349 The default implementation simply returns the index of the directive in
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	350 the `directives` list.
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	351
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	352 :param dir_cls: the directive class
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	353 :return: the sort key
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	354 """
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	355 if dir_cls in self._dir_order:
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	356 return self._dir_order.index(dir_cls)
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	357 return len(self._dir_order)
e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	358
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	359
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	360 class Template(DirectiveFactory):
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	361 """Abstract template base class.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	362
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	363 This class implements most of the template processing model, but does not
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	364 specify the syntax of templates.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	365 """
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	366
609 6d4877844e28 Add support for Python code blocks in text templates using the new syntax. cmlenz parents: 606 diff changeset	367 EXEC = StreamEventKind('EXEC')
6d4877844e28 Add support for Python code blocks in text templates using the new syntax. cmlenz parents: 606 diff changeset	368 """Stream event kind representing a Python code suite to execute."""
6d4877844e28 Add support for Python code blocks in text templates using the new syntax. cmlenz parents: 606 diff changeset	369
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	370 EXPR = StreamEventKind('EXPR')
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	371 """Stream event kind representing a Python expression."""
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	372
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	373 INCLUDE = StreamEventKind('INCLUDE')
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	374 """Stream event kind representing the inclusion of another template."""
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	375
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	376 SUB = StreamEventKind('SUB')
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	377 """Stream event kind representing a nested stream to which one or more
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	378 directives should be applied.
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	379 """
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	380
605 d0345c64da65 Text templates now default to rendering as plain text; it is no longer necessary to explicitly specify the "text" method to the `render()` or `serialize()` method of the generated markup stream. See tickets #62 and #118. cmlenz parents: 590 diff changeset	381 serializer = None
636 699601cce3cc Follow-up to [751]: applying the optimization to text templates was actually slowing them down, so only do it for markup templates. cmlenz parents: 635 diff changeset	382 _number_conv = unicode # function used to convert numbers to event data
605 d0345c64da65 Text templates now default to rendering as plain text; it is no longer necessary to explicitly specify the "text" method to the `render()` or `serialize()` method of the generated markup stream. See tickets #62 and #118. cmlenz parents: 590 diff changeset	383
714 fc6d9d2a3527 The `Template` class and its subclasses, as well as the interpolation API, now take an `filepath` parameter instead of `basedir`. Closes #207. Thanks to Waldemar Kornewald for the patch. cmlenz parents: 700 diff changeset	384 def __init__(self, source, filepath=None, filename=None, loader=None,
606 37ff75bb4301 Changed the default error handling mode to "strict". cmlenz parents: 605 diff changeset	385 encoding=None, lookup='strict', allow_exec=True):
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	386 """Initialize a template from either a string, a file-like object, or
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	387 an already parsed markup stream.
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	388
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	389 :param source: a string, file-like object, or markup stream to read the
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	390 template from
714 fc6d9d2a3527 The `Template` class and its subclasses, as well as the interpolation API, now take an `filepath` parameter instead of `basedir`. Closes #207. Thanks to Waldemar Kornewald for the patch. cmlenz parents: 700 diff changeset	391 :param filepath: the absolute path to the template file
fc6d9d2a3527 The `Template` class and its subclasses, as well as the interpolation API, now take an `filepath` parameter instead of `basedir`. Closes #207. Thanks to Waldemar Kornewald for the patch. cmlenz parents: 700 diff changeset	392 :param filename: the path to the template file relative to the search
fc6d9d2a3527 The `Template` class and its subclasses, as well as the interpolation API, now take an `filepath` parameter instead of `basedir`. Closes #207. Thanks to Waldemar Kornewald for the patch. cmlenz parents: 700 diff changeset	393 path
492 fd10321bb1ba Fix docstring typo. cmlenz parents: 475 diff changeset	394 :param loader: the `TemplateLoader` to use for loading included
fd10321bb1ba Fix docstring typo. cmlenz parents: 475 diff changeset	395 templates
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	396 :param encoding: the encoding of the `source`
606 37ff75bb4301 Changed the default error handling mode to "strict". cmlenz parents: 605 diff changeset	397 :param lookup: the variable lookup mechanism; either "strict" (the
37ff75bb4301 Changed the default error handling mode to "strict". cmlenz parents: 605 diff changeset	398 default), "lenient", or a custom lookup class
545 619340e2d805 Support for Python code blocks in templates can now be disabled. Closes #123. cmlenz parents: 492 diff changeset	399 :param allow_exec: whether Python code blocks in templates should be
619340e2d805 Support for Python code blocks in templates can now be disabled. Closes #123. cmlenz parents: 492 diff changeset	400 allowed
619340e2d805 Support for Python code blocks in templates can now be disabled. Closes #123. cmlenz parents: 492 diff changeset	401
619340e2d805 Support for Python code blocks in templates can now be disabled. Closes #123. cmlenz parents: 492 diff changeset	402 :note: Changed in 0.5: Added the `allow_exec` argument
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	403 """
714 fc6d9d2a3527 The `Template` class and its subclasses, as well as the interpolation API, now take an `filepath` parameter instead of `basedir`. Closes #207. Thanks to Waldemar Kornewald for the patch. cmlenz parents: 700 diff changeset	404 self.filepath = filepath or filename
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	405 self.filename = filename
363 37e4b4bb0b53 Parse template includes at parse time to avoid some runtime overhead. cmlenz parents: 362 diff changeset	406 self.loader = loader
442 97544725bb7f Back out [510] and instead implement configurable error handling modes. The default is the old 0.3.x behaviour, but more strict error handling is available as an option. cmlenz parents: 438 diff changeset	407 self.lookup = lookup
545 619340e2d805 Support for Python code blocks in templates can now be disabled. Closes #123. cmlenz parents: 492 diff changeset	408 self.allow_exec = allow_exec
715 b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	409 self._init_filters()
876 124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	410 self._init_loader()
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	411 self._prepared = False
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	412
374 b146277eb54a `MarkupTemplate`s can now be instantiated from markup streams, in addition to strings and file-like objects. Thanks to David Fraser for the patch. Closes #69. cmlenz parents: 363 diff changeset	413 if isinstance(source, basestring):
b146277eb54a `MarkupTemplate`s can now be instantiated from markup streams, in addition to strings and file-like objects. Thanks to David Fraser for the patch. Closes #69. cmlenz parents: 363 diff changeset	414 source = StringIO(source)
b146277eb54a `MarkupTemplate`s can now be instantiated from markup streams, in addition to strings and file-like objects. Thanks to David Fraser for the patch. Closes #69. cmlenz parents: 363 diff changeset	415 else:
b146277eb54a `MarkupTemplate`s can now be instantiated from markup streams, in addition to strings and file-like objects. Thanks to David Fraser for the patch. Closes #69. cmlenz parents: 363 diff changeset	416 source = source
434 5692bc32ba5f * Better method to propogate the full path to the template file on parse errors. Supersedes r513. cmlenz parents: 427 diff changeset	417 try:
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	418 self._stream = self._parse(source, encoding)
434 5692bc32ba5f * Better method to propogate the full path to the template file on parse errors. Supersedes r513. cmlenz parents: 427 diff changeset	419 except ParseError, e:
5692bc32ba5f * Better method to propogate the full path to the template file on parse errors. Supersedes r513. cmlenz parents: 427 diff changeset	420 raise TemplateSyntaxError(e.msg, self.filepath, e.lineno, e.offset)
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	421
715 b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	422 def __getstate__(self):
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	423 state = self.__dict__.copy()
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	424 state['filters'] = []
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	425 return state
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	426
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	427 def __setstate__(self, state):
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	428 self.__dict__ = state
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	429 self._init_filters()
b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	430
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	431 def __repr__(self):
860 16d55698006a A bit of cleanup of the `Markup` Python implementation. cmlenz parents: 855 diff changeset	432 return '<%s "%s">' % (type(self).__name__, self.filename)
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	433
715 b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	434 def _init_filters(self):
876 124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	435 self.filters = [self._flatten, self._include]
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	436
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	437 def _init_loader(self):
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	438 if self.loader is None:
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	439 from genshi.template.loader import TemplateLoader
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	440 if self.filename:
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	441 if self.filepath != self.filename:
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	442 basedir = os.path.normpath(self.filepath)[:-len(
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	443 os.path.normpath(self.filename))
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	444 ]
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	445 else:
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	446 basedir = os.path.dirname(self.filename)
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	447 else:
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	448 basedir = '.'
124b57282f81 Templates instantiated without a loader now get an implicit loader based on their file path, or the current directory as a fallback. Closes #320. cmlenz parents: 860 diff changeset	449 self.loader = TemplateLoader([os.path.abspath(basedir)])
715 b5bd8c109209 Enable pickling of `Template` and `Code` objects. cmlenz parents: 714 diff changeset	450
822 70fddd2262f5 Get rid of some Python 2.3 legacy that's no longer needed now that 2.4 is the baseline. cmlenz parents: 817 diff changeset	451 @property
70fddd2262f5 Get rid of some Python 2.3 legacy that's no longer needed now that 2.4 is the baseline. cmlenz parents: 817 diff changeset	452 def stream(self):
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	453 if not self._prepared:
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	454 self._prepare_self()
790 da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	455 return self._stream
da90cee22560 Merged the custom-directives branch back into trunk. cmlenz parents: 750 diff changeset	456
374 b146277eb54a `MarkupTemplate`s can now be instantiated from markup streams, in addition to strings and file-like objects. Thanks to David Fraser for the patch. Closes #69. cmlenz parents: 363 diff changeset	457 def _parse(self, source, encoding):
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	458 """Parse the template.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	459
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	460 The parsing stage parses the template and constructs a list of
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	461 directives that will be executed in the render stage. The input is
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	462 split up into literal output (text that does not depend on the context
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	463 data) and directives or expressions.
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	464
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	465 :param source: a file-like object containing the XML source of the
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	466 template, or an XML event stream
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	467 :param encoding: the encoding of the `source`
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	468 """
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	469 raise NotImplementedError
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	470
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	471 def _prepare_self(self, inlined=None):
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	472 if not self._prepared:
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	473 self._stream = list(self._prepare(self._stream, inlined))
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	474 self._prepared = True
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	475
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	476 def _prepare(self, stream, inlined):
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	477 """Call the `attach` method of every directive found in the template.
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	478
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	479 :param stream: the event stream of the template
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	480 """
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	481 from genshi.template.loader import TemplateNotFound
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	482 if inlined is None:
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	483 inlined = set((self.filepath,))
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	484
351 0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	485 for kind, data, pos in stream:
0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	486 if kind is SUB:
362 fe40d34fb71d Follow-up to [431]: directives are no longer instantiated directly at parse time, but instead by the `attach()` method of the directive class (which replaces the `prepare()` method). cmlenz parents: 361 diff changeset	487 directives = []
fe40d34fb71d Follow-up to [431]: directives are no longer instantiated directly at parse time, but instead by the `attach()` method of the directive class (which replaces the `prepare()` method). cmlenz parents: 361 diff changeset	488 substream = data[1]
847 e16447a9605f Backported a couple of templating core changes from the advanced-i18n branch, in particular considering the determination of directive ordering../set cmlenz parents: 843 diff changeset	489 for _, cls, value, namespaces, pos in sorted(data[0]):
362 fe40d34fb71d Follow-up to [431]: directives are no longer instantiated directly at parse time, but instead by the `attach()` method of the directive class (which replaces the `prepare()` method). cmlenz parents: 361 diff changeset	490 directive, substream = cls.attach(self, substream, value,
fe40d34fb71d Follow-up to [431]: directives are no longer instantiated directly at parse time, but instead by the `attach()` method of the directive class (which replaces the `prepare()` method). cmlenz parents: 361 diff changeset	491 namespaces, pos)
fe40d34fb71d Follow-up to [431]: directives are no longer instantiated directly at parse time, but instead by the `attach()` method of the directive class (which replaces the `prepare()` method). cmlenz parents: 361 diff changeset	492 if directive:
fe40d34fb71d Follow-up to [431]: directives are no longer instantiated directly at parse time, but instead by the `attach()` method of the directive class (which replaces the `prepare()` method). cmlenz parents: 361 diff changeset	493 directives.append(directive)
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	494 substream = self._prepare(substream, inlined)
351 0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	495 if directives:
0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	496 yield kind, (directives, list(substream)), pos
0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	497 else:
0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	498 for event in substream:
0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	499 yield event
0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	500 else:
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	501 if kind is INCLUDE:
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	502 href, cls, fallback = data
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	503 tmpl_inlined = False
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	504 if (isinstance(href, basestring) and
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	505 not getattr(self.loader, 'auto_reload', True)):
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	506 # If the path to the included template is static, and
1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	507 # auto-reloading is disabled on the template loader,
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	508 # the template is inlined into the stream provided it
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	509 # is not already in the stack of templates being
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	510 # processed.
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	511 tmpl = None
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	512 try:
1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	513 tmpl = self.loader.load(href, relative_to=pos[0],
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	514 cls=cls or self.__class__)
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	515 except TemplateNotFound:
1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	516 if fallback is None:
1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	517 raise
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	518 if tmpl is not None:
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	519 if tmpl.filepath not in inlined:
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	520 inlined.add(tmpl.filepath)
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	521 tmpl._prepare_self(inlined)
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	522 for event in tmpl.stream:
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	523 yield event
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	524 inlined.discard(tmpl.filepath)
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	525 tmpl_inlined = True
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	526 else:
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	527 for event in self._prepare(fallback, inlined):
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	528 yield event
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	529 tmpl_inlined = True
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	530 if tmpl_inlined:
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	531 continue
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	532 if fallback:
548 1cc1afc39176 Implement static includes, which improves performance a bit when auto reloading is disabled. cmlenz parents: 545 diff changeset	533 # Otherwise the include is performed at run time
1033 348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	534 data = href, cls, list(
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	535 self._prepare(fallback, inlined))
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	536 yield kind, data, pos
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	537 else:
348ba73df25c Merge r1257 from trunk (fix for infinite template inlining). hodgestar parents: 948 diff changeset	538 yield kind, data, pos
351 0cc031745884 The `py:content`, `py:replace`, and `py:strip=""` directives are now expanded when the template is loaded (as opposed to when it's rendered). cmlenz parents: 345 diff changeset	539
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	540 def generate(self, args, *kwargs):
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	541 """Apply the template to the given context data.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	542
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	543 Any keyword arguments are made available to the template as context
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	544 data.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	545
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	546 Only one positional argument is accepted: if it is provided, it must be
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	547 an instance of the `Context` class, and keyword arguments are ignored.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	548 This calling style is used for internal processing.
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	549
427 55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	550 :return: a markup event stream representing the result of applying
55c574767df2 More API documentation. cmlenz parents: 425 diff changeset	551 the template to the context data.
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	552 """
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	553 vars = {}
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	554 if args:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	555 assert len(args) == 1
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	556 ctxt = args[0]
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	557 if ctxt is None:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	558 ctxt = Context(**kwargs)
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	559 else:
08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	560 vars = kwargs
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	561 assert isinstance(ctxt, Context)
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	562 else:
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	563 ctxt = Context(**kwargs)
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	564
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	565 stream = self.stream
7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	566 for filter_ in self.filters:
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	567 stream = filter_(iter(stream), ctxt, **vars)
605 d0345c64da65 Text templates now default to rendering as plain text; it is no longer necessary to explicitly specify the "text" method to the `render()` or `serialize()` method of the generated markup stream. See tickets #62 and #118. cmlenz parents: 590 diff changeset	568 return Stream(stream, self.serializer)
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	569
813 ae8727f7e1e1 Merge the internal template filters `_eval` and `_exec` into the `_flatten` function for slightly better performance. cmlenz parents: 790 diff changeset	570 def _flatten(self, stream, ctxt, **vars):
636 699601cce3cc Follow-up to [751]: applying the optimization to text templates was actually slowing them down, so only do it for markup templates. cmlenz parents: 635 diff changeset	571 number_conv = self._number_conv
843 d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	572 stack = []
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	573 push = stack.append
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	574 pop = stack.pop
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	575 stream = iter(stream)
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	576
843 d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	577 while 1:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	578 for kind, data, pos in stream:
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	579
843 d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	580 if kind is START and data[1]:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	581 # Attributes may still contain expressions in start tags at
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	582 # this point, so do some evaluation
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	583 tag, attrs = data
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	584 new_attrs = []
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	585 for name, value in attrs:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	586 if type(value) is list: # this is an interpolated string
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	587 values = [event[1]
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	588 for event in self._flatten(value, ctxt, **vars)
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	589 if event[0] is TEXT and event[1] is not None
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	590 ]
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	591 if not values:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	592 continue
855 62c3ffae585d More 2to3 diff size reduction. cmlenz parents: 848 diff changeset	593 value = ''.join(values)
843 d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	594 new_attrs.append((name, value))
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	595 yield kind, (tag, Attrs(new_attrs)), pos
813 ae8727f7e1e1 Merge the internal template filters `_eval` and `_exec` into the `_flatten` function for slightly better performance. cmlenz parents: 790 diff changeset	596
843 d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	597 elif kind is EXPR:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	598 result = _eval_expr(data, ctxt, vars)
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	599 if result is not None:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	600 # First check for a string, otherwise the iterable test
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	601 # below succeeds, and the string will be chopped up into
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	602 # individual characters
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	603 if isinstance(result, basestring):
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	604 yield TEXT, result, pos
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	605 elif isinstance(result, (int, float, long)):
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	606 yield TEXT, number_conv(result), pos
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	607 elif hasattr(result, '__iter__'):
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	608 push(stream)
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	609 stream = _ensure(result)
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	610 break
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	611 else:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	612 yield TEXT, unicode(result), pos
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	613
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	614 elif kind is SUB:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	615 # This event is a list of directives and a list of nested
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	616 # events to which those directives should be applied
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	617 push(stream)
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	618 stream = _apply_directives(data[1], data[0], ctxt, vars)
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	619 break
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	620
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	621 elif kind is EXEC:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	622 _exec_suite(data, ctxt, vars)
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	623
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	624 else:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	625 yield kind, data, pos
813 ae8727f7e1e1 Merge the internal template filters `_eval` and `_exec` into the `_flatten` function for slightly better performance. cmlenz parents: 790 diff changeset	626
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	627 else:
843 d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	628 if not stack:
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	629 break
d10e5bceaa1f Refactored the template flattening method to be less recursive. cmlenz parents: 827 diff changeset	630 stream = pop()
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	631
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	632 def _include(self, stream, ctxt, **vars):
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	633 """Internal stream filter that performs inclusion of external
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	634 template files.
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	635 """
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	636 from genshi.template.loader import TemplateNotFound
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	637
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	638 for event in stream:
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	639 if event[0] is INCLUDE:
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	640 href, cls, fallback = event[1]
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	641 if not isinstance(href, basestring):
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	642 parts = []
813 ae8727f7e1e1 Merge the internal template filters `_eval` and `_exec` into the `_flatten` function for slightly better performance. cmlenz parents: 790 diff changeset	643 for subkind, subdata, subpos in self._flatten(href, ctxt,
ae8727f7e1e1 Merge the internal template filters `_eval` and `_exec` into the `_flatten` function for slightly better performance. cmlenz parents: 790 diff changeset	644 **vars):
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	645 if subkind is TEXT:
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	646 parts.append(subdata)
855 62c3ffae585d More 2to3 diff size reduction. cmlenz parents: 848 diff changeset	647 href = ''.join([x for x in parts if x is not None])
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	648 try:
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	649 tmpl = self.loader.load(href, relative_to=event[2][0],
610 5e358de79e4c * XInclude elements in markup templates now support the `parse` attribute; when set to "xml" (the default), the include is processed as before, but when set to "text", the included template is parsed as a text template using the new syntax (ticket #101). cmlenz parents: 609 diff changeset	650 cls=cls or self.__class__)
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	651 for event in tmpl.generate(ctxt, **vars):
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	652 yield event
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	653 except TemplateNotFound:
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	654 if fallback is None:
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	655 raise
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	656 for filter_ in self.filters:
700 08f22328303d Add option for unbuffered match template processing, which could cause excessive memory usage. Closes #190. cmlenz parents: 639 diff changeset	657 fallback = filter_(iter(fallback), ctxt, **vars)
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	658 for event in fallback:
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	659 yield event
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	660 else:
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	661 yield event
b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	662
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	663
609 6d4877844e28 Add support for Python code blocks in text templates using the new syntax. cmlenz parents: 606 diff changeset	664 EXEC = Template.EXEC
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	665 EXPR = Template.EXPR
475 b373f80f7763 Added include directive for text templates (#115). Thanks to Alastair for the original patch. cmlenz parents: 442 diff changeset	666 INCLUDE = Template.INCLUDE
336 7763f7aec949 Refactoring: `genshi.template` is now a package, it was getting way to crowded in that file. cmlenz parents: diff changeset	667 SUB = Template.SUB

Mercurial > genshi > mirror

annotate genshi/template/base.py @ 1033:348ba73df25c stable-0.6.x