Metadata-Version: 2.0
Name: toga
Version: 0.3.0.dev2
Summary: A Python native, OS native GUI toolkit.
Home-page: http://pybee.org/toga
Author: Russell Keith-Magee
Author-email: russell@keith-magee.com
License: New BSD
Description-Content-Type: UNKNOWN
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.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
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; sys_platform=="darwin"
Requires-Dist: toga-gtk; sys_platform=="linux"
Requires-Dist: toga-winforms; sys_platform=="win32"

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

Toga
====

.. image:: https://img.shields.io/pypi/pyversions/toga.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/pybee/toga/blob/master/LICENSE

.. image:: https://beekeeper.herokuapp.com/projects/pybee/batavia/shield
    :target: https://beekeeper.herokuapp.com/projects/pybee/batavia

.. image:: https://badges.gitter.im/pybee/general.svg
    :target: https://gitter.im/pybee/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 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-webkit2-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`` 

* **Arch Linux** ``pacman -S python-gobject webkit2gtk`` 

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


