Skip to main content

A Python native, OS native GUI toolkit.

Project description

Toga
====

A Python native, OS native GUI toolkit.

Prerequisites
~~~~~~~~~~~~~

Minimum requirements
^^^^^^^^^^^^^^^^^^^^

* Toga requires **Python 3**. Python 2 is not supported.

* If you're on macOS, you need to be on 10.7 (Lion) or newer.

* If you're on Linux, you need to have GTK+ 3.10 or later. This is the version
that ships starting with Ubuntu 14.04 and Fedora 20. You also need to install
the Python 3 bindings to GTK+.

* We're working on Windows support, but not all features and widgets are supported. At a minimum, you'll need Python 3 and .NET Framework 4. This has been tested on Windows 10, but should work on 7 and 8. Pull requests, help and corrections are most welcome.

Optional extras
^^^^^^^^^^^^^^^

If you want to use the WebView widget, you'll
also need to have WebKit, plus the GI bindings to WebKit installed. This means
you'll need to install the following:
* **Ubuntu 14.04** ``apt-get install python3-gi gir1.2-webkit-3.0``

* **Ubuntu 16.04 / Debian 8** ``apt-get install python3-gi gir1.2-webkit-4.0``
or ``apt-get install python3-gi gir1.2-webkit-3.0``

* **Fedora** ``dnf install python3-gobject pywebkitgtk``
or ``yum install python3-gobject pywebkitgtk``

Other distros should be similar, but feel free to send a pull request with updated dependencies if needed.

If these requirements aren't met, Toga either won't work at all, or won't have
full functionality.

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.

Documentation
~~~~~~~~~~~~~

Documentation for Toga can be found on `Read The Docs`_.

Community
~~~~~~~~~~~~~

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

* `@pybeeware on Twitter`_

* The `pybee/general`_ channel on Gitter.

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`_.

.. _BeeWare suite: http://pybee.org
.. _Read The Docs: https://toga.readthedocs.io
.. _@pybeeware on Twitter: https://twitter.com/pybeeware
.. _pybee/general: https://gitter.im/pybee/general
.. _log them on Github: https://github.com/pybee/toga/issues
.. _fork the code: https://github.com/pybee/toga
.. _submit a pull request: https://github.com/pybee/toga/pulls


Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

toga-0.2.9.tar.gz (28.9 kB view details)

Uploaded Source

Built Distribution

toga-0.2.9-py3-none-any.whl (4.3 kB view details)

Uploaded Python 3

File details

Details for the file toga-0.2.9.tar.gz.

File metadata

  • Download URL: toga-0.2.9.tar.gz
  • Upload date:
  • Size: 28.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for toga-0.2.9.tar.gz
Algorithm Hash digest
SHA256 db529624605b8573e69234c2badbfc18ad5708dde6dcd838ab61f7e920f345b0
MD5 df2424b0e280c17a11e3be5ce7e57b5d
BLAKE2b-256 f495ea0582f838b7951c09721d9aadc2a0c366206057f52d359130d50454dd3f

See more details on using hashes here.

File details

Details for the file toga-0.2.9-py3-none-any.whl.

File metadata

File hashes

Hashes for toga-0.2.9-py3-none-any.whl
Algorithm Hash digest
SHA256 69ed3a894d66616109e419f5e139666ecf2386da1cdf3127d9b473b66e28c7c3
MD5 13812d4a4f8c328f9971ad29fea1073c
BLAKE2b-256 638855b526d6e081a4c827f90839227c656166895d15fb159effad932eea3a87

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page