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.

0.1.4

0.1.4

Released: Sat Mar 10 2007

• got defs-within-defs to be cacheable

• fixes to code parsing/whitespace adjusting where plain python comments
  may contain quote characters

  References: #23

• fix to variable scoping for identifiers only referenced within
  functions

• added a path normalization step to lookup so URIs like
  "/foo/bar/../etc/../foo" pre-process the ".." tokens before checking
  the filesystem

• fixed/improved "caller" semantics so that undefined caller is
  "UNDEFINED", propigates nonzero method so it evaulates to False if
  not present, True otherwise. this way you can say % if caller:n
  ${caller.body()}n% endif

• <%include> has an "args" attribute that can pass arguments to the
  called template (keyword arguments only, must be declared in that
  page's <%page> tag.)

• <%include> plus arguments is also programmatically available via
  self.include_file(, **kwargs)

• further escaping added for multibyte expressions in %def, %call
  attributes

  References: #24

0.1.3

0.1.3

Released: Wed Feb 21 2007

• Small Syntax Change - the single line comment character is now
  two hash signs, i.e. "## this is a comment". This avoids a common
  collection with CSS selectors.

• the magic "coding" comment (i.e. # coding:utf-8) will still work with
  either one "#" sign or two for now; two is preferred going forward, i.e.

  coding:.

• new multiline comment form: "<%doc> a comment </%doc>"

• UNDEFINED evaluates to False

• improvement to scoping of "caller" variable when using <%call> tag

• added lexer error for unclosed control-line (%) line

• added "preprocessor" argument to Template, TemplateLookup - is a single
  callable or list of callables which will be applied to the template text
  before lexing. given the text as an argument, returns the new text.

• added mako.ext.preprocessors package, contains one preprocessor so far:
  'convert_comments', which will convert single # comments to the new ##
  format

0.1.2

0.1.2

Released: Thu Feb 1 2007

• fix to parsing of code/expression blocks to insure that non-ascii
  characters, combined with a template that indicates a non-standard
  encoding, are expanded into backslash-escaped glyphs before being AST
  parsed

  References: #11

• all template lexing converts the template to unicode first, to
  immediately catch any encoding issues and ensure internal unicode
  representation.

• added module_filename argument to Template to allow specification of a
  specific module file

• added modulename_callable to TemplateLookup to allow a function to
  determine module filenames (takes filename, uri arguments). used for

  References: #14

• added optional input_encoding flag to Template, to allow sending a
  unicode() object with no magic encoding comment

• "expression_filter" argument in <%page> applies only to expressions

• ["unicode"] added "default_filters" argument to Template, TemplateLookup. applies only
  to expressions, gets prepended to "expression_filter" arg from <%page>.
  defaults to, so that all expressions get stringified into u''
  by default (this is what Mako already does). By setting to [], expressions
  are passed through raw.

• added "imports" argument to Template, TemplateLookup. so you can predefine
  a list of import statements at the top of the template. can be used in
  conjunction with default_filters.

• support for CRLF templates...whoops ! welcome to all the windows users.

  References: #16

• small fix to local variable propigation for locals that are conditionally
  declared

• got "top level" def calls to work, i.e. template.get_def("somedef").render()