/usr/lib/python2.7/dist-packages/schooltool/lyceum/journal/interfaces.py is in python-schooltool.lyceum.journal 2.6.4-0ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 | #
# SchoolTool - common information systems platform for school administration
# Copyright (c) 2007 Shuttleworth Foundation
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
"""
Lyceum journal interfaces.
"""
import zope.schema
from zope.interface import Interface
from zope.interface import Attribute
from zope.location.interfaces import ILocation
from schooltool.requirement.interfaces import IScoreSystem
from schooltool.lyceum.journal import LyceumMessage as _
class IEvaluateRequirement(Interface):
def evaluate(person, requirement, grade, evaluator=None, score_system=None):
"""Add evaluation of a requirement."""
def getEvaluation(person, requirement, default=None):
"""Get evaluation of a requirement."""
class ISectionJournalData(IEvaluateRequirement):
"""A journal for a section."""
section = Attribute("""Section this data belongs to.""")
def setGrade(person, meeting, grade):
"""Set a grade for a person participating in this meeting."""
def getGrade(person, meeting, default=None):
"""Retrieve a grade for a person and a meeting."""
def setAbsence(person, meeting, explained=True, value=None):
"""Mark an absence as an explained or unexplained one."""
def getAbsence(person, meeting, default=False):
"""Retrieve the status of an absence."""
def isAbsent(person, meeting):
"""Retrieve the status of an absence."""
def isTardy(person, meeting):
"""Retrieve the status of an absence."""
def gradedMeetings(person):
"""Returns a list of (meeting, grades) for a person."""
def absentMeetings(person):
"""Returns a list of (meeting, absence) for a person."""
class ISectionJournal(ILocation):
section = Attribute("Section this journal belongs to.")
members = Attribute("List of students that belong to this section or any of the adjacent.")
def setGrade(person, meeting, grade):
"""Set a grade for a person participating in this meeting."""
def getGrade(person, meeting, default=None):
"""Retrieve a grade for a person and a meeting."""
def setAbsence(person, meeting, explained=True):
"""Mark an absence as an explained or unexplained one."""
def getAbsence(person, meeting, default=False):
"""Retrieve the status of an absence."""
def isAbsent(person, meeting):
"""Retrieve the status of an absence."""
def isTardy(person, meeting):
"""Retrieve the status of an absence."""
def meetings():
"""List all possible meetings for this section."""
def gradedMeetings(person):
"""Returns a list of (meeting, grades) for a person."""
def absentMeetings(person):
"""Returns a list of (meeting, absence) for a person."""
def hasMeeting(person, meeting):
"""Returns true if person should participate in a given meeting."""
def findMeeting(meeting_id):
"""Returns the meeting object for this meeting id.
The meeting might belong to any of the adjacent sections so it
goes through all their calendars to find the meeting.
"""
class IAttendanceScoreSystem(IScoreSystem):
scores = zope.schema.List(
title=u'All values',
description=u'(score, label)',
value_type=zope.schema.Tuple(),
required=True)
tag_absent = zope.schema.List(
title=u'Absence scores',
value_type=zope.schema.TextLine(),
required=True)
tag_tardy = zope.schema.List(
title=u'Tardy scores',
value_type=zope.schema.TextLine(),
required=True)
tag_excused = zope.schema.List(
title=u'Excused scores',
value_type=zope.schema.TextLine(),
required=True)
def isAbsent(score):
pass
def isTardy(score):
pass
def isExcused(score):
pass
class IPersistentAttendanceScoreSystem(IAttendanceScoreSystem):
hidden = zope.schema.Bool(
title=u"Hidden Score System",
required=False
)
class IJournalScoreSystemPreferences(Interface):
grading_scoresystem = zope.schema.Choice(
title=_("Grading score system"),
vocabulary="schooltool.lyceum.journal-grading-scoresystems",
required=True)
attendance_scoresystem = zope.schema.Choice(
title=_("Attendance score system"),
vocabulary="schooltool.lyceum.journal-attendance-scoresystems",
required=True)
class IAvailableScoreSystems(Interface):
"""A marker interface to get a list of available scoresystems."""
|