https://github.com/malthe/django-process-tools

Process-based WSGI application host for Django.
https://github.com/malthe/django-process-tools

Last synced: 15 days 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 14 years ago)
• Default Branch: master
• Last Pushed: 2010-04-27T12:30:18.000Z (over 14 years ago)
• Last Synced: 2024-10-22T20:22:52.372Z (2 months ago)
• Language: Python
• Homepage:
• Size: 105 KB
• Stars: 1
• Watchers: 2
• 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.