#!/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.

"""Views for editing and examining User profiles.

"""

__authors__ = [

  '"Pawel Solyga" <pawel.solyga@gmail.com>',

  ]

from google.appengine.api import users

from django import http

from django import shortcuts

from django import newforms as forms

from django.utils.translation import ugettext_lazy

import soc.logic

from soc.logic import validate

from soc.logic import out_of_band

from soc.logic.site import id_user

from soc.views import helper

import soc.views.helper.forms

import soc.views.helper.requests

import soc.views.helper.responses

from soc.views import simple

import soc.models.user

class UserForm(helper.forms.DbModelForm):

  """Django form displayed when creating or editing a User.

  """

  class Meta:

    """Inner Meta class that defines some behavior for the form.

    """

    #: db.Model subclass for which the form will gather information

    model = soc.models.user.User

    #: list of model fields which will *not* be gathered by the form

    exclude = ['id', 'former_ids', 'is_developer']

  def clean_link_name(self):

    link_name = self.cleaned_data.get('link_name')

    if not validate.isLinkNameFormatValid(link_name):

      raise forms.ValidationError("This link name is in wrong format.")

    user = id_user.getUserFromLinkName(link_name)

    if user and not id_user.doesLinkNameBelongToId(link_name, user.id):

      raise forms.ValidationError("This link name is already in use.")

    return link_name

DEF_USER_PROFILE_EDIT_TMPL = 'soc/user/profile/edit.html'

SUBMIT_MSG_PARAM_NAME = 's'

SUBMIT_MESSAGES = (

  ugettext_lazy('Profile saved.'),

)

SUBMIT_MSG_PROFILE_SAVED = 0

SUBMIT_PROFILE_SAVED_PARAMS = {

  SUBMIT_MSG_PARAM_NAME: SUBMIT_MSG_PROFILE_SAVED,

}

def edit(request, link_name=None, template=DEF_USER_PROFILE_EDIT_TMPL):

  """View for a User to modify the properties of a User Model entity.

  Args:

    request: the standard django request object

    link_name: the User's site-unique "link_name" extracted from the URL

    template: the template path to use for rendering the template

  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.

  """

  id = users.get_current_user()

  # create default template context for use with any templates

  context = helper.responses.getUniversalContext(request)

  if (not id) and (not link_name):

    # not logged in, and no link name, so request that the user sign in 

    return simple.requestLogin(request, template, context,

        # TODO(tlarsen): /user/profile could be a link to a help page instead

        login_message_fmt='To create a new'

                          ' <a href="/user/profile">User Profile</a>'

                          ' or modify an existing one, you must first'

                          ' <a href="%(sign_in)s">sign in</a>.')

  if (not id) and link_name:

    # not logged in, so show read-only public profile for link_name user

    return simple.public(request, template, link_name, context)

  link_name_user = None

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

  try:

      if link_name:

        link_name_user = id_user.getUserFromLinkNameOrDie(link_name)

  except out_of_band.ErrorResponse, error:

    # show custom 404 page when link name doesn't exist in Datastore

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

  # link_name_user will be None here if link name was already None...

  if link_name_user and (link_name_user.id != id):

    # link_name_user exists but is not the currently logged in Google Account,

    # so show public view for that (other) User entity

    return simple.public(request, template, link_name, context)

  if request.method == 'POST':

    form = UserForm(request.POST)

    if form.is_valid():

      new_link_name = form.cleaned_data.get('link_name')

      properties = {

        link_name : new_link_name,

        nick_name : form.cleaned_data.get("nick_name"),

        id : id,

      }

      # redirect to new /user/profile/new_link_name?s=0

      # (causes 'Profile saved' message to be displayed)

      return helper.responses.redirectToChangedSuffix(

          request, link_name, new_link_name, params=SUBMIT_PROFILE_SAVED_PARAMS)

  else: # request.method == 'GET'

    # try to fetch User entity corresponding to Google Account if one exists

    if user:

      # is 'Profile saved' parameter present, but referrer was not ourself?

      # (e.g. someone bookmarked the GET that followed the POST submit) 

      if (request.GET.get(SUBMIT_MSG_PARAM_NAME)

          and (not helper.requests.isReferrerSelf(request,

                                                  suffix=link_name))):

        # redirect to aggressively remove 'Profile saved' query parameter

        return http.HttpResponseRedirect(request.path)

      # referrer was us, so select which submit message to display

      # (may display no message if ?s=0 parameter is not present)

      context['notice'] = (

          helper.requests.getSingleIndexedParamValue(

              request, SUBMIT_MSG_PARAM_NAME, values=SUBMIT_MESSAGES))

      # populate form with the existing User entity

      form = UserForm(instance=user)

    else:

      if request.GET.get(SUBMIT_MSG_PARAM_NAME):

        # redirect to aggressively remove 'Profile saved' query parameter

        return http.HttpResponseRedirect(request.path)

      # no User entity exists for this Google Account, so show a blank form

      form = UserForm()

  context['form'] = form

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

def create(request, template=DEF_USER_PROFILE_EDIT_TMPL):

  """create() view is same as edit() view, but with no link_name supplied.

  """

  return edit(request, link_name=None, template=template)