cotcube-helpers 0.1.5.4 → 0.1.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97c255de9c0dac3cad83de38b0b8e1eb21af6d27bdf751d58dcc013b9044a7bc
-  data.tar.gz: 01cb8859f054baf5c87d55d7b718d8261b48428a59e0e728acbb759855526804
+  metadata.gz: 93dafb52f8ac98f974e664aa75c8ffec500d8e97424f4d8018632ebf2593b591
+  data.tar.gz: 4ebb3c134a1d4fcf498fbc1514649e072283f8f30071a8c668db7a483801e649
 SHA512:
-  metadata.gz: 6358bd447301dd4a001b3e4f3ab6e80cd8d2e3073eef1ef9f05fa5c907bf7fd3a19245bd4ea4667bfaebade359e1dc6ea5b24a8f24cf2a8f43bfbb070b6e2567
-  data.tar.gz: a8876e8e07211f0648b2e646b721e52912bcf117f5b6d811f744368a86ab5c030a2f7ad6542464486fd6502ce9f7c8c51ff9cc5e04e401f45c9289a69e8eb1f5
+  metadata.gz: 4b89d9ba9ace8dea6e88cbefc5caf8a56ea923d2130850eee74e5fca2c888b35994841225ccf96f64bcf73eb650febefb15508704ba01f704afceb49f7efdc15
+  data.tar.gz: 0722b12dff36977b75f53988a1563310438ff9ed445b8d563b76fe522e5116f55b291e4bf46924611bf0b5886a71a82f53b14e915b34c0d071e3f0e6112bc06e

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 0.1.7.3 (March 13, 2021)
+  - array_ext: pairwise and triplewise now support saving result in latter members []=
+
+## 0.1.7.2 (February 01, 2021)
+  - adding #deep_freeze to Enumerable
+  - range_ext: added #mod to modify an (actually) immutable range
+  - simple_series_stats: minor fix
+
+## 0.1.7.1 (January 17, 2021)
+  - bugfix
+
+## 0.1.7 (January 17, 2021)
+  - added new method 'simple_series_stats'
+
+## 0.1.6 (January 15, 2021)
+  - removing :ranges from Range#select_within
+  - Added Array#select_right_by
+
 ## 0.1.5.4 (January 02, 2021)
 
 

data/VERSION

@@ -1 +1 @@
-0.1.5.4
+0.1.7.3

data/lib/cotcube-helpers.rb

@@ -16,6 +16,7 @@ require_relative 'cotcube-helpers/datetime_ext'
 require_relative 'cotcube-helpers/subpattern'
 require_relative 'cotcube-helpers/parallelize'
 require_relative 'cotcube-helpers/simple_output'
+require_relative 'cotcube-helpers/simple_series_stats'
 require_relative 'cotcube-helpers/input'
 require_relative 'cotcube-helpers/reduce'
 
@@ -24,6 +25,7 @@ module Cotcube
     module_function :sub,
                     :parallelize,
                     :reduce,
+                    :simple_series_stats,
                     :keystroke
 
     # please not that module_functions of source provided in private files must be published there

data/lib/cotcube-helpers/array_ext.rb

@@ -29,28 +29,32 @@ class Array
   # This method iterates over an Array by calling the given block on all 2 consecutive elements
   # it returns a Array of self.size - 1
   #
-  def pairwise(&block)
+  def pairwise(ret=nil, &block)
     raise ArgumentError, 'Array.one_by_one needs an arity of 2 (i.e. |a, b|)' unless block.arity == 2
+    raise ArgumentError, 'Each element of Array should respond to []=, at least the last one fails.' unless self.last.respond_to?(:[]=)
     return [] if size <= 1
 
-    each_with_index.map do |_, i|
+    each_index.map do |i|
       next if i.zero?
 
-      block.call(self[i - 1], self[i])
+      r = block.call(self[i - 1], self[i])
+      ret.nil?  ? r : (self[i][ret] = r)
     end.compact
   end
 
   alias one_by_one pairwise
 
   # same as pairwise, but with arity of three
-  def triplewise(&block)
+  def triplewise(ret=nil, &block)
     raise ArgumentError, 'Array.triplewise needs an arity of 3 (i.e. |a, b, c|)' unless block.arity == 3
+    raise ArgumentError, 'Each element of Array should respond to []=, at least the last one fails. unless self.last.respond_to?(:[]=)
     return [] if size <= 2
 
-    each_with_index.map do |_, i|
+    each_index.map do |i|
       next if i < 2
 
-      block.call(self[i - 2], self[i - 1], self[i])
+      r = block.call(self[i - 2], self[i - 1], self[i])
+      ret.nil?  ? r : (self[i][ret] = r)
     end.compact
   end
 
@@ -74,4 +78,24 @@ class Array
       end.reduce(:|)
     end
   end
+
+  def select_right_by(inclusive: false, exclusive: false, initial: [], &block)
+    # unless range.is_a? Range and
+    #       (range.begin.nil? or range.begin.is_a?(Integer)) and
+    #       (range.end.nil? or range.end.is_a?(Integer))
+    #  raise ArgumentError, ":range, if given, must be a range of ( nil|Integer..nil|Integer), got '#{range}'"
+    # end
+
+    raise ArgumentError, 'No block given.' unless block.is_a? Proc
+
+    inclusive = true unless exclusive
+    if inclusive && exclusive
+      raise ArgumentError,
+            "Either :inclusive or :exclusive must remain falsey, got '#{inclusive}' and '#{exclusive}'"
+    end
+
+    index = find_index { |obj| block.call(obj) }
+
+    self[((inclusive ? index : index + 1)..)]
+  end
 end

data/lib/cotcube-helpers/enum_ext.rb

@@ -11,3 +11,25 @@ class Enumerator
     ret
   end
 end
+
+# Recursively freeze self if it's Enumerable
+# Supports all Ruby versions 1.8.* to 2.2.*+
+module Kernel
+  alias deep_freeze freeze
+  alias deep_frozen? frozen?
+end
+
+# Adding deep_freeze and deep_frozen?
+module Enumerable
+  def deep_freeze
+    unless @deep_frozen
+      each(&:deep_freeze)
+      @deep_frozen = true
+    end
+    freeze
+  end
+
+  def deep_frozen?
+    !!@deep_frozen
+  end
+end

data/lib/cotcube-helpers/range_ext.rb

@@ -2,12 +2,21 @@
 
 # Monkey patching the Ruby Core class Range
 class Range
-  def to_time_intervals(step:, timezone: Time.find_zone('America/Chicago'), ranges: nil)
+  def mod(first, last = 0)
+    exclude_end? ? ((self.begin + first)...(self.end + last)) : ((self.begin + first)..(self.begin + last))
+  end
+
+  def to_time_intervals(step:,
+                        timezone: Time.find_zone('America/Chicago'),
+                        # ranges: nil,
+                        debug: false)
     unless step.is_a? ActiveSupport::Duration
       raise ArgumentError,
             ":step must be a 'ActiveSupport::Duration', like '15.minutes', but '#{step}' is a '#{step.class}'"
     end
-    raise ArgumentError, "Sorry, currently supporting only 15.minutes, 1.hour, 1.day as :step" unless [15.minutes, 60.minutes, 1.hour, 1.day].include? step
+    unless [15.minutes, 60.minutes, 1.hour, 1.day].include? step
+      raise ArgumentError, 'Sorry, currently supporting only 15.minutes, 1.hour, 1.day as :step'
+    end
 
     valid_classes = [ActiveSupport::TimeWithZone, Time, Date, DateTime]
     unless timezone.is_a? ActiveSupport::TimeZone
@@ -30,21 +39,22 @@ class Range
     # here sub-day and super-day need to be distinguished, as they react differently to daylight time
     # for super-day, just return an array containing all calendar days
     if step.to_i >= 1.day
-      return (starting.to_date..ending.to_date).to_a.map{|x| x.to_datetime}
+      (starting.to_date..ending.to_date).to_a.map(&:to_datetime)
     else
 
+      # sub-day is checked for DST
+      # noinspection RubyNilAnalysis
+      actual_starting   = starting.to_time.to_i
+      actual_ending     = ending.to_time.to_i
+      actual_ending -= 3600 if starting.dst? && (not ending.dst?)
+      actual_ending += 3600 if ending.dst? && (not starting.dst?)
+
       ##### The following is the actual big magic line, as it creates the raw target array:
       #
-      result = (starting.to_time.to_i..ending.to_time.to_i).step(step).to_a.map { |x| timezone.at(x) }
+      result = (actual_starting..actual_ending).step(step).to_a.map { |x| timezone.at(x) }
       #
       # ###################<3##
 
-
-      # sub-day is checked for DST and filtered along provided ranges
-      # noinspection RubyNilAnalysis
-      starting_with_dst = result.first.dst?
-
-      # The following lambda is completely misplaces here.
       # It should probably relocated to Cotcube::Bardata
       # NOTE: In this current version 12 belongs to it succeeding hour
       #       i.e. 12am is right before 1am and 12pm right before 1pm
@@ -62,26 +72,29 @@ class Range
       end
       convert_to_sec_since.call('9:00a.m - 5:00p.m.')
 
-      ranges ||= [
-        61_200...144_000,   # Sun 5pm .. Mon 4pm
-        147_600...230_400,  # Mon 5pm .. Tue 4pm
-        234_000...316_800,  # ...
-        320_400...403_200,
-        406_800...489_600
-      ]
+      # ranges ||= [
+      #  61_200...144_000,   # Sun 5pm .. Mon 4pm
+      #  147_600...230_400,  # Mon 5pm .. Tue 4pm
+      #  234_000...316_800,  # ...
+      #  320_400...403_200,
+      #  406_800...489_600
+      # ]
 
       # if there was a change towards daylight saving time, subtract 1 hour, otherwise add 1 hour
       result.map! do |time|
-        if (not starting_with_dst) && time.dst?
-          time - 3600
-        elsif starting_with_dst && (not time.dst?)
-          time + 3600
-        else
-          time
+        print "#{time}\t" if debug
+        if (not starting.dst?) && time.dst?
+          time -= 3600
+          print "Time reduced (not starting_DST, but current\t" if debug
+        elsif starting.dst? && (not time.dst?)
+          time += 3600
+          print "Time extended (starting DST, but not current\t" if debug
         end
+        puts "#{time} " if debug
+        time
       end
 
-      result.select_within(ranges: ranges) { |x| x.to_datetime.to_seconds_since_monday_morning }
+      result # .select_within(ranges: ranges) { |x| x.to_datetime.to_seconds_since_sunday_morning }
     end
   end
 end

data/lib/cotcube-helpers/simple_series_stats.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Cotcube
+  # Missing top level documentation
+  module Helpers
+    # if given a block, :ind of base is set by block.call()
+    # dim reduces the sample size by top n% and least n%, so dim of 0.5 would remove 100% of the sample
+    def simple_series_stats(base:, ind: nil, dim: 0, format: '% 6.2f', prefix: '', print: true, &block)
+      raise ArgumentError, 'Need :ind of type integer' if base.first.is_a?(Array) and not ind.is_a?(Integer)
+      raise ArgumentError, 'Need :ind to evaluate base' if base.first.is_a?(Hash) and ind.nil?
+
+      dim = dim.to_f if dim.is_a? Numeric
+      dim = 0 if dim==false
+
+      raise ArgumentError, 'Expecting 0 <= :dim < 0.5' unless dim.is_a?(Float) and dim >= 0  and dim < 0.5
+      raise ArgumentError, 'Expecting arity of one if block given' if block_given? and not block.arity==1
+
+      precision = format[-1] == 'f' ? format[..-2].split('.').last.to_i : 0
+      worker = base.
+        tap {|b| b.map{|x| x[ind] = block.call(x) } if block.is_a? Proc }.
+        map {|x| ind.nil? ? x : x[ind] }.
+        compact.
+        sort
+      unless dim.zero?
+        reductor = (base.size * dim).round
+        worker = worker[reductor..base.size - reductor]
+      end
+      result = {}
+
+      result[:size]   =  worker.size
+      result[:min]    =  worker.first
+      result[:avg]    = (worker.reduce(:+) / result[:size]).round(precision+1)
+      result[:lower]  =  worker[ (result[:size] * 1 / 4).round ]
+      result[:median] =  worker[ (result[:size] * 2 / 4).round ]
+      result[:upper]  =  worker[ (result[:size] * 3 / 4).round ]
+      result[:max]    =  worker.last
+
+      output = result.
+        reject{|k,_| k == :size}.
+        map{|k,v| { type: k, value: v, output: "#{k}: #{format(format, v)}".colorize(k==:avg ? :light_yellow : :white) } }.
+        sort_by{|x| x[:value]}.
+        map{|x| x[:output]}
+      result[:output] = "#{format '%20s',(prefix.empty? ? '' : (prefix + ': '))}" + 
+                        "[" +
+                        " size: #{format '%6d', result[:size]} | ".light_white +
+                        output.join(' |  ') +
+                        " ]"
+
+      puts result[:output] if print
+      result
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cotcube-helpers
 version: !ruby/object:Gem::Version
-  version: 0.1.5.4
+  version: 0.1.7.3
 platform: ruby
 authors:
 - Benjamin L. Tischendorf
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-02 00:00:00.000000000 Z
+date: 2021-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -90,6 +90,7 @@ files:
 - lib/cotcube-helpers/range_ext.rb
 - lib/cotcube-helpers/reduce.rb
 - lib/cotcube-helpers/simple_output.rb
+- lib/cotcube-helpers/simple_series_stats.rb
 - lib/cotcube-helpers/string_ext.rb
 - lib/cotcube-helpers/subpattern.rb
 - lib/cotcube-helpers/swig/date.rb