Skip to content
Browse files

Added stub of docs/shortcuts.txt

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
1 parent 66e4541 commit e259b8712ad87d1a398d46c593fa81a824041e5d @adrianholovaty adrianholovaty committed
Showing with 41 additions and 0 deletions.
  1. +41 −0 docs/shortcuts.txt
41 docs/shortcuts.txt
@@ -0,0 +1,41 @@
+Django shortcut functions
+The package ``django.shortcuts`` collects helper functions and classes that
+"span" multiple levels of MVC. In other words, these functions/classes
+introduce controlled coupling for convenience's sake.
+``django.shortcuts.render_to_response`` renders a given template with a given
+context dictionary and returns an ``HttpResponse`` object with that rendered
+ from django.shortcuts import render_to_response
+ r = render_to_response('myapp/template.html', {'foo': 'bar'})
+This example is equivalent to::
+ from django.http import HttpResponse
+ from django.template import Context, loader
+ t = loader.get_template('myapp/template.html')
+ c = Context({'foo': 'bar'})
+ r = HttpResponse(t.render(c))
+``django.shortcuts.get_object_or_404`` calls ``get()`` on a given model
+manager, but it raises ``django.http.Http404`` instead of the model's
+``DoesNotExist`` exception.
+``django.shortcuts.get_list_or_404`` returns the result of ``filter()`` on a
+given model manager, raising ``django.http.Http404`` if the resulting list is

0 comments on commit e259b87

Please sign in to comment.
Something went wrong with that request. Please try again.