giftplayer, a handy GIFT quiz player

Gift format is a text format for quiz document of Moodle CMS.

giftpalayer is a quick checking tool for quiz written in Gift format.

Usage 1: Generate an HTML document for a given Gift quiz.

$ echo '::Q1:: Two times three equals {=six =6}' | giftplayer cat - | bcat

Here, bcat is a HTML viewer (if you are using Ubuntu, it can be installed with apt install ruby-bcat).

Usage 2: Run a web server for a given Gift quiz.

$ echo '::Q1:: Two times three equals {=six =6}' | giftplayer web -

Installation

Just to try it, clone the repository & run it like:

$ git clone https://github.com/tos-kamiya/giftplayer
$ cd giftplayer
$ ./giftplayer cat samples/sample_quiz.gift
<!DOCTYPE html>
<html>
....

Install docopt and Flask before running giftplayer, if not yet installed.

To install giftplayer, run sudo pip3 install git+https://github.com/tos-kamiya/giftplayer.

To uninstall giftplayer, run sudo pip3 uninstall giftplayer .

CLI usage

Usage:
  giftplayer cat [options] <giftscript>
  giftplayer web [options] <giftscript_or_directory>
  giftplayer (--help|--version)

Options:
  -s <seed> --shuffle=<seed>  Seed of shuffling choices of each question.
  -p <port> --port=<PORT>     Port number of web app', [default: 5000].
  --debug-wo-hint             Debug option. Generate HTML w/o parsing answer.

giftplayer web can show multiple gift scripts in a directory (>= 0.1.6).

Supported rules of GIFT syntax

See sample_quiz.gift.

Supported:

true/false
multiple choice
fill-in-the-blank
matching
math range
math range specified with interval end points
essay
multiple choice with multiple right answers

Not yet supported:

feedback
multiple numeric answers

License

BSD-3-Clause, except for an enclosed jquery-*.js file.