Is there a gi.repository documentation for python?


I’m looking for a gi.repository module documentation and I can’t find anything on the internet.
All I found is documentation of new Gtk3 libraries for C, or old PyGtk 2.0 Reference Manual

I’m looking for something like PyGtk 2.0 Reference Manual but for Gtk3.

Is there something similar for Python? (I’m not looking for dir(Gtk) or help(Gtk) in the Python console.)

Asked By: Jan Vorcak



Generally speaking, you should be able to use the C library documentation as your main reference. The naming conversions between the C functions and their Python versions are quite consistent, so it’s straight-forward in most cases. I would not expect to see Python-specific Gtk-via-introspection documentation.

I occasionally had trouble finding, for example, constants at first. In this case, using iPython’s tab-completion to search the Gtk, Gdk and Gobject namespaces was invaluable. There are a few rare cases in which introspection is impossible and, at least in the last version I was working with, they hadn’t been manually implemented (can’t remember exactly which functions), so there’s not much you can do with those; I had to dig into the gi.repository source to verify these cases.

Answered By: user626998

I think you’re looking for this.

It’s a work in progress, but basically is a tutorial for Gtk3 in python. I doesn’t really cover any other thing aside from Gtk widgets (so no Glib, for example), but it’s still useful to get started.

Answered By: jcollado

Give a look at the GNOME Wiki, most of the useful information on Gobject Introspection is there:

Answered By: liberforce

Currently the gi-documentation for python is in development. It will appear in gtk3.4 or later.

You can currently either build it on your own, or use unofficial generated versions like here. But be careful, they can contain information from future versions.

Answered By: Mic92

Yes, I found a site that contains documentations for all python bindings of perhaps all GNOME projects that are supported by the python gi.repository module or the Python GObject Introspection module:

The one specifically for GTK is:

There is also documentation specific to the gi package provided by PyGObject:

I hope you find these links helpful

Answered By: Yomi
Categories: questions Tags: , , ,
Answers are sorted by their score. The answer accepted by the question owner as the best is marked with
at the top-right corner.