app/soc/models/task.py
changeset 54 03e267d67478
parent 18 2e9454e4924e
child 181 fdd29818a954
equal deleted inserted replaced
53:57b4279d8c4e 54:03e267d67478
       
     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 """This module contains the Task Model."""
       
    18 
       
    19 __authors__ = [
       
    20   '"Todd Larsen" <tlarsen@google.com>',
       
    21   '"Sverre Rabbelier" <sverre@rabbelier.nl>',
       
    22 ]
       
    23 
       
    24 from google.appengine.ext import db
       
    25 
       
    26 from soc import models
       
    27 import soc.models.proposal
       
    28 
       
    29 
       
    30 class Task(db.Model):
       
    31   """Model of a Task, which is a Proposal to be completed by Contributors.
       
    32 
       
    33   A Task brings along a Proposal that was used to initiate the Task.  A Task
       
    34   may have a unique collection of Reviews, in addition to those attached to
       
    35   the original Proposal.
       
    36 
       
    37   A Task entity participates in the following relationships implemented
       
    38   as a db.ReferenceProperty elsewhere in another db.Model:
       
    39 
       
    40    contributors)  a required many:many relationship associating all of
       
    41      the Contributors to a Task to the specific Task.  See the
       
    42      TasksContributors model for details.
       
    43   """
       
    44  
       
    45   #: A required many:1 relationship with the Proposal on which the
       
    46   #: Task is based.  A Task may be based on only a single Proposal, 
       
    47   #: but a Proposal can be the foundation for multiple Tasks. The
       
    48   #: back-reference in the Proposal model is a Query named 'tasks'.  
       
    49   proposal = db.ReferenceProperty(reference_class=models.proposal.Proposal,
       
    50                                   required=True,
       
    51 				  collection_name="tasks")
       
    52