Metadata-Version: 1.1
Name: nose2django
Version: 0.1.2
Summary: Nose2 plugin to run django tests through nose2 instead of the django test runner.
Home-page: https://github.com/bretth/nose2django
Author: Brett Haydon
Author-email: brett@haydon.id.au
License: BSD
Description: nose2django
        ======================
        
        A plugin pair for nose2 that runs your django (>=1.4) tests through the nose2 command and also supports django-configurations_ settings management. It lets django initialise the test environment and setup the order of the test suite, but nose2/unittest2 handles the test discovery and execution.
        
        *There is another project called* |django-nose2|_ *which is authored by one of the nose2 devs. It uses the standard django approach of setting an alternative test runner and running via manage.py. I was interested with the move to shift setup.py configuration into setup.cfg and wanted to try that pattern for running tests rather that wrapping configuration into a custom test runner. Modern django has refactored the way a project is initialised which means there is less dependency on using manage.py and django-admin.py as the only possible entry points into your django project.*
        
        Installation
        --------------
        
        .. code-block:: bash
        
        	$ pip install nose2django
        
        Create a nose2.cfg file in your project's root directory (where manage.py is) and register the plugins in the correct order::
        
            [unittest]
            plugins = nose2django.config
                    nose2django.nose2django
        
            [django-config]
            always-on = True
        
            # optional settings
            settings = yourproject.settings
            configuration = YourTestConfiguration
        
            [django-runner]
            always-on = True
        
        
        You can optionally set the `settings` and `configuration` to a django settings module and a django-configurations configuration. It takes precedence over any existing environment.
        
        Usage
        --------
        
        As per nose2, optionally with either of the django-runner options.
        
        .. code-block:: bash
        
        	$ nose2 --settings=example.settings.test --configuration=TestSettings
        	
        Patterns
        ------------
        For django app test driven development of apps you want only as much django settings as required. Create a tests folder in your top level directory (avoid using the name tests - use something like test_yourapp to avoid name clashes), and put a minimal settings file in there and an `__init__.py` file to make it importable. Something like:
        
        .. code-block:: python
        
        	DATABASES = {
                'default': {
                    'ENGINE': 'django.db.backends.sqlite3' }
            }
        
        	INSTALLED_APPS = (
                'django.contrib.auth',
                'django.contrib.contenttypes',
                'django.contrib.sessions',
                'yourapp',
            )
        	ROOT_URLCONF='yourapp.urls', # if you have urls
        	SECRET_KEY = '1234'
        
        Acknowledgements
        ------------------
        
        nose2django re-uses parts of the existing django test runner code as licensed by django_.
        
        .. _django-configurations: https://github.com/jezdez/django-configurations
        .. _django-nose2: https://github.com/jpellerin/django-nose2
        .. _django: https://raw.github.com/django/django/master/LICENSE
        
        .. |django-nose2| replace:: *django-nose*
        
        .. :changelog:
        
        
        Changelog
        ---------
        
        v0.1.2 (2013-4-13)
        ^^^^^^^^^^^^^^^^^^^^
        
        - Add South compatibility.
        
        v0.1.1 (2013-4-6)
        ^^^^^^^^^^^^^^^^^^^^
        
        - Fix issue with django logging setup when nose -v.
        
        v0.1 (2013-03-29)
        ^^^^^^^^^^^^^^^^^^^^
        
        - Initial public (correctly packaged) release. Thanks tox.
        
        
Keywords: nose2
django
testing
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Plugins
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Software Development :: Testing
