Initial commit

CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing
+
+BeeWare <3's contributions!
+
+Please be aware, BeeWare operates under a Code of Conduct.
+
+See [CONTRIBUTING to BeeWare](https://beeware.org/contributing/) for details.

LICENSE

@@ -0,0 +1,27 @@
+Copyright (c) 2014 Russell Keith-Magee.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of Toga nor the names of its contributors may
+       be used to endorse or promote products derived from this software without
+       specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.1
+Name: toga-core
+Version: 0.4.8
+Summary: A Python native, OS native GUI toolkit.
+Author-email: Russell Keith-Magee <[email protected]>
+Maintainer-email: BeeWare Team <[email protected]>
+License: New BSD
+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: License :: OSI Approved :: BSD License
+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.3.0
+Requires-Dist: importlib_metadata>=4.4.0; python_version <= "3.9"
+Provides-Extra: dev
+Requires-Dist: coverage[toml]==7.6.2; extra == "dev"
+Requires-Dist: coverage-conditional-plugin==0.9.0; extra == "dev"
+Requires-Dist: Pillow==10.4.0; extra == "dev"
+Requires-Dist: pre-commit==4.0.1; extra == "dev"
+Requires-Dist: pytest==8.3.3; extra == "dev"
+Requires-Dist: pytest-asyncio==0.24.0; extra == "dev"
+Requires-Dist: pytest-freezer==0.4.8; extra == "dev"
+Requires-Dist: setuptools-scm==8.1.0; extra == "dev"
+Requires-Dist: tox==4.21.2; 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==10.4.0; extra == "docs"
+Requires-Dist: pyenchant==3.2.2; extra == "docs"
+Requires-Dist: sphinx==8.1.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==3.8.1; extra == "docs"
+Requires-Dist: sphinxcontrib-spelling==8.0.0; extra == "docs"
+
+Toga
+====
+
+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
+--------------------
+
+Toga requires **Python 3.9** or newer.
+
+Each backend also has specific requirements and pre-requisites. See the `platform
+documentation <https://toga.readthedocs.io/en/latest/reference/platforms.html>`__ 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:
+
+* `@[email protected] 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
+.. _@[email protected] 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'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`_.
+
+.. _guide for first time contributors: https://toga.readthedocs.io/en/latest/how-to/contribute/index.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

pyproject.toml

@@ -0,0 +1,129 @@
+[build-system]
+requires = [
+    "setuptools==75.1.0",
+    "setuptools_scm==8.1.0",
+    "setuptools_dynamic_dependencies @ git+https://github.com/beeware/setuptools_dynamic_dependencies",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+dynamic = ["version"]
+name = "toga-core"
+description = "A Python native, OS native GUI toolkit."
+readme = "README.rst"
+requires-python = ">= 3.9"
+license.text = "New BSD"
+authors = [
+    {name="Russell Keith-Magee", email="[email protected]"},
+]
+maintainers = [
+    {name="BeeWare Team", email="[email protected]"},
+]
+keywords = [
+    "gui",
+    "widget",
+    "cross-platform",
+    "toga",
+    "desktop",
+    "mobile",
+    "web",
+    "macOS",
+    "cocoa",
+    "iOS",
+    "android",
+    "windows",
+    "winforms",
+    "linux",
+    "freeBSD",
+    "gtk",
+    "console",
+    "web",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Software Development :: Widget Sets",
+]
+dependencies = [
+    "travertino >= 0.3.0",
+    # limited to <=3.9 for the `group` argument for `entry_points()`
+    "importlib_metadata >= 4.4.0; python_version <= '3.9'",
+]
+
+[project.optional-dependencies]
+# Extras used by developers *of* Toga are pinned to specific versions to
+# ensure environment consistency.
+dev = [
+    "coverage[toml] == 7.6.2",
+    "coverage-conditional-plugin == 0.9.0",
+    "Pillow == 10.4.0",
+    "pre-commit == 4.0.1",
+    "pytest == 8.3.3",
+    "pytest-asyncio == 0.24.0",
+    "pytest-freezer == 0.4.8",
+    "setuptools-scm == 8.1.0",
+    "tox == 4.21.2",
+    # typing-extensions needed for TypeAlias added in Py 3.10
+    "typing-extensions == 4.12.2 ; python_version < '3.10'",
+]
+# Docs are always built on a specific Python version; see RTD and tox config files,
+# and the docs contribution guide.
+docs = [
+    "furo == 2024.8.6",
+    "Pillow == 10.4.0",
+    "pyenchant == 3.2.2",
+    "sphinx == 8.1.3",
+    "sphinx_tabs == 3.4.5",
+    "sphinx-autobuild == 2024.10.3",
+    "sphinx-csv-filter == 0.4.2",
+    "sphinx-copybutton == 0.5.2",
+    "sphinx-toolbox == 3.8.1",
+    "sphinxcontrib-spelling == 8.0.0",
+]
+
+[project.urls]
+Homepage = "https://beeware.org/project/projects/libraries/toga/"
+Funding = "https://beeware.org/contributing/membership/"
+Documentation = "https://toga.readthedocs.io/"
+Tracker = "https://github.com/beeware/toga/issues"
+Source = "https://github.com/beeware/toga"
+Changelog = "https://toga.readthedocs.io/en/stable/background/project/releases.html"
+
+[project.entry-points."toga.image_formats"]
+pil = "toga.plugins.image_formats.PILConverter"
+
+[tool.setuptools_scm]
+root = ".."
+
+[tool.coverage.run]
+parallel = true
+branch = true
+relative_files = true
+
+# See notes in the root pyproject.toml file.
+source = ["src"]
+source_pkgs = ["toga"]
+
+[tool.coverage.paths]
+source = [
+    "src/toga",
+    "**/toga",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+filterwarnings = [
+    "error",
+]

setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+