Anki/aqt/reviewer.py
2011-04-28 09:26:47 +09:00

421 lines
13 KiB
Python

# -*- coding: utf-8 -*-
# Copyright: Damien Elmes <anki@ichi2.net>
# License: GNU GPL, version 3 or later; http://www.gnu.org/copyleft/gpl.html
import time, os, stat, shutil, difflib, simplejson
import unicodedata as ucd
from PyQt4.QtCore import *
from PyQt4.QtGui import *
from anki.utils import fmtTimeSpan, stripHTML
from anki.hooks import addHook, runHook, runFilter
from anki.sound import playFromText, clearAudioQueue
from aqt.utils import mungeQA, getBase
import aqt
class Reviewer(object):
"Manage reviews. Maintains a separate state."
def __init__(self, mw):
self.mw = mw
self.web = mw.web
self.card = None
self.cardQueue = []
self.state = None
def show(self):
self.mw.setKeyHandler(self._keyHandler)
self.web.setLinkHandler(self._linkHandler)
self._getCard()
# Fetching a card
##########################################################################
def _getCard(self):
if self.cardQueue:
# a card has been retrieved from undo
c = self.cardQueue.pop()
else:
c = self.mw.deck.sched.getCard()
self.card = c
clearAudioQueue()
if c:
self.mw.enableCardMenuItems()
self._maybeEnableSound()
#self.updateMarkAction()
self.state = "question"
self._showQuestion()
else:
self.mw.disableCardMenuItems()
if self.mw.deck.cardCount():
self._showCongrats()
else:
self._showEmpty()
def _maybeEnableSound(self):
print "enable sound fixme"
return
snd = (hasSound(self.reviewer.card.q()) or
(hasSound(self.reviewer.card.a()) and
self.state != "getQuestion"))
self.form.actionRepeatAudio.setEnabled(snd)
# HTML helpers
##########################################################################
_css = """
a.ansbut {
bottom: 1em;
height: 40px;
left: 50%;
margin-left: -125px;
position: fixed;
width: 250px;
font-size: 100%;
}
a.ansbut:focus {
background: #c7c7c7;
}
div.ansbut {
position: relative; top: 25%;
}
#easebuts {
bottom: 1em;
height: 55px;
left: 50%;
margin-left: -125px;
position: fixed;
width: 250px;
font-size: 100%;
display: none;
}
.easebut {
width: 60px;
font-size: 100%;
}
.time {
background: #eee;
padding: 5px;
border-radius: 10px;
}
div#filler {
height: 30px;
}
.q { margin-bottom: 1em; }
.a { margin-top: 1em; }
.inv { visibility: hidden; }
"""
def _styles(self):
css = self.mw.sharedCSS
css += self.card.model().css
css += self._css
css = runFilter("addStyles", css)
return css
# Showing the question (and preparing answer)
##########################################################################
_revHtml = """
<table width=100%% height=100%%><tr valign=middle><td>
%(q)s
<hr class=inv>
<span id="answer" />
%(a)s
</td></tr></table>
%(buts)s
<script>
function showans () {
$(".inv").removeClass('inv');
location.hash = "answer";
$(".ansbut").hide();
$("#easebuts").show();
};
$(document).ready(function () {
$(".ansbut").focus();
});
</script>
"""
def _showQuestion(self):
self.state = "question"
# fixme: timeboxing
# fixme: q/a separation
# fixme: prevent audio from repeating
# fixme: include placeholder for type answer result
c = self.card
# original question with sounds
q = c.q()
a = c.a("a inv")
if (#self.state != self.oldState and not nosound
self.mw.config['autoplaySounds']):
playFromText(q)
# render
# buf = self.typeAnsResult()
buf = self._revHtml % dict(
q=mungeQA(q),
a=mungeQA(a) + '<div id=filler></div>',
buts=self._reviewButtons())
buf = self.mw.deck.media.escapeImages(buf)
self.web.stdHtml(buf, self._styles(), bodyClass=c.cssClass())
runHook('showQuestion')
# Showing the answer
##########################################################################
def _showAnswer(self):
self.state = "answer"
c = self.card
a = c.a()
if self.mw.config['autoplaySounds']:
playFromText(a)
# render
runHook('showQuestion')
# Review buttons
##########################################################################
def _reviewButtons(self):
# type answer area
buf = self.typeAnsInput()
# show answer button
buf += """
<a id=ansbut class="but ansbut" href=ans onclick="showans();">
<div class=ansbut>%s</div>
</a>
""" % _("Show Answer")
# ease buttons
buf += self._answerButtons()
return buf
def _answerButtons(self):
if self.card.queue == 2:
labels = (_("Again"), _("Hard"), _("Good"), _("Easy"))
green = 2
else:
labels = (_("Again"), _("Good"), _("Easy"))
green = 1
times = []
buttons = []
def but(label, i):
return '''
<a class="but easebut" href=ease%d>%s</a>''' % (i, label)
for i in range(0, len(labels)):
times.append(self._buttonTime(i, green))
buttons.append(but(labels[i], i+1))
buf = ("<table><tr><td align=center>" +
"</td><td align=center>".join(times) + "</td></tr>")
buf += "<tr><td>" + "</td><td>".join(buttons) + "</td></tr></table>"
return "<div id=easebuts>" + buf + "</div>"
return buf
def _buttonTime(self, i, green):
if self.mw.config['suppressEstimates']:
return ""
txt = self.mw.deck.sched.nextIvlStr(self.card, i+1, True)
if i == 0:
txt = '<span style="color: #700">%s</span>' % txt
elif i == green:
txt = '<span style="color: #070">%s</span>' % txt
txt = '<span class=time>%s</span>' % txt
return txt
# Handlers
############################################################
def _keyHandler(self, evt):
if self.state == "question":
if evt.key() in (Qt.Key_Enter,
Qt.Key_Return):
evt.accept()
return self.web.eval("showans();")
elif evt.key() == Qt.Key_Space and not self.typeAns():
evt.accept()
return self.web.eval("showans();")
elif self.state == "answer":
# if evt.key() == Qt.Key_Space:
# key = str(self.defaultEaseButton())
# else:
# key = unicode(evt.text())
# if key and key >= "1" and key <= "4":
# # user entered a quality setting
# num=int(key)
# evt.accept()
# return getattr(self.form, "easeButton%d" %
# num).animateClick()
pass
evt.ignore()
def _linkHandler(self, url):
print "link", url
if url == "ans":
self._showAnswer()
# Font properties & output
##########################################################################
def write(self, text):
if type(text) != types.UnicodeType:
text = unicode(text, "utf-8")
self.buffer += text
def center(self, str, height=40):
if not self.main.config['splitQA']:
return "<center>" + str + "</center>"
return '''\
<center><div style="display: table; height: %s%%; width:100%%; overflow: hidden;">\
<div style="display: table-cell; vertical-align: middle;">\
<div style="">%s</div></div></div></center>''' % (height, str)
# Type in the answer
##########################################################################
failedCharColour = "#FF0000"
passedCharColour = "#00FF00"
futureWarningColour = "#FF0000"
# if self.card.cardModel.typeAnswer:
# try:
# cor = stripMedia(stripHTML(self.card.fact[
# self.card.cardModel.typeAnswer]))
# except KeyError:
# self.card.cardModel.typeAnswer = ""
# cor = ""
# if cor:
# given = unicode(self.main.typeAnswerField.text())
# res = self.correct(cor, given)
# a = res + "<br>" + a
# fixme: type answer undo area shouldn't trigger global shortcut
# class QLineEditNoUndo(QLineEdit):
# def __init__(self, parent):
# self.parent = parent
# QLineEdit.__init__(self, parent)
# def keyPressEvent(self, evt):
# if evt.matches(QKeySequence.Undo):
# evt.accept()
# if self.parent.form.actionUndo.isEnabled():
# self.parent.onUndo()
# else:
# return QLineEdit.keyPressEvent(self, evt)
def typeAns(self):
"True if current card has answer typing enabled."
return self.card.template()['typeAns']
def typeAnsInput(self):
return ""
if self.card.cardModel.typeAnswer:
self.adjustInputFont()
def getFont(self):
sz = 20
fn = u"Arial"
for fm in self.card.fact.model.fieldModels:
if fm.name == self.card.cardModel.typeAnswer:
sz = fm.quizFontSize or sz
fn = fm.quizFontFamily or fn
break
return (fn, sz)
def adjustInputFont(self):
(fn, sz) = self.getFont()
f = QFont()
f.setFamily(fn)
f.setPixelSize(sz)
self.main.typeAnswerField.setFont(f)
# add some extra space as layout is wrong on osx
self.main.typeAnswerField.setFixedHeight(
self.main.typeAnswerField.sizeHint().height() + 10)
def calculateOkBadStyle(self):
"Precalculates styles for correct and incorrect part of answer"
(fn, sz) = self.getFont()
st = "background: %s; color: #000; font-size: %dpx; font-family: %s;"
self.styleOk = st % (passedCharColour, sz, fn)
self.styleBad = st % (failedCharColour, sz, fn)
def ok(self, a):
"returns given sring in style correct (green)"
if len(a) == 0:
return ""
return "<span style='%s'>%s</span>" % (self.styleOk, a)
def bad(self, a):
"returns given sring in style incorrect (red)"
if len(a) == 0:
return ""
return "<span style='%s'>%s</span>" % (self.styleBad, a)
def head(self, a):
return a[:len(a) - 1]
def tail(self, a):
return a[len(a) - 1:]
def applyStyle(self, testChar, correct, wrong):
"Calculates answer fragment depending on testChar's unicode category"
ZERO_SIZE = 'Mn'
if ucd.category(testChar) == ZERO_SIZE:
return self.ok(self.head(correct)) + self.bad(self.tail(correct) + wrong)
return self.ok(correct) + self.bad(wrong)
def correct(self, a, b):
"Diff-corrects the typed-in answer."
if b == "":
return "";
self.calculateOkBadStyle()
ret = ""
lastEqual = ""
s = difflib.SequenceMatcher(None, b, a)
for tag, i1, i2, j1, j2 in s.get_opcodes():
if tag == "equal":
lastEqual = b[i1:i2]
elif tag == "replace":
ret += self.applyStyle(b[i1], lastEqual,
b[i1:i2] + ("-" * ((j2 - j1) - (i2 - i1))))
lastEqual = ""
elif tag == "delete":
ret += self.applyStyle(b[i1], lastEqual, b[i1:i2])
lastEqual = ""
elif tag == "insert":
dashNum = (j2 - j1) if ucd.category(a[j1]) != 'Mn' else ((j2 - j1) - 1)
ret += self.applyStyle(a[j1], lastEqual, "-" * dashNum)
lastEqual = ""
return ret + self.ok(lastEqual)
# Deck finished case
##########################################################################
def _showCongrats(self):
self.state = "congrats"
self.card = None
self.deck.db.flush()
self.hideButtons()
self.disableCardMenuItems()
self.switchToCongratsScreen()
self.form.learnMoreButton.setEnabled(
not not self.deck.newAvail)
self.startRefreshTimer()
self.bodyView.setState(state)
# focus finish button
self.form.finishButton.setFocus()
runHook('deckFinished')
def drawDeckFinishedMessage(self):
"Tell the user the deck is finished."
self.main.mainWin.congratsLabel.setText(
self.main.deck.deckFinishedMsg())
# Deck empty case
##########################################################################
def _showEmpty(self):
self.state = "empty"
self.switchToWelcomeScreen()
self.disableCardMenuItems()