strongmind_multi_version_common_cartridge 1.0.4

data/README.md

@@ -0,0 +1,36 @@
+# multi_version_common_cartridge
+A gem for writing different versions of Common Cartridges.
+
+It supports Common Cartridge version 1.1, 1.2, 1.3 and Thin CC version 1.2 and 1.3.
+
+## Usage
+``` ruby
+# Create a Common Cartridge
+cartridge = MultiVersionCommonCartridge::Cartridge.new
+cartridge.manifest.set_title('My cartridge')
+cartridge.items = [
+  MultiVersionCommonCartridge::Item.new.tap do |item|
+    item.title = 'My activity'
+    item.identifier = 'Some identifier'
+    item.resource = MultiVersionCommonCartridge::Resources::BasicLtiLink::BasicLtiLink.new.tap do |lti|
+      lti.title = 'My activity title'
+      lti.identiier = 'My activity identifier'
+      lti.scure_launch_url = 'https://example.com/lti'
+    end
+  end
+]
+
+# Create a Common Cartridge writer for version 1.2.0
+writer = MultiVersionCommonCartridge::Writers::CartridgeWriter.new(
+  cartridge, '1.2.0'
+end
+
+# Finalize the Common Cartridge for the specified version.
+writer.finalize
+
+# Check for error
+return if writer.errors?
+
+# Write the Common Cartridge
+writer.write_to_zip('cartridge.imscc')
+```

data/lib/multi_version_common_cartridge/cartridge.rb

@@ -0,0 +1,58 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  class Cartridge
+    attr_accessor :items
+
+    def initialize
+      @items = []
+      @resources = []
+    end
+
+    def manifest
+      @manifest ||= Manifest.new
+    end
+
+    def add_item(item)
+      @items << item
+    end
+
+    def all_items
+      @all_items ||= begin
+                       @items.each_with_object([]) do |item, memo|
+                         memo << item
+                         child_items(item, memo)
+                       end
+                     end.flatten
+    end
+
+    def add_resource(resource)
+      @resources << resource
+    end
+
+    def all_resources
+      @all_resources ||= all_items.map(&:resource).compact + @resources
+    end
+
+    private def child_items(item, memo)
+      item.children.each do |child|
+        memo << child
+        child_items(child, memo)
+      end
+    end
+  end
+end

data/lib/multi_version_common_cartridge/cartridge_versions.rb

@@ -0,0 +1,25 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  module CartridgeVersions
+    CC_1_1_0 = '1.1.0'.freeze
+    CC_1_2_0 = '1.2.0'.freeze
+    CC_1_3_0 = '1.3.0'.freeze
+    THIN_CC_1_2_0 = 'Thin 1.2.0'.freeze
+    THIN_CC_1_3_0 = 'Thin 1.3.0'.freeze
+  end
+end

data/lib/multi_version_common_cartridge/item.rb

@@ -0,0 +1,29 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  class Item
+    attr_accessor :title, :identifier, :resource, :children
+
+    def initialize
+      @children = []
+    end
+
+    def add_item(item)
+      children << item
+    end
+  end
+end

data/lib/multi_version_common_cartridge/manifest.rb

@@ -0,0 +1,33 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  class Manifest
+    attr_accessor :identifier, :titles, :description, :organization_identifier
+
+    def initialize
+      @titles = {}
+    end
+
+    def set_title(title, language: 'en-US')
+      titles[language] = title
+    end
+
+    def title(language)
+      titles[language]
+    end
+  end
+end

data/lib/multi_version_common_cartridge/resources/basic_lti_link.rb

@@ -0,0 +1,46 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  module Resources
+    module BasicLtiLink
+      class Vendor
+        attr_accessor :code, :name, :description, :url, :contact_email
+      end
+
+      class BasicLtiLink < MultiVersionCommonCartridge::Resources::Resource
+        attr_accessor :title, :description, :secure_launch_url, :extensions, :launch_url
+
+        def initialize
+          @extensions = []
+        end
+
+        def vendor
+          @vendor ||= Vendor.new
+        end
+      end
+
+      class Extension
+        attr_accessor :platform, :properties
+
+        def initialize(platform)
+          @platform = platform
+          @properties = {}
+        end
+      end
+    end
+  end
+end

data/lib/multi_version_common_cartridge/resources/canvas_assignment.rb

@@ -0,0 +1,30 @@
+# multi_version_common_cartridge
+# Copyright © 2023 StrongMind
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  module Resources
+    module CanvasAssignment
+
+      class CanvasAssignment < MultiVersionCommonCartridge::Resources::Resource
+        attr_accessor :title, :assignment_group_identifierref, :points_possible, :max_attempts, :allowed_attempts,
+                      :is_end_of_module_exam, :grading_type, :submission_types, :peer_review_count, :external_tool_url
+
+        def initialize; end
+
+      end
+    end
+  end
+end

data/lib/multi_version_common_cartridge/resources/canvas_course_settings.rb

@@ -0,0 +1,29 @@
+# multi_version_common_cartridge
+# Copyright © 2023 StrongMind
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  module Resources
+    module CanvasCourseSettings
+
+      class CanvasCourseSettings < MultiVersionCommonCartridge::Resources::Resource
+        attr_accessor :image_url, :group_weighting_scheme, :assignment_groups, :modules, :href
+
+        def initialize; end
+
+      end
+    end
+  end
+end

data/lib/multi_version_common_cartridge/resources/canvas_elements/assignment.rb

@@ -0,0 +1,33 @@
+module CanvasCartridge
+  module Elements
+    module Resources
+      module CanvasAssignment
+
+        class Assignment
+          include SAXMachine
+
+          attribute :xmlns
+          attribute 'xmlns:xsi', as: :xmlns_xsi
+          attribute :identifier, as: :identifier
+
+          element 'title', as: :title
+          element 'assignment_group_identifierref', as: :assignment_group_identifierref
+          element 'points_possible', as: :points_possible
+          element 'max_attempts', as: :max_attempts
+          element 'allowed_attempts', as: :allowed_attempts
+          element 'is_end_of_module_exam', as: :is_end_of_module_exam
+          element 'grading_type', as: :grading_type
+          element 'submission_types', as: :submission_types
+          element 'peer_review_count', as: :peer_review_count
+          element 'external_tool_url', as: :external_tool_url
+
+          def self.type
+            :canvas_assignment
+          end
+
+          def self.pattern; end
+        end
+      end
+    end
+  end
+end

data/lib/multi_version_common_cartridge/resources/canvas_elements/course_settings.rb

@@ -0,0 +1,111 @@
+module CanvasCartridge
+  module Elements
+    module Resources
+      module CourseSettings
+
+        class CourseSettings
+          include SAXMachine
+
+          attribute :identifier
+
+          attribute :xmlns
+          attribute 'xmlns:xsi', as: :xmlns_xsi
+
+          element 'image_url', as: :image_url
+          element 'group_weighting_scheme', as: :group_weighting_scheme
+
+          def self.type
+            :course_settings
+          end
+
+          def self.pattern; end
+        end
+
+        class AssignmentGroup
+          include SAXMachine
+
+          attribute :identifier
+
+          element 'title', as: :title
+          element 'position', as: :position
+          element 'group_weight', as: :group_weight
+
+        end
+
+        class AssignmentGroups
+          include SAXMachine
+
+          attribute :xmlns
+          attribute 'xmlns:xsi', as: :xmlns_xsi
+
+          elements 'assignmentGroup', class: AssignmentGroup, as: :groups
+        end
+
+        class Prerequisite
+          include SAXMachine
+          attribute :type
+          element :title
+          element :identifierref
+        end
+
+        class Prerequisites
+          include SAXMachine
+
+          elements :prerequisite, as: :prerequisites, class: Prerequisite
+        end
+
+        class Item
+          include SAXMachine
+          attribute :identifier, as: :identifier
+          element :title
+          element :workflow_state
+          element :content_type
+          element :identifierref
+          element :url
+          element :position
+          element :indent
+          element :global_identifierref
+        end
+
+        class Items
+          include SAXMachine
+
+          elements :item, as: :items, class: Item
+        end
+
+        class CompletionRequirement
+          include SAXMachine
+          attribute :type
+          element :identifierref
+        end
+
+        class CompletionRequirements
+          include SAXMachine
+
+          elements :completionRequirement, as: :completion_requirements, class: CompletionRequirement
+        end
+
+        class Module
+          include SAXMachine
+          attribute :identifier
+          element :title
+          element :workflow_state
+          element :position
+          element :require_sequential_progress
+          element :requirement_count
+          element :prerequisites, as: :root_prerequisites, class: Prerequisites
+          element :items, as: :root_items, class: Items
+          element :completionRequirements, as: :root_requirements, class: CompletionRequirements
+        end
+
+        class Modules
+          include SAXMachine
+
+          attribute :xmlns
+          attribute 'xmlns:xsi', as: :xmlns_xsi
+          elements :module, as: :modules, class: Module
+        end
+      end
+    end
+  end
+end

data/lib/multi_version_common_cartridge/resources/resource.rb

@@ -0,0 +1,23 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge. If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  module Resources
+    class Resource
+      attr_accessor :identifier, :href
+    end
+  end
+end

data/lib/multi_version_common_cartridge/sax_machine_nokogiri_xml_saver.rb

@@ -0,0 +1,85 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+class SaxMachineNokogiriXmlSaver
+  def save(builder, object, name)
+    sax_config = sax_config_for(object)
+    unless sax_config
+      builder.send(name, object)
+      return
+    end
+
+    attrs = xml_attributes(object, sax_config)
+    content = xml_content(object, sax_config)
+    create_xml_node(builder, name, content, attrs) do |xml_element|
+      sax_config.top_level_elements.each do |_, configs|
+        configs.each do |config|
+          as = config.instance_variable_get(:@as)
+          save(xml_element, object.send(as), config.name)
+        end
+      end
+
+      sax_config.collection_elements.each do |_, configs|
+        configs.each do |config|
+          as = config.instance_variable_get(:@as)
+          object.send(as).each do |elm|
+            save(xml_element, elm, config.name)
+          end
+        end
+      end
+    end
+  end
+
+  private def xml_attributes(object, sax_config)
+    attrs = sax_config.top_level_attributes.map do |attr|
+      [attr.name, object.send(attr.instance_variable_get(:@as))]
+    end.to_h
+    attrs.delete_if { |_, v| v.nil? }
+  end
+
+  private def xml_content(object, sax_config)
+    return if sax_config.top_level_element_value.empty?
+    element_value_config = sax_config.top_level_element_value.last
+    object.send(element_value_config.name)
+  end
+
+  private def create_xml_node(builder, name, content, attrs, &block)
+    if name.include?(':')
+      namespace, name = name.split(':', 2)
+      create_xml_element(builder[namespace], name, content, attrs, &block)
+    else
+      create_xml_element(builder, name, content, attrs, &block)
+    end
+  end
+
+  private def create_xml_element(builder, name, content, attrs, &block)
+    if content
+      builder.send(name, content, attrs) do |xml_element|
+        yield xml_element
+      end
+    else
+      builder.send(name, attrs) do |xml_element|
+        yield xml_element
+      end
+    end
+  end
+
+  private def sax_config_for(object)
+    if object.class.respond_to?(:sax_config)
+      object.class.sax_config
+    end
+  end
+end

data/lib/multi_version_common_cartridge/version.rb

@@ -0,0 +1,19 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  VERSION = '1.0.4'.freeze
+end

data/lib/multi_version_common_cartridge/writers/basic_lti_extension_writer.rb

@@ -0,0 +1,45 @@
+# multi_version_common_cartridge
+# Copyright © 2019 Vista Higher Learning, Inc.
+#
+# multi_version_common_cartridge is free software: you can redistribute it
+# and/or modify it under the terms of the GNU General Public
+# License as published by the Free Software Foundation, either
+# version 3 of the License, or (at your option) any later version.
+#
+# multi_version_common_cartridge 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
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with multi_version_common_cartridge.  If not, see <http://www.gnu.org/licenses/>.
+
+module MultiVersionCommonCartridge
+  module Writers
+    class BasicLtiExtensionWriter
+      include SupportedVersions
+
+      attr_reader :extension
+
+      def initialize(extension, version)
+        @extension = extension
+        @version = validate_version(version)
+      end
+
+      def finalize
+      end
+
+      def extension_element
+        @extension_element ||= CommonCartridge::Elements::Resources::BasicLtiLink::Extension.new.tap do |element|
+          element.platform = extension.platform
+          element.properties = extension.properties.map do |key, value|
+            CommonCartridge::Elements::Resources::BasicLtiLink::ExtensionProperty.new(
+              name: key, value: value
+            )
+          end
+        end
+      end
+    end
+  end
+end
+