Hot-keys on this page

r m x p   toggle line displays

j k   next/prev highlighted chunk

0   (zero) top of page

1   (one) first highlighted chunk

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

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

#! /usr/bin/env python3 

# -*- coding: utf-8 -*- 

 

#       Copyright 2013, Marten de Vries 

# 

#       This file is part of OpenTeacher. 

# 

#       OpenTeacher 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 3 of the License, or 

#       (at your option) any later version. 

# 

#       OpenTeacher 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 OpenTeacher.  If not, see <http://www.gnu.org/licenses/>. 

 

import datetime 

import contextlib 

 

class Controller: 

        def __init__(self, Event, parse, compose, check, *args, **kwargs): 

                super().__init__(*args, **kwargs) 

 

                self._parse = parse 

                self._compose = compose 

                self._check = check 

 

                self._showingCorrection = False 

 

                self._installEvents(Event) 

 

        @property 

        def lessonType(self): 

                return self._lessonType 

 

        @lessonType.setter 

        def lessonType(self, v): 

                with contextlib.suppress(AttributeError): 

                        self._lessonType.newItem.unhandle(self._onNewWord) 

                if self._showingCorrection: 

                        self.correctionShowingDone() 

 

                self._lessonType = v 

 

                self._lessonType.newItem.handle(self._onNewWord) 

                self.disableCorrectAnyway.send() 

 

        def _installEvents(self, Event): 

                self.clearInput = Event() 

                self.enableInput = Event() 

                self.disableInput = Event() 

                self.focusInput = Event() 

 

                self.showCorrection = Event() 

                self.hideCorrection = Event() 

 

                self.enableCheck = Event() 

                self.disableCheck = Event() 

                self.enableSkip = Event() 

                self.disableSkip = Event() 

                self.enableCorrectAnyway = Event() 

                self.disableCorrectAnyway = Event() 

 

        def _onNewWord(self, word): 

                self._lastWord = word 

 

                self._activity = {"start": datetime.datetime.now()} 

 

                self.clearInput.send() 

                self.focusInput.send() 

 

        def _enableUi(self): 

                self.enableCheck.send() 

                self.enableSkip.send() 

                self.enableInput.send() 

 

        def _disableUi(self): 

                self.disableCheck.send() 

                self.disableSkip.send() 

                self.disableInput.send() 

 

        def checkTriggered(self, inputContent): 

                self._assertLessonTypeSet() 

                self._assertLessonActive() 

                self._assertNotShowingCorrection() 

 

                result = self._checkAnswerAndSaveResult(inputContent) 

                if result == "wrong": 

                        self._resultWrong() 

                else: 

                        self._resultRight() 

 

        def _assertLessonTypeSet(self): 

                try: 

                        self.lessonType 

                except AttributeError: 

                        #just so it's clear what this function's doing. 

                        raise 

 

        def _assertLessonActive(self): 

                try: 

                        self._lastWord 

                except AttributeError: 

                        raise ValueError("No lesson active") 

 

        def userIsTyping(self): 

                self._assertLessonTypeSet() 

                self._assertLessonActive() 

                self._assertNotShowingCorrection() 

 

                self._activity["end"] = datetime.datetime.now() 

 

        def _resultWrong(self): 

                self._disableUi() 

                self.enableCorrectAnyway.send() 

 

                self._showingCorrection = True 

                correctAnswer = self._compose(self._lastWord["answers"]) 

                self.showCorrection.send(correctAnswer) 

 

        def _resultRight(self): 

                self.disableCorrectAnyway.send() 

                self._tellLessonTypeAboutTheResult() 

 

        def _checkAnswerAndSaveResult(self, userInput): 

                givenAnswer = self._parse(userInput) 

 

                self._lastResult = self._check(givenAnswer, self._lastWord) 

                self._lastResult.update({ 

                        "givenAnswer": userInput, 

                }) 

                return self._lastResult["result"] 

 

        def _assertNotShowingCorrection(self): 

                if self._showingCorrection: 

                        raise ValueError("Showing a correction -> calling this now makes no sense") 

 

        def _tellLessonTypeAboutTheResult(self): 

146                if not "end" in self._activity: 

                        #assume now 

                        self.userIsTyping() 

                self._lastResult["active"] = self._activity 

                self.lessonType.setResult(self._lastResult) 

 

        def correctionShowingDone(self): 

                self._assertShowingCorrection() 

                self._showingCorrection = False 

 

                self.hideCorrection.send() 

                self._tellLessonTypeAboutTheResult() 

                self._enableUi() 

 

        def _assertShowingCorrection(self): 

                if not self._showingCorrection: 

                        raise ValueError("Not showing a correction!") 

 

        def skipTriggered(self): 

                self._assertLessonTypeSet() 

                self._assertLessonActive() 

                self._assertNotShowingCorrection() 

 

                self.lessonType.skip() 

 

        def correctAnywayTriggered(self): 

                self._assertLessonTypeSet() 

                self._assertLessonActive() 

 

174                if self._showingCorrection: 

                        self.correctionShowingDone() 

                self._lastResult.update({ 

                        "result": "right", 

                        "givenAnswer": _("Corrected: %s") % self._lastResult["givenAnswer"], 

                }) 

                self.lessonType.correctLastAnswer(self._lastResult) 

                self.disableCorrectAnyway.send() 

 

class InputTypingLogicModule: 

        """This module offers an object that can be used to control the part 

           of a GUI where the user types his/her answer in in a test. 

 

        """ 

        def __init__(self, moduleManager, *args, **kwargs): 

                super().__init__(*args, **kwargs) 

                self._mm = moduleManager 

 

                self.type = "inputTypingLogic" 

                self.filesWithTranslations = ("inputTypingLogic.py",) 

                self.requires = ( 

                        self._mm.mods(type="event"), 

                        self._mm.mods(type="wordsStringComposer"), 

                        self._mm.mods(type="wordsStringParser"), 

                        self._mm.mods(type="wordsStringChecker"), 

                ) 

 

        def createController(self, *args, **kwargs): 

                return Controller(self._createEvent, self._parse, self._compose, self._check, *args, **kwargs) 

 

        def enable(self): 

                self._modules = next(iter(self._mm.mods(type="modules"))) 

                self._createEvent = self._modules.default(type="event").createEvent 

                self._parse = self._modules.default("active", type="wordsStringParser").parse 

                self._compose = self._modules.default("active", type="wordsStringComposer").compose 

                self._check = self._modules.default("active", type="wordsStringChecker").check 

 

                try: 

                        translator = self._modules.default("active", type="translator") 

                except IndexError: 

                        pass 

                else: 

                        translator.languageChanged.handle(self._retranslate) 

                self._retranslate() 

 

                self.active = True 

 

        def _retranslate(self): 

                #Install translator inside the whole of these file 

                global _ 

                global ngettext 

 

                try: 

                        translator = self._modules.default("active", type="translator") 

                except IndexError: 

exit                        _, ngettext = str, lambda a, b, n: a if n == 1 else b 

                else: 

                        _, ngettext = translator.gettextFunctions( 

                                self._mm.resourcePath("translations") 

                        ) 

 

        def disable(self): 

                self.active = False 

 

                del self._modules 

                del self._createEvent 

                del self._parse 

                del self._compose 

                del self._check 

 

def init(moduleManager): 

        return InputTypingLogicModule(moduleManager)