Pyhaa is a templating system, inspired by HAML. It's not meant to be compatible, and it's not a "port". Only basic rules apply, the rest may be incompatible.

Name is subject to change.

It's a project developed in my free time for my own enjoment, with little hope someday it gets finished or reach minimal level of usability.

Not much is done, what is working can be seen in unit tests.

1. HTML and etree output (for easy generation of XML)
2. Templating basics: inheritance, partials
3. Macros and constants for pre-codegen "dynamics"
4. Allow to write clean, but strict template code

1. Python 3 all the way
2. Forget about pretty-formatting, don't throw whitespaces into HTML if user does not ask for it (Instead of "Whitespace Removal" syntax known from HAML which doesn't actually solve all problems). Currently easiest option to view HTML code are developer tools, available for all modern web browsers, so you don't have to worry about pretty HTML.
3. Do not translate template into other templating language. This doubles problems and possible bugs you could get with just one and opens door to even more horrible, ugly and unmaintainable template code.
4. Forget about automatically "injecting" variables from template context into function local scope - use context directly.
5. Make it strict - forget about UNDEFINED objects instead raising error about undeclared variable, as this causes more problems than solves.
6. Yield instead of writing into io objects
7. Encode into given charset BEFORE compiling template to python code
8. Disallow class definition, function (at function level) and exception handling in template code - mostly for the sake of simplicity but also not to put too complicated code into templates. This may change in the future.

Things I left behind for later, not those "yet to be touched".

1. Store encoding in cached template and invalidate if encoding does not match
2. Clean up API, make it more flexible and less messy
3. Raise proper exceptions (move parsing.errors up one level and refactor)
4. Think of optimizations and code reorganization for get_inheritance_chain
5. Remove shorthands module and make unit-tests use environment
6. Better unit-test error handling
7. Reorganize and clean up code in parser a bit more
8. Make setting tag attributes from variable easier (currently only dict-comprehension is possible)

1. Find better way for inserting whitespaces (!sp syntax is too a bit ugly)
2. Think how to support preformatted text blocks blocks (inline javascript, <pre> blocks etc)
3. Rethink how to handle Python tokenizer readahead

Copyright © 2011 Tomasz Kowalczyk

I licence this code under GNU Lesser General Public Licence Version 3