Skip to main content

A Python native, OS native GUI toolkit.

Project description

https://beeware.org/project/projects/libraries/toga/toga.png

Toga

https://img.shields.io/badge/python-3.5%2C%203.6%2C%203.7-blue.svg https://img.shields.io/pypi/v/toga.svg https://img.shields.io/pypi/status/toga.svg https://img.shields.io/pypi/l/toga.svg https://beekeeper.beeware.org/projects/beeware/toga/shield https://badges.gitter.im/beeware/general.svg

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 and development files for GTK+.

    • Ubuntu / Debian sudo apt-get install python3-dev python3-gi python3-gi-cairo gir1.2-gtk-3.0 libgirepository1.0-dev libcairo2-dev

    • Fedora sudo dnf install pygobject3 python3-gobject python3-cairo-devel cairo-gobject-devel gobject-introspection-devel or sudo yum install pygobject3 python3-gobject python3-cairo-devel cairo-gobject-devel gobject-introspection-devel

    • Arch Linux sudo pacman -S gobject-introspection

  • 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 for Linux

In Linux, extra packages are needed if you want to use the WebView widget:

  • Ubuntu / Debian sudo apt-get install gir1.2-webkit2-4.0 Note: for Ubuntu 14.04 install gir1.2-webkit-3.0 instead of gir1.2-webkit-4.0

  • Fedora sudo dnf install pywebkitgtk or sudo yum install pywebkitgtk

  • Arch Linux sudo pacman -S webkit2gtk

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:

Contributing

If you’d like to contribute to Toga development, our guide for first time contributors will help you get started.

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.

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.3.0.dev13.tar.gz (47.1 kB view details)

Uploaded Source

Built Distribution

toga-0.3.0.dev13-py3-none-any.whl (3.6 kB view details)

Uploaded Python 3

File details

Details for the file toga-0.3.0.dev13.tar.gz.

File metadata

  • Download URL: toga-0.3.0.dev13.tar.gz
  • Upload date:
  • Size: 47.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.0.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.0

File hashes

Hashes for toga-0.3.0.dev13.tar.gz
Algorithm Hash digest
SHA256 8e713407c4735a43b093e04dffd666b1f5420ed73a9fb563ff8c7846f9adca91
MD5 bc9b20a647253488afaaf0525270f375
BLAKE2b-256 aa47f1266caff17638a6758caa9290fe5704158dda69d4c709382166a8ffe163

See more details on using hashes here.

File details

Details for the file toga-0.3.0.dev13-py3-none-any.whl.

File metadata

  • Download URL: toga-0.3.0.dev13-py3-none-any.whl
  • Upload date:
  • Size: 3.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.0.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.0

File hashes

Hashes for toga-0.3.0.dev13-py3-none-any.whl
Algorithm Hash digest
SHA256 6a277257c9ef0638dd71c4665b98309d3db587459557da19899747d3caf21fea
MD5 ddea210e661a5bb1e2e12474072e663b
BLAKE2b-256 ed9afb2cf5e51a677f4bb41d321d4dabf96b365e262d836e85552f607a44b293

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