diff -r 594e07154872 -r f5219e0ee998 app/soc/models/school.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/app/soc/models/school.py Fri Sep 19 17:51:33 2008 +0000 @@ -0,0 +1,49 @@ +#!/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. + +"""This module contains the School Model.""" + +__authors__ = [ + '"Todd Larsen" ', +] + + +from google.appengine.ext import db + +from django.utils.translation import ugettext_lazy + +from soc.models import base +import soc.models.group + + +class School(base.ModelWithFieldAttributes): + """Details specific to a School. + + A School is a specific type of Group that gathers Students together. + + A School entity participates in the following relationships implemented + as a db.ReferenceProperty elsewhere in another db.Model: + + students) a 1:many relationship of Students attending (or otherwise + belonging to) a School. This relation is implemented as the 'students' + back-reference Query of the Student model 'school' reference. + """ + + #: Required 1:1 relationship that ties School details to the more + #: generic Group details. The back-reference in the Group model is a + #: Query named 'school'. + group = db.ReferenceProperty(reference_class=soc.models.group.Group, + required=True, collection_name="school")