{ "info": { "author": "Espen Angell Kristiansen", "author_email": "UNKNOWN", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "#################\ndjangosenchatools\n#################\n\nDjango management commands for the JSBuilder commands in `Sencha SDK Tools`_.\nUnfortunately, the JSBuilder commands provided by Sencha Tools needs some\nworkarounds to work when the HTML document and resources are not in the same\ndirectory. We have turned these workarounds into a Django management command\navailable in the *djangosenchatools* app.\n\n\nIssues/contribute\n=================\n\nReport any issues at the `github project page `_, and feel free\nto add your own guides/experiences to the wiki, and to contribute changes using\npull requests.\n\n\nInstall\n=======\n\nInstall the python package::\n\n $ pip install djangosenchatools\n\n\nAdd it to your django project::\n\n INSTALLED_APPS = [\n ...\n 'djangosenchatools'\n ]\n\n\nUsage\n=====\n\nFirst, we need a Django ExtJS4 application. See `django_extjs4_examples`_ for\nan example application. We use the ``minimal_extjs4_app`` as our example.\n\n.. note:: The ``senchatoolsbuild`` management command runs ``collectstatic``.\n\n.. note:: You need to run the Django server (``manage.py runserver``) for all commands except --listall.\n\n\nBuild one app\n-------------\n\nRun::\n\n $ python manage.py senchatoolsbuild --url http://localhost:8000/minimal_extjs4_app/ --outdir /path/to/outdir\n\nWith ``--url`` and ``--outdir``, the senchatoolsbuild command runs ``sencha\ncreate jsb`` and ``sencha build``, and puts the result in the ``--outdir``.\nRun with ``-v3`` for full debug output if you want to see what the command does.\n\n\nBuild all INSTALLED_APPS\n------------------------\n\n``senchatoolsbuild`` can autodetect sencha apps and build them all in their\nrespective static directories. Run with ``--help`` and see the help for\n``--buildall`` to see how apps are detected.\n\nTo list detected apps, their ``--outdir`` and ``--url``, run::\n\n $ python manage.py senchatoolsbuild --listall\n\nAdd ``-v3`` to see skipped apps, and why they are skipped.\n\nTo build all detected apps, run::\n\n $ python manage.py senchatoolsbuild --buildall\n\n\nBuild one app by name\n---------------------\n\nYou can build a single app in ``INSTALLED_APPS`` using the same method of\ndetecting outdir and url as ``--buildall`` using ``--app``::\n\n $ python manage.py senchatoolsbuild --app minimal_extjs4_app\n\n\nUsing --watch\n-------------\n\nUse ``--watch`` to automatically rebuild on file changes:\n\n $ python manage.py senchatoolsbuild --app minimal_extjs4_app --watch /path/to/directory/containing/minimal_extjs4_app\n\nUse ``-v2`` for debug out. By default, only ``*.js``-files trigger rebuild\nevents, however you can change this using these settings (shown with their defaults):\n\n #: Files to include\n DJANGOSENCHATOOLS_WATCH_INCLUDE = ['*.js']\n \n #: Files to exclude\n #: - Matched after INCLUDE, so you can include a general pattern, and\n #: exclude specific files or dirs.\n DJANGOSENCHATOOLS_WATCH_EXCLUDE = ['*.*.swp', '*~', '*.pyc', '*.pyo',\n '*app-all.js', '*all-classes.js']\n\n_Note_: All patterns match against the absolute path of the file.\n\n\nIntegration with django_extjs4\n==============================\n\nThis app is made to work with `django_extjs4`_, however they are losely\ncoupled. The only place where you are likely to notice that they work together\nis that ``senchatoolsbuild`` checks that ``settings.EXTJS4_DEBUG==True``. You\ncan disable this check using ``--no-check-settings``.\n\n\nBuilding apps that require authentication\n=========================================\n\nAdd the following to your ``settings.py``::\n\n MIDDLEWARE_CLASSES += ['djangosenchatools.auth.SettingUserMiddleware']\n AUTHENTICATION_BACKENDS = ('djangosenchatools.auth.SettingUserBackend',)\n SENCHATOOLS_USER = 'myuser'\n\nWhere ``SENCHATOOLS_USER`` is the user that you want to be authenticated as\n(the user must exist). **NEVER** use this backend/middleware in production.\n\n\nReccommended setup\n------------------\n\nWe reccommend that you create a separate settings.py for ``senchatoolsbuild``\nwhere you set the required settings. Here is our ``djangosenchatools_settings.py``::\n\n from settings import *\n EXTJS4_DEBUG = True\n MIDDLEWARE_CLASSES += ['djangosenchatools.auth.SettingUserMiddleware']\n AUTHENTICATION_BACKENDS = ('djangosenchatools.auth.SettingUserBackend',)\n SENCHATOOLS_USER = 'grandma'\n\nWe use this settings module whenever we build apps using ``senchatoolsbuild``::\n\n $ python manage.py senchatoolsbuild --buildall --settings djangosenchatools_settings\n\n\n.. _`Sencha SDK Tools`: http://www.sencha.com/products/sdk-tools\n.. _`django_extjs4`: https://github.com/espenak/django_extjs4\n.. _`django_extjs4_examples`: https://github.com/espenak/django_extjs4_examples\n.. _`djangosenchatools`: https://github.com/espenak/djangosenchatools", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/espenak/djangosenchatools", "keywords": null, "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "djangosenchatools", "package_url": "https://pypi.org/project/djangosenchatools/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/djangosenchatools/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/espenak/djangosenchatools" }, "release_url": "https://pypi.org/project/djangosenchatools/1.0.5/", "requires_dist": null, "requires_python": null, "summary": "Django management command to simplify building extjs and sencha touch apps with Sencha tools.", "version": "1.0.5" }, "last_serial": 791172, "releases": { "1.0.3": [ { "comment_text": "", "digests": { "md5": "d198a2379323123cab996e65b8372e9e", "sha256": "6ef1399718a0561f47983eb16c65a8de3ecfe3de2e1cff6ba7076382a6dc208c" }, "downloads": -1, "filename": "djangosenchatools-1.0.3.tar.gz", "has_sig": false, "md5_digest": "d198a2379323123cab996e65b8372e9e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6023, "upload_time": "2012-04-22T20:22:25", "url": "https://files.pythonhosted.org/packages/89/3b/abcd4d1e0f25398504f001d25ea36ddcf64486628156e9f0b279054c653d/djangosenchatools-1.0.3.tar.gz" } ], "1.0.4": [ { "comment_text": "", "digests": { "md5": "6cd91f060ecd371d29ab754713c22911", "sha256": "e75201744281fb772651ce07b389ae34358b28c445d852531c9ba919797e283b" }, "downloads": -1, "filename": "djangosenchatools-1.0.4.tar.gz", "has_sig": false, "md5_digest": "6cd91f060ecd371d29ab754713c22911", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6893, "upload_time": "2012-04-23T00:10:54", "url": "https://files.pythonhosted.org/packages/4a/95/bfb6138e0ef58dfca4ad9d5e15116ef10a4ec716b9528b3fc5c9ecf5024d/djangosenchatools-1.0.4.tar.gz" } ], "1.0.5": [ { "comment_text": "", "digests": { "md5": "fad5a5667fb8912e9319c6f7453ffd44", "sha256": "ff83fecb41b30684dd6d09d27dde1105e89a68a664181677ffbafd0bb26bbe62" }, "downloads": -1, "filename": "djangosenchatools-1.0.5.tar.gz", "has_sig": false, "md5_digest": "fad5a5667fb8912e9319c6f7453ffd44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8957, "upload_time": "2012-12-07T10:13:45", "url": "https://files.pythonhosted.org/packages/76/11/d483f60c77e6c8fc7a119baa7355d29f50d84c900e478ac99e8d51aa2dc1/djangosenchatools-1.0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "fad5a5667fb8912e9319c6f7453ffd44", "sha256": "ff83fecb41b30684dd6d09d27dde1105e89a68a664181677ffbafd0bb26bbe62" }, "downloads": -1, "filename": "djangosenchatools-1.0.5.tar.gz", "has_sig": false, "md5_digest": "fad5a5667fb8912e9319c6f7453ffd44", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8957, "upload_time": "2012-12-07T10:13:45", "url": "https://files.pythonhosted.org/packages/76/11/d483f60c77e6c8fc7a119baa7355d29f50d84c900e478ac99e8d51aa2dc1/djangosenchatools-1.0.5.tar.gz" } ] }