Metadata-Version: 1.1
Name: toga
Version: 0.3.0.dev14
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
Description: .. 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
        
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
