mumuki-laboratory 7.6.2 → 7.7.0

data/vendor/bundle/ruby/2.6.0/bundler/gems/mumuki-domain-cb7a9018bb94/app/models/exam/passing_criterion.rb

@@ -0,0 +1,53 @@
+class Exam::PassingCriterion
+
+  attr_reader :value
+
+  def initialize(value)
+    @value = value
+  end
+
+  def type
+    self.class.name.demodulize.underscore
+  end
+
+  def as_json
+    {type: type, value: value}
+  end
+
+  def ensure_valid!
+    raise "Invalid criterion value #{value} for #{type}" unless valid_passing_grade?
+  end
+
+  def self.parse(type, value)
+    parse_criterion_type(type, value)
+  end
+
+  def self.parse_criterion_type(type, value)
+    "Exam::PassingCriterion::#{type.camelize}".constantize.new(value)
+  rescue
+    raise "Invalid criterion type #{type}"
+  end
+
+end
+
+class Exam::PassingCriterion::None < Exam::PassingCriterion
+  def initialize(_)
+    @value = nil
+  end
+
+  def valid_passing_grade?
+    !value
+  end
+end
+
+class Exam::PassingCriterion::Percentage < Exam::PassingCriterion
+  def valid_passing_grade?
+    value.between? 0, 100
+  end
+end
+
+class Exam::PassingCriterion::PassedExercises < Exam::PassingCriterion
+  def valid_passing_grade?
+    value >= 0
+  end
+end

data/vendor/bundle/ruby/2.6.0/bundler/gems/mumuki-domain-cb7a9018bb94/app/models/exam_authorization.rb

@@ -0,0 +1,10 @@
+class ExamAuthorization < ApplicationRecord
+
+  belongs_to :user
+  belongs_to :exam
+
+  def start!
+    update!(started: true, started_at: Time.now) unless started?
+  end
+
+end

data/vendor/bundle/ruby/2.6.0/bundler/gems/mumuki-domain-cb7a9018bb94/app/models/exercise.rb

@@ -0,0 +1,255 @@
+class Exercise < ApplicationRecord
+  RANDOMIZED_FIELDS = [:default_content, :description, :extra, :hint, :test]
+  BASIC_RESOURCE_FIELDS = %i(
+    name layout editor corollary teacher_info manual_evaluation locale
+    choices assistance_rules randomizations tag_list extra_visible goal
+    free_form_editor_source initial_state final_state)
+
+  include WithDescription
+  include WithLocale
+  include WithNumber,
+          WithName,
+          WithAssignments,
+          FriendlyName,
+          WithLanguage,
+          Assistable,
+          WithRandomizations,
+          WithDiscussions
+
+  include Submittable,
+          Questionable
+
+  include SiblingsNavigation,
+          ParentNavigation
+
+  belongs_to :guide
+
+  markdown_on :teacher_info
+
+  defaults { self.submissions_count = 0 }
+
+  alias_method :progress_for, :assignment_for
+
+  serialize :choices, Array
+  serialize :settings, Hash
+
+  validates_presence_of :submissions_count,
+                        :guide, :bibliotheca_id
+
+  randomize(*RANDOMIZED_FIELDS)
+  delegate :timed?, to: :navigable_parent
+
+  def console?
+    queriable?
+  end
+
+  def used_in?(organization=Organization.current)
+    guide.usage_in_organization(organization).present?
+  end
+
+  def structural_parent
+    guide
+  end
+
+  def guide_done_for?(user)
+    guide.done_for?(user)
+  end
+
+  def choice?
+    false
+  end
+
+  def previous
+    sibling_at number.pred
+  end
+
+  def sibling_at(index)
+    index = number + index unless index.positive?
+    guide.exercises.find_by(number: index)
+  end
+
+  def search_tags
+    [language&.name, *tag_list].compact
+  end
+
+  def transparent_id
+    "#{guide.transparent_id}/#{bibliotheca_id}"
+  end
+
+  def transparent_params
+    guide.transparent_params.merge(bibliotheca_id: bibliotheca_id)
+  end
+
+  def friendly
+    defaulting_name { "#{navigable_parent.friendly} - #{name}" }
+  end
+
+  def submission_for(user)
+    assignment_for(user).submission
+  end
+
+  def new_solution
+    Mumuki::Domain::Submission::Solution.new(content: default_content)
+  end
+
+  def import_from_resource_h!(number, resource_h)
+    self.language = Language.for_name(resource_h.dig(:language, :name)) || guide.language
+    self.locale = guide.locale
+
+    reset!
+
+    attrs = whitelist_attributes(resource_h, except: [:type, :id])
+    attrs[:choices] = resource_h[:choices].to_a
+    attrs[:bibliotheca_id] = resource_h[:id]
+    attrs[:number] = number
+    attrs[:manual_evaluation] ||= false
+    attrs = attrs.except(:expectations, :custom_expectations) if type != 'Problem'
+
+    assign_attributes(attrs)
+    save!
+  end
+
+  def choice_values
+    choices.map { |it| it.indifferent_get(:value) }
+  end
+
+  def choice_index_for(value)
+    choice_values.index(value)
+  end
+
+  def to_resource_h(*args)
+    to_expanded_resource_h(*args).compact
+  end
+
+  # Keep this list up to date with
+  # Mumuki::Domain::Store::Github::ExerciseSchema
+  def to_expanded_resource_h(options={})
+    language_resource_h = language.to_embedded_resource_h if language != guide.language
+    as_json(only: BASIC_RESOURCE_FIELDS)
+      .merge(id: bibliotheca_id, language: language_resource_h, type: type.underscore)
+      .merge(expectations: self[:expectations])
+      .merge(custom_expectations: self[:custom_expectations])
+      .merge(settings: self[:settings])
+      .merge(RANDOMIZED_FIELDS.map { |it| [it, self[it]] }.to_h)
+      .symbolize_keys
+      .tap { |it| it.markdownified!(:hint, :corollary, :description, :teacher_info) if options[:markdownified] }
+  end
+
+  def reset!
+    self.name = nil
+    self.description = nil
+    self.corollary = nil
+    self.hint = nil
+    self.extra = nil
+    self.tag_list = []
+  end
+
+  def ensure_type!(type)
+    if self.type != type
+      reclassify! type
+    else
+      self
+    end
+  end
+
+  def reclassify!(type)
+    update!(type: type)
+    Exercise.find(id)
+  end
+
+  def messages_path_for(user)
+    "api/guides/#{guide.slug}/#{bibliotheca_id}/student/#{URI.escape user.uid}/messages?language=#{language}"
+  end
+
+  def messages_url_for(user)
+    Mumukit::Platform.classroom_api.organic_url_for(Organization.current, messages_path_for(user))
+  end
+
+  def description_context
+    splitted_description.first.markdownified
+  end
+
+  def splitted_description
+    description.split('> ')
+  end
+
+  def description_task
+    splitted_description.drop(1).join("\n").markdownified
+  end
+
+  def custom?
+    false
+  end
+
+  def inspection_keywords
+    {}
+  end
+
+  # Submits the user solution
+  # only if the corresponding assignment has attemps left
+  def try_submit_solution!(user, solution={})
+    assignment = assignment_for(user)
+    if assignment.attempts_left?
+      submit_solution!(user, solution)
+    else
+      assignment
+    end
+  end
+
+  # An exercise with hidden results cannot be limited
+  # as those exercises can be submitted as many times as the
+  # student wants because no result output is given
+  def limited?
+    !results_hidden? && navigable_parent.limited_for?(self)
+  end
+
+  def results_hidden?
+    navigable_parent&.results_hidden_for?(self)
+  end
+
+  def files_for(current_content)
+    language
+      .directives_sections
+      .split_sections(current_content)
+      .map { |name, content| Mumuki::Domain::File.new name, content }
+  end
+
+  def self.find_transparently!(params)
+    Guide.find_transparently!(params).locate_exercise! params[:bibliotheca_id]
+  end
+
+  def self.locate!(slug_and_bibliotheca_id)
+    slug, bibliotheca_id = slug_and_bibliotheca_id
+    Guide.locate!(slug).locate_exercise! bibliotheca_id
+  end
+
+  def settings
+    guide.settings.deep_merge super
+  end
+
+  def pending_siblings_for(user)
+    guide.pending_exercises(user)
+  end
+
+  private
+
+  def evaluation_class
+    if manual_evaluation?
+      manual_evaluation_class
+    else
+      automated_evaluation_class
+    end
+  end
+
+  def manual_evaluation_class
+    Mumuki::Domain::Evaluation::Manual
+  end
+
+  def automated_evaluation_class
+    Mumuki::Domain::Evaluation::Automated
+  end
+
+  def self.default_layout
+    layouts.keys[0]
+  end
+end

data/vendor/bundle/ruby/2.6.0/bundler/gems/mumuki-domain-cb7a9018bb94/app/models/exercise/challenge.rb

@@ -0,0 +1,25 @@
+class Challenge < Exercise
+  include WithLayout
+
+  markdown_on :hint
+
+  def reset!
+    super
+    self.layout = self.class.default_layout
+  end
+
+  def extra(*)
+    [guide.extra, super]
+      .compact
+      .join("\n")
+      .strip
+      .ensure_newline
+  end
+
+  private
+
+  def defaults
+    super
+    self.layout ||= self.class.default_layout
+  end
+end

data/vendor/bundle/ruby/2.6.0/bundler/gems/mumuki-domain-cb7a9018bb94/app/models/exercise/interactive.rb

@@ -0,0 +1,41 @@
+class Interactive < Challenge
+  include Triable
+
+  markdown_on :corollary
+  validate :ensure_triable_language
+  validate :ensure_stateful_console
+
+  serialize :goal
+  name_model_as Exercise
+
+  def console?
+    true
+  end
+
+  def stateful_console?
+    true
+  end
+
+  def queriable?
+    false
+  end
+
+  def hidden?
+    false
+  end
+
+  def upload?
+    false
+  end
+
+  private
+
+  def ensure_triable_language
+    errors.add(:base, :language_not_triable) unless language.triable?
+  end
+
+  def ensure_stateful_console
+    errors.add(:base, :console_not_stateful) unless language.stateful_console?
+  end
+
+end

data/vendor/bundle/ruby/2.6.0/bundler/gems/mumuki-domain-cb7a9018bb94/app/models/exercise/playground.rb

@@ -0,0 +1,23 @@
+class Playground < QueriableChallenge
+  validate :ensure_queriable_language
+
+  name_model_as Exercise
+
+  def setup_query_assignment!(assignment)
+    assignment.running!
+  end
+
+  def save_query_results!(assignment)
+    unless assignment.passed?
+      assignment.passed!
+      assignment.notify!
+    end
+  end
+
+  private
+
+  def ensure_queriable_language
+    errors.add(:base, :language_not_queriable) unless queriable?
+  end
+
+end

data/vendor/bundle/ruby/2.6.0/bundler/gems/mumuki-domain-cb7a9018bb94/app/models/exercise/problem.rb

@@ -0,0 +1,59 @@
+class Problem < QueriableChallenge
+  include WithExpectations,
+          WithEditor,
+          Solvable
+
+  markdown_on :corollary
+
+  validate :ensure_evaluation_criteria
+
+  name_model_as Exercise
+
+  def setup_query_assignment!(assignment)
+  end
+
+  def save_query_results!(assignment)
+  end
+
+  def reset!
+    super
+    self.test = nil
+    self.expectations = []
+  end
+
+  def expectations
+    own_expectations + guide_expectations
+  end
+
+  def custom_expectations
+    "#{own_custom_expectations}\n#{guide_custom_expectations}"
+  end
+
+  def guide_expectations
+    guide.expectations
+  end
+
+  def guide_custom_expectations
+    guide.custom_expectations
+  end
+
+  def evaluation_criteria?
+    manual_evaluation? || expectations? || test.present?
+  end
+
+  def expectations?
+    own_expectations.present? || own_custom_expectations.present?
+  end
+
+  # Sets the layout. This method accepts input_kids as a synonym of input_primary
+  # for historical reasons
+  def layout=(layout)
+    self[:layout] = layout.like?(:input_kids) ? :input_primary : layout
+  end
+
+  private
+
+  def ensure_evaluation_criteria
+    errors.add :base, :evaluation_criteria_required unless evaluation_criteria?
+  end
+end