Module: Lotus::Utils::Kernel
- Defined in:
- lib/lotus/utils/kernel.rb
Overview
Kernel utilities
Constant Summary collapse
- NUMERIC_MATCHER =
This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.
Matcher for numeric values
/\A([\d\/\.\+iE]+|NaN|Infinity)\z/.freeze
Class Method Summary collapse
-
.Array(arg) ⇒ Array
Coerces the argument to be an Array.
-
.BigDecimal(arg) ⇒ BigDecimal
Coerces the argument to be a BigDecimal.
-
.Boolean(arg) ⇒ true, false
Coerces the argument to be a Boolean.
-
.Date(arg) ⇒ Date
Coerces the argument to be a Date.
-
.DateTime(arg) ⇒ DateTime
Coerces the argument to be a DateTime.
-
.Float(arg) ⇒ Float
Coerces the argument to be a Float.
- .Hash(arg) ⇒ Object
-
.inspect_type_error(arg) ⇒ Object
private
Returns the most useful type error possible.
-
.Integer(arg) ⇒ Fixnum
Coerces the argument to be an Integer.
-
.Pathname(arg) ⇒ Pathname
Coerces the argument to be a Pathname.
-
.Set(arg) ⇒ Set
Coerces the argument to be a Set.
- .String(arg) ⇒ Object
-
.Symbol(arg) ⇒ Symbol
Coerces the argument to be a Symbol.
-
.Time(arg) ⇒ Time
Coerces the argument to be a Time.
Class Method Details
.Array(arg) ⇒ Array
Coerces the argument to be an Array.
It’s similar to Ruby’s Kernel.Array, but it applies further transformations:
* flatten
* compact
* uniq
81 82 83 84 85 86 87 |
# File 'lib/lotus/utils/kernel.rb', line 81 def self.Array(arg) super(arg).dup.tap do |a| a.flatten! a.compact! a.uniq! end end |
.BigDecimal(arg) ⇒ BigDecimal
Coerces the argument to be a BigDecimal.
421 422 423 424 425 426 427 428 429 430 431 432 433 |
# File 'lib/lotus/utils/kernel.rb', line 421 def self.BigDecimal(arg) case arg when ->(a) { a.respond_to?(:to_d) } then arg.to_d when Float, Complex, Rational BigDecimal(arg.to_s) when ->(a) { a.to_s.match(NUMERIC_MATCHER) } BigDecimal.new(arg) else raise TypeError.new "can't convert #{inspect_type_error(arg)}into BigDecimal" end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into BigDecimal" end |
.Boolean(arg) ⇒ true, false
Coerces the argument to be a Boolean.
911 912 913 914 915 916 917 918 919 920 921 |
# File 'lib/lotus/utils/kernel.rb', line 911 def self.Boolean(arg) case arg when Numeric then arg > 0 && arg <= 1 when String, '0' then Boolean(arg.to_i) when ->(a) { a.respond_to?(:to_bool) } then arg.to_bool else !!arg end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Boolean" end |
.Date(arg) ⇒ Date
Coerces the argument to be a Date.
727 728 729 730 731 732 733 734 735 |
# File 'lib/lotus/utils/kernel.rb', line 727 def self.Date(arg) if arg.respond_to?(:to_date) arg.to_date else Date.parse(arg.to_s) end rescue ArgumentError, NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Date" end |
.DateTime(arg) ⇒ DateTime
Coerces the argument to be a DateTime.
794 795 796 797 798 799 800 801 802 803 |
# File 'lib/lotus/utils/kernel.rb', line 794 def self.DateTime(arg) case arg when ->(a) { a.respond_to?(:to_datetime) } then arg.to_datetime when Numeric then DateTime(Time.at(arg)) else DateTime.parse(arg.to_s) end rescue ArgumentError, NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into DateTime" end |
.Float(arg) ⇒ Float
Coerces the argument to be a Float.
It’s similar to Ruby’s Kernel.Float, but it doesn’t stop at the first error and raise an exception only when the argument can’t be coerced.
547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 |
# File 'lib/lotus/utils/kernel.rb', line 547 def self.Float(arg) super(arg) rescue ArgumentError, TypeError begin case arg when NilClass, ->(a) { a.respond_to?(:to_f) && a.to_s.match(NUMERIC_MATCHER) } arg.to_f else raise TypeError.new "can't convert #{inspect_type_error(arg)}into Float" end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Float" end rescue RangeError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Float" end |
.Hash(arg) ⇒ Object
201 202 203 204 205 206 207 208 209 |
# File 'lib/lotus/utils/kernel.rb', line 201 def self.Hash(arg) if arg.respond_to?(:to_h) arg.to_h else super(arg) end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Hash" end |
.inspect_type_error(arg) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns the most useful type error possible
If the object does not respond_to?(:inspect), we return the class, else we return nil. In all cases, this method is tightly bound to callers, as this method appends the required space to make the error message look good.
1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 |
# File 'lib/lotus/utils/kernel.rb', line 1041 def self.inspect_type_error(arg) (arg.respond_to?(:inspect) ? arg.inspect : arg.to_s) << " " rescue NoMethodError => _ # missing the #respond_to? method, fall back to returning the class' name begin arg.class.name << " instance " rescue NoMethodError # missing the #class method, can't fall back to anything better than nothing # Callers will have to guess from their code nil end end |
.Integer(arg) ⇒ Fixnum
Coerces the argument to be an Integer.
It’s similar to Ruby’s Kernel.Integer, but it doesn’t stop at the first error and raise an exception only when the argument can’t be coerced.
331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 |
# File 'lib/lotus/utils/kernel.rb', line 331 def self.Integer(arg) super(arg) rescue ArgumentError, TypeError, NoMethodError begin case arg when NilClass, ->(a) { a.respond_to?(:to_i) && a.to_s.match(NUMERIC_MATCHER) } arg.to_i else raise TypeError.new "can't convert #{inspect_type_error(arg)}into Integer" end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Integer" end rescue RangeError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Integer" end |
.Pathname(arg) ⇒ Pathname
Coerces the argument to be a Pathname.
971 972 973 974 975 976 977 978 979 |
# File 'lib/lotus/utils/kernel.rb', line 971 def self.Pathname(arg) case arg when ->(a) { a.respond_to?(:to_pathname) } then arg.to_pathname else super end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Pathname" end |
.Set(arg) ⇒ Set
Coerces the argument to be a Set.
136 137 138 139 140 141 142 143 144 |
# File 'lib/lotus/utils/kernel.rb', line 136 def self.Set(arg) if arg.respond_to?(:to_set) arg.to_set else Set.new(::Kernel.Array(arg)) end rescue NoMethodError raise TypeError.new("can't convert #{inspect_type_error(arg)}into Set") end |
.String(arg) ⇒ Object
652 653 654 655 656 657 658 659 660 661 662 663 |
# File 'lib/lotus/utils/kernel.rb', line 652 def self.String(arg) case arg when ->(a) { a.respond_to?(:to_str) } arg.to_str when ->(a) { a.respond_to?(:to_s) } arg.to_s else super(arg) end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into String" end |
.Symbol(arg) ⇒ Symbol
Coerces the argument to be a Symbol.
1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 |
# File 'lib/lotus/utils/kernel.rb', line 1022 def self.Symbol(arg) case arg when '' then raise TypeError.new "can't convert #{inspect_type_error(arg)}into Symbol" when ->(a) { a.respond_to?(:to_sym) } then arg.to_sym else raise TypeError.new "can't convert #{inspect_type_error(arg)}into Symbol" end rescue NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Symbol" end |
.Time(arg) ⇒ Time
Coerces the argument to be a Time.
859 860 861 862 863 864 865 866 867 868 |
# File 'lib/lotus/utils/kernel.rb', line 859 def self.Time(arg) case arg when ->(a) { a.respond_to?(:to_time) } then arg.to_time when Numeric then Time.at(arg) else Time.parse(arg.to_s) end rescue ArgumentError, NoMethodError raise TypeError.new "can't convert #{inspect_type_error(arg)}into Time" end |