Metadata-Version: 2.1
Name: toga
Version: 0.3.0.dev12
Summary: A Python native, OS native GUI toolkit.
Home-page: https://beeware.org/project/projects/libraries/toga/
Author: Russell Keith-Magee
Author-email: russell@keith-magee.com
License: New BSD
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Widget Sets
Requires-Dist: toga-cocoa (==0.3.0.dev12) ; sys_platform=="darwin"
Requires-Dist: toga-gtk (==0.3.0.dev12) ; sys_platform=="linux"
Requires-Dist: toga-winforms (==0.3.0.dev12) ; sys_platform=="win32"

.. image:: https://beeware.org/project/projects/libraries/toga/toga.png
    :width: 72px
    :target: https://beeware.org/toga

Toga
====

.. image:: https://img.shields.io/badge/python-3.5%2C%203.6%2C%203.7-blue.svg
    :target: https://pypi.python.org/pypi/toga

.. image:: https://img.shields.io/pypi/v/toga.svg
    :target: https://pypi.python.org/pypi/toga

.. image:: https://img.shields.io/pypi/status/toga.svg
    :target: https://pypi.python.org/pypi/toga

.. image:: https://img.shields.io/pypi/l/toga.svg
    :target: https://github.com/beeware/toga/blob/master/LICENSE

.. image:: https://beekeeper.beeware.org/projects/beeware/toga/shield
    :target: https://beekeeper.beeware.org/projects/beeware/toga

.. image:: https://badges.gitter.im/beeware/general.svg
    :target: https://gitter.im/beeware/general


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:

* `@pybeeware on Twitter`_

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

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

.. _BeeWare suite: https://beeware.org/
.. _Read The Docs: https://toga.readthedocs.io
.. _@pybeeware on Twitter: https://twitter.com/pybeeware
.. _beeware/general: https://gitter.im/beeware/general
.. _guide for first time contributors: https://toga.readthedocs.io/en/latest/how-to/contribute.html 
.. _log them on Github: https://github.com/beeware/toga/issues
.. _fork the code: https://github.com/beeware/toga
.. _submit a pull request: https://github.com/beeware/toga/pulls
.. _Virtual Environment: https://www.virtualenv.org


