cotcube-helpers 0.1.6 → 0.1.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0417adfcb0f782bfa9e783dbd1c673a489fca39ce9a0f14fa965eb47aaa64b11
-  data.tar.gz: 1b14e149cc6b1bd437d1413dfa49b461c798868959cf97b164a0b3a2e1f72889
+  metadata.gz: a685d90173074f0ee3490602a9108cec0f8a8ff6e616fce2db1ef3566d0f2ef6
+  data.tar.gz: b08e52e6e47a233658765b4fdb3aab72d649aefff91eabb46e8cbcef6542e84e
 SHA512:
-  metadata.gz: c2babf733929f4ca0705ac2018b075e3b62df051c4918d01fcc6c11b49a7cad2ee68fd8ef26504edc5678c3057a97092de252a34cec2a953f638cd9262c2e65d
-  data.tar.gz: 1d9e367613f5b373c73cada786dee68d4e5ccc965573373b39d6419433a5f8131bc553773279d7ba58f2706a63be474448e15cc1e7bce1da63278ad384abeee0
+  metadata.gz: b8ced4fffb8f219416f05fe6daf3e891499e788d58d1ca4ea233cfff18998972b3aa9f0be10abdda3081671e534d0346201cfa7f5442b0bc996b75a6f3b1208b
+  data.tar.gz: 853ae393f9f3ba54321d82d2dba17e61fd6f85a4609029dee619ddcab10b2c2e5aa5dd6e7105f3f88e1e072b60034f7657a4cb53baed8188ddb67347326bce7a

data/CHANGELOG.md

@@ -1,3 +1,20 @@
+## 0.1.7.4 (March 13, 2021)
+  - hotfix on 0.1.7.3
+
+## 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

data/VERSION

@@ -1 +1 @@
-0.1.6
+0.1.7.4

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
 
@@ -61,37 +65,37 @@ class Array
     unless attr.nil? || first[attr]
       raise ArgumentError,
             "At least first element of Array '#{first}' does not contain attr '#{attr}'!"
-    end
-    raise ArgumentError, 'Ranges should be an Array or, more precisely, respond_to :map' unless ranges.respond_to? :map
-    raise ArgumentError, 'Each range in :ranges should respond to .include!' unless ranges.map do |x|
-                                                                                      x.respond_to? :include?
-                                                                                    end.reduce(:&)
-
-    select do |el|
-      value = attr.nil? ? el : el[attr]
-      ranges.map do |range|
-        range.include?(block.nil? ? value : block.call(value))
-      end.reduce(:|)
-    end
   end
+  raise ArgumentError, 'Ranges should be an Array or, more precisely, respond_to :map' unless ranges.respond_to? :map
+  raise ArgumentError, 'Each range in :ranges should respond to .include!' unless ranges.map do |x|
+    x.respond_to? :include?
+  end.reduce(:&)
+
+  select do |el|
+    value = attr.nil? ? el : el[attr]
+    ranges.map do |range|
+      range.include?(block.nil? ? value : block.call(value))
+    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
+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
+  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
+  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) }
+  index = find_index { |obj| block.call(obj) }
 
-    self[((inclusive ? index : index + 1)..)]
-  end
+  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,6 +2,10 @@
 
 # Monkey patching the Ruby Core class Range
 class Range
+  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,

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.6
+  version: 0.1.7.4
 platform: ruby
 authors:
 - Benjamin L. Tischendorf
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-15 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