Class: ActiveModel::Type::Value
- Defined in:
- lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb
Direct Known Subclasses
Binary, Boolean, Date, DateTime, Decimal, Float, ImmutableString, Integer, Time, ActiveRecord::Type::Json, ActiveRecord::Type::Serialized
Instance Attribute Summary collapse
-
#limit ⇒ Object
readonly
Returns the value of attribute limit.
-
#precision ⇒ Object
readonly
Returns the value of attribute precision.
-
#scale ⇒ Object
readonly
Returns the value of attribute scale.
Instance Method Summary collapse
- #==(other) ⇒ Object (also: #eql?)
- #assert_valid_value(_) ⇒ Object
-
#binary? ⇒ Boolean
These predicates are not documented, as I need to look further into their use, and see if they can be removed entirely.
-
#cast(value) ⇒ Object
Type casts a value from user input (e.g. from a setter).
-
#changed?(old_value, new_value, _new_value_before_type_cast) ⇒ Boolean
Determines whether a value has changed for dirty checking.
-
#changed_in_place?(raw_old_value, new_value) ⇒ Boolean
Determines whether the mutable value has been modified since it was read.
-
#deserialize(value) ⇒ Object
Converts a value from database input to the appropriate ruby type.
-
#force_equality?(_value) ⇒ Boolean
:nodoc:.
- #hash ⇒ Object
-
#initialize(precision: nil, limit: nil, scale: nil) ⇒ Value
constructor
A new instance of Value.
-
#map(value) {|value| ... } ⇒ Object
:nodoc:.
-
#serializable?(value) ⇒ Boolean
Returns true if this type can convert
value
to a type that is usable by the database. -
#serialize(value) ⇒ Object
Casts a value from the ruby type to a type that the database knows how to understand.
-
#type ⇒ Object
:nodoc:.
-
#type_cast_for_schema(value) ⇒ Object
Type casts a value for schema dumping.
-
#value_constructed_by_mass_assignment?(_value) ⇒ Boolean
:nodoc:.
Constructor Details
#initialize(precision: nil, limit: nil, scale: nil) ⇒ Value
Returns a new instance of Value.
8 9 10 11 12 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 8 def initialize(precision: nil, limit: nil, scale: nil) @precision = precision @scale = scale @limit = limit end |
Instance Attribute Details
#limit ⇒ Object (readonly)
Returns the value of attribute limit.
6 7 8 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 6 def limit @limit end |
#precision ⇒ Object (readonly)
Returns the value of attribute precision.
6 7 8 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 6 def precision @precision end |
#scale ⇒ Object (readonly)
Returns the value of attribute scale.
6 7 8 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 6 def scale @scale end |
Instance Method Details
#==(other) ⇒ Object Also known as: eql?
109 110 111 112 113 114 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 109 def ==(other) self.class == other.class && precision == other.precision && scale == other.scale && limit == other.limit end |
#assert_valid_value(_) ⇒ Object
121 122 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 121 def assert_valid_value(_) end |
#binary? ⇒ Boolean
These predicates are not documented, as I need to look further into their use, and see if they can be removed entirely.
65 66 67 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 65 def binary? # :nodoc: false end |
#cast(value) ⇒ Object
Type casts a value from user input (e.g. from a setter). This value may be a string from the form builder, or a ruby object passed to a setter. There is currently no way to differentiate between which source it came from.
The return value of this method will be returned from ActiveRecord::AttributeMethods::Read#read_attribute. See also: Value#cast_value.
value
The raw input, as provided to the attribute setter.
45 46 47 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 45 def cast(value) cast_value(value) unless value.nil? end |
#changed?(old_value, new_value, _new_value_before_type_cast) ⇒ Boolean
Determines whether a value has changed for dirty checking. old_value
and new_value
will always be type-cast. Types should not need to override this method.
72 73 74 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 72 def changed?(old_value, new_value, _new_value_before_type_cast) old_value != new_value end |
#changed_in_place?(raw_old_value, new_value) ⇒ Boolean
Determines whether the mutable value has been modified since it was read. Returns false
by default. If your type returns an object which could be mutated, you should override this method. You will need to either:
-
pass
new_value
to Value#serialize and compare it toraw_old_value
or
-
pass
raw_old_value
to Value#deserialize and compare it tonew_value
raw_old_value
The original value, before being passed to deserialize
.
new_value
The current value, after type casting.
93 94 95 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 93 def changed_in_place?(raw_old_value, new_value) false end |
#deserialize(value) ⇒ Object
Converts a value from database input to the appropriate ruby type. The return value of this method will be returned from ActiveRecord::AttributeMethods::Read#read_attribute. The default implementation just calls Value#cast.
value
The raw input, as provided from the database.
31 32 33 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 31 def deserialize(value) cast(value) end |
#force_equality?(_value) ⇒ Boolean
:nodoc:
101 102 103 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 101 def force_equality?(_value) # :nodoc: false end |
#hash ⇒ Object
117 118 119 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 117 def hash [self.class, precision, scale, limit].hash end |
#map(value) {|value| ... } ⇒ Object
:nodoc:
105 106 107 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 105 def map(value) # :nodoc: yield value end |
#serializable?(value) ⇒ Boolean
Returns true if this type can convert value
to a type that is usable by the database. For example a boolean type can return true
if the value parameter is a Ruby boolean, but may return false
if the value parameter is some other object.
18 19 20 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 18 def serializable?(value) true end |
#serialize(value) ⇒ Object
Casts a value from the ruby type to a type that the database knows how to understand. The returned value from this method should be a String
, Numeric
, Date
, Time
, Symbol
, true
, false
, or nil
.
53 54 55 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 53 def serialize(value) value end |
#type ⇒ Object
:nodoc:
22 23 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 22 def type # :nodoc: end |
#type_cast_for_schema(value) ⇒ Object
Type casts a value for schema dumping. This method is private, as we are hoping to remove it entirely.
59 60 61 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 59 def type_cast_for_schema(value) # :nodoc: value.inspect end |
#value_constructed_by_mass_assignment?(_value) ⇒ Boolean
:nodoc:
97 98 99 |
# File 'lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activemodel-7.0.4/lib/active_model/type/value.rb', line 97 def value_constructed_by_mass_assignment?(_value) # :nodoc: false end |