EditObj

***** CONTENT *****

EditObj can create and display a Tkinter dialog box for editing any
Python object (similarly to what Java call a Bean editor, but for
Python object). EditObj is a usefull tool for writing (text or
non-text) editors of all kinds, including GUI editor, 3D editor,...

As Python is a dynamic language, you'll need to give some knowledge of
your object's structure, essentially by mapping attributes names to a
given editor (such as FloatEditor, StringEditor, FileNameEditor,...).
Though EditObj support the edition of ANY Python object; the dition
will simply be more user-friendly if the appropriate editor is given.

EditObj supports also lists, dictionaries and hierarchies (nested
lists) edition.

The Python Tk console (console.py) comes from Ka-Ping Yee
<ping@lfw.org>, in a slighly modified version.


EditObj also includes some interesting components:

 * EventObj is a (hackish) pure Python module that allows to add
modification callback (=event) to any Python object (including
lists and dicts). It can be used for debugging, for automatic update
checking, or as an event framework.

 * TreeWidget (editobj.treewidget) is a tree widget for Tkinter, in
pure-Python.

It is inspired on Guido's IDE tree widget, but adds some features:
   - highly optimized (supports more than 10000 nodes !)
   - asynchronous rendering
   - Linux-friendly look-and-feel (and PGM icons instead of gif)
   - inheritance-based interface (inherit the Node class)
   - ...

The same package also provides a scrollpane, that can be used to add
scrollbars for a Tkinter Frame.

 * A multiple undo-redo framework (cancel.py), based on closure.


***** LICENSE *****

EditObj is Free Software and is available under the GNU GPL.


***** INSTALLATION *****

EditObj requires at least Python 2.2 (tested with 2.2.1); any platform
providing Tkinter should be right (tested under Linux).

Distribution uses the Python distutils tools.
Install it with (as root):

  cd EditObj-XXX
  python ./setup.py install


***** DOCUMENTATION *****

See the module's docstrings for more info about how to use it.

Demo of EditObj and TreeWidget are available in ./demo

Enjoy it !


Jiba -- Jean-Baptiste LAMY -- jiba@tuxfamily.org
                              http://oomadness.tuxfamily.org