app/soc/models/student_project.py
author Sverre Rabbelier <sverre@rabbelier.nl>
Fri, 15 May 2009 23:05:13 +0200
changeset 2319 3eee2308f1dd
parent 2183 4e036dcc79ba
child 2573 f09f317769c4
permissions -rw-r--r--
Do not rely on notifiction module being imported This has worked so far mostly by accident, but it turned out to be brittle while writing tests. This makes sure that the notification module is always imported before use.

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

"""This module contains the Student Project Model.
"""

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


from google.appengine.ext import db

from django.utils.translation import ugettext

import soc.models.linkable
import soc.models.mentor
import soc.models.program
import soc.models.student


class StudentProject(soc.models.linkable.Linkable):
  """Model for a student project used in the GSoC workflow.
  """

  #: Required field indicating the "title" of the project
  title = db.StringProperty(required=True,
      verbose_name=ugettext('Title'))
  title.help_text = ugettext('Title of the project')

  #: Required, text field describing the project
  abstract = db.TextProperty(required=True)
  abstract.help_text = ugettext(
      'Short abstract, summary, or snippet;'
      ' 500 characters or less, plain text displayed publicly')

  #: Optional, text field containing all kinds of information about this project
  public_info = db.TextProperty(required=False, default ='')
  public_info.help_text = ugettext(
      'Additional information about this project to be shown publicly')

  #: Optional, URL which can give more information about this project
  additional_info = db.URLProperty(required=False)
  additional_info.help_text = ugettext(
      'Link to a resource containing more information about this project.')

  #: Optional field storing a feed URL; displayed publicly.
  feed_url = db.LinkProperty(
      verbose_name=ugettext('Project Feed URL'))
  feed_url.help_text = ugettext(
      'The URL should be a valid ATOM or RSS feed. '
      'Feed entries are shown on the public page.')

  #: A property containing which mentor has been assigned to this project.
  #: A project must have a mentor at all times
  mentor = db.ReferenceProperty(reference_class=soc.models.mentor.Mentor,
                                required=True,
                                collection_name='student_projects')

  #: A property containing a list of additional Mentors for this project
  additional_mentors = db.ListProperty(item_type=db.Key, default=[])

  #: The status of this project
  #: accepted: This project has been accepted into the program
  #: mid_term_passed: This project has passed the midterm evaluation
  #: mid_term_failed: This project has failed the midterm evaluation
  #: final_failed: This project has failed the final evaluation
  #: passed: This project has completed the program successfully
  status = db.StringProperty(required=True, default='accepted',
      choices=['accepted', 'mid_term_passed', 'mid_term_failed', 
              'final_failed', 'passed'])

  #: Student which this project is from
  student = db.ReferenceProperty(
      reference_class=soc.models.student.Student,
      required=True, collection_name='student_projects')

  #: Program in which this project has been created
  program = db.ReferenceProperty(reference_class=soc.models.program.Program,
                                 required=True, 
                                 collection_name='student_projects')