Muntjac
=======

A web application GUI toolkit.

Muntjac_ is a translation of Vaadin_ to the Python_ programming language. It
is similar to GUI toolkits for desktop applications, such as PyQT_, wxPython_
and PyGTK_. However, it can be used to create dynamic, browser independent,
web applications. There is no need to write HTML, Javascript or RPC code,
just server-side Python.

Quick Start
-----------

Define a subclass of Application_::

	class HelloWorld(Application):

	    def init(self):
	        main = Window('Hello window')
	        self.setMainWindow(main)

	        main.addComponent(Label('Hello World!'))

Pass the application class to a servlet, wrap the resulting WSGI application
in session middleware and serve::

    wsgi_app = ApplicationServlet(HelloWorld, debug=True)

    wsgi_app = paste.session.SessionMiddleware(wsgi_app)

    httpd = wsgiref.simple_server.make_server('localhost', 8080, wsgi_app)
    httpd.serve_forever()

Navigate your browser to ``http://localhost:8080/``.


License and Copyright
---------------------

Copyright (C) 2011 Vaadin Ltd.
Copyright (C) 2011 Richard Lincoln

Muntjac is available under either the terms of the `GNU Affero General Public
License`_ or a commercial license.

.. _Muntjac: http://www.muntiacus.org/
.. _Vaadin: http://www.vaadin.com/
.. _Python: http://www.python.org/
.. _PyQt: http://www.riverbankcomputing.co.uk/software/pyqt/
.. _wxPython: http://www.wxpython.org/
.. _PyGTK: http://www.pygtk.org/
.. _Application: http://doc.muntiacus.org/api/muntjac.application.Application-class.html
.. _GNU Affero General Public License: http://www.gnu.org/licenses/agpl-3.0.txt