toga 0.1.1

A Python native, OS native GUI toolkit.

A Python native, OS native GUI toolkit.

Quickstart

To get a demonstration of the capabilities of Toga, run the following:

$ pip install toga-demo
$ toga-demo

This will pop up a GUI window with some sample widgets.

Problems using virtualenv under Linux

When running under Linux, Toga uses the system native python GTK+3 bindings for display purposes. However, if you’re using a –no-site-packages virtualenv, the Python bindings for GTK won’t be in your PYTHONPATH.

Unfortunately, you can’t pip install GTK+ bindings, so you have to use a workaround. To make the system GTK+ bindings available to your virtualenv, symlinking the gi module from the system dist-packages directory into your virtualenv’s site-packages:

$ cd $VIRTUAL_ENV/lib/python2.7/site-packages
$ ln -si /usr/lib/python2.7/dist-packages/gi

Documentation

Documentation for Toga can be found on Read The Docs.

Related projects

This package is a top level package. It depends on the use of platform-specific backends to provide real functionality:

• toga-cocoa: for OS/X

• toga-gtk: GTK+ backend for Linux desktops

• toga-win32: for Windows desktops (limited support)

• toga-iOS: for iOS devices (iPhone, iPad, iPod)

• toga-android: for Android devices (limited support)

Community

Toga is part of the BeeWare suite. You can talk to the community through:

• @pybeeware on Twitter

• The BeeWare Users Mailing list, for questions about how to use the BeeWare suite.

• The BeeWare Developers Mailing list, for discussing the development of new features in the BeeWare suite, and ideas for new tools for the suite.

Contributing

If you experience problems with Toga, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.