Kiwi is a PyGTK framework for building graphical applications loosely based on MVC Model-View-Controller (MVC) and Allen Holub's Visual proxy [1]. 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.16.tar.gz


What's new since 1.9.15?
======================
- Polish translation (Jarek Zgoda)
- Support for currency marker in KiwiLabel (#3389, Ronaldo Maia)
- Improvements to glade-3 plugin (Ali, #3461)
- ObjectList::row-expanded signal (Ali, #3460)
- Kiwi completion fixes/workaround (Ali, #2901)
- Tasklet updates (Gustavo)
- ValueUnset and KiwiEntry (Ali, #3408)
- Gaxml support in loader
- Gazpacho support for ObjectList (Ali, #3389)
- Rml translation support
- SQLObject full text index support


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 support: 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 and Glade-3 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/

Optional dependencies:
gazpacho 0.6.6 http://gazpacho.sicem.biz/
glade-3 http://glade.gnome.org/

The support for Glade 3 is still experimental and to install it you need
to run a separate script in the glade3-plugin directory.


Documentation
============
Kiwi provides API documentation generated by pydoctor, 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

--
Johan Dahlin <jdahlin@async.com.br>
Async Open Source