summaryrefslogtreecommitdiff
path: root/README
blob: eb7ec8aad70498d7557f90757c65395d4277439b (plain)
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
PyGObject
=====
Original authors:   James Henstridge <james@daa.com.au>
                    Johan Dahlin <johan@gnome.org>

Current maintainers:  Tomeu Vizoso <tomeu.vizoso@collabora.co.uk>
                      Martin Pitt <martinpitt@gnome.org>
                      Paolo Borelli <pborelli@gnome.org>
                      Ignacio Casal Quinteiro <icq@gnome.org>
                      Sebastian Pölsterl <sebp@k-d-w.org>
		      Simon Feltman <sfeltman@gnome.org>


This archive contains bindings for the GLib, and GObject,
to be used in Python. It is a fairly complete set of bindings,
it's already rather useful, and is usable to write moderately
complex programs.  (see the examples directory for some examples
of the simpler programs you could write).

If you have any enhancements or bug reports, please file them in
bugzilla at:
  http://bugzilla.gnome.org/enter_bug.cgi?product=pygobject

If you have a patch, file the bug first and then use the "create new
attachment" link on the bug's info page.  My preferred format for
patches is unified diff format (ie. diff -u).  Please don't send me
diffs which don't have any context, as these make it very difficult to
see what the patch does.

New Versions
============

New versions of this package can be found at:
  http://ftp.gnome.org/pub/GNOME/sources/pygobject/


Mailing list
============

pygobject development is discussed on the GNOME python-hackers mailing list.
You can subscribe to it through the web interface:

  https://mail.gnome.org/mailman/listinfo/python-hackers-list/

Requirements
============
  * C compiler (GCC and MSVC supported)
  * Python 2.7 or higher
  * Glib/Gio 2.38.0 or higher
  * gobject-introspection 1.46.0 or higher
  * libffi (optional)

Copyright Information
=====================

This software is covered by the GNU Lesser General Public Licence
(version 2.1, or if you choose, a later version).  Basically just don't
say you wrote bits you didn't.

Compilation
===========

PyGObject uses the standard autotools for the build infrastructure.  To
build, it should be as simple as running:

    $ ./configure --prefix=<prefix where python is installed>
    $ make
    $ make install

By default, configure searches for a few well-known Python interpreter
names, such as "python3", "python2", "python2.7", or "python".  If your
Python interpreter isn't in the path, or is not called "python", you can
configure pygobject to build against that with --with-python=<path> or
setting the PYTHON environment variable:

   $ ./configure --with-python=python3
   $ PYTHON=python3.2 ./configure
   $ ./configure --with-python=~/my-patched-python/python

If configure can't find GTK+, you may need to set the PKG_CONFIG_PATH
environment variable to help it find the libraries.

The "make install" target will generate normal and optimised bytecode
for all the .py files.

Note. If you're installing to another prefix than the one where python
is installed you'll need to set the PYTHONPATH variable to the
$prefix/lib/pythonX.Y/site-packages directory created by
the PyGObject installation.

Tests
=====

After having compiled and installed pygobject, you may want to test them.
There are a number of example programs available in the examples/
subdirectory.


Getting Help
============

If you have questions about programming with PyGObject, you might want to
check the documentation on

  https://live.gnome.org/PyGObject/

If that does not help, send a message to the mailing list (information on
subscribing is above), or join #python on irc.gnome.org.