--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/app/soc/views/document/show.py	Thu Nov 13 16:40:05 2008 +0000
@@ -0,0 +1,87 @@
+#!/usr/bin/python2.5
+#
+# Copyright 2008 the Melange authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Document viewers.
+
+public: how the general public sees a Document
+"""
+
+__authors__ = [
+  '"Todd Larsen" <tlarsen@google.com>',
+  ]
+
+
+from soc.logic import out_of_band
+from soc.logic import path_link_name
+from soc.logic.models import document
+from soc.views import helper
+from soc.views import simple
+from soc.views.helper import decorators
+
+import soc.views.helper.responses
+import soc.views.helper.templates
+
+
+DEF_DOCS_PUBLIC_TMPL = 'soc/document/public.html'
+
+@decorators.view
+def public(request, page=None, partial_path=None, link_name=None,
+           template=DEF_DOCS_PUBLIC_TMPL):
+  """How the "general public" sees a Document.
+
+  Args:
+    request: the standard django request object
+    page: a soc.logic.site.page.Page object which is abstraction that combines 
+      a Django view with sidebar menu info
+    partial_path: the Document's site-unique "path" extracted from the URL,
+      minus the trailing link_name
+    link_name: the last portion of the Document's site-unique "path"
+      extracted from the URL
+    template: the "sibling" template (or a search list of such templates)
+      from which to construct the public.html template name (or names)
+
+  Returns:
+    A subclass of django.http.HttpResponse which either contains the form to
+    be filled out, or a redirect to the correct view in the interface.
+  """
+  # create default template context for use with any templates
+  context = helper.responses.getUniversalContext(request)
+
+  # TODO: there eventually needs to be a call to some controller logic that
+  #   implements some sort of access controls, based on the currently
+  #   logged-in User's Roles, etc.
+
+  # TODO: based on the User's Roles, Documents that the User can edit
+  #   should display a link to a document edit form
+  
+  doc = None
+
+  # try to fetch User entity corresponding to link_name if one exists
+  path = path_link_name.combinePath([partial_path, link_name])
+
+  # try to fetch Document entity corresponding to path if one exists    
+  try:
+    if path:
+      doc = document.logic.getFromFields(partial_path=partial_path,
+                                         link_name=link_name)
+  except out_of_band.ErrorResponse, error:
+    # show custom 404 page when Document path doesn't exist in Datastore
+    return simple.errorResponse(request, page, error, template, context)
+
+  doc.content = helper.templates.unescape(doc.content)
+  context['entity'] = doc
+
+  return helper.responses.respond(request, template, context)
\ No newline at end of file