ruql 0.0.4 → 0.0.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 997beabb8740224d399921151286761f842799d9
+  data.tar.gz: ead3b2482c09f2f2b494fff9b5fb19f41e841931
+SHA512:
+  metadata.gz: c681825fc87751977bb73d8fc403860f8591588a11f809b3dc5ddbf8b1cc9699441b1ec3f67e8ca07d54dd5fd0fb493dcbbb794e517206d99c4ec6aba6e35e63
+  data.tar.gz: 08054ec2bb224f2e86be37d8e5e69ce51872150eaa47827f52fa238c8c465415dcccba861339fdd587e36b1357c06dca4f44f79ce830262a7865380c23a9631b

data/bin/ruql

@@ -1,6 +1,7 @@
 #!/usr/bin/env ruby
 
-require 'ruql'
+# require 'ruql'
+require_relative '../lib/ruql'
 require 'getopt/long'
 
 def usage
@@ -16,6 +17,7 @@ renderer choices are:
   AutoQCM  - LaTeX for use with AutoQCM (http://home.gna.org/auto-qcm)
   Coursera - [obsolete] Coursera HTML/XML format for online auto-grading
   JSON     - [partially implemented] JSON format
+  Qualtrics -[partially implemented] Qualtrics survey (txt) format
 
 Global options:
   -l <loglevel>, --log=<loglevel>
@@ -36,6 +38,9 @@ The EdXML renderer supports these options:
   NOTE: The 'points' and 'randomize' attributes of questions are not honored by
      some systems.
 
+  -y <file.yml>, --yaml=<file.yml>
+      Render the questions with a specific yaml file.
+
 The HTML5 and HTML Forms renderers supports these options:
   -c <href>, --css=<href>
       embed <href> for stylesheet into generated HTML5
@@ -46,7 +51,7 @@ The HTML5 and HTML Forms renderers supports these options:
       file.html.erb should have <%= yield %> where questions should go.
       An example is in the templates/ directory of RuQL.
       The following local variables will be replaced with their values in
-      the template: 
+      the template:
         <%= quiz.title %> - the quiz title
         <%= quiz.num_questions %> - total number of questions
         <%= quiz.points %> - total number of points for whole quiz
@@ -64,6 +69,10 @@ The AutoQCM renderer supports these options:
 
 The JSON renderer currently supports no options
 
+The Qualtrics renderer supports these options:
+  -t <file.txt.erb>, --template=<file.txt.erb>
+  The file should have <%= yield %> where questions should go. Since this just creates survey questions, grading information is ignored.Currently supports the same type of questions as the AutoQCM renderer.
+
 eos
   exit
 end
@@ -73,6 +82,7 @@ def main
   raise "Cannot read #{filename}" unless File.readable? filename
   renderer = ARGV.shift
   raise "Unknown renderer '#{renderer}'" unless Quiz.get_renderer(renderer)
+
   opts = Getopt::Long.getopts(
     ['-c', '--css', Getopt::REQUIRED],
     ['-j', '--js', Getopt::REQUIRED],
@@ -80,7 +90,9 @@ def main
     ['-s', '--solutions', Getopt::BOOLEAN],
     ['-n', '--name', Getopt::REQUIRED],
     ['-l', '--log', Getopt::REQUIRED],
-    )
+    ['-y', '--yaml', Getopt::REQUIRED]
+  )
+  Quiz.set_yaml_file opts.delete("y") || opts.delete("yaml")
   Quiz.instance_eval "#{IO.read(filename)}"
   Quiz.quizzes.each { |quiz| puts quiz.render_with(renderer, opts)  }
 end

data/lib/ruql/dropdown.rb

@@ -0,0 +1,19 @@
+class Dropdown < Question
+
+  DropdownChoice = Struct.new(:correct, :list)
+  DropdownText = Struct.new(:text)
+
+  def choice(correct, list)
+    @choices << DropdownChoice.new(correct, list)
+  end
+  def label(str)
+    @choices << DropdownChoice.new(0, [str])
+  end
+
+  attr_accessor :choices
+
+  def initialize(opts={})
+    super
+    self.choices = []
+  end
+end

data/lib/ruql/open_assessment/criterion.rb

@@ -0,0 +1,45 @@
+class Criterion
+
+  attr_accessor :options, :feedback, :criterion_name,
+                :criterion_label, :criterion_prompt
+
+  ##
+  # Initializes a criterion
+  def initialize(options={})
+    @options = []
+    @feedback = options[:feedback] || "required"
+  end
+
+  ##
+  # Sets the criterion name
+  def name(name)     ; @criterion_name = name     ; end
+
+  ##
+  # Sets the criterion label
+  def label(label)   ; @criterion_label = label   ; end
+
+  ##
+  # Sets the criterion prompt
+  def prompt(prompt) ; @criterion_prompt = prompt ; end
+
+  ##
+  # Adds an option to the block and evaluates the proc bloc
+  def option(*args, &block)
+    option = Option.new(*args)
+    option.instance_eval(&block)
+    raise "Missing option parameters" if option.missing_parameters?
+    options << option
+  end
+
+  ##
+  # Adds an already initialized option
+  def add_option(option)
+    options << option
+  end
+
+  ##
+  # Validation to make sure that all the required fields are in
+  def missing_parameters?
+    @criterion_name.nil? || @criterion_label.nil? || @criterion_prompt.nil?
+  end
+end

data/lib/ruql/open_assessment/open_assessment.rb

@@ -0,0 +1,141 @@
+require 'securerandom'
+class OpenAssessment
+
+  attr_accessor :question_title, :prompts, :criterions, :name,
+                :url_name, :self_assessment, :peer_review,
+                :must_grade, :graded_by
+  attr_accessor :allow_file_upload, :allow_latex
+  attr_accessor :submission_start, :submission_due,
+                :submission_start_time, :submission_due_time,
+                :self_assessment_start, :self_assessment_due,
+                :self_assessment_start_time, :self_assessment_due_time,
+                :peer_review_start, :peer_review_due,
+                :peer_review_start_time, :peer_review_due_time
+  attr_accessor :question_feedback_prompt, :question_feedback_default_text
+  attr_accessor :yaml
+  attr_accessor :trainings
+  attr_accessor :answer, :question_scoring_guideline
+
+  @@single_question_scores =
+    [[5, "Excellent", "You got all of the question correct"],
+     [4, "Great", "You got most of the question correct"],
+     [3, "Good", "You got half of the question correct"],
+     [2, "Fair", "You got parts of the question correct"],
+     [1, "OK", "You got bits of the question correct"],
+     [0, "Poor", "You got none of the question correct"]]
+
+  @@DATE_REGEX = /\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/
+
+  ##
+  # Initializes the open assessment question
+  def initialize(options={}, yaml={})
+    @peer_review = options[:peer_review] || false
+    @self_assessment = options[:self_assessment]
+    @self_assessment = true if @self_assessment.nil?
+
+    @prompts = []
+    @criterions = []
+    @trainings = []
+
+    @url_name = options[:url_name] || SecureRandom.hex
+    @yaml = yaml
+
+    @must_grade = @yaml["must_grade"] || 5
+    @graded_by = @yaml["graded_by"] || 3
+
+    @allow_file_upload = options[:allow_file_upload] || false
+    @allow_latex = options[:allow_latex] || false
+
+    # Parsing start/due dates
+    start_date = @yaml["submission_start"] || Time.now.to_s
+    end_date = @yaml["submission_due"] || (Time.now + 14).to_s
+
+    peer_review_start = @yaml["peer_review_start"] || start_date
+    peer_review_due = @yaml["peer_review_due"] || end_date
+
+    self_assessment_start = @yaml["self_assessment_start"] || start_date
+    self_assessment_due = @yaml["self_assessment_due"] || end_date
+
+    @submission_start = Date.parse(start_date)
+    @submission_due = Date.parse(end_date)
+    @submission_start_time = @yaml["submission_start_time"] || "00:00"
+    @submission_due_time = @yaml["submission_due_time"] || "00:00"
+
+    @peer_review_start = Date.parse(peer_review_start)
+    @peer_review_due = Date.parse(peer_review_due)
+    @peer_review_start_time = @yaml["peer_review_start_time"] || "00:00"
+    @peer_review_due_time = @yaml["peer_review_due_time"] || "00:00"
+
+    @self_assessment_start = Date.parse(self_assessment_start)
+    @self_assessment_due = Date.parse(self_assessment_due)
+    @self_assessment_start_time = @yaml["self_assessment_start_time"] || "00:00"
+    @self_assessment_due_time = @yaml["self_assessment_due_time"] || "00:00"
+
+    # Default feedback settings
+    @question_feedback_prompt = "Leave feedback"
+    @question_feedback_default_text = "Let them know how they did"
+  end
+
+  ##
+  # Sets the title of the question
+  def title(title)      ; @question_title  = title  ; end
+
+  ##
+  # Adds a prompt to the question - you must have at least one
+  def prompt(prompt)    ; @prompts << prompt        ; end
+
+  ##
+  # Sets the answers for a simple_open_assessment question
+  def answer(answer)    ; @question_answer = answer ; end
+
+  ##
+  # Sets the scoring guidelines for a simple_open_assesment question
+  def scoring_guideline(score_array) ; @question_scoring_guideline = score_array ; end
+
+  ##
+  # Sets the feedback prompt if you want students to leave feedback
+  def feedback_prompt(fb_prompt) ; @question_feedback_prompt = fb_prompt ; end
+
+  ##
+  # Sets the default text for the feedback textarea
+  def feedback_default_text(fb_text) ; @question_feedback_default_text = fb_text ; end
+
+  ##
+  # Adds a criterion and evaluates its proc block.
+  def criterion(*args, &block)
+    criterion = Criterion.new(*args)
+    criterion.instance_eval(&block)
+
+    raise "Missing criterion parameters" if criterion.missing_parameters?
+
+    @criterions << criterion
+  end
+
+  ##
+  # Adds fields for a simple_open_assessment question
+  def add_simple_question
+    criterion = Criterion.new
+    criterion.name("How'd you do?")
+    criterion.label("Scoring Rubric")
+
+    raise "Must have answer for question" if @question_answer.nil?
+    criterion.prompt(@question_answer)
+
+    criterions << criterion
+    scoring_guidelines = @question_scoring_guideline || @@single_question_scores
+    scoring_guidelines.each do |score_array|
+      option = Option.new({ points: score_array[0] })
+      option.add_params(score_array)
+      criterion.add_option(option)
+    end
+  end
+
+  ##
+  # Adds a student training question - only used with peer review enabled questions
+  def student_training(*args, &block)
+    return unless @peer_review
+    training = Training.new(*args)
+    training.instance_eval(&block)
+    @trainings << training
+  end
+end

data/lib/ruql/open_assessment/option.rb

@@ -0,0 +1,34 @@
+class Option
+  attr_accessor :points, :opt_name, :opt_label, :opt_explanation
+
+  ##
+  # Initializes an option
+  def initialize(options={})
+    @points = options[:points] || 0
+  end
+
+  ##
+  # Adds name to option
+  def name(name)               ; @opt_name = name               ; end
+
+  ##
+  # Adds label to option
+  def label(label)             ; @opt_label = label             ; end
+
+  ##
+  # Adds explanation to option
+  def explanation(explanation) ; @opt_explanation = explanation ; end
+
+  ##
+  # Sets preset option paramters
+  def add_params(score_array)
+    _, @opt_label, @opt_explanation = score_array
+    @opt_name = @opt_label
+  end
+
+  ##
+  # Validation to make sure that all the required fields are in
+  def missing_parameters?
+    @opt_name.nil? || @opt_label.nil? || @opt_explanation.nil?
+  end
+end

data/lib/ruql/open_assessment/training.rb

@@ -0,0 +1,21 @@
+class Training
+
+  attr_accessor :training_criterions, :training_answer
+
+  ##
+  # Initializes a training response
+  def initialize(options={})
+    @training_criterions = []
+  end
+
+  ##
+  # Sets the answer for the training response
+  def answer(s) ; @training_answer = s ; end
+
+  ##
+  # Adds a training criterion and evaluates to proc block
+  def training_criterion(*args)
+    training = TrainingCriterion.new(*args)
+    @training_criterions << training
+  end
+end

data/lib/ruql/open_assessment/training_criterion.rb

@@ -0,0 +1,15 @@
+class TrainingCriterion
+  attr_accessor :criterion, :option
+
+  ##
+  # Initializes a training criterion for a training response
+  def initialize(options={})
+    @criterion = options[:criterion]
+    @option = options[:option]
+
+    # Validation
+    if @criterion.nil? || @option.nil?
+      raise "Must include criterion and option."
+    end
+  end
+end

data/lib/ruql/question.rb

@@ -1,6 +1,6 @@
 class Question
   attr_accessor :question_text, :answers, :randomize, :points, :name, :question_tags, :question_comment
-  
+
   def initialize(*args)
     options = if args[-1].kind_of?(Hash) then args[-1] else {} end
     @answers = options[:answers] || []
@@ -12,9 +12,9 @@ class Question
   end
 
   def raw? ; !!@raw ; end
-  
+
   def text(s) ; @question_text = s ; end
-  
+
   def explanation(text)
     @answers.each { |answer| answer.explanation ||= text }
   end
@@ -28,7 +28,7 @@ class Question
   end
 
   # these are ignored but legal for now:
-  def tags(*args) # string or array of strings 
+  def tags(*args) # string or array of strings
     if args.length > 1
       @question_tags += args.map(&:to_s)
     else

data/lib/ruql/quiz.rb

@@ -1,8 +1,9 @@
-
 class Quiz
   @@quizzes = []
+  @@yaml_file = nil
+  @quiz_yaml = {}
   def self.quizzes ; @@quizzes ;  end
-  @@default_options = 
+  @@default_options =
     {
     :open_time => Time.now,
     :soft_close_time => Time.now + 24*60*60,
@@ -28,7 +29,7 @@ class Quiz
   attr_reader :logger
   attr_accessor :title
 
-  def initialize(title, options={})
+  def initialize(title, yaml, options={})
     @output = ''
     @questions = options[:questions] || []
     @title = title
@@ -36,12 +37,13 @@ class Quiz
     @seed = srand
     @logger = Logger.new(STDERR)
     @logger.level = Logger.const_get (options.delete('l') ||
-      options.delete('log') || 'warn').upcase
+                                      options.delete('log') || 'warn').upcase
+    @quiz_yaml = yaml
   end
 
   def self.get_renderer(renderer)
     Object.const_get(renderer.to_s + 'Renderer') rescue nil
-  end      
+  end
 
   def render_with(renderer,options={})
     srand @seed
@@ -49,7 +51,11 @@ class Quiz
     @renderer.render_quiz
     @output = @renderer.output
   end
-  
+
+  def self.set_yaml_file(file)
+    @@yaml_file = file &&  YAML::load_file(file)
+  end
+
   def points ; questions.map(&:points).inject { |sum,points| sum + points } ; end
 
   def num_questions ; questions.length ; end
@@ -57,7 +63,7 @@ class Quiz
   def random_seed(num)
     @seed = num.to_i
   end
-  
+
   # this should really be done using mixins.
   def choice_answer(*args, &block)
     if args.first.is_a?(Hash) # no question text
@@ -72,7 +78,7 @@ class Quiz
 
   def select_multiple(*args, &block)
     if args.first.is_a?(Hash) # no question text
-      q = SelectMultiple.new('',*args)
+      q = SelectMultiple.new('', *args)
     else
       text = args.shift
       q = SelectMultiple.new(text, *args)
@@ -86,6 +92,32 @@ class Quiz
     @questions << q
   end
 
+  def dropdown(*args, &block)
+    q = Dropdown.new(*args)
+    q.instance_eval(&block)
+    @questions << q
+  end
+  
+  def open_assessment(*args, &block)
+    q = get_open_assessment(*args, &block)
+    @questions << q
+  end
+
+  def simple_open_assessment(*args, &block)
+    q = get_open_assessment(*args, &block)
+    q.add_simple_question
+    @questions << q
+  end
+
+  def get_open_assessment(*args, &block)
+    y = @quiz_yaml.shift
+    raise "Cannot continue - You must have a yaml block for each peer evaluation question" if y.nil?
+    yaml = y[1][0]
+    q = OpenAssessment.new(*args, yaml)
+    q.instance_eval(&block)
+    q
+  end
+
   def fill_in(*args, &block)
     if args.first.is_a?(Hash) # no question text
       q = FillIn.new('', *args)
@@ -97,8 +129,8 @@ class Quiz
     @questions << q
   end
 
-  def self.quiz(*args,&block)
-    quiz = Quiz.new(*args)
+  def self.quiz(*args, &block)
+    quiz = Quiz.new(*args, (@@yaml_file.shift if @@yaml_file))
     quiz.instance_eval(&block)
     @@quizzes << quiz
   end

data/lib/ruql/renderer.rb

@@ -17,4 +17,12 @@ class Renderer
     self.instance_eval@@render_handlers[:quiz].call(self.quiz)
   end
 
+  # Override these methods in each renderer:
+
+  %w(fill_in multiple_choice select_multiple dropdown open_assessment true_false).each do |q|
+    define_method "render_#{q}" do |question|
+      STDERR.puts "Question type '#{q}' not yet implemented for this renderer"
+    end
+  end
+  
 end

data/lib/ruql/renderers/auto_qcm_renderer.rb

@@ -12,6 +12,8 @@ class AutoQCMRenderer
       options.delete('template') ||
       File.join(Gem.loaded_specs['ruql'].full_gem_path, 'templates/autoqcm.tex.erb')
     @penalty = (options.delete('p') || options.delete('penalty') || '0').to_f
+    @show_solutions = options.delete('s') || options.delete('solutions')
+    
   end
 
   def render_quiz
@@ -34,8 +36,8 @@ class AutoQCMRenderer
 
   def render_question(q,index)
     case q
+    when SelectMultiple,TrueFalse then render(q, index, 'mult') # These are subclasses of MultipleChoice, should go first
     when MultipleChoice then render(q, index)
-    when SelectMultiple,TrueFalse then render(q, index, 'mult')
     else
       @quiz.logger.error "Question #{index} (#{q.question_text[0,15]}...): AutoQCM can only handle multiple_choice, truefalse, or select_multiple questions"
       ''
@@ -48,10 +50,15 @@ class AutoQCMRenderer
     @output << "\\AMCrandomseed{#{seed}}\n\n"
   end
   
-  def render(question, index, type='')
+  def render(question, index, type='')    
     output = ''
     output << "\\begin{question#{type}}{q#{index}}\n"
     output << "  \\scoring{b=#{question.points},m=#{@penalty*question.points}}\n"
+    if type == 'mult'
+      question.question_text = "Select ALL that apply. " + question.question_text
+    elsif type == ''
+      question.question_text = "Choose ONE answer. " + question.question_text
+    end
     output << "  " << to_tex(question.question_text) << "\n"
 
     # answers - ignore randomization
@@ -61,9 +68,17 @@ class AutoQCMRenderer
       answer_text = to_tex(answer.answer_text)
       answer_type = if answer.correct? then 'correct' else 'wrong' end
       output << "    \\#{answer_type}choice{#{answer_text}}\n"
+      if @show_solutions and answer.explanation
+        explanation = to_tex(answer.explanation)
+        if answer_type == 'wrong'
+          output << "{\\color{red}\\tab #{explanation}}"
+        else
+          output << "{\\color[rgb]{0,.5,0}\\tab #{explanation}}"
+        end
+      end
     end
     output << "  \\end{choices}\n"
-    output << "\\end{question}\n\n"
+    output << "\\end{question#{type}}\n\n"
     output
   end
 

data/lib/ruql/renderers/edxml_renderer.rb

@@ -1,7 +1,10 @@
+require 'builder'
+require 'yaml'
+
 class EdXmlRenderer
-  require 'builder'
 
   attr_reader :output
+  attr_accessor :file, :yaml_file
   def initialize(quiz,options={})
     @only_question = options.delete('n') || options.delete('name')
     @output = ''
@@ -13,11 +16,13 @@ class EdXmlRenderer
     case thing
     when MultipleChoice,SelectMultiple,TrueFalse then render_multiple_choice(thing)
     when FillIn then render_fill_in(thing)
+    when OpenAssessment then render_open_assessment(thing)
+    when Dropdown then render_dropdown(thing)
     else
       raise "Unknown question type: #{thing}"
     end
   end
-  
+
   def render_quiz
     # entire quiz can be in one question group, as long as we specify
     # that ALL question from the group must be used to make the quiz.
@@ -29,11 +34,16 @@ class EdXmlRenderer
     @output
   end
 
-  def render_fill_in(question)
-    raise "Not yet implemented for edXML"
-  end
-
   def render_multiple_choice(question)
+    # the OLX for select-multiple and select-one are frustratingly different in arbitrary ways
+    # single choice has <multiplechoiceresponse> element containing a <choicegroup> with <choice>s
+    # select-mult has <choiceresponse> element containing a <checkboxgroup> with <choice>s
+
+    question_type, answer_type =
+      if question.kind_of?(SelectMultiple)
+      then ['choiceresponse', 'checkboxgroup']
+      else ['multiplechoiceresponse', 'choicegroup']
+      end
     @b.problem do
       # if question text has explicit newlines, use them to separate <p>'s
       if question.raw?
@@ -43,32 +53,147 @@ class EdXmlRenderer
           if question.raw? then @b.p { |p| p << line } else @b.p(line) end
         end
       end
-      @b.multiplechoiceresponse do
-        @b.choicegroup :type => 'MultipleChoice' do
+
+      @b.__send__(question_type) do
+        @b.__send__(answer_type, :type => 'MultipleChoice') do
           question.answers.each do |answer|
             if question.raw?
-              @b.choice(:correct => answer.correct?) do |choice|
-                choice << answer.answer_text
-                choice << "\n"
-              end
+              @b.choice(:correct => answer.correct?) { @b << answer.answer_text.chomp }
             else
               @b.choice answer.answer_text, :correct => answer.correct?
             end
           end
         end
       end
-      @b.solution do
-        @b.div :class => 'detailed_solution' do
-          @b.p 'Explanation'
-          if question.raw?
-            @b.p { |p| p << question.correct_answer.explanation }
-          else
-            @b.p question.correct_answer.explanation
+      if (ans = question.correct_answer.explanation)
+        @b.solution do
+          @b.div :class => 'detailed-solution' do
+            @b.p 'Explanation'
+            if question.raw?
+              @b.p { |p| p << ans }
+            else
+              @b.p ans
+            end
           end
         end
       end
     end
   end
 
-end
+  def render_dropdown(question)
+    @b.problem do
+      if question.raw?
+        @b.p { |p| p << question.question_text }
+      else
+        question.question_text.lines.map(&:chomp).each do |line|
+          if question.raw? then @b.p { |p| p << line } else @b.p(line) end
+        end
+      end
+      question.choices.each do |choice|
+        idx = choice.correct
+        menu_opts = choice.list
+        if menu_opts.length == 1 # this is actually a label
+          @b.span menu_opts[0]
+        else
+          @b.optionresponse do
+            debugger if menu_opts[idx].nil?
+            @b.optioninput :options => options_list_for_attribute(menu_opts),
+            :correct => escape_doublequotes(menu_opts[idx])
+          end
+        end
+      end
+    end
+  end
+  
+  def render_open_assessment(question)
+    @b.openassessment url_name: question.url_name,
+                      submission_start: "#{question.submission_start.to_s}T"\
+                                        "#{question.submission_start_time}:00+00:00",
+                      submission_due: "#{question.submission_due.to_s}T"\
+                                      "#{question.submission_due_time}:00+00:00",
+                      allow_file_upload: question.allow_file_upload.to_s.capitalize,
+                      allow_latex: question.allow_latex.to_s.capitalize do
+
+      @b.title question.question_title
 
+      # Oh good lord my eyes
+      @b.assessments do
+        if question.trainings.size > 0
+          @b.assessment name: "student-training" do
+            question.trainings.each do |training|
+              @b.example do
+                @b.answer do
+                  @b.part training.training_answer
+                end
+                training.training_criterions.each do |criterion|
+                  @b.select criterion: criterion.criterion,
+                            option:    criterion.option
+                end
+              end
+            end
+          end
+        end
+
+        if question.peer_review
+          @b.assessment name: "peer-assessment",
+                        must_grade: question.must_grade,
+                        must_be_graded_by: question.graded_by,
+                        start: "#{question.peer_review_start.to_s}T" \
+                               "#{question.peer_review_start_time}:00+00:00",
+                        due: "#{question.peer_review_due.to_s}T"\
+                             "#{question.peer_review_due_time}:00+00:00"
+
+        end
+
+        if question.self_assessment
+          @b.assessment name: "self-assessment",
+                        start: "#{question.self_assessment_start.to_s}T"\
+                               "#{question.self_assessment_start_time}:00+00:00",
+                        due: "#{question.self_assessment_due.to_s}T"\
+                             "#{question.self_assessment_due_time}:00+00:00"
+        end
+      end
+
+      @b.prompts do
+        question.prompts.each do |description|
+          @b.prompt do
+            @b.description description
+          end
+        end
+      end
+
+      @b.rubric do
+        question.criterions.each do |criterion|
+          @b.criterion feedback: criterion.feedback do
+            @b.name   criterion.criterion_name
+            @b.label  criterion.criterion_label
+            @b.prompt criterion.criterion_prompt
+
+            criterion.options.each do |option|
+              @b.option points: option.points do
+                @b.name        option.opt_name
+                @b.label       option.opt_label
+                @b.explanation option.opt_explanation
+              end
+            end
+          end
+        end
+        @b.feedbackprompt        question.question_feedback_prompt
+        @b.feedback_default_text question.question_feedback_default_text
+      end
+    end
+  end
+
+  private
+
+  def escape_doublequotes(str)
+    str.gsub(/"/, '&quot;') 
+  end
+
+  def options_list_for_attribute(list)
+    # takes a list of strings, places single quotes around each element
+    # and HTML-escapes doublequotes within any element. Because OLX.
+    attr = list.map { |e| "'" << escape_doublequotes(e) << "'" }.join(',')
+    "(#{attr})"
+  end
+end

data/lib/ruql/renderers/qualtrics_renderer.rb

@@ -0,0 +1,63 @@
+class QualtricsRenderer
+
+  attr_reader :output
+  
+  def initialize(quiz, options={})
+    @output = ''
+    @quiz = quiz
+    @template = options.delete('t') || options.delete('template')
+  end
+
+  def render_quiz
+    quiz = @quiz                # make quiz object available in template's scope
+    with_erb_template(IO.read(File.expand_path @template)) do
+      output = ''
+      @quiz.questions.each_with_index do |q,i|
+        next_question = render_question q,i
+        output << next_question
+      end
+      output
+    end
+  end
+
+  def with_erb_template(template)
+    # template will 'yield' back to render_quiz to render the questions
+    @output = ERB.new(template).result(binding)
+  end
+
+  def render_question(q,index)
+    case q
+    when SelectMultiple,TrueFalse then render(q, index, 'Multiple') # These are subclasses of MultipleChoice, should go first
+    when MultipleChoice then render(q, index, 'Single')
+    else
+      @quiz.logger.error "Question #{index} (#{q.question_text[0,15]}...): Only written to handle multiple_choice, truefalse, or select_multiple questions at this time."
+      ''
+    end
+  end
+  
+  def render(question, index, type='')    
+    output = ''
+    output << "[[Question:MC:#{type}Answer]]\n"
+    output << "[[ID:#{index}]]\n"
+    if type == 'Multiple'
+      question.question_text = "Select ALL that apply. " + question.question_text
+    elsif type == 'Single'
+      question.question_text = "Choose ONE answer. " + question.question_text
+    end
+    output << question.question_text << "\n"
+
+    # answers - ignore randomization
+
+    output << "[[AdvancedChoices]]\n"
+    question.answers.each do |answer|
+      output << "[[Choice]]\n"
+      output << "#{answer.answer_text}\n"
+    end
+    if type == 'Multiple'
+      output << "[[Choice]]\n"
+      output << "<i>None of these answers are correct.</i>\n"
+    end
+    output
+  end
+
+end

data/lib/ruql/tex_output.rb

@@ -1,15 +1,24 @@
 module TexOutput
 
+  def add_newlines(str)
+    str.gsub(Regexp.new('<pre>(.*?)</pre>', Regexp::MULTILINE | Regexp::IGNORECASE) ) do |code_section|
+      code_section.gsub!("\n"){"\\\\"}
+      code_section.gsub!("  "){"\\hspace*{2em}"}      
+    end
+  end
+  
   @@tex_replace = {
     /_/ => '\textunderscore{}',
     Regexp.new('<tt>([^<]+)</tt>', Regexp::IGNORECASE) => "\\texttt{\\1}",
-    Regexp.new('<pre>(.*?)</pre>', Regexp::MULTILINE | Regexp::IGNORECASE) => "\\begin{Verbatim}\\1\\end{Verbatim}",
+    Regexp.new('<pre>(.*?)</pre>', Regexp::MULTILINE | Regexp::IGNORECASE) => "\\texttt{\\1}",
   }
 
   @@tex_escape = Regexp.new '\$|&|%|#|\{|\}'
 
   def to_tex(str)
     str = str.gsub(@@tex_escape) { |match| "\\#{match}" }
+    str = add_newlines(str)
+    
     @@tex_replace.each_pair do |match, replace|
       str = str.gsub(match, replace)
     end

data/lib/ruql.rb

@@ -1,6 +1,7 @@
 # basic gems/libs we rely on
 require 'builder'
 require 'logger'
+require 'date'
 
 $LOAD_PATH.unshift File.expand_path(File.join(File.dirname(__FILE__)))
 
@@ -11,6 +12,7 @@ require 'ruql/renderers/html_form_renderer'
 require 'ruql/renderers/edxml_renderer'
 require 'ruql/renderers/auto_qcm_renderer'
 require 'ruql/renderers/json_renderer'
+require 'ruql/renderers/qualtrics_renderer'
 
 # question types
 require 'ruql/quiz'
@@ -20,3 +22,9 @@ require 'ruql/multiple_choice'
 require 'ruql/select_multiple'
 require 'ruql/true_false'
 require 'ruql/fill_in'
+require 'ruql/dropdown'
+require 'ruql/open_assessment/open_assessment'
+require 'ruql/open_assessment/criterion'
+require 'ruql/open_assessment/option'
+require 'ruql/open_assessment/training'
+require 'ruql/open_assessment/training_criterion'

metadata

@@ -1,48 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: ruql
 version: !ruby/object:Gem::Version
-  version: 0.0.4
-  prerelease: 
+  version: 0.0.8
 platform: ruby
 authors:
 - Armando Fox
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-25 00:00:00.000000000 Z
+date: 2016-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: builder
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
+        version: '3.0'
   prerelease: false
+  name: builder
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.0'
+  type: :runtime
 - !ruby/object:Gem::Dependency
-  name: getopt
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
+        version: 1.4.2
   prerelease: false
+  name: getopt
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.4.2
+  type: :runtime
 description: Ruby-embedded DSL for creating short-answer quiz questions
 email: fox@cs.berkeley.edu
 executables:
@@ -50,49 +45,55 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- bin/ruql
 - lib/ruql.rb
-- lib/ruql/quiz.rb
 - lib/ruql/answer.rb
-- lib/ruql/question.rb
-- lib/ruql/renderer.rb
-- lib/ruql/select_multiple.rb
+- lib/ruql/dropdown.rb
 - lib/ruql/fill_in.rb
 - lib/ruql/multiple_choice.rb
-- lib/ruql/true_false.rb
-- lib/ruql/tex_output.rb
+- lib/ruql/open_assessment/criterion.rb
+- lib/ruql/open_assessment/open_assessment.rb
+- lib/ruql/open_assessment/option.rb
+- lib/ruql/open_assessment/training.rb
+- lib/ruql/open_assessment/training_criterion.rb
+- lib/ruql/question.rb
+- lib/ruql/quiz.rb
+- lib/ruql/renderer.rb
 - lib/ruql/renderers/auto_qcm_renderer.rb
 - lib/ruql/renderers/edxml_renderer.rb
 - lib/ruql/renderers/html5_renderer.rb
 - lib/ruql/renderers/html_form_renderer.rb
 - lib/ruql/renderers/json_renderer.rb
+- lib/ruql/renderers/qualtrics_renderer.rb
 - lib/ruql/renderers/xml_renderer.rb
+- lib/ruql/select_multiple.rb
+- lib/ruql/tex_output.rb
+- lib/ruql/true_false.rb
 - templates/autoqcm.tex.erb
 - templates/html5.html.erb
 - templates/htmlform.html.erb
-- bin/ruql
 homepage: http://github.com/saasbook/ruql
 licenses:
 - CC By-SA
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.25
+rubygems_version: 2.2.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Ruby question language
 test_files: []