https://github.com/malthe/django-process-tools
Process-based WSGI application host for Django.
https://github.com/malthe/django-process-tools
Last synced: 5 months ago
JSON representation
Process-based WSGI application host for Django.
- Host: GitHub
- URL: https://github.com/malthe/django-process-tools
- Owner: malthe
- Created: 2010-04-21T15:06:13.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2010-04-27T12:30:18.000Z (over 15 years ago)
- Last Synced: 2025-03-29T06:42:15.824Z (8 months ago)
- Language: Python
- Homepage:
- Size: 105 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Changelog: CHANGES.rst
Awesome Lists containing this project
README
Overview
========
This package enables you to test, manage and run Django applications
in their own process space.
Testing
-------
Simply inherit your test case class from
``dpt.testing.FunctionalTestCase`` instead of ``unittest.TestCase``.
This will cause the testrunner to start a new process and run the test
in isolation. Test results will appear exactly the same.
Note that this will set up the default Django settings environment
``django.conf.global_settings`` with a SQLite in-memory database.
Running an application
----------------------
For a general introduction to PasteDeploy consult its `documentation
`_.
Sample configuration ``deploy.ini``::
[app:my-django-app]
use = egg:django-process-tools#app
settings = %(here)s/settings.py
[composite:main]
use = egg:Paste#urlmap
/ = my-django-app
[server:main]
use = egg:Spawning
host = 0.0.0.0
port = 8080
processes = 4
threadpool_workers = 1
Note the reference to the ``settings.py`` file which in this example
resides in the same directory (the ``here`` variable is substituted
with the local directory).
To run the application we use `PasteScript
`_ with the ``serve`` command::
$ paster serve deploy.ini
Management
----------
The ``manage`` command mimicks Django's ``manage.py`` script. Here's
an example of an invocation of the ``syncdb`` command::
$ paster manage deploy.ini my-django-app syncdb
To show all commands::
$ paster manage deploy.ini my-django-app help
Note that if the application name is ``main`` (this short-hand is used
in general with the Paste system), the command is just::
$ paster manage deploy.ini syncdb
Support
-------
This software is kept in source control: `git repository
`_.
For support please log on to ``irc.freenode.net`` and join
``#repoze``.
License
-------
This software is made available as-is under the BSD license.