canvas_link_migrator 0.1.0

data/lib/canvas_link_migrator/resource_map_service.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2023 - present Instructure, Inc.
+#
+# This file is part of Canvas.
+#
+# Canvas is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, version 3 of the License.
+#
+# Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+# A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+module CanvasLinkMigrator
+  # This class encapsulates the logic to retrieve metadata (for various types of assets)
+  # given a migration id. This particular implementation relies on the migration object Canvas
+  # creates
+  #
+  # Each function returns exactly one id (if available), and nil if an id
+  # cannot be resolved
+  #
+  class ResourceMapService
+    attr_reader :migration_data
+
+    def initialize(migration_data)
+      @migration_data = migration_data
+    end
+
+    def resources
+      migration_data["resource_mapping"]
+    end
+
+    ### Overwritable methods
+    def supports_embedded_images
+      false
+    end
+
+    def fix_relative_urls?
+      true
+    end
+
+    def process_domain_substitutions(url)
+      url
+    end
+
+    def context_hosts
+      migration_data["destination_hosts"]
+    end
+
+    def attachment_path_id_lookup; end
+
+    def attachment_path_id_lookup_lower; end
+
+    def root_folder_name
+      migration_data["destination_root_folder"]
+    end
+    ### End of Ovewritable methods
+
+    # Returns the path for the context, for a course, it should return something like
+    # "courses/1"
+    def context_path
+      "/courses/#{migration_data["destination_course"]}"
+    end
+
+    # Looks up a wiki page slug for a migration id
+    def convert_wiki_page_migration_id_to_slug(migration_id)
+      resources.dig("wiki_pages", migration_id, "destination", "url")
+    end
+
+    # looks up a discussion topic
+    def convert_discussion_topic_migration_id(migration_id)
+      resources.dig("discussion_topics", migration_id, "destination", "id")
+    end
+
+    def convert_context_module_tag_migration_id(migration_id)
+      resources.dig("module_items", migration_id, "destination", "id")
+    end
+
+    def convert_attachment_migration_id(migration_id)
+      resources.dig("files", migration_id, "destination", "id")
+    end
+  end
+end

data/lib/canvas_link_migrator/version.rb

@@ -0,0 +1,3 @@
+module CanvasLinkMigrator
+  VERSION = "0.0.1"
+end

data/lib/canvas_link_migrator.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2023 - present Instructure, Inc.
+#
+# This file is part of Canvas.
+#
+# Canvas is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, version 3 of the License.
+#
+# Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+# A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+
+require "canvas_link_migrator/resource_map_service"
+require "canvas_link_migrator/imported_html_converter"
+require "canvas_link_migrator/link_parser"
+require "canvas_link_migrator/link_replacer"
+require "canvas_link_migrator/link_resolver"
+
+module CanvasLinkMigrator
+  def self.relative_url?(url)
+    URI.parse(url).relative? && !url.to_s.start_with?("//")
+  rescue URI::Error
+    # leave the url as it was
+    false
+  end
+end

data/spec/canvas_link_migrator/imported_html_converter_spec.rb

@@ -0,0 +1,279 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2012 - present Instructure, Inc.
+#
+# This file is part of Canvas.
+#
+# Canvas is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, version 3 of the License.
+#
+# Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+# A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+require "spec_helper"
+require "json"
+
+describe CanvasLinkMigrator::ImportedHtmlConverter do
+  # tests link_parser and link_resolver
+
+  describe ".convert" do
+    before do
+      @path = "/courses/2/"
+      @converter = CanvasLinkMigrator::ImportedHtmlConverter.new(resource_map: JSON.parse(File.read("spec/fixtures/canvas_resource_map.json")))
+    end
+
+    it "converts a wiki reference" do
+      test_string = %(<a href="%24WIKI_REFERENCE%24/wiki/test-wiki-page?query=blah">Test Wiki Page</a>)
+      html, bad_links = @converter.convert_exported_html(test_string)
+      expect(html).to eq %(<a href="#{@path}pages/test-wiki-page?query=blah">Test Wiki Page</a>)
+      expect(bad_links).to be_nil
+    end
+
+    context "when course attachments exist" do
+      subject { @converter.convert_exported_html(test_string) }
+
+      let(:migration_id) { "E" }
+
+      context "and a data-download-url attribute references an icon maker icon" do
+        let(:test_string) do
+          %(<img src="$CANVAS_COURSE_REFERENCE$/file_ref/#{migration_id}/download?download_frd=1" alt="" data-inst-icon-maker-icon="true" data-download-url="$CANVAS_COURSE_REFERENCE$/file_ref/#{migration_id}/download?download_frd=1&icon_maker_icon=1">)
+        end
+
+        it "converts data-download-url for files without appending a context" do
+          html, bad_links = subject
+          expect(html).to eq(
+            "<img src=\"#{@path}files/5/download?download_frd=1\" alt=\"\" data-inst-icon-maker-icon=\"true\" data-download-url=\"/files/5/download?download_frd=1&icon_maker_icon=1\">"
+          )
+          expect(bad_links).to be_nil
+        end
+      end
+
+      # it "finds an attachment by migration id" do
+      #   test_string = %{<p>This is an image: <br /><img src="%24CANVAS_OBJECT_REFERENCE%24/attachments/F" alt=":(" /></p>}
+      #   expect(@converter.convert_exported_html(test_string)).to eq([%{<p>This is an image: <br><img src="#{@path}files/6/preview" alt=":("></p>}, nil])
+      # end
+
+      # it "finds an attachment by path" do
+      #   test_string = %{<p>This is an image: <br /><img src="%24IMS_CC_FILEBASE%24/test.png" alt=":(" /></p>}
+
+      #   # if there isn't a path->migration id map it'll be a relative course file path
+      #   expect(@converter.convert_exported_html(test_string)).to eq %{<p>This is an image: <br><img src="#{@path}file_contents/course%20files/test.png" alt=":("></p>}
+
+      #   @migration.attachment_path_id_lookup = { "test.png" => att.migration_id }
+      #   expect(@converter.convert_exported_html(test_string)).to eq %{<p>This is an image: <br><img src="#{@path}files/#{att.id}/preview" alt=":("></p>}
+      # end
+
+      # it "finds an attachment by a path with a space" do
+      #   att = make_test_att
+      #   @migration.attachment_path_id_lookup = { "subfolder/with a space/test.png" => att.migration_id }
+
+      #   test_string = %(<img src="subfolder/with%20a%20space/test.png" alt="nope" />)
+      #   expect(@converter.convert_exported_html(test_string)).to eq %(<img src="#{@path}files/#{att.id}/preview" alt="nope">)
+
+      #   test_string = %(<img src="subfolder/with+a+space/test.png" alt="nope" />)
+      #   expect(@converter.convert_exported_html(test_string)).to eq %(<img src="#{@path}files/#{att.id}/preview" alt="nope">)
+      # end
+
+      # it "finds an attachment even if the link has an extraneous folder" do
+      #   att = make_test_att
+      #   @migration.attachment_path_id_lookup = { "subfolder/test.png" => att.migration_id }
+
+      #   test_string = %(<img src="anotherfolder/subfolder/test.png" alt="nope" />)
+      #   expect(@converter.convert_exported_html(test_string)).to eq %(<img src="#{@path}files/#{att.id}/preview" alt="nope">)
+      # end
+
+      # it "finds an attachment by path if capitalization is different" do
+      #   att = make_test_att
+      #   @migration.attachment_path_id_lookup = { "subfolder/withCapital/test.png" => "wrong!" }
+      #   @migration.attachment_path_id_lookup_lower = { "subfolder/withcapital/test.png" => att.migration_id }
+
+      #   test_string = %(<img src="subfolder/WithCapital/TEST.png" alt="nope" />)
+      #   expect(@converter.convert_exported_html(test_string)).to eq %(<img src="#{@path}files/#{att.id}/preview" alt="nope">)
+      # end
+
+      # it "finds an attachment with query params" do
+      #   att = make_test_att
+      #   @migration.attachment_path_id_lookup = { "test.png" => att.migration_id }
+
+      #   test_string = %(<img src="%24IMS_CC_FILEBASE%24/test.png?canvas_customaction=1&canvas_qs_customparam=1" alt="nope" />)
+      #   expect(@converter.convert_exported_html(test_string)).to eq %(<img src="#{@path}files/#{att.id}/customaction?customparam=1" alt="nope">)
+
+      #   test_string = %(<img src="%24IMS_CC_FILEBASE%24/test.png?canvas_qs_customparam2=3" alt="nope" />)
+      #   expect(@converter.convert_exported_html(test_string)).to eq %(<img src="#{@path}files/#{att.id}/preview?customparam2=3" alt="nope">)
+
+      #   test_string = %(<img src="%24IMS_CC_FILEBASE%24/test.png?notarelevantparam" alt="nope" />)
+      #   expect(@converter.convert_exported_html(test_string)).to eq %(<img src="#{@path}files/#{att.id}/preview" alt="nope">)
+      # end
+    end
+
+    it "converts picture source srcsets" do
+      test_string = %(<source srcset="$CANVAS_COURSE_REFERENCE$/img.src">)
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<source srcset="/courses/2/img.src">), nil])
+    end
+
+    it "converts a wiki reference without $ escaped" do
+      test_string = %(<a href="$WIKI_REFERENCE$/wiki/test-wiki-page?query=blah">Test Wiki Page</a>)
+
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<a href="#{@path}pages/test-wiki-page?query=blah">Test Wiki Page</a>), nil])
+    end
+
+    it "converts a wiki reference by migration id" do
+      test_string = %(<a href="wiki_page_migration_id=A">Test Wiki Page</a>)
+
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<a href="#{@path}pages/slug-a">Test Wiki Page</a>), nil])
+    end
+
+    it "converts a discussion reference by migration id" do
+      test_string = %(<a href="discussion_topic_migration_id=G">Test topic</a>)
+
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<a href="#{@path}discussion_topics/7">Test topic</a>), nil])
+    end
+
+    it "converts course section urls" do
+      test_string = %(<a href="%24CANVAS_COURSE_REFERENCE%24/discussion_topics">discussions</a>)
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<a href="#{@path}discussion_topics">discussions</a>), nil])
+    end
+
+    it "leaves invalid and absolute urls alone" do
+      test_string = %(<a href="stupid &^%$ url">Linkage</a><br><a href="http://www.example.com/poop">Linkage</a>)
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<a href="stupid &amp;^%$ url">Linkage</a><br><a href="http://www.example.com/poop">Linkage</a>), nil])
+    end
+
+    it "leaves invalid mailto addresses alone" do
+      test_string = %(<a href="mailto:.">Bad mailto</a><br><a href="mailto:test@example.com">Good mailto</a>)
+      expect(@converter.convert_exported_html(test_string)).to eq(
+        [
+          %(<a href="mailto:.">Bad mailto</a><br><a href="mailto:test@example.com">Good mailto</a>),
+          nil
+        ]
+      )
+    end
+
+    it "recognizes and relative-ize absolute links outside the course but in one of the course's domains" do
+      test_string = %(<a href="https://apple.edu/courses/123">Mine</a><br><a href="https://kiwi.edu/courses/456">Vain</a><br><a href="http://other-canvas.example.com/">Other Instance</a>)
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<a href="/courses/123">Mine</a><br><a href="/courses/456">Vain</a><br><a href="http://other-canvas.example.com/">Other Instance</a>), nil])
+    end
+
+    it "prepends course files for unrecognized relative urls" do
+      test_string = %(<a href="/relative/path/to/file">Linkage</a>)
+      html, bad_links = @converter.convert_exported_html(test_string)
+      expect(html).to eq %(<a href="#{@path}file_contents/course%20files/relative/path/to/file">Linkage</a>)
+      expect(bad_links.length).to eq 1
+      expect(bad_links[0]).to include({ link_type: :file, missing_url: "/courses/2/file_contents/course%20files/relative/path/to/file" })
+
+      test_string = %(<a href="relative/path/to/file">Linkage</a>)
+      html, bad_links = @converter.convert_exported_html(test_string)
+      expect(html).to eq %(<a href="#{@path}file_contents/course%20files/relative/path/to/file">Linkage</a>)
+      expect(bad_links.length).to eq 1
+      expect(bad_links[0]).to include({ link_type: :file, missing_url: "/courses/2/file_contents/course%20files/relative/path/to/file" })
+
+      test_string = %(<a href="relative/path/to/file%20with%20space.html">Linkage</a>)
+      html, bad_links = @converter.convert_exported_html(test_string)
+      expect(html).to eq %(<a href="#{@path}file_contents/course%20files/relative/path/to/file%20with%20space.html">Linkage</a>)
+      expect(bad_links.length).to eq 1
+      expect(bad_links[0]).to include({ link_type: :file, missing_url: "/courses/2/file_contents/course%20files/relative/path/to/file%20with%20space.html" })
+    end
+
+    it "preserves media comment links" do
+      test_string = <<~HTML.strip
+        <p>
+          with media object url: <a id="media_comment_m-stuff" class="instructure_inline_media_comment video_comment" href="/media_objects/m-stuff">this is a media comment</a>
+          with file content url: <a id="media_comment_0_bq09qam2" class="instructure_inline_media_comment video_comment" href="/courses/2/file_contents/course%20files/media_objects/0_bq09qam2">this is a media comment</a>
+        </p>
+      HTML
+
+      expect(@converter.convert_exported_html(test_string)).to eq([test_string, nil])
+    end
+
+    it "handles and repair half broken media links" do
+      test_string = %(<p><a href="/courses/2/file_contents/%24IMS_CC_FILEBASE%24/#" class="instructure_inline_media_comment video_comment" id="media_comment_m-stuff">this is a media comment</a><br><br></p>)
+
+      expect(@converter.convert_exported_html(test_string)).to eq([%(<p><a href="/media_objects/m-stuff" class="instructure_inline_media_comment video_comment" id="media_comment_m-stuff">this is a media comment</a><br><br></p>), nil])
+    end
+
+    it "preserves new RCE media iframes" do
+      test_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" src="/media_objects_iframe/m-stuff?type=video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-stuff"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([test_string, nil])
+    end
+
+    it "handles and repair half broken new RCE media iframes" do
+      test_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" src="%24IMS_CC_FILEBASE%24/#" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-abcde"></iframe>)
+      repaired_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" src="/media_objects_iframe/m-abcde?type=video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-abcde"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([repaired_string, nil])
+    end
+
+    it "converts source tags to RCE media iframes" do
+      test_string = %(<video style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-stuff"><source src="/media_objects_iframe/m-stuff?type=video" data-media-id="m-stuff" data-media-type="video"></video>)
+      converted_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-stuff" src="/media_objects_iframe/m-stuff?type=video"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([converted_string, nil])
+
+      test_string = %(<audio style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="audio" data-media-id="m-stuff"><source src="/media_objects_iframe/m-stuff?type=audio" data-media-id="m-stuff" data-media-type="audio"></audio>)
+      converted_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="audio" data-media-id="m-stuff" src="/media_objects_iframe/m-stuff?type=audio"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([converted_string, nil])
+    end
+
+    it "converts source tags to RCE media attachment iframes" do
+      test_string = %(<video style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-stuff"><source src="$CANVAS_OBJECT_REFERENCE$/media_attachments_iframe/E?type=video" data-media-id="m-stuff" data-media-type="video"></video>)
+      converted_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-stuff" src="/media_attachments_iframe/5?type=video"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([converted_string, nil])
+
+      test_string = %(<audio  style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="audio" data-media-id="m-stuff"><source src="$CANVAS_OBJECT_REFERENCE$/media_attachments_iframe/E?type=audio" data-media-id="m-stuff" data-media-type="audio"></video>)
+      converted_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="audio" data-media-id="m-stuff" src="/media_attachments_iframe/5?type=audio"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([converted_string, nil])
+    end
+
+    it "converts source tags to RCE media attachment iframes when link is untranslated" do
+      test_string = %(<video style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-stuff"><source src="/media_attachments_iframe/5?type=video" data-media-id="m-stuff" data-media-type="video"></video>)
+      converted_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="video" allowfullscreen="allowfullscreen" allow="fullscreen" data-media-id="m-stuff" src="/media_attachments_iframe/5?type=video"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([converted_string, nil])
+
+      test_string = %(<audio  style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="audio" data-media-id="m-stuff"><source src="/media_attachments_iframe/5?type=audio" data-media-id="m-stuff" data-media-type="audio"></video>)
+      converted_string = %(<iframe style="width: 400px; height: 225px; display: inline-block;" title="this is a media comment" data-media-type="audio" data-media-id="m-stuff" src="/media_attachments_iframe/5?type=audio"></iframe>)
+      expect(@converter.convert_exported_html(test_string)).to eq([converted_string, nil])
+    end
+
+    it "leaves source tags without data-media-id alone" do
+      test_string = %(<video style="width: 400px; height: 225px; display: inline-block;" title="this is a non-canvas video" allowfullscreen="allowfullscreen" allow="fullscreen"><source src="http://www.example.com/video.mov"></video>)
+      expect(@converter.convert_exported_html(test_string)).to eq([test_string, nil])
+    end
+
+    it "only converts url params" do
+      test_string = <<~HTML
+        <object>
+        <param name="controls" value="CONSOLE" />
+        <param name="controller" value="true" />
+        <param name="autostart" value="false" />
+        <param name="loop" value="false" />
+        <param name="src" value="%24IMS_CC_FILEBASE%24/test.mp3" />
+        <EMBED name="tag"  src="%24IMS_CC_FILEBASE%24/test.mp3" loop="false" autostart="false" controller="true" controls="CONSOLE" >
+        </EMBED>
+        </object>
+      HTML
+
+      expect(@converter.convert_exported_html(test_string)[0]).to match(<<~HTML.strip)
+        <object>
+        <param name="controls" value="CONSOLE">
+        <param name="controller" value="true">
+        <param name="autostart" value="false">
+        <param name="loop" value="false">
+        <param name="src" value="/courses/2/file_contents/course%20files/test.mp3">
+        <embed name="tag" src="/courses/2/file_contents/course%20files/test.mp3" loop="false" autostart="false" controller="true" controls="CONSOLE">
+
+        </object>
+      HTML
+    end
+
+    it "leaves an anchor tag alone" do
+      test_string = '<p><a href="#anchor_ref">ref</a></p>'
+      expect(@converter.convert_exported_html(test_string)).to eq([test_string, nil])
+    end
+  end
+end

data/spec/canvas_link_migrator/link_resolver_spec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2023 - present Instructure, Inc.
+#
+# This file is part of Canvas.
+#
+# Canvas is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, version 3 of the License.
+#
+# Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+# A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+require "spec_helper"
+require "json"
+
+describe CanvasLinkMigrator::LinkResolver do
+  def resolver(assets = JSON.parse(File.read("spec/fixtures/canvas_resource_map.json")))
+    CanvasLinkMigrator::LinkResolver.new(CanvasLinkMigrator::ResourceMapService.new(assets))
+  end
+
+  describe "resolve_link!" do
+    it "converts wiki_pages links" do
+      link = { link_type: :wiki_page, migration_id: "A", query: "?foo=bar" }
+      resolver.resolve_link!(link)
+      expect(link[:new_value]).to eq("/courses/2/pages/slug-a?foo=bar")
+    end
+
+    it "converts module_item links" do
+      link = { link_type: :module_item, migration_id: "C", query: "?foo=bar" }
+      resolver.resolve_link!(link)
+      expect(link[:new_value]).to eq("/courses/2/modules/items/3?foo=bar")
+    end
+
+    it "converts file_ref urls" do
+      link = { link_type: :file_ref, migration_id: "F" }
+      resolver.resolve_link!(link)
+      expect(link[:new_value]).to eq("/courses/2/files/6/preview")
+    end
+
+    it "converts attachment urls" do
+      link = { link_type: :object, type: "attachments", migration_id: "E", query: "?foo=bar" }
+      resolver.resolve_link!(link)
+      expect(link[:new_value]).to eq("/courses/2/files/5/preview")
+    end
+
+    it "converts media_attachments_iframe urls" do
+      link = { link_type: :object, type: "media_attachments_iframe", migration_id: "F", query: "?foo=bar" }
+      resolver.resolve_link!(link)
+      expect(link[:new_value]).to eq("/media_attachments_iframe/6?foo=bar")
+    end
+
+    it "converts discussion_topic links" do
+      link = { link_type: :discussion_topic, migration_id: "G", query: "?foo=bar" }
+      resolver.resolve_link!(link)
+      expect(link[:new_value]).to eq("/courses/2/discussion_topics/7?foo=bar")
+    end
+  end
+end

data/spec/canvas_link_migrator_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2012 - present Instructure, Inc.
+#
+# This file is part of Canvas.
+#
+# Canvas is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, version 3 of the License.
+#
+# Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+# A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+
+require "spec_helper"
+
+describe CanvasLinkMigrator do
+  describe ".relative_url?" do
+    it "recognizes an absolute url" do
+      expect(CanvasLinkMigrator.relative_url?("http://example.com")).to be false
+    end
+
+    it "recognizes relative urls" do
+      expect(CanvasLinkMigrator.relative_url?("/relative/eh")).to be true
+      expect(CanvasLinkMigrator.relative_url?("also/relative")).to be true
+      expect(CanvasLinkMigrator.relative_url?("watup/nothing.html#anchoritbaby")).to be true
+      expect(CanvasLinkMigrator.relative_url?("watup/nothing?absolutely=1")).to be true
+    end
+
+    it "does not error on invalid urls" do
+      expect(CanvasLinkMigrator.relative_url?("stupid &^%$ url")).to be_falsey
+      expect(CanvasLinkMigrator.relative_url?("mailto:jfarnsworth@instructure.com,")).to be_falsey
+    end
+  end
+end

data/spec/fixtures/canvas_resource_map.json

@@ -0,0 +1,73 @@
+{
+  "contains_migration_ids": true,
+  "destination_course": "2",
+  "destination_hosts": [
+    "apple.edu",
+    "kiwi.edu"
+  ],
+  "destination_root_folder": "course files/",
+  "resource_mapping": {
+    "discussion_topics": {
+      "G": {
+        "destination": {
+          "id": "7"
+        },
+        "source": {
+          "id": "6"
+        }
+      }
+    },
+    "files": {
+      "E": {
+        "destination": {
+          "id": "5",
+          "media_entry_id": "m-stuff"
+        },
+        "source": {
+          "id": "3",
+          "media_entry_id": "m-stuff"
+        }
+      },
+      "F": {
+        "destination": {
+          "id": "6",
+          "media_entry_id": "m-stuff"
+        },
+        "source": {
+          "id": "4",
+          "media_entry_id": "m-stuff"
+        }
+      }
+    },
+    "module_items": {
+      "C": {
+        "destination": {
+          "id": "3"
+        },
+        "source": {
+          "id": "2"
+        }
+      }
+    },
+    "wiki_pages": {
+      "A": {
+        "destination": {
+          "id": "2",
+          "url": "slug-a"
+        },
+        "source": {
+          "id": "1",
+          "url": "slug-a"
+        }
+      }
+    }
+  },
+  "file_tree": {
+    "folder 1": {
+      "id": "1",
+      "sub_folders": {}
+    }
+  },
+  "source_course": "1",
+  "source_host": "pineapple.edu"
+}

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+#
+# Copyright (C) 2021 - present Instructure, Inc.
+#
+# This file is part of Canvas.
+#
+# Canvas is free software: you can redistribute it and/or modify it under
+# the terms of the GNU Affero General Public License as published by the Free
+# Software Foundation, version 3 of the License.
+#
+# Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
+# WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+# A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Affero General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+
+require "byebug"
+require "canvas_link_migrator"

data/test.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+set -e
+bundle check || bundle install
+bundle exec rspec spec