Fixed #21977 -- Deprecated SimpleTestCase.urls

3 files changed, 15 insertions, 0 deletions

diff --git a/docs/internals/deprecation.txt b/docs/internals/deprecation.txt
index dc51a5c9cc..49eaa90ccb 100644
--- a/docs/internals/deprecation.txt
+++ b/docs/internals/deprecation.txt
@@ -20,6 +20,8 @@ about each item can often be found in the release notes of two versions prior.
 * Support for the ``prefix`` argument to
   ``django.conf.urls.i18n.i18n_patterns()`` will be removed.
 
+* ``SimpleTestCase.urls`` will be removed.
+
 .. _deprecation-removed-in-1.9:
 
 1.9
diff --git a/docs/releases/1.8.txt b/docs/releases/1.8.txt
index 623cf9f226..46bbbdbb3e 100644
--- a/docs/releases/1.8.txt
+++ b/docs/releases/1.8.txt
@@ -256,6 +256,14 @@ Updating your code is as simple as ensuring that ``urlpatterns`` is a list of
         url('^other/$', views.otherview),
     ]
 
+``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 2.0. Use :func:`@override_settings(ROOT_URLCONF=...)
+<django.test.override_settings>` instead.
+
 ``prefix`` argument to :func:`~django.conf.urls.i18n.i18n_patterns`
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/topics/testing/tools.txt b/docs/topics/testing/tools.txt
index 30eec42bbd..c2a8c08f19 100644
--- a/docs/topics/testing/tools.txt
+++ b/docs/topics/testing/tools.txt
@@ -961,6 +961,11 @@ 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