Module: Volt::Validations

Included in:
Model
Defined in:
lib/volt/models/validations/validations.rb

Overview

Include in any class to get validation logic

Defined Under Namespace

Modules: ClassMethods

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object 



63
64
65
66
 
# File 'lib/volt/models/validations/validations.rb', line 63

def self.included(base)
  base.send :extend, ClassMethods
  base.class_attribute(:custom_validations, :validations_to_run)
end

Instance Method Details

#clear_server_errors(key) ⇒ Object

When a field is changed, we want to clear any errors from the server



110
111
112
 
# File 'lib/volt/models/validations/validations.rb', line 110

def clear_server_errors(key)
  @server_errors.delete(key)
end

#error_in_changed_attributes? ⇒ Boolean

Returns true if any of the changed fields now has an error

Returns:

  • (Boolean) —

    true if one of the changed fields has an error.



143
144
145
146
147
148
149
150
151
152
 
# File 'lib/volt/models/validations/validations.rb', line 143

def error_in_changed_attributes?
  errs = errors

  changed_attributes.each_pair do |key, _|
    # If any of the fields with errors are also the ones that were
    return true if errs[key]
  end

  false
end

#errors(marked_only = false) ⇒ Object 



114
115
116
117
118
119
120
121
122
123
 
# File 'lib/volt/models/validations/validations.rb', line 114

def errors(marked_only = false)
  @errors ||= Errors.new

  if marked_only
    # Only return the fields that have been marked
    @errors.to_h.select { |key, _| marked_fields[key] }
  else
    @errors
  end
end

#mark_all_fields! ⇒ Object

Marks all fields, useful for when a model saves.



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
 
# File 'lib/volt/models/validations/validations.rb', line 79

def mark_all_fields!
  # TODO: We can use a Set here, but set was having issues.  Check in a
  # later version of opal.
  fields_to_mark = []

  # Look at each validation
  validations = self.class.validations_to_run
  if validations
    fields_to_mark += validations.keys
  end

  # Also include any current fields
  fields_to_mark += attributes.keys

  fields_to_mark.each do |key|
    mark_field!(key.to_sym)
  end
end

#mark_field!(field_name) ⇒ Object

Once a field is ready, we can use include_in_errors! to start showing its errors.



70
71
72
 
# File 'lib/volt/models/validations/validations.rb', line 70

def mark_field!(field_name)
  marked_fields[field_name] = true
end

#marked_errors ⇒ Object 



98
99
100
 
# File 'lib/volt/models/validations/validations.rb', line 98

def marked_errors
  errors(true)
end

#marked_fields ⇒ Object 



74
75
76
 
# File 'lib/volt/models/validations/validations.rb', line 74

def marked_fields
  @marked_fields ||= ReactiveHash.new
end

#server_errors ⇒ Object

server errors are errors that come back from the server when we save! Any changes to the associated fields will clear the error until another save!



105
106
107
 
# File 'lib/volt/models/validations/validations.rb', line 105

def server_errors
  @server_errors ||= ReactiveHash.new
end

#validate(field_name = nil, options = nil) ⇒ Object 



58
59
60
61
 
# File 'lib/volt/models/validations/validations.rb', line 58

def validate(field_name = nil, options = nil)
  @instance_validations[field_name] ||= {}
  @instance_validations[field_name].merge!(options)
end

#validate! ⇒ Object

TODO: Errors is being called for any validation change. We should have errors return a hash like object that only calls the validation for each one.



127
128
129
130
131
132
133
134
135
136
137
138
139
 
# File 'lib/volt/models/validations/validations.rb', line 127

def validate!
  errors.clear

  run_validations.then do
    # See if any server errors are in place and merge them in if they are
    errors.merge!(server_errors.to_h) if Volt.client?
  end.then do
    run_custom_validations
  end.then do
    # Return the errors object
    errors
  end
end