Class: Exercise

Inherits:
ApplicationRecord show all
Includes:
Assistable, FriendlyName, ParentNavigation, Questionable, SiblingsNavigation, Submittable, WithAssignments, WithDescription, WithDiscussions, WithLanguage, WithLocale, WithName, WithNumber, WithRandomizations
Defined in:
app/models/exercise.rb

Direct Known Subclasses

Challenge, Reading

Constant Summary collapse

RANDOMIZED_FIELDS = 
[:default_content, :description, :extra, :hint, :test, :expectations, :custom_expectations]
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)

Class Method Summary collapse

Instance Method Summary collapse

Methods included from SiblingsNavigation

#navigable_name, #next_for, #restart, #siblings

Methods included from ParentNavigation

#leave, #navigable_name, #navigable_parent, #navigation_end?

Methods included from Submittable

#find_assignment_and_submit!, #submit!

Methods included from Questionable

#submit_question!

Methods included from WithAssignments

#assignment_for, #find_assignment_for, #has_messages_for?, #messages_for, #status_for

Methods included from FriendlyName

#friendly_name, #to_param

Methods included from Assistable

#assist_with, #assistant

Methods included from WithRandomizations

#randomizer, #seed, #seed_with!

Methods included from WithDiscussions

#discuss!, #new_discussion_for, #try_solve_discussions!

Methods inherited from ApplicationRecord

aggregate_of, all_except, defaults, #delete, #destroy!, numbered, organic_on, resource_fields, #save, #save_and_notify!, #save_and_notify_changes!, serialize_symbolized_hash_array, teaser_on, #update_and_notify!, update_or_create!, whitelist_attributes

Class Method Details

.find_transparently!(params) ⇒ Object 



223
224
225
 
# File 'app/models/exercise.rb', line 223

def self.find_transparently!(params)
  Guide.find_transparently!(params).locate_exercise! params[:bibliotheca_id]
end

.locate!(slug_and_bibliotheca_id) ⇒ Object 



227
228
229
230
 
# File 'app/models/exercise.rb', line 227

def self.locate!(slug_and_bibliotheca_id)
  slug, bibliotheca_id = slug_and_bibliotheca_id
  Guide.locate!(slug).locate_exercise! bibliotheca_id
end

Instance Method Details

#choice? ⇒ Boolean

Returns:

  • (Boolean) 


66
67
68
 
# File 'app/models/exercise.rb', line 66

def choice?
  false
end

#choice_index_for(value) ⇒ Object 



124
125
126
 
# File 'app/models/exercise.rb', line 124

def choice_index_for(value)
  choice_values.index(value)
end

#choice_values ⇒ Object 



120
121
122
 
# File 'app/models/exercise.rb', line 120

def choice_values
  choices.map { |it| it.indifferent_get(:value) }
end

#console? ⇒ Boolean

Returns:

  • (Boolean) 


42
43
44
 
# File 'app/models/exercise.rb', line 42

def console?
  queriable?
end

#content_used_in?(organization) ⇒ Boolean

Returns:

  • (Boolean) 


54
55
56
 
# File 'app/models/exercise.rb', line 54

def content_used_in?(organization)
  navigable_content_in(organization).present?
end

#custom? ⇒ Boolean

Returns:

  • (Boolean) 


186
187
188
 
# File 'app/models/exercise.rb', line 186

def custom?
  false
end

#description_context ⇒ Object 



174
175
176
 
# File 'app/models/exercise.rb', line 174

def description_context
  splitted_description.first.markdownified
end

#description_task ⇒ Object 



182
183
184
 
# File 'app/models/exercise.rb', line 182

def description_task
  splitted_description.drop(1).join("\n").markdownified
end

#ensure_type!(type) ⇒ Object 



153
154
155
156
157
158
159
 
# File 'app/models/exercise.rb', line 153

def ensure_type!(type)
  if self.type != type
    reclassify! type
  else
    self
  end
end

#files_for(current_content) ⇒ Object 



216
217
218
219
220
221
 
# File 'app/models/exercise.rb', line 216

def files_for(current_content)
  language
    .directives_sections
    .split_sections(current_content)
    .map { |name, content| Mumuki::Domain::File.new name, content }
end

#friendly ⇒ Object 



91
92
93
 
# File 'app/models/exercise.rb', line 91

def friendly
  defaulting_name { "#{navigable_parent.friendly} - #{name}" }
end

#guide_done_for?(user) ⇒ Boolean

Returns:

  • (Boolean) 


62
63
64
 
# File 'app/models/exercise.rb', line 62

def guide_done_for?(user)
  guide.done_for?(user)
end

#import_from_resource_h!(number, resource_h) ⇒ Object 



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
 
# File 'app/models/exercise.rb', line 103

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

#inspection_keywords ⇒ Object 



190
191
192
 
# File 'app/models/exercise.rb', line 190

def inspection_keywords
  {}
end

#limited? ⇒ Boolean

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

Returns:

  • (Boolean) 


208
209
210
 
# File 'app/models/exercise.rb', line 208

def limited?
  !results_hidden? && navigable_parent.limited_for?(self)
end

#messages_path_for(user) ⇒ Object 



166
167
168
 
# File 'app/models/exercise.rb', line 166

def messages_path_for(user)
  "api/guides/#{guide.slug}/#{bibliotheca_id}/student/#{URI.escape user.uid}/messages?language=#{language}"
end

#messages_url_for(user) ⇒ Object 



170
171
172
 
# File 'app/models/exercise.rb', line 170

def messages_url_for(user)
  Mumukit::Platform.classroom_api.organic_url_for(Organization.current, messages_path_for(user))
end

#navigable_content_in(organization = Organization.current) ⇒ Object 



50
51
52
 
# File 'app/models/exercise.rb', line 50

def navigable_content_in(organization = Organization.current)
  self if used_in?(organization)
end

#new_solution ⇒ Object 



99
100
101
 
# File 'app/models/exercise.rb', line 99

def new_solution
  Mumuki::Domain::Submission::Solution.new(content: default_content)
end

#pending_siblings_for(user) ⇒ Object 



236
237
238
 
# File 'app/models/exercise.rb', line 236

def pending_siblings_for(user)
  guide.pending_exercises(user)
end

#previous ⇒ Object 



70
71
72
 
# File 'app/models/exercise.rb', line 70

def previous
  sibling_at number.pred
end

#reclassify!(type) ⇒ Object 



161
162
163
164
 
# File 'app/models/exercise.rb', line 161

def reclassify!(type)
  update!(type: type)
  Exercise.find(id)
end

#reset! ⇒ Object 



144
145
146
147
148
149
150
151
 
# File 'app/models/exercise.rb', line 144

def reset!
  self.name = nil
  self.description = nil
  self.corollary = nil
  self.hint = nil
  self.extra = nil
  self.tag_list = []
end

#results_hidden? ⇒ Boolean

Returns:

  • (Boolean) 


212
213
214
 
# File 'app/models/exercise.rb', line 212

def results_hidden?
  navigable_parent&.results_hidden_for?(self)
end

#search_tags ⇒ Object 



79
80
81
 
# File 'app/models/exercise.rb', line 79

def search_tags
  [language&.name, *tag_list].compact
end

#settings ⇒ Object 



232
233
234
 
# File 'app/models/exercise.rb', line 232

def settings
  guide.settings.deep_merge super
end

#sibling_at(index) ⇒ Object 



74
75
76
77
 
# File 'app/models/exercise.rb', line 74

def sibling_at(index)
  index = number + index unless index.positive?
  guide.exercises.find_by(number: index)
end

#solvable? ⇒ Boolean

Returns:

  • (Boolean) 


240
241
242
 
# File 'app/models/exercise.rb', line 240

def solvable?
  is_a? ::Problem
end

#splitted_description ⇒ Object 



178
179
180
 
# File 'app/models/exercise.rb', line 178

def splitted_description
  description.split('> ')
end

#structural_parent ⇒ Object 



58
59
60
 
# File 'app/models/exercise.rb', line 58

def structural_parent
  guide
end

#submission_for(user) ⇒ Object 



95
96
97
 
# File 'app/models/exercise.rb', line 95

def submission_for(user)
  assignment_for(user).submission
end

#to_expanded_resource_h(options = {}) ⇒ Object

Keep this list up to date with Mumuki::Domain::Store::Github::ExerciseSchema



134
135
136
137
138
139
140
141
142
 
# File 'app/models/exercise.rb', line 134

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(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

#to_resource_h(*args) ⇒ Object 



128
129
130
 
# File 'app/models/exercise.rb', line 128

def to_resource_h(*args)
  to_expanded_resource_h(*args).compact
end

#transparent_id ⇒ Object 



83
84
85
 
# File 'app/models/exercise.rb', line 83

def transparent_id
  "#{guide.transparent_id}/#{bibliotheca_id}"
end

#transparent_params ⇒ Object 



87
88
89
 
# File 'app/models/exercise.rb', line 87

def transparent_params
  guide.transparent_params.merge(bibliotheca_id: bibliotheca_id)
end

#try_submit_solution!(user, solution = {}) ⇒ Object

Submits the user solution only if the corresponding assignment has attemps left



196
197
198
199
200
201
202
203
 
# File 'app/models/exercise.rb', line 196

def try_submit_solution!(user, solution={})
  assignment = assignment_for(user)
  if assignment.attempts_left?
    submit_solution!(user, solution)
  else
    assignment
  end
end

#used_in?(organization = Organization.current) ⇒ Boolean

Returns:

  • (Boolean) 


46
47
48
 
# File 'app/models/exercise.rb', line 46

def used_in?(organization=Organization.current)
  guide.usage_in_organization(organization).present?
end