summaryrefslogtreecommitdiff
path: root/README.rst
blob: c0907106488600c30dabbd4f0ae9e4fa7455fb94 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
`wheezy.template`_ is a `python`_ package written in pure Python
code. It is a lightweight template library. The design goals achived:

* **Compact, Expressive, Clean:** Minimizes the number of keystrokes required
  to build a template. Enables fast and well read coding. You do not need to
  explicitly denote statement blocks within HTML (unlike other template
  systems), the parser is smart enough to understand your code. This enables
  a compact and expressive syntax which is really clean and just pleasure
  to type.
* **Intuitive, No time to Learn:** Basic Python programming skills
  plus HTML markup. You are productive just from start. Use full power
  of Python with minimal markup required to denote python statements.
* **Do Not Repeat Yourself:** Master layout templates for inheritance;
  include and import directives for maximum reuse.
* **Blazingly Fast:** Maximum rendering performance: ultimate speed and
  context preprocessor features.

Simple template::

    @require(user, items)
    Welcome, @user.name!
    @if items:
        @for i in items:
            @i.name: @i.price!s.
        @end
    @else:
        No items found.
    @end

It is optimized for performance, well tested and documented.

Resources:

* `source code`_, `examples`_ and `issues`_ tracker are available
  on `bitbucket`_
* `documentation`_, `readthedocs`_
* `eggs`_ on `pypi`_

Install
-------

`wheezy.template`_ requires `python`_ version 2.4 to 2.7 or 3.2+.
It is independent of operating system. You can install it from `pypi`_
site using `setuptools`_::

    $ easy_install wheezy.template

If you are using `virtualenv`_::

    $ virtualenv env
    $ env/bin/easy_install wheezy.template

If you run into any issue or have comments, go ahead and add on
`bitbucket`_.

.. _`bitbucket`: http://bitbucket.org/akorn/wheezy.template
.. _`doctest`: http://docs.python.org/library/doctest.html
.. _`documentation`: http://packages.python.org/wheezy.template
.. _`eggs`: http://pypi.python.org/pypi/wheezy.template
.. _`examples`: http://bitbucket.org/akorn/wheezy.template/src/tip/demos
.. _`issues`: http://bitbucket.org/akorn/wheezy.template/issues
.. _`pypi`: http://pypi.python.org/pypi/wheezy.template
.. _`python`: http://www.python.org
.. _`readthedocs`: http://readthedocs.org/builds/wheezytemplate
.. _`setuptools`: http://pypi.python.org/pypi/setuptools
.. _`source code`: http://bitbucket.org/akorn/wheezy.template/src
.. _`virtualenv`: http://pypi.python.org/pypi/virtualenv
.. _`wheezy.template`: http://pypi.python.org/pypi/wheezy.template