Metadata-Version: 1.0
Name: django-nose
Version: 0.1.3
Summary: Django test runner that uses nose.
Home-page: http://github.com/jbalogh/django-nose
Author: Jeff Balogh
Author-email: me@jeffbalogh.org
License: BSD
Description: ============
        Requirements
        ============
        
        This package is most useful when installed with:
        
            * Django 1.2+
            * nose
        
        
        ===========================
        Upgrading from Django < 1.2
        ===========================
        
        Django 1.2 switches to a `class-based test runner`_.  To use ``django-nose``
        with Django 1.2, change your ``TEST_RUNNER`` from ``django_nose.run_tests`` to
        ``django_nose.NoseTestSuiteRunner``.
        
        ``django_nose.run_tests`` will continue to work in Django 1.2, but will raise a
        warning.  In Django 1.3 it will stop working.
        
        If you were using ``django_nose.run_gis_tests``, you should also switch to
        ``django_nose.NoseTestSuiteRunner`` and use one of the `spatial backends`_ in
        your ``DATABASES`` settings.
        
        .. _class-based test runner: http://docs.djangoproject.com/en/dev/releases/1.2/#function-based-test-runners
        .. _spatial backends: http://docs.djangoproject.com/en/dev/ref/contrib/gis/db-api/#id1
        
        
        Installation
        ------------
        
        You can get django-nose from pypi with: ::
        
            pip install django-nose
        
        The development version can be installed with: ::
        
            pip install -e git://github.com/jbalogh/django-nose.git#egg=django-nose
        
        Since django-nose extends Django's built-in test command, you should add it to
        your ``INSTALLED_APPS`` in ``settings.py``: ::
        
            INSTALLED_APPS = (
                ...
                'django_nose',
                ...
            )
        
        Then set ``TEST_RUNNER`` in ``settings.py``: ::
        
            TEST_RUNNER = 'django_nose.NoseTestSuiteRunner'
        
        
        Usage
        -----
        
        See ``./manage.py help test`` for all the options nose provides, and look to
        the `nose docs`_ for more help with nose.
        
        Customization
        -------------
        
        Always Passing The Same Options
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        To always set the same command line options you can use a `nose.cfg or
        setup.cfg`_ (as usual) or you can specify them in settings.py like this::
        
            NOSE_ARGS = ['--failed', '--stop']
        
        Using Custom Plugins
        ~~~~~~~~~~~~~~~~~~~~
        
        If you need to `make custom plugins`_, you can define each plugin class
        somewhere within your app and load them from settings.py like this::
        
            NOSE_PLUGINS = [
                'yourapp.tests.plugins.SystematicDysfunctioner',
                # ...
            ]
        
        Just like middleware or anything else, each string must be a dot separated,
        importable path to an actual class.  Each plugin class will be instantiated and
        added to the Nose test runner.
        
        Caveats
        -------
        
        `South`_ installs its own test command that turns off migrations during
        testing.  Make sure that ``django_nose`` comes *after* ``south`` in
        ``INSTALLED_APPS`` so that django_nose's test command is used.
        
        .. _nose docs: http://somethingaboutorange.com/mrl/projects/nose/
        .. _nose.cfg or setup.cfg: http://somethingaboutorange.com/mrl/projects/nose/0.11.2/usage.html#configuration
        .. _make custom plugins: http://somethingaboutorange.com/mrl/projects/nose/0.11.2/plugins.html#writing-plugins
        .. _South: http://south.aeracode.org/
        
        
        ======================
        Support for Django 1.1
        ======================
        
        If you want to use django-nose with Django 1.1, use
        https://github.com/jbalogh/django-nose/tree/django-1.1 or
        http://pypi.python.org/pypi/django-nose/0.0.3.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
