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

from soc.logic import system

from soc.logic.site import id_user

def respond(request, template, context=None):

    request: the Django HTTP request object

    template: the template (or search list of templates) to render

    context: the context supplied to the template (implements dict)

    django.shortcuts.render_to_response(template, context) results

    Whatever django.shortcuts.render_to_response(template, context) raises.

  context = getUniversalContext(request, context=context)

    return shortcuts.render_to_response(template, context)

    return http.HttpResponse('AssertionError')

def getUniversalContext(request, context=None):

  """Constructs a template context dict will many common variables defined.

  Args:

    request: the Django HTTP request object

    context: the template context dict to be updated in-place (pass in a copy

      if the original must not be modified), or None if a new one is to be

      created; any existing fields already present in the context dict passed

      in by the caller are left unaltered 

  Returns:

    updated template context dict supplied by the caller, or a new context

    dict if the caller supplied None

    {

      'request': the Django HTTP request object passed in by the caller

      'id': the logged-in Google Account if there is one

      'user': the User entity corresponding to the Google Account in

        context['id']

      'is_admin': True if users.is_current_user_admin() is True

      'is_debug': True if system.isDebug() is True

      'sign_in': a Google Account login URL

      'sign_out': a Google Account logout URL

    }

  """

  if context is None:

    context = {}

  # set some universal values if caller did not already set them  

  context['request'] = context.get('request', request)

  context['id'] = id_user.getIdIfMissing(context.get('id', None))

  context['user'] = id_user.getUserIfMissing(context.get('user', None),

                                             context['id'])

  context['is_admin'] = context.get(

      'is_admin', users.is_current_user_admin())

  context['is_debug'] = context.get('is_debug', system.isDebug())

  context['sign_in'] = context.get(

      'sign_in', users.create_login_url(request.path))

  context['sign_out'] = context.get(

      'sign_out', users.create_logout_url(request.path))

  return context