ams_migration 0.1.3

data/spec/lib/canvas/converter/new_quiz/stimulus_spec.rb

@@ -0,0 +1,20 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::NewQuiz::Stimulus do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "new_quiz", "stimulus.json")) }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to a text return value" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq('<p><strong>Instructions</strong></p><p>Here are some instructions</p><p><strong>Stimulus Title</strong></p><p>The content in <sub>question</sub>. With <strong>some</strong> funky <span style="text-decoration: underline;">extra</span> <em>words</em> <span style="color: #f1c40f;">that</span> I can <span style="background-color: #843fa1;">format</span></p><p><img src="https://dummy-inscloudgate.net/files/3ec7226b-fd6d-49df-8236-cb52001ea10b?token=eyJ0eXAiOiJKV1QiLCJhbGciOi" alt="Alternative Text" /></p>')
+    expect(conversion[:title]).to eq("Stimulus Title")
+  end
+end

data/spec/lib/canvas/converter/new_quiz/true_false_spec.rb

@@ -0,0 +1,24 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::NewQuiz::TrueFalse do
+  let(:question) { File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "new_quiz", "true_false.json")) }
+
+  subject { described_class.new(question) }
+
+  it_behaves_like "handles common errors"
+
+  it "converts to true false item" do
+    conversion = subject.convert
+    expect(conversion[:question]).to eq({ stimulus: '<p>This is<span style="color: #f1c40f;"> the</span> stem/stimulus <strong>with</strong> <span style="text-decoration: underline;">some</span> formatting</p><p><img src="https://dummy-inscloudgate.net/files/3ec7226b-fd6d-49df-8236-cb52001ea10b?token=eyJ0eXAiOiJKV1QiLCJhbGciOi" alt="Alternative Text" /></p>',
+                                          options: [{ label: "True", value: "0" },
+                                                    { label: "False", value: "1" }],
+                                          type: "mcq",
+                                          validation: { valid_response: { score: 1, value: ["0"] },
+                                                        scoring_type: "exactMatch" } })
+  end
+end

data/spec/lib/canvas/converter/new_quiz/unknown_spec.rb

@@ -0,0 +1,36 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require_relative "../common_error"
+
+describe AmsMigration::Canvas::Converter::NewQuiz::Unknown do
+  let(:question) do
+    File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "new_quiz", "unknown.json"))
+  end
+
+  subject { described_class.new(question) }
+
+  it "returns errors with malformed json" do
+    subject = described_class.new('{"this is": "not valid json" xyz }')
+    conversion = subject.convert
+    expect(conversion[:errors].length).to be >= 1
+  end
+
+  it "returns with question type error" do
+    conversion = subject.convert
+    expect(conversion[:errors]).to include("Unknown question type: Unknown")
+  end
+
+  context "With unsupported Bank entry type" do
+    let(:question) do
+      File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "new_quiz", "bank_item.json"))
+    end
+
+    it "returns with entry type error" do
+      conversion = subject.convert
+      expect(conversion[:errors]).to include("Unsupported entry type: Bank")
+    end
+  end
+end

data/spec/lib/factories/classic_quiz_item_converter_factory_spec.rb

@@ -0,0 +1,183 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+
+describe AmsMigration::CanvasQuizzes::ClassicQuizItemConverterFactory do
+  describe ".create_converter" do
+    subject { described_class.create_converter(item) }
+
+    context "when item is a multiple choice question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::MULTI_CHOICE
+        }
+      end
+
+      it "returns a MultipleChoice converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::MultipleChoice)
+      end
+    end
+
+    context "when item is a multiple answers question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::MULTIPLE_ANSWERS
+        }
+      end
+
+      it "returns a MultipleAnswer converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::MultipleAnswer)
+      end
+    end
+
+    context "when item is a matching question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::MATCHING
+        }
+      end
+
+      it "returns a Matching converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::Matching)
+      end
+    end
+
+    context "when item is a fill in blank question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::FILL_IN_BLANK
+        }
+      end
+
+      it "returns a FillInBlank converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::FillInBlank)
+      end
+    end
+
+    context "when item is a fill in multiple blanks question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::FILL_IN_MULTIPLE_BLANKS
+        }
+      end
+
+      it "returns a FillInMultipleBlanks converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::FillInMultipleBlanks)
+      end
+    end
+
+    context "when item is a multiple dropdowns question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::MULTIPLE_DROPDOWNS
+        }
+      end
+
+      it "returns a MultipleDropdown converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::MultipleDropdown)
+      end
+    end
+
+    context "when item is a true/false question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::TRUE_FALSE
+        }
+      end
+
+      it "returns a TrueFalse converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::TrueFalse)
+      end
+    end
+
+    context "when item is a numerical question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::NUMERICAL
+        }
+      end
+
+      it "returns a Numerical converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::Numerical)
+      end
+    end
+
+    context "when item is a text only question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::TEXT_ONLY
+        }
+      end
+
+      it "returns a Text converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::Text)
+      end
+    end
+
+    context "when item is a calculated question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::CALCULATED
+        }
+      end
+
+      it "returns a Calculated converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::Calculated)
+      end
+    end
+
+    context "when item is a file upload question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::FILE_UPLOAD
+        }
+      end
+
+      it "returns a FileUpload converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::FileUpload)
+      end
+    end
+
+    context "when item is an essay question" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::ESSAY
+        }
+      end
+
+      it "returns an Essay converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::Essay)
+      end
+    end
+
+    context "when item type is unknown" do
+      let(:item) do
+        {
+          "question_type" => "unknown-type"
+        }
+      end
+
+      it "returns an Unknown converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::ClassicQuiz::Unknown)
+      end
+    end
+
+    context "when converting item to json" do
+      let(:item) do
+        {
+          "question_type" => AmsMigration::Canvas::Converter::ClassicQuiz::ClassicQuestion::MULTI_CHOICE,
+          "question_text" => "Sample question"
+        }
+      end
+
+      it "passes the json representation to the converter" do
+        allow(AmsMigration::Canvas::Converter::ClassicQuiz::MultipleChoice).to receive(:new)
+        described_class.create_converter(item)
+        expect(AmsMigration::Canvas::Converter::ClassicQuiz::MultipleChoice)
+          .to have_received(:new).with(item.to_json)
+      end
+    end
+  end
+end

data/spec/lib/factories/new_quiz_item_converter_factory_spec.rb

@@ -0,0 +1,71 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+
+describe AmsMigration::CanvasQuizzes::NewQuizItemConverterFactory do
+  let(:item_type) { "unknown" }
+  let(:item) do
+    JSON.parse(File.read(File.join(SPEC_ROOT, "fixtures", "sample_data", "new_quiz", "#{item_type}.json")))
+  end
+
+  describe ".create_converter" do
+    subject { described_class.create_converter(item) }
+    context "when item is a multiple choice question" do
+      let(:item_type) { "multiple_choice" }
+
+      it "returns a MultipleChoice converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::NewQuiz::MultipleChoice)
+      end
+    end
+
+    context "when item is a multiple answer question" do
+      let(:item_type) { "multiple_answer" }
+
+      it "returns a MultipleAnswer converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::NewQuiz::MultipleAnswer)
+      end
+    end
+
+    context "when item is a matching question" do
+      let(:item_type) { "matching" }
+
+      it "returns a Matching converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::NewQuiz::Matching)
+      end
+    end
+
+    context "when item is a stimulus" do
+      let(:item_type) { "stimulus" }
+
+      it "returns a Stimulus converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::NewQuiz::Stimulus)
+      end
+    end
+
+    # TODO: looks like it is not supported yet
+    context "when item is a bank entry" do
+      # let(:item_type) { 'bank_entry_item' }
+      let(:item) do
+        {
+          "entry_type" => "Item",
+          "archived" => false,
+          "entry" => {}
+        }
+      end
+
+      it "normalizes the item and returns appropriate converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::NewQuiz::Unknown)
+      end
+    end
+
+    context "when item type is unknown" do
+      let(:item_type) { "unknown" }
+
+      it "returns an Unknown converter" do
+        expect(subject).to be_a(AmsMigration::Canvas::Converter::NewQuiz::Unknown)
+      end
+    end
+  end
+end

data/spec/lib/services/learnosity_data_api_client_spec.rb

@@ -0,0 +1,130 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+require "webmock/rspec"
+require "logger"
+
+describe AmsMigration::Services::LearnosityDataApiClient do
+  let(:config) do
+    {
+      consumer_key: "test_consumer_key",
+      consumer_secret: "test_consumer_secret",
+      domain: "test.domain.com",
+      data_api_url: "https://data.learnosity.com/v1",
+      organization_id: "test_org_id",
+      logger: Logger.new(nil)
+    }
+  end
+
+  subject(:client) { described_class.new(config) }
+
+  describe "#post_request" do
+    let(:request_data) { { "test_key" => "test_value" } }
+    let(:endpoint) { "activities" }
+    let(:method) { "get" }
+    let(:expected_url) { "#{config[:data_api_url]}/itembank/#{endpoint}" }
+
+    context "when the request is successful" do
+      let(:response_body) do
+        {
+          "meta" => { "status" => true },
+          "data" => [{ "id" => "123" }]
+        }
+      end
+
+      before do
+        stub_request(:post, expected_url)
+          .to_return(
+            status: 200,
+            body: response_body.to_json,
+            headers: { "Content-Type" => "application/json" }
+          )
+      end
+
+      it "makes a POST request with the correct parameters" do
+        result = client.post_request(request_data, endpoint, method)
+
+        expect(result).to eq(response_body)
+        expect(WebMock).to have_requested(:post, expected_url)
+      end
+
+      it "includes organization_id in the request" do
+        client.post_request(request_data, endpoint, method)
+
+        expect(WebMock).to(have_requested(:post, expected_url)
+          .with do |req|
+            form_data = URI.decode_www_form(req.body).to_h
+            json_data = JSON.parse(form_data["request"])
+            expect(json_data["organisation_id"]).to eq(config[:organization_id])
+          end)
+      end
+
+      it "signs the request using Learnosity SDK" do
+        client.post_request(request_data, endpoint, method)
+
+        expect(WebMock).to(have_requested(:post, expected_url)
+          .with do |req|
+            form_data = URI.decode_www_form(req.body).to_h
+            expect(form_data.keys).to include("security")
+            expect(form_data.keys).to include("request")
+            expect(form_data.keys).to include("action")
+          end)
+      end
+    end
+
+    context "when the request fails" do
+      let(:error_response) do
+        {
+          "meta" => {
+            "status" => false,
+            "message" => "Invalid request"
+          },
+          "errors" => ["Something went wrong"]
+        }
+      end
+
+      before do
+        stub_request(:post, expected_url)
+          .to_return(
+            status: 400,
+            body: error_response.to_json,
+            headers: { "Content-Type" => "application/json" }
+          )
+      end
+
+      it "logs the error and returns the response" do
+        expect(config[:logger]).to receive(:debug).at_least(:once)
+        result = client.post_request(request_data, endpoint, method)
+        expect(result).to eq(error_response)
+      end
+    end
+
+    context "when response body is empty" do
+      before do
+        stub_request(:post, expected_url)
+          .to_return(
+            status: 200,
+            body: "",
+            headers: { "Content-Type" => "application/json" }
+          )
+      end
+
+      it "handles empty response gracefully" do
+        result = client.post_request(request_data, endpoint, method)
+        expect(result).to be_nil
+      end
+    end
+  end
+
+  describe "#security_packet" do
+    it "returns a hash with consumer_key and domain" do
+      security = client.send(:security_packet)
+      expect(security).to eq({
+                               "consumer_key" => config[:consumer_key],
+                               "domain" => config[:domain]
+                             })
+    end
+  end
+end

data/spec/lib/services/new_quiz_learnosity_transformer_spec.rb

@@ -0,0 +1,196 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "spec_helper"
+
+describe AmsMigration::Services::NewQuizLearnosityTransformer do
+  let(:root_account_uuid) { "test-account-123" }
+  let(:transformer) { described_class.new(root_account_uuid:) }
+  let(:quiz_id) { 456 }
+  let(:quiz_title) { "Sample Quiz" }
+  let(:item_id) { 789 }
+  let(:quiz_item) do
+    {
+      id: item_id,
+      position: 1,
+      title: "Sample Question"
+    }
+  end
+  let(:quiz) do
+    {
+      quiz: {
+        id: quiz_id,
+        title: quiz_title
+      },
+      quiz_items: [quiz_item]
+    }
+  end
+  let(:converted_item) do
+    {
+      title: "Sample Question",
+      question: {
+        type: "mcq",
+        stimulus: "What is the answer?",
+        options: []
+      }
+    }
+  end
+
+  before do
+    allow(AmsMigration::CanvasQuizzes::NewQuizItemConverterFactory).to receive(:create_converter)
+      .with(quiz_item)
+      .and_return(double(convert: converted_item))
+  end
+
+  describe "#transform" do
+    subject { transformer.transform(quiz) }
+
+    it "transforms quiz into Learnosity format" do
+      expect(subject).to include(
+        activities: [
+          {
+            "reference" => "a-nq-#{root_account_uuid}-#{quiz_id}",
+            "data" => {
+              "items" => ["i-nq-#{root_account_uuid}-#{item_id}"]
+            },
+            "title" => quiz_title,
+            "tags" => [
+              { "type" => "import_original_id", "name" => quiz_id.to_s },
+              { "type" => "import_account_id", "name" => root_account_uuid.to_s },
+              { "type" => "import_system", "name" => "NQ" }
+            ]
+          }
+        ],
+        items: [
+          {
+            "reference" => "i-nq-#{root_account_uuid}-#{item_id}",
+            "title" => "Sample Question",
+            "status" => "published",
+            "definition" => {
+              "widgets" => [
+                { "reference" => "q-nq-#{root_account_uuid}-#{item_id}" }
+              ]
+            },
+            "tags" => [
+              { "type" => "import_original_id", "name" => item_id.to_s },
+              { "type" => "import_account_id", "name" => root_account_uuid.to_s },
+              { "type" => "import_system", "name" => "NQ" }
+            ]
+          }
+        ],
+        questions: [
+          {
+            "reference" => "q-nq-#{root_account_uuid}-#{item_id}",
+            "type" => "mcq",
+            "data" => converted_item[:question]
+          }
+        ],
+        features: {}
+      )
+    end
+
+    context "when question type is unsupported" do
+      let(:converted_item) do
+        {
+          title: "Unsupported Question",
+          question: {
+            type: "unsupported_canvas_question_type"
+          }
+        }
+      end
+
+      it "excludes unsupported questions from the result" do
+        expect(subject).to include(
+          activities: [
+            {
+              "reference" => "a-nq-#{root_account_uuid}-#{quiz_id}",
+              "data" => { "items" => [] },
+              "title" => quiz_title,
+              "tags" => [
+                { "type" => "import_original_id", "name" => quiz_id.to_s },
+                { "type" => "import_account_id", "name" => root_account_uuid.to_s },
+                { "type" => "import_system", "name" => "NQ" }
+              ]
+            }
+          ],
+          items: [],
+          questions: [],
+          features: {}
+        )
+      end
+    end
+
+    context "when question data is empty" do
+      let(:converted_item) do
+        {
+          title: "Empty Question",
+          question: {}
+        }
+      end
+
+      it "excludes empty questions from the result" do
+        expect(subject).to include(
+          activities: [
+            {
+              "reference" => "a-nq-#{root_account_uuid}-#{quiz_id}",
+              "data" => { "items" => [] },
+              "title" => quiz_title,
+              "tags" => [
+                { "type" => "import_original_id", "name" => quiz_id.to_s },
+                { "type" => "import_account_id", "name" => root_account_uuid.to_s },
+                { "type" => "import_system", "name" => "NQ" }
+              ]
+            }
+          ],
+          items: [],
+          questions: [],
+          features: {}
+        )
+      end
+    end
+
+    context "with multiple quiz items" do
+      let(:item_id_2) { 790 }
+      let(:quiz_item_2) do
+        {
+          id: item_id_2,
+          position: 2,
+          title: "Second Question"
+        }
+      end
+      let(:converted_item_2) do
+        {
+          title: "Second Question",
+          question: {
+            type: "mcq",
+            stimulus: "What is the second answer?",
+            options: []
+          }
+        }
+      end
+
+      before do
+        quiz[:quiz_items] << quiz_item_2
+        allow(AmsMigration::CanvasQuizzes::NewQuizItemConverterFactory).to receive(:create_converter)
+          .with(quiz_item_2)
+          .and_return(double(convert: converted_item_2))
+      end
+
+      it "transforms all quiz items in correct order" do
+        expect(subject[:activities].first["data"]["items"]).to eq([
+                                                                    "i-nq-#{root_account_uuid}-#{item_id}",
+                                                                    "i-nq-#{root_account_uuid}-#{item_id_2}"
+                                                                  ])
+        expect(subject[:items].map { |i| i["reference"] }).to eq([
+                                                                   "i-nq-#{root_account_uuid}-#{item_id}",
+                                                                   "i-nq-#{root_account_uuid}-#{item_id_2}"
+                                                                 ])
+        expect(subject[:questions].map { |q| q["reference"] }).to eq([
+                                                                       "q-nq-#{root_account_uuid}-#{item_id}",
+                                                                       "q-nq-#{root_account_uuid}-#{item_id_2}"
+                                                                     ])
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,20 @@
+# Copyright (C) 2025 - present Instructure, Inc.
+# This code is made publicly available for educational and reference purposes only.
+# You may not copy, modify, redistribute, or use this code in any software or service without explicit permission.
+
+require "bundler/setup"
+require "ams_migration"
+require "webmock/rspec"
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end
+
+SPEC_ROOT = File.expand_path(__dir__)
+
+WebMock.disable_net_connect!(allow_localhost: true)