lite-ruby 1.0.31 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 15a0127d8b5abef7b86a8b357d76bd81721b3e17633e25935d074c914f2ce6c9
-  data.tar.gz: 0e0cbbb3cb414574370770851e3423b1f09094d1aebd0a133897c24ad9b40588
+  metadata.gz: 706904db37834627c1356104bc628510a7aa144278306c0cdb8a95594204444a
+  data.tar.gz: 5aac1bf1134a94b67dca8d577396f5da9f4f1f35c294040412c1ac3c49f2a3ee
 SHA512:
-  metadata.gz: 28cb3f81b2df9ff0483153c8c7077c04220efa0012958d6533cd8903a6d7b22e1099ab77c5c3db6b024cf04d211c37eb8bae9581e6457c02ddf1d891a5bf7142
-  data.tar.gz: 5adfc54f1824eab97ab7f23f20ea4b33f3405fddbd97ba32d48fa93f883eb35e0f6f9d70ac24f39ff046ae5a0775a080e0fcffaea1cfd4ce3e353e50afcd1bf8
+  metadata.gz: 1241428618317da93171051ef4ec7ff613f8db822d1514c71653f5d591067eb787fa6bd88b5a9462020fa6a0116edf3e064462996ca8f6734da52c8031102317
+  data.tar.gz: 2fe2fca36eec6f76495fcef11e57f1dc75153a36c642225e613a43bb97defc28d803aeb78063b4459e9ebd426277f803baf8e3f6c3eecdd32d47fba94ec50b4b

data/.rubocop.yml

@@ -44,6 +44,8 @@ RSpec/ExampleLength:
   Enabled: false
 RSpec/MultipleExpectations:
   Enabled: false
+Style/ArgumentsForwarding:
+  Enabled: false
 Style/Documentation:
   Enabled: false
 Style/ExpandPathArguments:

data/CHANGELOG.md

@@ -6,6 +6,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0] - 2020-11-06
+### Added
+- Added Array => `extract!` to `except!` alias
+- Added Array => `only(!)` to `select_values(!)` alias
+- Added Hash => `collect_keys` to `map_keys` alias
+- Added Hash => `collect_values` to `map_values` alias
+### Changed
+- Rename Date, Time => `[method_name]_12` to `[method_name]12` ex: `hour_12` is now `hour12`
+- Rename String => `transliterize` to `transliterate`
+- Skip loading clashing methods with active support
+### Remove
+- Numeric `clamp`
+
 ## [1.0.31] - 2020-09-21
 ### Changed
 - Changed `block_given?` => `defined?(yield)` for more performance
@@ -26,8 +39,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.0.26] - 2020-06-12
 ### Added
-- Added array => `all_after`
-- Added array => `all_before`
+- Added Array => `all_after`
+- Added Array => `all_before`
 
 ## [1.0.26] - 2020-05-22
 ### Changed

data/Gemfile.lock

@@ -1,25 +1,25 @@
 PATH
   remote: .
   specs:
-    lite-ruby (1.0.31)
+    lite-ruby (1.1.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actionpack (6.0.3.3)
-      actionview (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
+    actionpack (6.0.3.4)
+      actionview (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       rack (~> 2.0, >= 2.0.8)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actionview (6.0.3.3)
-      activesupport (= 6.0.3.3)
+    actionview (6.0.3.4)
+      activesupport (= 6.0.3.4)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activesupport (6.0.3.3)
+    activesupport (6.0.3.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
@@ -49,7 +49,7 @@ GEM
     nokogiri (1.10.10)
       mini_portile2 (~> 2.4.0)
     parallel (1.19.2)
-    parser (2.7.1.4)
+    parser (2.7.2.0)
       ast (~> 2.4.1)
     rack (2.2.3)
     rack-test (1.1.0)
@@ -59,45 +59,46 @@ GEM
       nokogiri (>= 1.6)
     rails-html-sanitizer (1.3.0)
       loofah (~> 2.3)
-    railties (6.0.3.3)
-      actionpack (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
+    railties (6.0.3.4)
+      actionpack (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
       method_source
       rake (>= 0.8.7)
       thor (>= 0.20.3, < 2.0)
     rainbow (3.0.0)
     rake (13.0.1)
-    regexp_parser (1.8.0)
+    regexp_parser (1.8.2)
     rexml (3.2.4)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    rubocop (0.91.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+    rubocop (1.2.0)
       parallel (~> 1.10)
-      parser (>= 2.7.1.1)
+      parser (>= 2.7.1.5)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.7)
+      regexp_parser (>= 1.8)
       rexml
-      rubocop-ast (>= 0.4.0, < 1.0)
+      rubocop-ast (>= 1.0.1)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (0.4.2)
-      parser (>= 2.7.1.4)
+    rubocop-ast (1.1.1)
+      parser (>= 2.7.1.5)
     rubocop-performance (1.8.1)
       rubocop (>= 0.87.0)
       rubocop-ast (>= 0.4.0)
-    rubocop-rspec (1.43.2)
-      rubocop (~> 0.87)
+    rubocop-rspec (2.0.0)
+      rubocop (~> 1.0)
+      rubocop-ast (>= 1.1.0)
     ruby-progressbar (1.10.1)
     ruby_parser (3.15.0)
       sexp_processor (~> 4.9)
@@ -107,7 +108,7 @@ GEM
     tzinfo (1.2.7)
       thread_safe (~> 0.1)
     unicode-display_width (1.7.0)
-    zeitwerk (2.4.0)
+    zeitwerk (2.4.1)
 
 PLATFORMS
   ruby

data/README.md

@@ -4,6 +4,7 @@
 [![Build Status](https://travis-ci.org/drexed/lite-ruby.svg?branch=master)](https://travis-ci.org/drexed/lite-ruby)
 
 Lite::Ruby is a collection of useful Ruby methods for its primitive classes.
+AcitveSupport equivalent methods do not get included when AcitveSupport is available.
 
 **NOTE:** If you are coming from `ActiveObject`, please read the [port](#port) section.
 

data/docs/ARRAY.md

@@ -155,7 +155,7 @@ Returns a list of duplicate elements.
 [1, 1, 2, 2, 2, 3].duplicates(3) #=> [2]
 ```
 
-`except(!)`
+`except(!)` aka `remove_values(!)`
 ------
 Removes given values from the array.
 
@@ -235,7 +235,7 @@ Converts blank values into `nil`.
 ['', 3, 4].nillify! #=> [nil, 3, 4]
 ```
 
-`only(!)`
+`only(!)` aka `select_values(!)`
 ------
 Selects given values from the array.
 
@@ -285,14 +285,6 @@ Returns a sample of random n values by size or given.
 [1, 2, 3].rand_sample(1) #=> [2]
 ```
 
-`reject_values`
-------
-Delete multiple values from a `dup` copy of the original array.
-
-```ruby
-[1, 2, 3, 4, 5].reject_values(2, 4) #=> [1, 3, 5]
-```
-
 `rposition`
 ------
 Returns the position of the last matching value.

data/docs/HASH.md

@@ -110,7 +110,7 @@ Merge the values of this hash with those from another, setting all values to be
 { a: 1, b: 2 }.collate(a: 3, b: 4, c: 5) #=> { a: [1, 3], b: [2, 4], c: [5] }
 ```
 
-`collect_keys`
+`collect_keys` aka `map_keys`
 ------
 Returns an array with all keys converted using the block operation.
 
@@ -119,7 +119,7 @@ Returns an array with all keys converted using the block operation.
 { foo: 'bar', 'baz' => :boo }.collect_keys { |k| k.to_s.upcase } #=> ['FOO', BAZ']
 ```
 
-`collect_values`
+`collect_values` aka `map_values`
 ------
 Returns an array with all values converted using the block operation.
 

data/docs/NUMERIC.md

@@ -8,16 +8,6 @@ Returns the sum of two numbers.
 4.add(2) #=> 6
 ```
 
-`clamp`
-------
-Returns the closest number outside of the lower and upper bound.
-
-```ruby
-1.clamp(3, 6) # => 3
-5.clamp(3..6) # => 5
-8.clamp(3, 6) # => 6
-```
-
 `close?`
 ------
 Returns if a number is within the degree of another.

data/docs/STRING.md

@@ -511,12 +511,12 @@ If the position is negative, it is counted from the end of the string.
 'example'.to(-2) #=> 'exampl'
 ```
 
-`transliterize(!)`
+`transliterate(!)`
 ------
 Returns a string with swapped special characters.
 
 ```ruby
-'źåöé'.transliterize #=> 'zaoe'
+'źåöé'.transliterate #=> 'zaoe'
 ```
 
 `truncate`

data/docs/TIME.md

@@ -20,8 +20,8 @@ Converts a `time` object to `strftime` it using a human readable string.
 | --- | --- | --- | --- | --- |
 | Hour | 24h zero-padded | `h`, `hour`, `hour_padded` | %H | (00..23) |
 | Hour | 24h blank-padded | `hh`, `HOUR`, `hour_blank` | %k | ( 0..23) |
-| Hour | 12h zero-padded | `hhh`, `hour_12`, `hour_12_padded` | %I | (01..12) |
-| Hour | 12h blank-padded | `hhhh`, `HOUR_12`, `hour_12_blank` | %l | ( 1..12) |
+| Hour | 12h zero-padded | `hhh`, `hour12`, `hour12_padded` | %I | (01..12) |
+| Hour | 12h blank-padded | `hhhh`, `HOUR12`, `hour12_blank` | %l | ( 1..12) |
 | Minute | Minute | `n`, `minute` | %M | (00..59) |
 | Second | Second | `s`, `second` | %S | (00..59) |
 | Meridian | Lowercase | `ampm`, `meridian` | %P | am..pm |
@@ -48,8 +48,8 @@ Converts a `time` object to a predefined format.
 | --- | --- | --- | --- | --- |
 | Hour | 24h zero-padded | `:hour`, `:hour_padded` | %H | (00..23) |
 | Hour | 24h blank-padded | `:hour_blank` | %k | ( 0..23) |
-| Hour | 12h zero-padded | `hour_12`, `:hour_12_padded` | %I | (01..12) |
-| Hour | 12h blank-padded | `:hour_12_blank` | %l | ( 1..12) |
+| Hour | 12h zero-padded | `hour12`, `:hour12_padded` | %I | (01..12) |
+| Hour | 12h blank-padded | `:hour12_blank` | %l | ( 1..12) |
 | Minute | Minute | `:minute` | %M | (00..59) |
 | Second | Second | `:second` | %S | (00..59) |
 | Meridian | Lowercase | `:ampm` | %P | am..pm |
@@ -67,28 +67,28 @@ Converts a `time` object to a predefined format.
 | Combo | 24h time | `:time_blank` | %k:%M %z | 0:31 |
 | Combo | 24h time | `:time_tz` | %H:%M %z | 00:31 +0000 |
 | Combo | 24h time | `:time_tzn` | %H:%M %Z | 00:31 UTC |
-| Combo | 12h time | `:time_12`, `:time_12_padded` | %I:%M %P | 07:31 am |
-| Combo | 12h time | `:time_12_blank` | %l:%M %P | 7:31 am |
-| Combo | 12h Time | `:time_12_tz` | %I:%M %P %z | 07:31 am +0000 |
-| Combo | 12h Time | `:time_12_tzn` | %I:%M %P %Z | 07:31 am UTC |
+| Combo | 12h time | `:time12`, `:time12_padded` | %I:%M %P | 07:31 am |
+| Combo | 12h time | `:time12_blank` | %l:%M %P | 7:31 am |
+| Combo | 12h Time | `:time12_tz` | %I:%M %P %z | 07:31 am +0000 |
+| Combo | 12h Time | `:time12_tzn` | %I:%M %P %Z | 07:31 am UTC |
 | Combo | 24h daytime | `:daytime` | %B %-d %H:%M | January 9 00:31 |
 | Combo | 24h daytime | `:daytime_abbr` | %b %-d %H:%M | Jan 9 00:31 |
 | Combo | 24h daytime | `:daytime_iso` | %m-%d %H:%M | 01-09 00:31 |
-| Combo | 12h daytime | `:daytime_12` | %B %-d %H:%M | January 9 12:31 am |
-| Combo | 12h daytime | `:daytime_12_abbr` | %b %-d %H:%M | Jan 9 12:31 am |
-| Combo | 12h daytime | `:daytime_12_iso` | %m-%d %H:%M | 01-09 12:31 am |
+| Combo | 12h daytime | `:daytime12` | %B %-d %H:%M | January 9 12:31 am |
+| Combo | 12h daytime | `:daytime12_abbr` | %b %-d %H:%M | Jan 9 12:31 am |
+| Combo | 12h daytime | `:daytime12_iso` | %m-%d %H:%M | 01-09 12:31 am |
 | Combo | 24h datetime | `:datetime` | %B %-d, %Y %H:%M | January 9, 2014 00:31 |
 | Combo | 24h datetime | `:datetime_abbr` | %b %-d, %Y %H:%M | Jan 9, 2014 00:31 |
 | Combo | 24h datetime | `:datetime_iso` | %Y-%m-%d %H:%M | 2014-01-09 00:31 |
 | Combo | 24h datetime | `:datetime_tzn` | %B %-d, %Y %H:%M %Z | January 9, 2014 00:31 UTC |
 | Combo | 24h datetime | `:datetime_abbr_tzn` | %b %-d, %Y %H:%M %Z | Jan 9, 2014 00:31 UTC |
 | Combo | 24h datetime | `:datetime_iso_tzn` | %Y-%m-%d %H:%M %z | 2014-01-09 00:31 +0000 |
-| Combo | 12h datetime | `:datetime_12` | %B %-d, %Y %H:%M | January 9, 2014 12:31 am |
-| Combo | 12h datetime | `:datetime_12_abbr` | %b %-d, %Y %H:%M | Jan 9, 2014 12:31 am |
-| Combo | 12h datetime | `:datetime_12_iso` | %Y-%m-%d %H:%M | 2014-01-09 12:31 am |
-| Combo | 12h datetime | `:datetime_12_tzn` | %B %-d, %Y %H:%M %Z | January 9, 2014 12:31 am UTC |
-| Combo | 12h datetime | `:datetime_12_abbr_tzn` | %b %-d, %Y %H:%M %Z | Jan 9, 2014 12:31 am UTC |
-| Combo | 12h datetime | `:datetime_12_iso_tzn` | %Y-%m-%d %H:%M %z | 2014-01-09 12:31 am +0000 |
+| Combo | 12h datetime | `:datetime12` | %B %-d, %Y %H:%M | January 9, 2014 12:31 am |
+| Combo | 12h datetime | `:datetime12_abbr` | %b %-d, %Y %H:%M | Jan 9, 2014 12:31 am |
+| Combo | 12h datetime | `:datetime12_iso` | %Y-%m-%d %H:%M | 2014-01-09 12:31 am |
+| Combo | 12h datetime | `:datetime12_tzn` | %B %-d, %Y %H:%M %Z | January 9, 2014 12:31 am UTC |
+| Combo | 12h datetime | `:datetime12_abbr_tzn` | %b %-d, %Y %H:%M %Z | Jan 9, 2014 12:31 am UTC |
+| Combo | 12h datetime | `:datetime12_iso_tzn` | %Y-%m-%d %H:%M %z | 2014-01-09 12:31 am +0000 |
 
 ```ruby
 Time.now.stamp(:datetime) #=> 'January 09, 2014 02:31 pm'

data/lib/lite/ruby/array.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 if Lite::Ruby.configuration.monkey_patches.include?('array')
+  require 'lite/ruby/safe/array' unless defined?(ActiveSupport)
+
   class Array
 
     def assert_min_values!(*valid_values)
@@ -109,10 +111,6 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
     # rubocop:enable Metrics/PerceivedComplexity, Style/GuardClause, Style/IfInsideElse
     # rubocop:enable Metrics/AbcSize, Metrics/BlockNesting, Metrics/MethodLength
 
-    def deep_dup
-      map(&:deep_dup)
-    end
-
     def delete_first
       self[1..-1]
     end
@@ -160,11 +158,8 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
     end
 
     def except!(*values)
-      replace(except(*values))
-    end
-
-    def from(position)
-      self[position, size] || []
+      reject! { |val| values.include?(val) }
+      self
     end
 
     def fulfill(value, amount)
@@ -183,54 +178,12 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
       collection << self[-rem, rem]
     end
 
-    # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
-    def in_groups(number, fill_with = nil, &block)
-      collection_size = size
-      division = collection_size.div(number)
-      modulo = collection_size % number
-
-      collection = []
-      start = 0
-      number.times do |int|
-        mod_gt_zero = modulo.positive?
-        grouping = division + (mod_gt_zero && modulo > int ? 1 : 0)
-        collection << last_group = slice(start, grouping)
-        last_group << fill_with if (fill_with != false) && mod_gt_zero && (grouping == division)
-        start += grouping
-      end
-
-      return collection unless defined?(yield)
-
-      collection.each(&block)
-    end
-    # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
-
-    # rubocop:disable Metrics/MethodLength, Style/GuardClause
-    def in_groups_of(number, fill_with = nil, &block)
-      if number.to_i <= 0
-        raise ArgumentError, "Group size must be a positive integer, was #{number.inspect}"
-      elsif fill_with == false
-        collection = self
-      else
-        padding = (number - size % number) % number
-        collection = dup.concat(Array.new(padding, fill_with))
-      end
-
-      sliced_collection = collection.each_slice(number)
-      return sliced_collection.to_a unless defined?(yield)
-
-      sliced_collection(&block)
-    end
-    # rubocop:enable Metrics/MethodLength, Style/GuardClause
-
     def indexes(value)
       array = []
       each_with_index { |val, i| array << i if value == val }
       array
     end
 
-    alias indices indexes
-
     def merge(*values)
       dup.merge!(*values)
     end
@@ -252,7 +205,8 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
     end
 
     def only!(*values)
-      replace(only(*values))
+      select! { |val| values.include?(val) }
+      self
     end
 
     def position(value)
@@ -284,7 +238,7 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
     end
 
     def promote!(value)
-      replace(promote(value))
+      sort_by! { |val| val == value ? -1 : 0 }
     end
 
     def rand_sample(max = nil)
@@ -292,10 +246,6 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
       sample(amount)
     end
 
-    def reject_values(*args)
-      reject { |val| args.include?(val) }
-    end
-
     def rposition(value)
       idx = rindex(value)
       return idx if idx.nil?
@@ -307,36 +257,13 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
       delete_at(Random.rand(size - 1))
     end
 
-    # rubocop:disable Metrics/AbcSize, Metrics/BlockNesting, Metrics/MethodLength
-    def split(number = nil)
-      array = [[]]
-
-      if defined?(yield)
-        each { |val| yield(val) ? (array << []) : (array.last << val) }
-      else
-        dup_arr = dup
-
-        until dup_arr.empty?
-          if (idx = dup_arr.index(number))
-            array.last << dup_arr.shift(idx)
-            dup_arr.shift
-            array << []
-          else
-            array.last << arr.shift(dup_arr.size)
-          end
-        end
-      end
-
-      array
-    end
-    # rubocop:enable Metrics/AbcSize, Metrics/BlockNesting, Metrics/MethodLength
-
     def strip
       reject(&:blank?)
     end
 
     def strip!
-      replace(strip)
+      reject!(&:blank?)
+      self
     end
 
     def swap(from, to)
@@ -344,24 +271,12 @@ if Lite::Ruby.configuration.monkey_patches.include?('array')
       self
     end
 
-    def to(position)
-      return first(position + 1) if position >= 0
-
-      self[0..position]
-    end
-
-    def to_sentence(options = {})
-      words_connector = options[:words_connector] || ', '
-      two_words_connector = options[:two_words_connector] || ' and '
-      last_word_connector = options[:last_word_connector] || ', and '
-
-      case size
-      when 0 then ''
-      when 1 then self[0].to_s.dup
-      when 2 then "#{self[0]}#{two_words_connector}#{self[1]}"
-      else "#{self[0...-1].join(words_connector)}#{last_word_connector}#{self[-1]}"
-      end
-    end
+    alias extract! except!
+    alias indices indexes
+    alias reject_values except
+    alias reject_values! except!
+    alias select_values only
+    alias select_values! only!
 
   end
 end