alembic 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df412b5e51656af183c1272085c276a062e48e21b10c96dc879d64802cc2f1f3
-  data.tar.gz: a50967fb05d36e74f384629c4339de6bf1f6a1bfebb555deb125180669fdf65a
+  metadata.gz: f4ad973a4cd7a81bb2d9ff18e31075ca5b4dc32c20b82c86d3cdbf39445ce28d
+  data.tar.gz: fdf0002e2cb0c7a559be457f24df5af9d64354f6136d5428a81e6a31c7b4e00b
 SHA512:
-  metadata.gz: 299c2fbfc3638afc343191ae323c59adc0a4198b8f50f393cfdb0b0b61ada4e94117c925171817b980bc06d7a3453da6c87aa6499c4dbb6b4a4ad95c2c986491
-  data.tar.gz: 5bf2cf3497adf09bd4b934252b34563e92d54f3466bb4796c548fcf520e8bb93bcb27c17b1038e56aec515bc75228d777a3489d7a9d9fa454c27718c6c509faa
+  metadata.gz: d0f8baba0a3c8f8b0eef256bae0bf3211a8037216f4ebbf6df5ea09c830de4ed50b23f07f8cf1c754757aa09884216d9fb2402f5d27c871c242f2b88118c2ac5
+  data.tar.gz: 546561d85803831584fa1e8aa6b9ce9bcf6503c51277e6a0b36258cd71ceab78ae252acdd6b4c721b2affbf5e5be62eb59dd128480ea7bcfd7f6e417290667bc

data/app/controllers/alembic/manage/answer_keys_controller.rb

@@ -21,6 +21,11 @@ module Alembic
         Flow::AnswerKey.chosen(step_settings(question.id))
       end
 
+      def named_right_answer(question)
+        accepted = Flow::AnswerKey.accepted(step_settings(question.id))
+        accepted.any? ? accepted.to_sentence(two_words_connector: " or ", last_word_connector: ", or ") : super
+      end
+
       def shows_answer_values?
         Flow::Summaries.new(previewed).shows_answer_values?
       end

data/app/controllers/concerns/alembic/summarizes.rb

@@ -10,7 +10,7 @@ module Alembic
       helper ContentBlocksHelper
       helper KsBlocks::LayoutHelper
       after_action :keep_ended_inner_run, only: :step
-      helper_method :flow_summary, :first_step_path, :summary_values, :intro_values, :start_over_path, :finish_link, :visited_flow_address, :answered_right?, :single_choice?, :drawing_of, :chosen_answer, :step_category, :shown
+      helper_method :flow_summary, :first_step_path, :summary_values, :intro_values, :start_over_path, :finish_link, :visited_flow_address, :answered_right?, :single_choice?, :drawing_of, :chosen_answer, :named_right_answer, :step_category, :shown
     end
 
     private
@@ -41,6 +41,11 @@ module Alembic
 
     def chosen_answer(_question); end
 
+    def named_right_answer(question)
+      chosen = chosen_answer(question)
+      @guide.choice_label(question.id, chosen) if chosen.present?
+    end
+
     def start_over_path
       flow_start_path(visited_flow_address)
     end

data/app/models/alembic/flow/answer_key.rb

@@ -8,6 +8,10 @@ module Alembic
         else Outputs::WeightedSum.right_answers(step).first
         end
       end
+
+      def self.accepted(step)
+        Array(step["accepted_answers"]).filter_map { |answer| answer["value"].presence }
+      end
     end
   end
 end

data/app/views/alembic/flows/step.html.erb

@@ -32,8 +32,8 @@
           <%= render @drawing, step: shown(@question), chosen: chosen_answer(@question) %>
         <% end %>
 
-        <% if (right_answer = chosen_answer(@question)).present? %>
-          <%= ui_value_list(rows: [ { label: ui_badge(label: "Right answer", variant: :success), value: @guide.choice_label(@question.id, right_answer) } ]) %>
+        <% if (right_answer = named_right_answer(@question)).present? %>
+          <%= ui_value_list(rows: [ { label: ui_badge(label: "Right answer", variant: :success), value: right_answer } ]) %>
         <% end %>
 
         <div class="mt-8 flex items-center gap-4">

data/lib/alembic/answer_explanations.rb

@@ -0,0 +1,25 @@
+module Alembic
+  module AnswerExplanations
+    TEXT = {
+      "question" => {
+        "answers.info" => "Extra detail saved with this answer, which the question page does not show to a player.",
+        "answers.hint" => "A smaller line a player sees under this answer's text.",
+        "answers.label" => "The text a player sees for this answer in place of its value.",
+        "answers.value" => "The text saved when a player picks this answer, which the player also sees when the label is blank or the flow shows answer values.",
+        "answers.weight" => "The points a player scores by picking this answer, and any weight above zero makes it a right answer."
+      },
+      "multiple_select" => {
+        "answers.label" => "The text a player sees for this answer in place of its value.",
+        "answers.value" => "The text saved when a player ticks this answer, which the player also sees when the label is blank.",
+        "answers.weight" => "Any weight above zero makes this a right answer, whatever its size, and the question scores one point only when a player ticks every right answer and no others."
+      },
+      "fill_in_the_blank" => {
+        "accepted_answers.value" => "A typed answer that matches this text, ignoring capitals and the spaces around it, is right and scores one point."
+      }
+    }.freeze
+
+    def explanation_for(step_type, setting)
+      super || TEXT.dig(step_type.to_s, setting.to_s)
+    end
+  end
+end

data/lib/alembic/engine.rb

@@ -33,6 +33,10 @@ module Alembic
       end
     end
 
+    initializer "alembic.answer_explanations" do |app|
+      app.config.to_prepare { Alembic.explain_answer_fields }
+    end
+
     initializer "alembic.question_importer" do |app|
       app.config.to_prepare { require "alembic/question_importer" if defined?(Ixport::Importer) }
     end

data/lib/alembic/version.rb

@@ -1,3 +1,3 @@
 module Alembic
-  VERSION = "0.15.0"
+  VERSION = "0.16.0"
 end

data/lib/alembic.rb

@@ -1,6 +1,7 @@
 require "json"
 require "alembic/version"
 require "alembic/engine"
+require "alembic/answer_explanations"
 
 module Alembic
   NotPublished = EasyFlow::NotPublished
@@ -37,9 +38,12 @@ module Alembic
     end
 
     def set_up_flow_host
-      EasyFlow.host(FLOW_HOST) do |host|
-        FLOW_HOST_SETTINGS.each { |name| host.public_send(:"#{name}=", public_send(name)) }
-      end
+      host = explain_answer_fields
+      FLOW_HOST_SETTINGS.each { |name| host.public_send(:"#{name}=", public_send(name)) }
+    end
+
+    def explain_answer_fields
+      flow_host.extend(AnswerExplanations)
     end
 
     def lead_partial=(_partial)
@@ -69,6 +73,13 @@ module Alembic
     def admin_layout
       @admin_layout || "application"
     end
+
+    private
+
+    def flow_host
+      host = EasyFlow.host_named(FLOW_HOST)
+      host.set_up? ? host : EasyFlow.host(FLOW_HOST)
+    end
   end
 
   set_up_flow_host

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: alembic
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - tylercschneider
@@ -57,20 +57,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.32'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.32.1
+        version: '0.35'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.32'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.32.1
+        version: '0.35'
 description: Alembic builds and runs data-driven interactive diagnostics — scored
   assessments and branching guides — that place a visitor on an outcome and capture
   the result. A runtime engine plus a UI builder.
@@ -228,6 +222,7 @@ files:
 - db/migrate/20261020120000_add_kept_result_to_alembic_flow_run_summaries.rb
 - db/migrate/20261025031225_add_shuffles_answers_to_alembic_flow_definition_summaries.rb
 - lib/alembic.rb
+- lib/alembic/answer_explanations.rb
 - lib/alembic/engine.rb
 - lib/alembic/leftover_stylesheet.rb
 - lib/alembic/question_importer.rb