Metadata-Version: 2.4
Name: toga-core
Version: 0.5.2
Summary: A Python native, OS native GUI toolkit.
Author-email: Russell Keith-Magee <russell@keith-magee.com>
Maintainer-email: BeeWare Team <team@beeware.org>
License-Expression: BSD-3-Clause
Project-URL: Homepage, https://beeware.org/project/projects/libraries/toga/
Project-URL: Funding, https://beeware.org/contributing/membership/
Project-URL: Documentation, https://toga.readthedocs.io/
Project-URL: Tracker, https://github.com/beeware/toga/issues
Project-URL: Source, https://github.com/beeware/toga
Project-URL: Changelog, https://toga.readthedocs.io/en/stable/background/project/releases.html
Keywords: gui,widget,cross-platform,toga,desktop,mobile,web,macOS,cocoa,iOS,android,windows,winforms,linux,freeBSD,gtk,console,web
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: User Interfaces
Classifier: Topic :: Software Development :: Widget Sets
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: travertino==0.5.2
Provides-Extra: dev
Requires-Dist: coverage[toml]==7.9.2; extra == "dev"
Requires-Dist: coverage-conditional-plugin==0.9.0; extra == "dev"
Requires-Dist: Pillow==11.3.0; extra == "dev"
Requires-Dist: pre-commit==4.2.0; extra == "dev"
Requires-Dist: pytest==8.4.1; extra == "dev"
Requires-Dist: pytest-asyncio==1.0.0; extra == "dev"
Requires-Dist: pytest-freezer==0.4.9; extra == "dev"
Requires-Dist: pytest-xdist==3.8.0; extra == "dev"
Requires-Dist: setuptools-scm==8.3.1; extra == "dev"
Requires-Dist: tox==4.27.0; extra == "dev"
Requires-Dist: typing-extensions==4.12.2; python_version < "3.10" and extra == "dev"
Provides-Extra: docs
Requires-Dist: furo==2024.8.6; extra == "docs"
Requires-Dist: Pillow==11.3.0; extra == "docs"
Requires-Dist: pyenchant==3.2.2; extra == "docs"
Requires-Dist: sphinx==8.2.3; extra == "docs"
Requires-Dist: sphinx_tabs==3.4.5; extra == "docs"
Requires-Dist: sphinx-autobuild==2024.10.3; extra == "docs"
Requires-Dist: sphinx-csv-filter==0.4.2; extra == "docs"
Requires-Dist: sphinx-copybutton==0.5.2; extra == "docs"
Requires-Dist: sphinx-toolbox==4.0.0; extra == "docs"
Requires-Dist: sphinxcontrib-spelling==8.0.1; extra == "docs"
Dynamic: license-file
Dynamic: requires-dist

.. |pyversions| image:: https://img.shields.io/pypi/pyversions/toga-core.svg
    :target: https://pypi.python.org/pypi/toga-core
    :alt: Python Versions

.. |license| image:: https://img.shields.io/pypi/l/toga-core.svg
    :target: https://github.com/beeware/toga-core/blob/main/LICENSE
    :alt: BSD-3-Clause License

.. |maturity| image:: https://img.shields.io/pypi/status/toga-core.svg
    :target: https://pypi.python.org/pypi/toga-core
    :alt: Project status

Toga
====

|pyversions| |license| |maturity|

A Python native, OS native GUI toolkit.

This package provides the core Toga API. In order to use Toga, you'll also need to
install a backend that implements the core Toga API for that platform:

* **Android** `toga-android <https://pypi.org/project/toga-android>`__
* **iOS** `toga-iOS <https://pypi.org/project/toga-iOS>`__
* **Linux** `toga-gtk <https://pypi.org/project/toga-gtk>`__
* **macOS** `toga-cocoa <https://pypi.org/project/toga-cocoa>`__
* **Textual** `toga-textual <https://pypi.org/project/toga-textual>`__
* **Web** `toga-web <https://pypi.org/project/toga-web>`__
* **Windows** `toga-winforms <https://pypi.org/project/toga-winforms>`__

Minimum requirements
--------------------

Each backend has specific requirements and pre-requisites. See the `platform
documentation <https://toga.readthedocs.io/en/latest/reference/platforms/>`__ for
details.

Quickstart
----------

To get a demonstration of the capabilities of Toga, run the following::

    $ python -m 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`_.

.. _Read The Docs: https://toga.readthedocs.io

Community
---------

Toga is part of the `BeeWare suite`_. You can talk to the community through:

* `@beeware@fosstodon.org on Mastodon`_
* `Discord`_
* The Toga `GitHub Discussions forum`_

We foster a welcoming and respectful community as described in our
`BeeWare Community Code of Conduct`_.

.. _BeeWare suite: https://beeware.org
.. _@beeware@fosstodon.org on Mastodon: https://fosstodon.org/@beeware
.. _Discord: https://beeware.org/bee/chat/
.. _GitHub Discussions forum: https://github.com/beeware/toga/discussions
.. _BeeWare Community Code of Conduct: https://beeware.org/community/behavior/

Contributing
------------

If you experience problems with Toga, `log them on GitHub
<https://github.com/beeware/toga/issues>`__.

If you'd like to contribute to Toga development, our `contribution guide
<https://toga.readthedocs.io/en/latest/how-to/contribute/index.html>`__
details how to set up a development environment, and other requirements we have
as part of our contribution process.
