Refs #21977 -- Removed SimpleTestCase.urls per deprecation timeline.

from django.core.management.color import no_style

from django.core.management.sql import emit_post_migrate_signal

from django.core.servers.basehttp import WSGIRequestHandler, WSGIServer

from django.core.urlresolvers import clear_url_caches, set_urlconf

from django.db import DEFAULT_DB_ALIAS, connection, connections, transaction

from django.forms.fields import CharField

from django.http import QueryDict

)

from django.utils import six

from django.utils.decorators import classproperty

from django.utils.deprecation import (

    RemovedInDjango20Warning, RemovedInDjango110Warning,

)

from django.utils.deprecation import RemovedInDjango20Warning

from django.utils.encoding import force_text

from django.utils.six.moves.urllib.parse import (

    unquote, urlparse, urlsplit, urlunsplit,

        * Clearing the mail test outbox.

        """

        self.client = self.client_class()

        self._urlconf_setup()

        mail.outbox = []

    def _urlconf_setup(self):

        if hasattr(self, 'urls'):

            warnings.warn(

                "SimpleTestCase.urls is deprecated and will be removed in "

                "Django 1.10. Use @override_settings(ROOT_URLCONF=...) "

                "in %s instead." % self.__class__.__name__,

                RemovedInDjango110Warning, stacklevel=2)

            set_urlconf(None)

            self._old_root_urlconf = settings.ROOT_URLCONF

            settings.ROOT_URLCONF = self.urls

            clear_url_caches()

    def _post_teardown(self):

        """Performs any post-test things. This includes:

        * Putting back the original ROOT_URLCONF if it was changed.

        """

        self._urlconf_teardown()

    def _urlconf_teardown(self):

        if hasattr(self, '_old_root_urlconf'):

            set_urlconf(None)

            settings.ROOT_URLCONF = self._old_root_urlconf

            clear_url_caches()

        """Perform any post-test things."""

        pass

    def settings(self, **kwargs):

        """

``django.test.SimpleTestCase.urls``

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The attribute :attr:`SimpleTestCase.urls <django.test.SimpleTestCase.urls>`

for specifying URLconf configuration in tests has been deprecated and will be

removed in Django 1.10. Use :func:`@override_settings(ROOT_URLCONF=...)

<django.test.override_settings>` instead.

The attribute ``SimpleTestCase.urls`` for specifying URLconf configuration in

tests has been deprecated and will be removed in Django 1.10. Use

:func:`@override_settings(ROOT_URLCONF=...) <django.test.override_settings>`

instead.

``prefix`` argument to :func:`~django.conf.urls.i18n.i18n_patterns`

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* The ability to run tests with :ref:`modified settings <overriding-settings>`.

* Using the :attr:`~SimpleTestCase.client` :class:`~django.test.Client`.

* Custom test-time :attr:`URL maps <SimpleTestCase.urls>`.

If you need any of the other more complex and heavyweight Django-specific

features like:

URLconf configuration

~~~~~~~~~~~~~~~~~~~~~

.. attribute:: SimpleTestCase.urls

.. deprecated:: 1.8

    Use ``@override_settings(ROOT_URLCONF=...)`` instead for URLconf

    configuration.

If your application provides views, you may want to include tests that use the

test client to exercise those views. However, an end user is free to deploy the

views in your application at any URL of their choosing. This means that your

tests can't rely upon the fact that your views will be available at a

particular URL.

In order to provide a reliable URL space for your test,

``django.test.*TestCase`` classes provide the ability to customize the URLconf

configuration for the duration of the execution of a test suite. If your

``*TestCase`` instance defines an ``urls`` attribute, the ``*TestCase`` will use

the value of that attribute as the :setting:`ROOT_URLCONF` for the duration

of that test.

For example::

    from django.test import TestCase

    class TestMyViews(TestCase):

        urls = 'myapp.test_urls'

        def test_index_page_view(self):

            # Here you'd test your view using ``Client``.

            call_some_test_code()

This test case will use the contents of ``myapp.test_urls`` as the

URLconf for the duration of the test case.

particular URL. Decorate your test class or test method with

``@override_settings(ROOT_URLCONF=...)`` for URLconf configuration.

.. _emptying-test-outbox:

from __future__ import unicode_literals

import os

import unittest

import warnings

from django.test import SimpleTestCase

from django.test.utils import reset_warning_registry

from django.utils import six

from django.utils.deprecation import RenameMethodsBase

from django.utils.encoding import force_text

class RenameManagerMethods(RenameMethodsBase):

                '`DeprecatedMixin.old` is deprecated, use `new` instead.',

                '`RenamedMixin.old` is deprecated, use `new` instead.',

            ])

class DeprecatingSimpleTestCaseUrls(unittest.TestCase):

    def test_deprecation(self):

        """

        Ensure the correct warning is raised when SimpleTestCase.urls is used.

        """

        class TempTestCase(SimpleTestCase):

            urls = 'tests.urls'

            def test(self):

                pass

        with warnings.catch_warnings(record=True) as recorded:

            warnings.filterwarnings('always')

            suite = unittest.TestLoader().loadTestsFromTestCase(TempTestCase)

            with open(os.devnull, 'w') as devnull:

                unittest.TextTestRunner(stream=devnull, verbosity=2).run(suite)

                msg = force_text(recorded.pop().message)

                self.assertEqual(msg,

                    "SimpleTestCase.urls is deprecated and will be removed in "

                    "Django 1.10. Use @override_settings(ROOT_URLCONF=...) "

                    "in TempTestCase instead.")