rafini 0.5.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 487c2085e2d72ff8cbcb19139112d40803daaf94
-  data.tar.gz: f367404c6323a01f3bd75b2cd69f2524e9ebd57d
+SHA256:
+  metadata.gz: b81e63f8b4651660cd62560692546173a7ae971ce0a0a76b6bc772c573f2d181
+  data.tar.gz: 37146803ff33ddcf74da2cd90bb5ddd4a2b1da0fe2be0c55b1b5b984a14029ca
 SHA512:
-  metadata.gz: c76b4db1a927a1a6b2ffd13f621adf32df2fb9657cf5f33e86bfa5d6457dc813f37d92d879009220c078574ad2807407e3233abf3e909d9c2706745a0fa8bcba
-  data.tar.gz: 0d1f221119ff12ad9f978ae7f6c55c48c1f9a97009af8845d0637f6cc536902c903b2b01f63df318faed9eaf216306c93c3eed4a8842a486efb71041696f90d4
+  metadata.gz: ecb3a3935d9892365a7568e304994605657b0ff0ed9c4e5adab0eee83c4d42d9584b0b6c6cdcd2d602f2817371d3a632f51396bf62b9ca134153c7eae926f22a
+  data.tar.gz: a1795c03155fbaa64fd90b4a5a8ab4ad033fa5489bb925168a765ab4be71b742cca5bc61d282c88c9c4af75c2b9c24feb8c2bd87f5d01189a5b32e34fd2a8c89

data/README.md

@@ -0,0 +1,117 @@
+# rafini 2.0.0
+
+## DESCRIPTION:
+
+Just a collection of useful refinements.
+
+## SYNOPSIS:
+
+### using Rafini::Array
+
+    # joins
+    ['a','b','c','d','e','f'].joins('-','-',' '){':'} #=> "a-b-c d:e:f"
+
+    # per
+    h={}
+    ['a','b','c'].per(['A','B','C']){|l,u| h[l]=u}
+    h #=> {'a'=>'A','b'=>'B','c'=>'C'}
+
+    # which
+    ['dog','cat','bunny'].which{|a|a=~/c/} #=> "cat"
+
+    # is
+    [:a,:b,:c].is(true) #=> {a: true, b: true, c: true}
+
+### using Rafini::Exception
+
+    # $!.puts
+    begin
+      raise 'Ugly Message'
+    rescue RuntimeError
+      $!.puts 'Nice Message'
+    end
+
+    # Rafini.bang!
+    value = Rafini.bang!('Nice Message') do
+      raise 'Ugly Message'
+    end
+    value #=> return value of block or error object
+
+    # Rafini.thread_bang!
+    Rafini.thread_bang!('Nice Message') do
+      # this is in a thread
+      raise 'Ugly Message'
+    end
+
+### using Rafini::Hash
+
+    # to_struc
+    struct = {a:'A',b:'C',c:'C'}.to_struct
+    struct.a #=> 'A'
+
+    # modify
+    {a:'A',b:'B'}.modify({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'X',c:'Y',d:'D'}
+
+    # supplement
+    {a:'A',b:'B'}.supplement({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'B',c:'C',d:'D'}
+
+    # amend
+    {a:'A',b:'B'}.amend({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'X'}
+
+    # maps
+    {a:'A',b:'B',c:'C',c:'D'}.maps(:c,:a,:b) #=> ['C','A','B']
+
+### using Rafini::Integer
+
+    # odometer
+    123.odometer(10,10) #=> [3,2,1]
+    30.odometer(2,3,5) #=> [0,0,0,1]
+
+### using Rafini::Odometers
+
+    # sec2time
+    12501.sec2time.to_s #=> "3 hours and 28 minutes"
+
+    # illion
+    3_512_325.illion.to_s #=> "3.51M"
+
+### using Rafini::String
+
+    # camelize
+    'a_camel_kick'.camelize #=> "ACamelKick"
+
+    # semantic
+    '1.2.3'.semantic(0..1) #=> '1.2'
+
+### Rafini::Empty
+
+    STRING, ARRAY, HASH = ''.frozen, [].frozen, {}.frozen
+
+## INSTALL:
+
+    $ gem install rafini
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2020 carlosjhr64
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/rafini.rb

@@ -1,13 +1,12 @@
-require 'rafini/version'
-
-require 'rafini/array'
-require 'rafini/exception'
-require 'rafini/hash'
-require 'rafini/integer'
-require 'rafini/string'
-
-require 'rafini/odometers'
-require 'rafini/empty'
-
+module Rafini
+  VERSION = '2.0.0'
+  require 'rafini/array'
+  require 'rafini/exception'
+  require 'rafini/hash'
+  require 'rafini/integer'
+  require 'rafini/string'
+  require 'rafini/odometers'
+  require 'rafini/empty'
+end
 # Requires:
 #`ruby`

data/lib/rafini/array.rb

@@ -1,7 +1,6 @@
 module Rafini
   module Array
     refine ::Array do
-
       # string = array.joins(sep1,sep2,sep3,...){|i| sep[i]}
       #
       # Returns a string created by converting each element of the array to
@@ -16,7 +15,7 @@ module Rafini
       #    ['a','b','c'].joins{|i|i} #=> 'a1b2c'
       def joins(*p, &block)
         str = ''
-        if length > 1
+        if length > 0
           str << self[0]
           1.upto(length-1) do |i|
             str << (p.empty? ? (block ? block.call(i).to_s : '') : p.shift.to_s)
@@ -41,10 +40,7 @@ module Rafini
       #
       # Returns first object for which block is true.
       # ['dog','cat','bunny'].which{|a|a=~/c/} #=> "cat"
-      def which
-        self.each{|obj| return obj if yield(obj)}
-        return nil
-      end
+      alias which detect
 
       # [:a,:b,:c].is(true) #=> {:a=>true,:b=>true,:c=>true}
       #
@@ -53,17 +49,6 @@ module Rafini
         self.each{|key| hash[key]=value}
         return hash
       end
-
-      # [:a, :b, :c].any?(:b, :d) #=> true
-      #
-      # Are any of the given in the array?
-      def any?(*a)
-        a.each do |b|
-          return true if include?(b)
-        end
-        return false
-      end
-
     end
   end
 end

data/lib/rafini/exception.rb

@@ -1,7 +1,6 @@
 module Rafini
   module Exception
     refine ::Exception do
-
       # $!.puts outputs to standard error what went bang!
       # The given message is what you normally want to see.
       # The exeption message is also shown if in verbose mode.

data/lib/rafini/hash.rb

@@ -1,7 +1,6 @@
 module Rafini
   module Hash
     refine ::Hash do
-
       # struct = hash.to_struct
       # Why not?
       def to_struct
@@ -52,9 +51,14 @@ module Rafini
         end
         self
       end
-      # TODO: ammend was a typo, to go away on a major revision bump.
-      alias ammend amend
 
+      # hash.maps(key1,...)
+      #
+      # Maps parameters list with hash.
+      #    {a:'A",b:'B',c:'C'}.maps(:c,:a,:b) #=> ['C','A','B']
+      def maps(*keys)
+        keys.map{|_|self[_]}
+      end
     end
   end
 end

data/lib/rafini/integer.rb

@@ -1,7 +1,6 @@
 module Rafini
   module Integer
     refine ::Integer do
-
       # odometer
       # Kinda hard to explain...
       #   123.odometer(10,10) #=> [3,2,1]

data/lib/rafini/odometers.rb

@@ -1,5 +1,44 @@
 module Rafini
   module Odometers
+    SEC2TIME = {
+      second:     60,
+      minute:     60,
+      hour:       24,
+      day:        7,
+      week:       4,
+      month:      13,
+      year:       10,
+      decade:     10,
+      centurie:   10,
+      millennium: 10,
+      age:        10,
+      epoch:      10,
+      era:        5,
+      eon:        2,
+      gigaannum:  nil,
+    }
+
+    SCALE = {
+      base: {
+        ones:         10,
+        tens:         10,
+        hundreds:     10,
+        thousands:    1_000,
+      },
+      short: {
+        millions:     1_000,
+        billions:     1_000,
+        trillions:    1_000,
+        quadrillions: nil,
+      },
+      long: {
+        millions:     1_000_000,
+        billions:     1_000_000,
+        trillions:    1_000_000,
+        quadrillions: nil,
+      },
+    }
+
     refine ::Integer do
       # Need Rafini::Integer for #odometer
       # Need Rafini::Hash for #to_struct
@@ -27,24 +66,6 @@ module Rafini
         return hash.to_struct
       end
 
-      SEC2TIME = {
-          second:     60,
-          minute:     60,
-          hour:       24,
-          day:        7,
-          week:       4,
-          month:      13,
-          year:       10,
-          decade:     10,
-          centurie:   10,
-          millennium: 10,
-          age:        10,
-          epoch:      10,
-          era:        5,
-          eon:        2,
-          gigaannum:  nil,
-      }
-
       # Integer#sec2time
       # Returns a struct with the different time scales for number of seconds.
       # Note that the month(4 weeks)/year(13 months) are not meant to be exact.
@@ -54,27 +75,6 @@ module Rafini
         self.odoread(SEC2TIME)
       end
 
-      SCALE = {
-        base: {
-          ones:         10,
-          tens:         10,
-          hundreds:     10,
-          thousands:    1_000,
-        },
-        short: {
-          millions:     1_000,
-          billions:     1_000,
-          trillions:    1_000,
-          quadrillions: nil,
-        },
-        long: {
-          millions:     1_000_000,
-          billions:     1_000_000,
-          trillions:    1_000_000,
-          quadrillions: nil,
-        },
-      }
-
       # 1_230.illion.to_s #=> "1.23k"
       # 1_230_000.illion.to_s #=> "1.23M"
       # ...etc

data/lib/rafini/string.rb

@@ -5,7 +5,16 @@ module Rafini
       # 1) A camel kick, as in "I gotz camelized".
       # 2) "a_camel_kick" => "ACamelKick"
       def camelize(sep=/_/)
-        self.split(sep).map{ |word| word.capitalize }.join('')
+        self.split(sep).map{|word|word.capitalize }.join('')
+      end
+
+      # semantic:
+      # 'a.b.c'.semantic(1) #=> 'b'
+      # 'a.b.c'.semantic(0..1) #=> 'a.b'
+      # 'a.b.c'.semantic(0..2, '/') #=> 'b/c'
+      # 'a/b/c'.semantic(0..2, '.', /\//) #=> 'a.b.c'
+      def semantic(v,s='.',sx=/\./)
+        [*self.split(sx)[v]].join(s)
       end
     end
   end

metadata

@@ -1,24 +1,24 @@
 --- !ruby/object:Gem::Specification
 name: rafini
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 2.0.0
 platform: ruby
 authors:
 - carlosjhr64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-16 00:00:00.000000000 Z
+date: 2020-08-15 00:00:00.000000000 Z
 dependencies: []
-description: |
-  Just a collection of useful refinements.
+description: 'Just a collection of useful refinements.
+
+  '
 email: carlosjhr64@gmail.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- README.rdoc
+extra_rdoc_files: []
 files:
-- README.rdoc
+- README.md
 - lib/rafini.rb
 - lib/rafini/array.rb
 - lib/rafini/empty.rb
@@ -27,15 +27,12 @@ files:
 - lib/rafini/integer.rb
 - lib/rafini/odometers.rb
 - lib/rafini/string.rb
-- lib/rafini/version.rb
 homepage: https://github.com/carlosjhr64/rafini
 licenses:
 - MIT
 metadata: {}
 post_install_message: 
-rdoc_options:
-- "--main"
-- README.rdoc
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -49,11 +46,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 2.1.3p242 (2014-09-19 revision 47630) [x86_64-linux]'
-rubyforge_project: 
-rubygems_version: 2.4.1
+- 'ruby: ruby 2.7.1p83 (2020-03-31 revision a0c7c23c9c) [x86_64-linux]'
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Just a collection of useful refinements.
 test_files: []
-has_rdoc: 

data/README.rdoc

@@ -1,114 +0,0 @@
-= rafini
-
-== DESCRIPTION:
-
-Just a collection of useful refinements.
-
-== SYNOPSIS:
-
-=== using Rafini::Array
-
-   # joins
-   ['a','b','c','d','e','f'].joins('-','-',' '){':'} #=> "a-b-c d:e:f"
-
-   # per
-   h={}
-   ['a','b','c'].per(['A','B','C']){|l,u| h[l]=u}
-   h #=> {'a'=>'A','b'=>'B','c'=>'C'}
-
-   # which
-   ['dog','cat','bunny'].which{|a|a=~/c/} #=> "cat"
-
-   # is
-   [:a,:b,:c].is(true) #=> {a: true, b: true, c: true}
-
-   # any?
-   [:a,:b,:c].any?(:b,:d) #=> true
-
-=== using Rafini::Exception
-
-   # $!.puts
-   begin
-     raise 'Ugly Message'
-   rescue RuntimeError
-     $!.puts 'Nice Message'
-   end
-
-   # Rafini.bang!
-   value = Rafini.bang!('Nice Message') do
-     raise 'Ugly Message'
-   end
-   value #=> return value of block or error object
-
-   # Rafini.thread_bang!
-   Rafini.thread_bang!('Nice Message') do
-     # this is in a thread
-     raise 'Ugly Message'
-   end
-
-=== using Rafini::Hash
-
-   # to_struc
-   struct = {a:'A',b:'C',c:'C'}.to_struct
-   struct.a #=> 'A'
-
-   # modify
-   {a:'A',b:'B'}.modify({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'X',c:'Y',d:'D'}
-
-   # supplement
-   {a:'A',b:'B'}.supplement({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'B',c:'C',d:'D'}
-
-   # amend
-   {a:'A',b:'B'}.amend({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'X'}
-
-=== using Rafini::Integer
-
-   # odometer
-   123.odometer(10,10) #=> [3,2,1]
-   30.odometer(2,3,5) #=> [0,0,0,1]
-
-=== using Rafini::Odometers
-
-   # sec2time
-   12501.sec2time.to_s #=> "3 hours and 28 minutes"
-
-   # illion
-   3_512_325.illion.to_s #=> "3.51M"
-
-=== using Rafini::String
-
-   # camelize
-   'a_camel_kick'.camelize #=> "ACamelKick"
-
-=== Rafini::Empty
-
-   STRING, ARRAY, HASH = ''.frozen, [].frozen, {}.frozen
-
-== INSTALL:
-
-  $ sudo gem install rafini
-
-== LICENSE:
-
-(The MIT License)
-
-Copyright (c) 2014 carlosjhr64
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/rafini/version.rb

@@ -1,3 +0,0 @@
-module Rafini
-  VERSION = '0.5.0'
-end