Kiwi is a PyGTK framework for building graphical applications loosely based on MVC Model-View-Controller (MVC) and Allen Holub's Visual proxy. Think of Kiwi as a high-level, object-oriented layer built on PyGTK.

Its design is based on real-world experience using PyGTK to develop large desktop applications, which use many concepts common to most graphical applications: multiple windows and dialogs, forms, data persistence, lists and high-level classes that support domain objects directly.



Download
=======

Grab the latest sources from:

http://www.async.com.br/projects/kiwi/download/kiwi-1.9.11.tar.gz


What's new since 1.9.11?
======================
- Rewritten UI Test framework, not using threads
- Improved Date Error message (#3041, Marco Antonio Porcho Souza)
- ComboEntry.set_selected_iter improvements (#3099,
Goedson Teixeira Paixao)
- French translation (Benoit Myard)
- Proper Hyperlink allocation (#2923, Ali Afshar)
- Avoid tasklet zombies (Gustavo Carneiro)
- Logging fixes (#2984, Johan)
- Add enum type (Johan)
- Backport any/all from Python 2.5 (Johan)
- Simplify ObjectTree API (Johan)

Features
=======

* An MVC-derived framework of classes:
* Views, which represent the graphical display
* Controllers, which handles user interaction with the widgets in a View.
* Delegates, combines a View and a Controller.
* Models, which are special mixins for your domain objects
* Proxies, special types of Delegate designed to implement forms

* Validation: Kiwi supports validation on different levels:
data type validation and verification on the Model/Proxy level, View validation and hooks for visually displaying validation state.

* ObjectList widget, which provides a higher level abstraction of GtkTreeView and all its classes (GtkTreeModel, GtkTreeViewColumn, GtkCellRenderer) with hooks to easily integrate into the Kiwi Framework.

* Mask suport: You can set a mask on entries to force the input to follow a certain standard, such as zip code, social security, ip address

* Gazpacho integration for most (non-deprecated) interactive widgets with attributes for handling validation and proxy attributes.

* UI Test framework
Features a recorder and a player. The recorder allows you to record different tasks, a script will be saved which will reproduce the actions you made in the interface.

* Kiwi Tasklets
Tasklet is a small coroutines framework written by Gustavo Carneiro, it was previously known as gtasklets.

* PyGTK utilities, to make it easier to add signals and properties to your objects.

* i18n translation utilities, to help you translate PyGTK applications, currently depends on gettext and intltool.

* and many other things!


Requirements
===========

Python 2.3 or higher (2.4 recommended) http://www.python.org/
PyGTK 2.6.0 or higher (2.8 recommended) http://www.pygtk.org/
gazpacho 0.6.5 (svn recommenced) http://gazpacho.sicem.biz/


Documentation
============
Kiwi provides API documentation generated by epydoc, it can be found at

http://www.async.com.br/projects/kiwi/api/

Included in the tarball are also a number of examples, which serves as a good starting point. Keep in mind that most of them require gazpacho to be installed.


Thanks
=====
Christian Robottom Reis: Original author and design Lorenzo Gil Sanchez: PyGTK 2.x port

Also thanks to the following people which has contributed features or bug reports:
Ali Afshar, Henrique Romano, Daniel Saran R. da Cunha, Evandro Vale Miquelito, Gustavo Barbieri, Gustavo Carneiro, Ronaldo Maia, Benoit Myard, Patrick O'Brien, Goedson Teixeira Paixao, Sidnei da Silva, Marco Antonio Porcho Souza

Resources
========

Homepage http://www.async.com.br/projects/kiwi/
Download http://www.async.com.br/projects/kiwi/download/
Repository http://svn.async.com.br/cgi-bin/viewcvs.cgi/kiwi/
Report a bug http://bugs.async.com.br/enter_bug.cgi?product=Kiwi
API docs http://www.async.com.br/projects/kiwi/api/
Open bugs http://tinyurl.com/cyrms
Mail. list http://www.async.com.br/mailman/listinfo/kiwi/

[1] http://en.wikipedia.org/wiki/Model-view-controller