A Django backend for the Toga widget toolkit.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for freakboy3742 from gravatar.com freakboy3742

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: BSD License (New BSD)
  • Author: Russell Keith-Magee
  • Maintainer: BeeWare Team
  • Tags gui, widget, cross-platform, toga, web, django
  • Requires: Python >=3.6
Classifiers
Report project as malware

Project description

A Django backend for the Toga widget toolkit.

This package isn’t much use by itself; it needs to be combined with the core Toga library and the Toga Web library.

For more details, see the Toga project on Github.

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. You can talk to the community through:

Contributing

If you experience problems with this backend, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page