====
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
Metadata
Release files for toga 0.2.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| toga-0.2.12.tar.gz | 28.9 kB | Without provenance | Details for toga-0.2.12.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| toga-0.2.12-py3-none-any.whl | Python 3 | none | any | Details for toga-0.2.12-py3-none-any.whl |
Total release size: 33.2 kB
Release files / toga-0.2.12.tar.gz
| Download URL | toga-0.2.12.tar.gz |
|---|---|
| Size | 28.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
afac1fbf327cb530d4fe35ff48fea36cb822ccb6d021f4134537c906a0f77bf5
|
|
BLAKE2b-256 checksum How to use checksums |
58ecfdefead8b0057b6f45a056471e65faad3776758c017e66951a6eb1e84472
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / toga-0.2.12-py3-none-any.whl
| Download URL | toga-0.2.12-py3-none-any.whl |
|---|---|
| Size | 4.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
78ab73df3471cfa76107aa13cf32329a5080940ed690b641977bb1dbe33aab61
|
|
BLAKE2b-256 checksum How to use checksums |
5643495155a1085d302e34f2eb05f27f48fabebdf9cafbe17effbd07964b7e48
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for toga 0.2.12
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.