Ticket #5189: client.patch

django/test/client.py

@@ -253 +253 @@
         else:
             return False
 
+    def logout(self):
+        """Removes the authenticated user's cookies.
+
+        Causes the authenticated user to be logged out.
+        """
+        try:
+            Session.objects.get(session_key=self.cookies['sessionid'].value).delete()
+        except KeyError:
+            pass
+
+        self.cookies = SimpleCookie()
+ No newline at end of file

tests/modeltests/test_client/models.py

@@ -246 +246 @@
         login = self.client.login(username='inactive', password='password')
         self.failIf(login)
 
+    def test_logout(self):
+       # Log in
+        self.client.login(username='testclient', password='password')
+
+        # Request a page that requires a login
+        response = self.client.get('/test_client/login_protected_view/')
+        self.assertEqual(response.status_code, 200)
+        self.assertEqual(response.context['user'].username, 'testclient')
+
+       # Log out
+       self.client.logout()
+
+       # Request a page that requires a login
+       response = self.client.get('/test_client/login_protected_view/')
+       self.assertRedirects(response, '/accounts/login/')
+
     def test_session_modifying_view(self):
         "Request a page that modifies the session"
         # Session value isn't set initially

docs/testing.txt

@@ -550 +550 @@
     conditions. You'll need to create users as part of the test suite -- either
     manually (using the Django model API) or with a test fixture.
 
+``logout()``
+    **New in Django development version**
+
+    If your site uses Django's `authentication system`_ and you deal with
+    logging in users using test client's ``login()`` method you can also use
+    client's ``logout()`` method to simulate the effect of logging a user out from
+    the site.
+
+    After you call this method, the test client will have all the cookies and
+    session data cleared to defaults. Your current user will become an
+    Anonymous User.
+
+
 .. _authentication system: ../authentication/
 .. _authentication backend: ../authentication/#other-authentication-sources