![]()
Django 1.1 Testing and Debugging
![]()
Table of Contents
Django 1.1 Testing and Debugging
Credits
About the Author
About the Reviewer
Preface
What this book covers
What you need for this book
Who this book is for
Conventions
Reader feedback
Customer support
Errata
Piracy
Questions
1. Django Testing Overview
Getting started: Creating a new application
Understanding the sample unit test
Understanding the sample doctest
Running the sample tests
Breaking things on purpose
Test errors versus test failures
Command line options for running tests
Verbosity
Settings
Pythonpath
Traceback
Noinput
Version
Summary
2. Does This Code Work? Doctests in Depth
The Survey application models
Testing the Survey model
Testing Survey model creation
Is that test useful?
Developing a custom Survey save method
Deciding what to test
Some pros and cons of doctests so far
Additional doctest caveats
Beware of environmental dependence
Beware of database dependence
Beware of test interdependence
Beware of Unicode
Summary
3. Testing 1, 2, 3: Basic Unit Testing
Unit tests for the Survey save override method
Pros of the unit test version
Cons of the unit test version
Revisiting the doctest caveats
Environmental dependence
Database dependence
Test interdependence
Unicode
Providing data for unit tests
Providing data in test fixtures
Example test that needs test data
Using the admin application to create test data
Writing the function itself
Writing a test that uses the test data
Extracting the test data from the database
Getting the test data loaded during the test run
Creating data during test set up
Summary
4. Getting Fancier: Django Unit Test Extensions
Organizing tests
Creating the survey application home page
Defining the survey application URLs
Developing views to serve pages
Creating templates for pages
Testing the survey home page
Creating the survey detail pages
Refining the survey detail view
Templates for the survey detail pages
Basic testing of the survey detail pages
Customizing the admin add and change survey pages
Developing a custom survey form
Configuring admin to use the custom form
Testing the admin customization
Additional test support
Supporting additional HTTP methods
Maintaining persistent state
E-mail services
Providing test-specific URL configuration
Response context and template information
Testing transactional behavior
Summary
5. Filling in the Blanks: Integrating Django and Other Test Tools
Problems of integration
Specifying an alternative test runner
Creating a new management command
How much of the code are we testing?
Using coverage standalone
Integrating coverage into a Django project
The twill web browsing and testing tool
Using the twill command line program
Using twill in a TestCase
Summary
6. Django Debugging Overview
Django debug settings
The DEBUG and TEMPLATE_DEBUG settings
The TEMPLATE_STRING_IF_INVALID setting
Debug error pages
Database query history
Debug support in the development server
Handling problems in production
Creating general error pages
Reporting production error information
Internal server error notifications
Page not found notifications
Summary
7. When the Wheels Fall Off: Understanding a Django Debug Page
Starting the Survey voting implementation
Creating test data for voting
Defining a question form for voting
Debug page #1: TypeError at /
Elements of the debug page
Basic error information
Traceback
Request information
GET
POST
FILES
COOKIES
META
Settings
Understanding and fixing the TypeError
Handling multiple Survey questions
Creating the data for multiple questions
Coding support for multiple questions
Debug page #2: TemplateSyntaxError at /1/
Understanding and fixing the TemplateSyntaxError
Recording Survey responses
Coding support for recording Survey responses
Debug page #3: NoReverseMatch at /1/
Understanding and fixing the NoReverseMatch exception
Debug page #4: TemplateDoesNotExist at /thanks/1/
Understanding and fixing TemplateDoesNotExist
Handling invalid Survey submissions
Coding custom error message and placement
Debug page #5: Another TemplateSyntaxError
Fixing the second TemplateSyntaxError
Summary
8. When Problems Hide: Getting More Information
Tracking SQL queries for a request
Settings for accessing query history in templates
SQL queries for the home page
Packaging the template query display for reuse
Testing the repackaged template code
SQL queries for the active Survey form display page
SQL queries for posting survey answers
The Django Debug Toolbar
Installing the Django Debug Toolbar
Debug toolbar appearance
The SQL panel
The Time panel
The Settings panel
The HTTP Headers panel
The Request Vars panel
The Templates panel
The Signals panel
The Logging panel
Redirect handling by the debug toolbar
Tracking internal code state
Resist the urge to sprinkle prints
Simple logging configuring for development
Deciding what to log
Decorators to log function entry and exit
Applying the decorators to the Survey code
Logging in the debug toolbar
Summary
9. When You Don't Even Know What to Log: Using Debuggers
Implementing the Survey results display
Results display using pygooglechart
Getting started with the debugger
The list command
The where command
The args command
The whatis command
The print and pp commands
Debugging the pygooglechart results display
The step and next commands
The continue command
The jump command
The break command
The clear command
Fixing the pygooglechart results display
The up and down commands
The return command
Results display using matplotlib
Improving the matplotlib approach
Setting up static file serving
Dynamically generating image files
Dealing with race conditions
Using the debugger to force race situations
Notes on using graphical debuggers
Summary
10. When All Else Fails: Getting Outside Help
Tracking down a problem in Django
Revisiting the Chapter 7 voting form
Is the right code actually running?
Is the code correct as per the documentation?
Searching for a matching problem report
Another way to search for a matching problem report
Determining the release that contains a fix
What if a fix hasn't been released yet?
What if a fix hasn't been committed yet?
What if a ticket has been closed without a fix?
Tracking down unreported problems
Where to ask questions
Tips on asking questions that will get good answers
Opening a new ticket to report a problem
Summary
11. When it's Time to Go Live: Moving to Production
Developing an Apache/mod_wsgi configuration
Creating the WSGI script for the marketr project
Creating an Apache VirtualHost for the marketr project
Activating the new Apache configuration
Debugging the new Apache configuration
Configuring Apache to serve static files
Testing multithreaded behavior
Generating load with siege
Load testing the results recording code
Fixing the results recording code
Additional load testing notes
Using Apache/mod_wsgi during development
Summary
Index
![]()
Django 1.1 Testing and Debugging
Copyright © 2010 Packt Publishing
All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.
Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the author nor Packt Publishing,...
