Welcome to Muntjac
Web Application GUI Toolkit
Rich Widget Set
Muntjac includes a wide range of widgets and layout types. Styling is achieved using CSS.
Download & Install
Muntjac is written in pure Python and does not currently have any C extensions. It has been tested on:
To run Muntjac you must install:
- Paste – WSGI tools
- Paste WebKit – WSGI servlet implementation
- Babel – Internationalization utilities
To run the test suite you must also install:
- Mox – Mock object framework
All of these libraries are pure Python and available from the PyPI.
$ easy_install muntjacAlternatively, you can download the Muntjac source archive and run the setup file directly:
$ python setup.py installWindows users may prefer to download and run the installer.
Installing Muntjac will create a muntjac command on your path. To run the test suite type:
$ muntjac -tOtherwise, running the command will start a demo server. To list the available options type:
$ muntjac -h
Sampler Widget SetMuntjac includes only a default widget set as standard. The sampler demo requires additional themes and widget sets. To run the sampler first download both the default and sampler widget sets. Then extract them to the same directory.
Then point muntjac to the new VAADIN directory using:
$ muntjac --contextRoot=/path/to/VAADIN/directoryNote that the value is not the VAADIN directory itself, but the parent directory that contains it.
To create a Muntjac application first 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 new class to ApplicationServlet, wrap the resulting WSGI application in Paste session middleware and serve:
wsgi_app = ApplicationServlet(HelloWorld, debug=True) wsgi_app = paste.session.SessionMiddleware(wsgi_app) httpd = make_server('localhost', 8080, wsgi_app) httpd.serve_forever()Navigate your browser to http://localhost:8080/. For further information please refer to the API documentation and the Vaadin documentation.
Community & Support
The mailing list a good place to ask questions, help others, discuss ideas or just share new projects.
Issues can be reported through the Muntjac issue tracker to ensure new bugs are not lost.
- Muntjac is available under the terms of the Apache Software License Version 2.0.