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
====
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
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.12.tar.gz
(28.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
toga-0.2.12-py3-none-any.whl
(4.3 kB
view details)
File details
Details for the file toga-0.2.12.tar.gz.
File metadata
- Download URL: toga-0.2.12.tar.gz
- Upload date:
- Size: 28.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
afac1fbf327cb530d4fe35ff48fea36cb822ccb6d021f4134537c906a0f77bf5
|
|
| MD5 |
20a27b5a44464feb9e9c5bd70452efc4
|
|
| BLAKE2b-256 |
58ecfdefead8b0057b6f45a056471e65faad3776758c017e66951a6eb1e84472
|
File details
Details for the file toga-0.2.12-py3-none-any.whl.
File metadata
- Download URL: toga-0.2.12-py3-none-any.whl
- Upload date:
- Size: 4.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
78ab73df3471cfa76107aa13cf32329a5080940ed690b641977bb1dbe33aab61
|
|
| MD5 |
9b66434f226d0a04afe1e2f94e3469fa
|
|
| BLAKE2b-256 |
5643495155a1085d302e34f2eb05f27f48fabebdf9cafbe17effbd07964b7e48
|
