Welcome to PyGUI
================

This is an experimental Python GUI framework. The ultimate aim of
this project is to create a GUI package worthy of becoming the
standard GUI for Python -- truly Pythonic, fully documented in
Python terms, implemented on all the major platforms, and, ideally,
distributed with Python itself, so that one may write GUI
applications that work with any Python installation, anywhere.

Two implementations are provided in this version: one for
MacOS X built on Carbon, and one built on Gtk which should work
on X11 and Windows, given suitable libraries. The Gtk version
requires that PyGtk be installed.

This package is still under development. The basic set of widgets
is more or less complete, and will probably be expanded in the
future. Text and table widgets are currently the most notable
omissions, which I hope to remedy soon.

To install it, either do 'python setup.py' to install it in
your Python site directory, or put the directory containing the
GUI directory on your PYTHONPATH.

To get started with it, have a look at the documentation starting
with Doc/index.html, and the example application in the Demos
directory. You may also find it instructive to study the
programs in the Tests directory, although some of them are
not written in the best style.

License: This is free software. You are welcome to use it
however you want.

Please send comments, questions, suggestions and bug reports to:

   greg@cosc.canterbury.ac.nz

Discussion is also welcome on the comp.lang.python newsgroup.
   
The latest version of PyGUI is available from:

   http://www.cosc.canterbury.ac.nz/~greg/python_gui
   
Have fun,

Greg Ewing
greg@cosc.canterbury.ac.nz
http://www.cosc.canterbury.ac.nz/~greg
