Metadata-Version: 2.1
Name: toga-django
Version: 0.3.0.dev33
Summary: A Django backend for the Toga widget toolkit.
Home-page: https://beeware.org/project/projects/libraries/toga/
Author: Russell Keith-Magee
Author-email: russell@keith-magee.com
Maintainer: BeeWare Team
Maintainer-email: team@beeware.org
License: New BSD
Project-URL: Funding, https://beeware.org/contributing/membership/
Project-URL: Documentation, http://toga.readthedocs.io/en/latest/
Project-URL: Tracker, https://github.com/beeware/toga/issues
Project-URL: Source, https://github.com/beeware/toga
Keywords: gui,widget,cross-platform,toga,web,django
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.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
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.6
Description-Content-Type: text/x-rst; charset=UTF-8
License-File: LICENSE
Requires-Dist: django (~=3.0)
Requires-Dist: django-environ (==0.4.1)
Requires-Dist: toga-web (==0.3.0.dev33)

toga-django
===========

A `Django <https://djangoproject.com>`__ backend for the `Toga widget toolkit
<https://beeware.org/toga>`__.

This package isn't much use by itself; it needs to be combined with `the core
Toga library <https://pypi.python.org/pypi/toga-core>`__ and `the Toga Web
library <https://pypi.python.org/pypi/toga-web>`__.

For more details, see the `Toga project on Github
<https://github.com/beeware/toga>`__.

Prerequisites
~~~~~~~~~~~~~

This backend requires Django 3.0 as a minimum requirement.

Usage
~~~~~

Toga Django defines a ``TogaApp`` class that can be used to mount a Toga Web
instance in a Django app. If you have Toga application named `myapp`, Django
deployment is acheived by putting the following into your project's
``urls.py``::

    from django.conf import settings
    from django.conf.urls.static import static
    from django.contrib import admin
    from django.urls import path

    from toga_django import TogaApp

    from tutorial import app

    urlpatterns = [
        path('admin/', admin.site.urls),
        path('/', TogaApp(app).urls),
    ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

This will mount the Toga app at `/`, the Django admin at `/admin`, and serve
static content in debug mode. You can mount the app at any URL you wish,
and you can also add other routes for other views.

The app can then be executed with::

    $ ./manage.py runserver

This assumes a standard Toga app layout, where the application `myapp` has a
submodule `app.py` that defines a `main()` method.

Community
---------

Toga is part of the `BeeWare suite <http://beeware.org>`__. You can talk to the
community through:

* `@pybeeware on Twitter <https://twitter.com/pybeeware>`__

* `Discord <https://beeware.org/bee/chat/>`__

* The Toga `Github Discussions forum <https://github.com/beeware/toga/discussions>`__

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

If you experience problems with this backend, `log them on GitHub
<https://github.com/beeware/toga/issues>`_. If you want to contribute code,
please `fork the code <https://github.com/beeware/toga>`__ and `submit a pull
request <https://github.com/beeware/toga/pulls>`_.


