qti 2.26.1 → 2.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d185ca9468c4d41b04a10ffc8fdddc3b443ecd632de1f5b64c68dde754da375e
-  data.tar.gz: 5d47f324498c8c1d0bbb42eea2dbc08976aa7836c0cd6c386456f0e2bd5b86b5
+  metadata.gz: e41a3a5f23ea40d864c780f298babfa504ff43ec2db3b45b2601ab52233745b0
+  data.tar.gz: 4258a94f2294a5d54a4e5fbe91b52b53d2942baaea5496d6cf989e3f5c87cffe
 SHA512:
-  metadata.gz: c61f7ecb24c47c98892d9edf31f1d145d7f3acddd9fab59c22dc15d0559a3e1c531046f33bee05790aff8db27b1d785d38554ac15eb994025b2dc0713e8e2586
-  data.tar.gz: e2fc18ee5e506a6db953868dd5e90e69e418f04054be671250c6fa55fa375cd8ba9954e7f3d90ec6f4b819abad673eef8344723671cd45b7c11d3e0972d4e50d
+  metadata.gz: 9430cbbbec8edd4361403e47f35dfea883431a9edd3519bc56b361f211af0ae3c0a8e51bc32bba4ee40360b725d354c7faa3517d50ffecb51b33970691ee065e
+  data.tar.gz: 8ba772bb5cbbc3d492c37bd015052dd70e5c0ddbd01923a51959067a67ea407db8e91b14b3bd9c83452678e05ff80626a53f3750384d37d77ae680b7dbc60635

data/lib/qti/models/assessment_meta.rb

@@ -331,6 +331,14 @@ module Qti
         tag_under_quiz('hide_item_response_correctness_at')
       end
 
+      def disable_document_access
+        tag_under_quiz('disable_document_access')
+      end
+
+      def disable_document_access?
+        string_true?(disable_document_access)
+      end
+
       private
 
       def tag_under_quiz(tag)
@@ -367,6 +375,7 @@ module Qti
         :display_item_response_qualifier, :show_item_responses_at,
         :hide_item_responses_at, :display_item_response_correctness_qualifier,
         :show_item_response_correctness_at, :hide_item_response_correctness_at,
+        :disable_document_access?,
         to: :@canvas_meta_data, prefix: :canvas, allow_nil: true
 
       alias canvas_instructions canvas_description

data/lib/qti/v1/models/stimulus_item.rb

@@ -54,13 +54,30 @@ module Qti
           end
         end
 
+        def default_orientation
+          passage == 'true' ? 'top' : 'left'
+        end
+
         def orientation
           @orientation ||= begin
             presentation = @node.at_xpath('.//xmlns:presentation')
-            return 'left' if presentation.blank?
-            presentation.at_xpath('.//xmlns:material')&.attributes&.[]('orientation')&.value || 'left'
+            return default_orientation if presentation.blank?
+
+            orientation_value = presentation.at_xpath('.//xmlns:material')&.attributes&.[]('orientation')&.value
+            orientation_value.presence || default_orientation
           end
         end
+
+        def passage_qti_metadata?
+          qti_metadata_children.children.any? { |node| node.text == 'passage' }
+        end
+
+        def passage
+          return false unless passage_qti_metadata?
+
+          passage_label = qti_metadata_children.children.find { |node| node.text == 'passage' }
+          passage_label&.next&.text.presence || false
+        end
       end
     end
   end

data/lib/qti/v2/models/stimulus_item.rb

@@ -37,6 +37,10 @@ module Qti
         def orientation
           'left'
         end
+
+        def passage
+          false
+        end
       end
     end
   end

data/lib/qti/version.rb

@@ -1,3 +1,3 @@
 module Qti
-  VERSION = '2.26.1'.freeze
+  VERSION = '2.28.0'.freeze
 end

data/spec/fixtures/items_1.2/stimulus.xml

@@ -31,6 +31,10 @@
               <fieldlabel>source_url</fieldlabel>
               <fieldentry>https://sourceurl.com</fieldentry>
             </qtimetadatafield>
+            <qtimetadatafield>
+              <fieldlabel>passage</fieldlabel>
+              <fieldentry>false</fieldentry>
+            </qtimetadatafield>
           </qtimetadata>
         </itemmetadata>
         <presentation>

data/spec/fixtures/items_1.2/stimulus_passage.xml

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<questestinterop xmlns="http://www.imsglobal.org/xsd/ims_qtiasiv1p2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.imsglobal.org/xsd/ims_qtiasiv1p2 http://www.imsglobal.org/xsd/ims_qtiasiv1p2p1.xsd">
+  <assessment ident="i1e5e0d6fba7342e63ae43afe9863070d" title="Quiz.text">
+    <qtimetadata>
+      <qtimetadatafield>
+        <fieldlabel>cc_maxattempts</fieldlabel>
+        <fieldentry>1</fieldentry>
+      </qtimetadatafield>
+    </qtimetadata>
+    <section ident="root_section">
+      <item ident="d74b47a4abeeed159e030bfecbcecea2" title="some title" instructions="some instructions">
+        <itemmetadata>
+          <qtimetadata>
+            <qtimetadatafield>
+              <fieldlabel>question_type</fieldlabel>
+              <fieldentry>text_only_question</fieldentry>
+            </qtimetadatafield>
+            <qtimetadatafield>
+              <fieldlabel>points_possible</fieldlabel>
+              <fieldentry>0.0</fieldentry>
+            </qtimetadatafield>
+            <qtimetadatafield>
+              <fieldlabel>original_answer_ids</fieldlabel>
+              <fieldentry/>
+            </qtimetadatafield>
+            <qtimetadatafield>
+              <fieldlabel>assessment_question_identifierref</fieldlabel>
+              <fieldentry>9f47365e112840d80a79a960b1b0b6a7</fieldentry>
+            </qtimetadatafield>
+            <qtimetadatafield>
+              <fieldlabel>source_url</fieldlabel>
+              <fieldentry>https://sourceurl.com</fieldentry>
+            </qtimetadatafield>
+            <qtimetadatafield>
+              <fieldlabel>passage</fieldlabel>
+              <fieldentry>true</fieldentry>
+            </qtimetadatafield>
+          </qtimetadata>
+        </itemmetadata>
+        <presentation>
+          <material orientation="top">
+            <mattext texttype="text/html">&lt;p&gt;passage content&lt;/p&gt;</mattext>
+          </material>
+        </presentation>
+      </item>
+    </section>
+  </assessment>
+</questestinterop>

data/spec/fixtures/test_qti_1.2_canvas_extended_1/gba044ae1fc7cfd3dc413e0df695e0068/assessment_meta.xml

@@ -33,6 +33,7 @@
   <one_time_results>false</one_time_results>
   <show_correct_answers_last_attempt>false</show_correct_answers_last_attempt>
   <allow_clear_mc_selection>true</allow_clear_mc_selection>
+  <disable_document_access>true</disable_document_access>
   <only_visible_to_overrides>false</only_visible_to_overrides>
   <module_locked>false</module_locked>
   <nq_ip_filter from="255.255.0.0" to="255.255.0.255"/>

data/spec/lib/qti/models/assessment_meta_spec.rb

@@ -57,6 +57,7 @@ context 'Canvas Assessment Meta Data' do
         .to eq(display_item_response_correctness_qualifier)
       expect(assessment.canvas_show_item_response_correctness_at).to eq(show_item_response_correctness_at)
       expect(assessment.canvas_hide_item_response_correctness_at).to eq(hide_item_response_correctness_at)
+      expect(assessment.canvas_disable_document_access?).to eq(disable_document_access)
     end
   end
 
@@ -112,6 +113,7 @@ context 'Canvas Assessment Meta Data' do
     let(:hide_item_responses_at) { nil }
     let(:show_item_response_correctness_at) { nil }
     let(:hide_item_response_correctness_at) { nil }
+    let(:disable_document_access) { false }
 
     include_examples('loads canvas meta data')
   end
@@ -173,6 +175,7 @@ context 'Canvas Assessment Meta Data' do
     let(:hide_item_responses_at) { '2024-07-21 11:59:00 UTC' }
     let(:show_item_response_correctness_at) { '2024-07-19 06:00:00 UTC' }
     let(:hide_item_response_correctness_at) { '2024-07-22 11:59:00 UTC' }
+    let(:disable_document_access) { true }
 
     include_examples('loads canvas meta data')
   end
@@ -229,6 +232,7 @@ context 'Canvas Assessment Meta Data' do
     let(:hide_item_responses_at) { nil }
     let(:show_item_response_correctness_at) { nil }
     let(:hide_item_response_correctness_at) { nil }
+    let(:disable_document_access) { false }
 
     include_examples('loads canvas meta data')
   end
@@ -285,6 +289,7 @@ context 'Canvas Assessment Meta Data' do
     let(:hide_item_responses_at) { nil }
     let(:show_item_response_correctness_at) { nil }
     let(:hide_item_response_correctness_at) { nil }
+    let(:disable_document_access) { false }
 
     include_examples('loads canvas meta data')
   end

data/spec/lib/qti/v1/models/stimulus_item_spec.rb

@@ -59,7 +59,24 @@ describe Qti::V1::Models::StimulusItem do
     {
       source_url: 'https://sourceurl.com',
       instructions: 'some instructions',
-      orientation: 'top'
+      orientation: 'top',
+      passage: 'false'
+    }.each do |key, value|
+      it "returns the correct #{key}" do
+        expect(stimulus_item.send(key)).to eq(value)
+      end
+    end
+  end
+
+  context 'when the passage item was generated by New Quizzes' do
+    let(:file_path) { File.join('spec', 'fixtures', 'items_1.2', 'stimulus_passage.xml') }
+    let(:test_object) { Qti::V1::Models::Assessment.from_path!(file_path) }
+    let(:stimulus_item) { test_object.create_stimulus(test_object.assessment_items.first) }
+    {
+      source_url: 'https://sourceurl.com',
+      instructions: 'some instructions',
+      orientation: 'top',
+      passage: 'true'
     }.each do |key, value|
       it "returns the correct #{key}" do
         expect(stimulus_item.send(key)).to eq(value)
@@ -75,7 +92,8 @@ describe Qti::V1::Models::StimulusItem do
     {
       source_url: nil,
       instructions: nil,
-      orientation: 'left'
+      orientation: 'left',
+      passage: false
     }.each do |key, value|
       it "returns the correct #{key}" do
         expect(stimulus_item.send(key)).to eq(value)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: qti
 version: !ruby/object:Gem::Version
-  version: 2.26.1
+  version: 2.28.0
 platform: ruby
 authors:
 - Adrian Diaz
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-31 00:00:00.000000000 Z
+date: 2025-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -423,6 +423,7 @@ files:
 - spec/fixtures/items_1.2/question_group.xml
 - spec/fixtures/items_1.2/single_fib.xml
 - spec/fixtures/items_1.2/stimulus.xml
+- spec/fixtures/items_1.2/stimulus_passage.xml
 - spec/fixtures/items_1.2/stimulus_with_child_item.xml
 - spec/fixtures/items_1.2/text.no.question.xml
 - spec/fixtures/items_1.2/true_false.xml
@@ -806,6 +807,7 @@ test_files:
 - spec/fixtures/items_1.2/question_group.xml
 - spec/fixtures/items_1.2/single_fib.xml
 - spec/fixtures/items_1.2/stimulus.xml
+- spec/fixtures/items_1.2/stimulus_passage.xml
 - spec/fixtures/items_1.2/stimulus_with_child_item.xml
 - spec/fixtures/items_1.2/text.no.question.xml
 - spec/fixtures/items_1.2/true_false.xml