1 #!/usr/bin/python2.5

     2 #

     3 # Copyright 2008 the Melange authors.

     4 #

     5 # Licensed under the Apache License, Version 2.0 (the "License");

     6 # you may not use this file except in compliance with the License.

     7 # You may obtain a copy of the License at

     8 #

     9 #   http://www.apache.org/licenses/LICENSE-2.0

    10 #

    11 # Unless required by applicable law or agreed to in writing, software

    12 # distributed under the License is distributed on an "AS IS" BASIS,

    13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    14 # See the License for the specific language governing permissions and

    15 # limitations under the License.

    16 

    17 """Document viewers.

    18 

    19 public: how the general public sees a Document

    20 """

    21 

    22 __authors__ = [

    23   '"Todd Larsen" <tlarsen@google.com>',

    24   ]

    25 

    26 

    27 from soc.logic import out_of_band

    28 from soc.logic import path_link_name

    29 from soc.logic.models import document

    30 from soc.views import helper

    31 from soc.views import simple

    32 from soc.views.helper import decorators

    33 

    34 import soc.views.helper.responses

    35 import soc.views.helper.templates

    36 

    37 

    38 DEF_DOCS_PUBLIC_TMPL = 'soc/document/public.html'

    39 

    40 @decorators.view

    41 def public(request, page=None, partial_path=None, link_name=None,

    42            template=DEF_DOCS_PUBLIC_TMPL):

    43   """How the "general public" sees a Document.

    44 

    45   Args:

    46     request: the standard django request object

    47     page: a soc.logic.site.page.Page object which is abstraction that combines 

    48       a Django view with sidebar menu info

    49     partial_path: the Document's site-unique "path" extracted from the URL,

    50       minus the trailing link_name

    51     link_name: the last portion of the Document's site-unique "path"

    52       extracted from the URL

    53     template: the "sibling" template (or a search list of such templates)

    54       from which to construct the public.html template name (or names)

    55 

    56   Returns:

    57     A subclass of django.http.HttpResponse which either contains the form to

    58     be filled out, or a redirect to the correct view in the interface.

    59   """

    60   # create default template context for use with any templates

    61   context = helper.responses.getUniversalContext(request)

    62 

    63   # TODO: there eventually needs to be a call to some controller logic that

    64   #   implements some sort of access controls, based on the currently

    65   #   logged-in User's Roles, etc.

    66 

    67   # TODO: based on the User's Roles, Documents that the User can edit

    68   #   should display a link to a document edit form

    69   

    70   doc = None

    71 

    72   # try to fetch User entity corresponding to link_name if one exists

    73   path = path_link_name.combinePath([partial_path, link_name])

    74 

    75   # try to fetch Document entity corresponding to path if one exists    

    76   try:

    77     if path:

    78       doc = document.logic.getFromFields(partial_path=partial_path,

    79                                          link_name=link_name)

    80   except out_of_band.ErrorResponse, error:

    81     # show custom 404 page when Document path doesn't exist in Datastore

    82     return simple.errorResponse(request, page, error, template, context)

    83 

    84   doc.content = helper.templates.unescape(doc.content)

    85   context['entity'] = doc

    86 

    87   return helper.responses.respond(request, template, context)