app/soc/views/models/grading_survey_group.py
author Lennard de Rijk <ljvderijk@gmail.com>
Fri, 10 Jul 2009 12:09:09 +0200
changeset 2586 283bb903b216
parent 2585 37584af2420e
child 2589 2ecd4df2c9c7
permissions -rw-r--r--
Added GradingSurveyGroup to the sitemap and sidebar.

#!/usr/bin/python2.5
#
# Copyright 2009 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 GradingSurveyGroup.
"""

__authors__ = [
    '"Daniel Diniz" <ajaksu@gmail.com>',
    '"Lennard de Rijk" <ljvderijk@gmail.com>',
  ]


import time

from google.appengine.ext.db import djangoforms

from soc.logic import dicts
from soc.logic.models.program import logic as program_logic
from soc.logic.models.survey import grading_logic
from soc.logic.models.survey import project_logic
from soc.logic.models.user import logic as user_logic
from soc.logic.models.grading_survey_group import logic as survey_group_logic
from soc.models.grading_survey_group import GradingSurveyGroup
from soc.models.grading_project_survey import GradingProjectSurvey
from soc.models.project_survey import ProjectSurvey
from soc.views.helper import access
from soc.views.helper import decorators
from soc.views.helper import redirects
from soc.views.models import base


class GroupForm(djangoforms.ModelForm):
  """Form for creating a GradingSurveyGroup.
  """

  grading_survey = djangoforms.ModelChoiceField(GradingProjectSurvey)

  student_survey = djangoforms.ModelChoiceField(ProjectSurvey, required=False)

  def __init__(self, *args, **kwargs):
    """Process field names for readable display and initialize form.
    """

    # use survey titles in drop-downs
    self.choiceTitles('grading_survey', grading_logic)
    self.choiceTitles('student_survey', project_logic)

    super(GroupForm, self).__init__(*args, **kwargs)

  def choiceTitles(self, field, logic):
    """Fetch entity titles for choice field entries.
    """

    # TODO(ajaksu): subclass ModelChoiceField so we don't need this method
    choice_list = []

    model = logic.getModel()

    for value, text in tuple(self.base_fields[field].choices):
      if value:
        entity = model.get(value)
        text = entity.title
      choice_list.append((value,text))

    choices = tuple(choice_list)

    self.base_fields[field].choices = choices

  class Meta:
    """Inner Meta class for fetching fields from model.
    """
    model = GradingSurveyGroup

    # exclude the necessary fields from the form
    exclude = ['link_id', 'scope', 'scope_path', 'last_update_started',
               'last_update_complete']


class View(base.View):
  """View methods for the GradingSurveyGroup model.
  """

  def __init__(self, params=None):
    """Defines the fields and methods required for the base View class
    to provide the user with list, public, create, edit and delete views.

    Params:
      params: a dict with params for this View
    """

    rights = access.Checker(params)
    rights['create'] = ['checkIsDeveloper']
    rights['edit'] = ['checkIsDeveloper']
    rights['delete'] = ['checkIsDeveloper']
    rights['show'] = ['checkIsDeveloper']
    rights['list'] = ['checkIsDeveloper']

    new_params = {}
    new_params['logic'] = survey_group_logic
    new_params['rights'] = rights
    new_params['name'] = "Grading Survey Group"
    new_params['sidebar_grouping'] = "Surveys"

    new_params['no_admin'] = True
    new_params['no_create_raw'] = True
    new_params['no_create_with_key_fields'] = True

    new_params['create_form'] = GroupForm
    new_params['edit_form'] = GroupForm

    params = dicts.merge(params, new_params)

    super(View, self).__init__(params=params)

  @decorators.merge_params
  @decorators.check_access
  def create(self, request, access_type,
             page_name=None, params=None, **kwargs):
    """Pass the correct survey queries to GroupForm.

    For params see base.View.create().
    """

    self.setQueries(kwargs['scope_path'], params)

    return super(View, self).create(request, access_type, page_name=page_name,
                                    params=params, **kwargs)

  @decorators.merge_params
  @decorators.check_access
  def edit(self, request, access_type,
           page_name=None, params=None, seed=None, **kwargs):
    """Pass the correct survey queries to GroupForm.

    For params see base.View.edit().
    """

    self.setQueries(kwargs['scope_path'], params)

    return super(View, self).edit(request, access_type, page_name=page_name,
                                  params=params, seed=seed, **kwargs)

  def _editPost(self, request, entity, fields):
    """See base.View._editPost().
    """

    if not entity:
      # generate a unique link_id
      fields['link_id'] = 't%i' % (int(time.time()*100))

      # TODO: seriously redesign _editPost to pass along kwargs
      fields['scope_path'] = fields['grading_survey'].scope_path
    else:
      fields['link_id'] = entity.link_id

    # fill in the scope via call to super
    super(View, self)._editPost(request, entity, fields)

  def setQueries(self, program, params):
    """Add program filtering queries to the GroupForm.
    """

    # fetch the program
    program = program_logic.getFromKeyNameOr404(program)

    # filter grading surveys by program and use title for display
    grading_query = grading_logic.getQueryForFields(filter={'scope':program})

    # filter project surveys by program and use title for display
    student_query = project_logic.getQueryForFields(filter={'scope':program})

    if params.get('edit_form'):
      params['edit_form'].base_fields['student_survey'].query = student_query
      params['edit_form'].base_fields['grading_survey'].query = grading_query

    if params.get('create_form'):
      params['create_form'].base_fields['student_survey'].query = student_query
      params['create_form'].base_fields['grading_survey'].query = grading_query


view = View()

create = decorators.view(view.create)
edit = decorators.view(view.edit)
delete = decorators.view(view.delete)
list = decorators.view(view.list)
public = decorators.view(view.public)