app/soc/models/author.py
changeset 54 03e267d67478
parent 12 bdb96b9afe8e
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 Author 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.person
       
    28 
       
    29 
       
    30 class Author(db.Model):
       
    31   """Author details for a specific Program.
       
    32 
       
    33   An Author entity participates in the following relationships implemented 
       
    34   as a db.ReferenceProperty elsewhere in another db.Model:
       
    35 
       
    36    works)  a many:many relationship with Works, stored in a separate
       
    37      WorksAuthors model.  See the WorksAuthors model class for details.
       
    38 
       
    39    contributor)  a 1:1 relationship associating a Contributor with generic
       
    40      Author details and capabilities.  This relation is implemented as the
       
    41      'contributor' back-reference Query of the Contributor model 'author'
       
    42      reference.
       
    43 
       
    44    reviewer)  a 1:1 relationship associating a Reviewer with generic
       
    45      Author details and capabilities.  This relation is implemented as the
       
    46      'reviewer' back-reference Query of the Reviewer model 'author' reference.
       
    47 
       
    48    admin)  a 1:1 relationship associating an Administrator with generic
       
    49      Author details and capabilities.  This relation is implemented as the
       
    50      'admin' back-reference Query of the Administrator model 'author'
       
    51      reference.
       
    52   """
       
    53 
       
    54   #: A required 1:1 relationship associating generic Person details
       
    55   #: with the Author role entity.
       
    56   person = db.ReferenceProperty(reference_class=models.person.Person, 
       
    57 		  		required=True, collection_name="author")