djangosenchatools

Django management commands for the JSBuilder commands in Sencha SDK Tools. Unfortunately, the JSBuilder commands provided by Sencha Tools needs some workarounds to work when the HTML document and resources are not in the same directory. We have turned these workarounds into a Django management command available in the djangosenchatools app.

Issues/contribute

Report any issues at the github project page, and feel free to add your own guides/experiences to the wiki, and to contribute changes using pull requests.

Install

Install the python package:

$ pip install djangosenchatools

Add it to your django project:

INSTALLED_APPS = [
    ...
    'djangosenchatools'
]

Usage

First, we need a Django ExtJS4 application. See django_extjs4_examples for an example application. We use the minimal_extjs4_app as our example.

Build one app

Run:

$ python manage.py senchatoolsbuild --url http://localhost:8000/minimal_extjs4_app/ --outdir /path/to/outdir

With --url and --outdir, the senchatoolsbuild command runs sencha create jsb and sencha build, and puts the result in the --outdir. Run with -v3 for full debug output if you want to see what the command does.

Build all INSTALLED_APPS

senchatoolsbuild can autodetect sencha apps and build them all in their respective static directories. Run with --help and see the help for --buildall to see how apps are detected.

To list detected apps, their --outdir and --url, run:

$ python manage.py senchatoolsbuild --listall

Add -v3 to see skipped apps, and why they are skipped.

To build all detected apps, run:

$ python manage.py senchatoolsbuild --buildall

Build one app by name

You can build a single app in INSTALLED_APPS using the same method of detecting outdir and url as --buildall using --app:

$ python manage.py senchatoolsbuild --app minimal_extjs4_app

Using --watch

Use --watch to automatically rebuild on file changes:

$ python manage.py senchatoolsbuild --app minimal_extjs4_app --watch /path/to/directory/containing/minimal_extjs4_app

Use -v2 for debug out. By default, only *.js-files trigger rebuild events, however you can change this using these settings (shown with their defaults):

#: Files to include DJANGOSENCHATOOLS_WATCH_INCLUDE = ['*.js']

#: Files to exclude #: - Matched after INCLUDE, so you can include a general pattern, and #: exclude specific files or dirs. DJANGOSENCHATOOLS_WATCH_EXCLUDE = ['..swp', '~', '.pyc', '*.pyo',

'*app-all.js', '*all-classes.js']

_Note_: All patterns match against the absolute path of the file.

Integration with django_extjs4

This app is made to work with django_extjs4, however they are losely coupled. The only place where you are likely to notice that they work together is that senchatoolsbuild checks that settings.EXTJS4_DEBUG==True. You can disable this check using --no-check-settings.

Building apps that require authentication

Add the following to your settings.py:

MIDDLEWARE_CLASSES += ['djangosenchatools.auth.SettingUserMiddleware']
AUTHENTICATION_BACKENDS = ('djangosenchatools.auth.SettingUserBackend',)
SENCHATOOLS_USER = 'myuser'

Where SENCHATOOLS_USER is the user that you want to be authenticated as (the user must exist). NEVER use this backend/middleware in production.

Reccommended setup

We reccommend that you create a separate settings.py for senchatoolsbuild where you set the required settings. Here is our djangosenchatools_settings.py:

from settings import *
EXTJS4_DEBUG = True
MIDDLEWARE_CLASSES += ['djangosenchatools.auth.SettingUserMiddleware']
AUTHENTICATION_BACKENDS = ('djangosenchatools.auth.SettingUserBackend',)
SENCHATOOLS_USER = 'grandma'

We use this settings module whenever we build apps using senchatoolsbuild:

$ python manage.py senchatoolsbuild --buildall --settings djangosenchatools_settings