X-Git-Url: http://git.ithinksw.org/philo.git/blobdiff_plain/54d1617957cfa3a8c9ffd714ad6c4bef09e727de..HEAD:/philo/views.py diff --git a/philo/views.py b/philo/views.py index 28740fd..2c2a952 100644 --- a/philo/views.py +++ b/philo/views.py @@ -8,6 +8,17 @@ from philo.exceptions import MIDDLEWARE_NOT_CONFIGURED @vary_on_headers('Accept') def node_view(request, path=None, **kwargs): + """ + :func:`node_view` handles incoming requests by checking to make sure that: + + - the request has an attached :class:`.Node`. + - the attached :class:`~philo.models.nodes.Node` handles any remaining path beyond its location. + + If these conditions are not met, then :func:`node_view` will either raise :exc:`Http404` or, if it seems like the address was mistyped (for example missing a trailing slash), return an :class:`HttpResponseRedirect` to the correct address. + + Otherwise, :func:`node_view` will call the :class:`.Node`'s :meth:`~.Node.render_to_response` method, passing ``kwargs`` in as the ``extra_context``. + + """ if "philo.middleware.RequestNodeMiddleware" not in settings.MIDDLEWARE_CLASSES: raise MIDDLEWARE_NOT_CONFIGURED @@ -26,10 +37,10 @@ def node_view(request, path=None, **kwargs): raise Http404 node = request.node - subpath = request.node.subpath + subpath = request.node._subpath # Explicitly disallow trailing slashes if we are otherwise at a node's url. - if request._cached_node_path != "/" and request._cached_node_path[-1] == "/" and subpath == "/": + if node._path != "/" and node._path[-1] == "/" and subpath == "/": return HttpResponseRedirect(node.get_absolute_url()) if not node.handles_subpath(subpath):