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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
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.22.x ftp://ftp.gtk.org/pub/gtk/v2.22/
- PyGTK 2.22.x ftp://ftp.gtk.org/pub/gtk/python/
- Python >= 2.6 http://www.python.org/download/
Optional
- 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>]
You can also fetch the latest source code from github:
$ git clone github.com/jdahlin/kiwi.git
* Contribute
We use gerrit to control the Kiwi development:
http://gerrit.async.com.br/
Create an account there and submit your patches via:
$ git push git+ssh://$USERNAME@gerrit.async.com.br:29418/kiwi
* 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>
|