File: README

package info (click to toggle)
kiwi 1.9.22-1
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 11,908 kB
  • ctags: 5,549
  • sloc: python: 15,779; ansic: 193; xml: 77; makefile: 57; sh: 17
file content (96 lines) | stat: -rw-r--r-- 3,263 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
Kiwi: A Framework for developing graphical applications in Python.

Kiwi is a framework composed of a set of modules, which eases Python
development using PyGTK. Kiwi makes graphical applications *much* faster
to code, with good architecture and more Python-like bindings; it also
offers extended widgets based upon the original PyGTK widgets.

* Requirements

    - GTK+ 2.6.x      ftp://ftp.gtk.org/pub/gtk/v2.6/
    - PyGTK 2.6.x     ftp://ftp.gtk.org/pub/gtk/python/v2.6/
    - Python > 2.3    http://www.python.org/download/

  Optional

    - gazpacho > 0.6.5   http://ftp.gnome.org/pub/GNOME/sources/gazpacho/
    - zope.interfaces    http://www.zope.org/Products/ZopeInterface
    - sqlobject > 0.6.0  http://www.sqlobject.org/

  Some features of the ui test framework requires PyGObject 2.10.0 or higher
  to function properly. It'll work without but some features are disabled.

* Installation

    To install (having made sure that the dependencies are installed and
    working) do (as root normally):

        python setup.py install

    (You can optionally provide a prefix using the following form,
    but if you do remember to setup PYTHONPATH accordingly)

        python setup.py install [--prefix=<prefix>]

* Documentation

    Included in doc/howto/ and doc/api/ are HTML versions of the
    developer's guide and API reference, respectively. You can also
    browse the online versions at:

        - Developer's guide: http://www.async.com.br/projects/kiwi/howto/
        - API documentation: http://www.async.com.br/projects/kiwi/api/

    The developer's guide is available in compressed PostScript format from:

        http://www.async.com.br/projects/kiwi/howto.ps.gz

    You can regenerate all the documentation; just see doc/Makefile.
    To generate the API docs you will need:

        - epydoc                        http://epydoc.sf.net/

    To generate the developer's guide you will need:

        - Python source (the tarball)   http://www.python.org/download/
        - LaTeX                         (various distributions)
        - latex2html    http://saftsack.fs.uni-bayreuth.de/~latex2ht/current/
        - GhostScript                   http://www.cs.wisc.edu/~ghost/
        - NetPBM (for latex2html)       http://netbpm.sf.net/

* Directory Layout

    examples/

        Contains a number of examples, most of which are referenced in
        the documentation.

    kiwi/

        Contains the module code itself; this is installed into your
        Python's site-packages directory by setup.py.

    doc/

        Contains documentation for Kiwi, including the LaTeX source code
        which can be used to rebuild the docs. doc/Makefile contains
        commands to regenerate the full set of docs.

    extra/

        Contains patches to GTK+ and PyGTK code, and helper scripts that
        can be used to accelerate certain tasks.

    tests/

        Contains a number of test cases for the Kiwi widgets and
        framework. All checkins and additions of new code should be
        preceded by a working testcase.

* Contact info:

    URL and download: http://www.async.com.br/projects/kiwi/

    Maintainer: Johan Dahlin <jdahlin@async.com.br>
    Original author: Christian Reis <kiko@async.com.br>