0.2.3

0.2.3

Released: Sun Nov 23 2008

• the <%namespacename:defname> syntax described at
  http://techspot.zzzeek.org/?p=28 has now
  been added as a built in syntax, and is recommended
  as a more modern syntax versus <%call expr="expression">.
  The %call tag itself will always remain,
  with <%namespacename:defname> presenting a more HTML-like
  alternative to calling defs, both plain and
  nested. Many examples of the new syntax are in the
  "Calling a def with embedded content" section
  of the docs.

• added support for Jython 2.5.

• cache module now uses Beaker's CacheManager
  object directly, so that all cache types are included.
  memcached is available as both "ext:memcached" and
  "memcached", the latter for backwards compatibility.

• added "cache" accessor to Template, Namespace.
  e.g. ${local.cache.get('somekey')} or
  template.cache.invalidate_body()

• added "cache_enabled=True" flag to Template,
  TemplateLookup. Setting this to False causes cache
  operations to "pass through" and execute every time;
  this flag should be integrated in Pylons with its own
  cache_enabled configuration setting.

• the Cache object now supports invalidate_def(name),
  invalidate_body(), invalidate_closure(name),
  invalidate(key), which will remove the given key
  from the cache, if it exists. The cache arguments
  (i.e. storage type) are derived from whatever has
  been already persisted for that template.

  References: #92

• For cache changes to work fully, Beaker 1.1 is required.
  1.0.1 and up will work as well with the exception of
  cache expiry. Note that Beaker 1.1 is required
  for applications which use dynamically generated keys,
  since previous versions will permanently store state in memory
  for each individual key, thus consuming all available
  memory for an arbitrarily large number of distinct
  keys.

• fixed bug whereby an <%included> template with
  <%page> args named the same as a builtin would not
  honor the default value specified in <%page>

  References: #93

• fixed the html_error_template not handling tracebacks from
  normal .py files with a magic encoding comment

  References: #88

• RichTraceback() now accepts an optional traceback object
  to be used in place of sys.exc_info()[2]. html_error_template()
  and text_error_template() accept an optional
  render()-time argument "traceback" which is passed to the
  RichTraceback object.

• added ModuleTemplate class, which allows the construction
  of a Template given a Python module generated by a previous
  Template. This allows Python modules alone to be used
  as templates with no compilation step. Source code
  and template source are optional but allow error reporting
  to work correctly.

• fixed Python 2.3 compat. in mako.pyparser

  References: #90

• fix Babel 0.9.3 compatibility; stripping comment tags is now
  optional (and enabled by default).

0.2.2

0.2.2

Released: Mon Jun 23 2008

• cached blocks now use the current context when rendering
  an expired section, instead of the original context
  passed in

  References: #87

• fixed a critical issue regarding caching, whereby
  a cached block would raise an error when called within a
  cache-refresh operation that was initiated after the
  initiating template had completed rendering.

0.2.1

0.2.1

Released: Mon Jun 16 2008

• fixed bug where 'output_encoding' parameter would prevent
  render_unicode() from returning a unicode object.

• bumped magic number, which forces template recompile for
  this version (fixes incompatible compile symbols from 0.1
  series).

• added a few docs for cache options, specifically those that
  help with memcached.

0.2.0

0.2.0

Released: Tue Jun 3 2008

• Speed improvements (as though we needed them, but people
  contributed and there you go):

• added "bytestring passthru" mode, via
  disable_unicode=True argument passed to Template or
  TemplateLookup. All unicode-awareness and filtering is
  turned off, and template modules are generated with
  the appropriate magic encoding comment. In this mode,
  template expressions can only receive raw bytestrings
  or Unicode objects which represent straight ASCII, and
  render_unicode() may not be used if multibyte
  characters are present. When enabled, speed
  improvement around 10-20%. (courtesy
  anonymous guest)

  References: #77

• inlined the "write" function of Context into a local
  template variable. This affords a 12-30% speedup in
  template render time. (idea courtesy same anonymous
  guest)

  References: #76

• New Features, API changes:

• added "attr" accessor to namespaces. Returns
  attributes configured as module level attributes, i.e.
  within <%! %> sections. i.e.:

  somefile.html

  <%!
  foo = 27
  %>

  some other template

  <%namespace name="myns" file="somefile.html"/>
  ${myns.attr.foo}The slight backwards incompatibility here is, you
  can't have namespace defs named "attr" since the
  "attr" descriptor will occlude it.

  References: #62

• cache_key argument can now render arguments passed
  directly to the %page or %def, i.e. <%def
  name="foo(x)" cached="True" cache_key="${x}"/>

  References: #78

• some functions on Context are now private:
  _push_buffer(), _pop_buffer(),
  caller_stack._push_frame(), caller_stack._pop_frame().

• added a runner script "mako-render" which renders
  standard input as a template to stdout

  References: #56, #81

• [bugfixes] can now use most names from builtins as variable
  names without explicit declaration (i.e. 'id',
  'exception', 'range', etc.)

  References: #83, #84

• [bugfixes] can also use builtin names as local variable names
  (i.e. dict, locals) (came from fix for)

  References: #84

• [bugfixes] fixed bug in python generation when variable names are
  used with identifiers like "else", "finally", etc.
  inside them

  References: #68

• [bugfixes] fixed codegen bug which occurred when using <%page>
  level caching, combined with an expression-based
  cache_key, combined with the usage of <%namespace
  import="*"/> - fixed lexer exceptions not cleaning up
  temporary files, which could lead to a maximum number
  of file descriptors used in the process

  References: #69

• [bugfixes] fixed issue with inline format_exceptions that was
  producing blank exception pages when an inheriting
  template is present

  References: #71

• [bugfixes] format_exceptions will apply the encoding options of
  html_error_template() to the buffered output

• [bugfixes] rewrote the "whitespace adjuster" function to work
  with more elaborate combinations of quotes and
  comments

  References: #75

0.1.10

0.1.10

no release date

• fixed propagation of 'caller' such that nested %def calls
  within a <%call> tag's argument list propigates 'caller'
  to the %call function itself (propigates to the inner
  calls too, this is a slight side effect which previously
  existed anyway)

• fixed bug where local.get_namespace() could put an
  incorrect "self" in the current context

• fixed another namespace bug where the namespace functions
  did not have access to the correct context containing
  their 'self' and 'parent'

0.1.9

0.1.9

no release date

• filters.Decode filter can also accept a non-basestring
  object and will call str() + unicode() on it

  References: #47

• comments can be placed at the end of control lines,
  i.e. if foo: # a comment,, thanks to
  Paul Colomiets

  References: #53

• fixed expressions and page tag arguments and with embedded
  newlines in CRLF templates, follow up to, thanks
  Eric Woroshow

  References: #16

• added an IOError catch for source file not found in RichTraceback
  exception reporter

  References: #51

0.1.8

0.1.8

Released: Tue Jun 26 2007

• variable names declared in render methods by internal
  codegen prefixed by "_M" to prevent name collisions
  with user code

• added a Babel (http://babel.edgewall.org/) extractor entry
  point, allowing extraction of gettext messages directly from
  mako templates via Babel

  References: #45

• fix to turbogears plugin to work with dot-separated names
  (i.e. load_template('foo.bar')). also takes file extension
  as a keyword argument (default is 'mak').

• more tg fix: fixed, allowing string-based
  templates with tgplugin even if non-compatible args were sent

  References: #35

0.1.7

0.1.7

Released: Wed Jun 13 2007

• one small fix to the unit tests to support python 2.3

• a slight hack to how cache.py detects Beaker's memcached,
  works around unexplained import behavior observed on some
  python 2.3 installations

0.1.6

0.1.6

Released: Fri May 18 2007

• caching is now supplied directly by Beaker, which has
  all of MyghtyUtils merged into it now. The latest Beaker
  (0.7.1) also fixes a bug related to how Mako was using the
  cache API.

• fix to module_directory path generation when the path is "./"

  References: #34

• TGPlugin passes options to string-based templates

  References: #35

• added an explicit stack frame step to template runtime, which
  allows much simpler and hopefully bug-free tracking of 'caller',
  fixes

  References: #28

• if plain Python defs are used with <%call>, a decorator
  @runtime.supports_callable exists to ensure that the "caller"
  stack is properly handled for the def.

• fix to RichTraceback and exception reporting to get template
  source code as a unicode object

  References: #37

• html_error_template includes options "full=True", "css=True"
  which control generation of HTML tags, CSS

  References: #39

• added the 'encoding_errors' parameter to Template/TemplateLookup
  for specifying the error handler associated with encoding to
  'output_encoding'

  References: #40

• the Template returned by html_error_template now defaults to
  output_encoding=sys.getdefaultencoding(),
  encoding_errors='htmlentityreplace'

  References: #37

• control lines, i.e. % lines, support backslashes to continue long
  lines (#32)

• fixed codegen bug when defining <%def> within <%call> within <%call>

• leading utf-8 BOM in template files is honored according to pep-0263

0.1.5

0.1.5

Released: Sat Mar 31 2007

• AST expression generation - added in just about everything
  expression-wise from the AST module

  References: #26

• AST parsing, properly detects imports of the form "import foo.bar"

  References: #27

• fix to lexing of <%docs> tag nested in other tags

• fix to context-arguments inside of <%include> tag which broke
  during 0.1.4

  References: #29

• added "n" filter, disables all filters normally applied to an expression
  via <%page> or default_filters (but not those within the filter)

• added buffer_filters argument, defines filters applied to the return value
  of buffered/cached/filtered %defs, after all filters defined with the %def
  itself have been applied. allows the creation of default expression filters
  that let the output of return-valued %defs "opt out" of that filtering
  via passing special attributes or objects.