Initial definition of the Answer Model.
authorSverre Rabbelier <srabbelier@gmail.com>
Mon, 12 May 2008 20:12:46 +0000
changeset 20 7a901a99b349
parent 19 f2a5ec8fb780
child 21 6edf98d9c739
Initial definition of the Answer Model. Patch by: Sverre Rabbelier Review by: Todd Larsen Review issue: 102 Review URL: http://codereviews.googleopensourceprograms.com/102
soc/models/answer.py
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/soc/models/answer.py	Mon May 12 20:12:46 2008 +0000
@@ -0,0 +1,67 @@
+#!/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 Answer Model."""
+
+__authors__ = [
+  '"Todd Larsen" <tlarsen@google.com>',
+  '"Sverre Rabbelier" <sverre@rabbelier.nl>',
+]
+
+from google.appengine.ext import db
+
+from soc import models
+import soc.models.question
+import soc.models.review
+
+
+class Answer(db.Model):
+  """Model of a specific Answer to a Question in a specific Review."""
+
+  #: A required many:1 relationship, where each of many Answers is
+  #: a specific answer to a single Question.  An Answer must always
+  #: be associated with a Question in order to be interpreted.
+  #: It is currently unclear how useful this back-reference will be,
+  #: since the same question could be used in multiple different
+  #: Review "templates". Given this, 'answers' currently only exists
+  #: for completeness. 
+  question = db.ReferenceProperty(reference_class=models.question.Question,
+                                  required=True, collection_name="answers")
+
+  #: A required many:1 relationship, where each of many Answers to
+  #: different Questions represents the answer set of a specific
+  #: Review. The back-reference in the Review model is a Query named
+  #: 'answers' which represents all of the specific answers to
+  #: questions in that Review.
+  review = db.ReferenceProperty(reference_class=models.review.Review,
+                                required=True, collection_name="answers")
+
+  #: db.StringProperty storing the "short" answer to the question;
+  #: the interpretation of this value depends on the Question entity
+  #: referred to by 'question'. Answers can be indexed, filtered, and
+  #: sorted by their "short" answer. Depending on the Question type,
+  #: some Answers will use only 'short', some only 'long', some both.
+  short = db.StringProperty()
+
+  #: db.TextProperty storing the "long" answer to the question;
+  #: the interpretation of this value depends on the Question entity
+  #: referred to by 'question'.
+  long = db.TextProperty()
+
+  #: db.ListProperty of short strings from the list of possible
+  #: picks in the question.pick_choices list.
+  picks = db.ListProperty(item_type=str)
+