rafini 3.0.210112 → 3.2.221213

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df4dc73d0b92dcd762d1c741eb30f8dcfc56fdd84d18bfdbc2435290d9a3df97
-  data.tar.gz: c7764c8ae13bb99ff51977d7b52f926eee9083e5db6f75e43c860c2eb9557715
+  metadata.gz: bdc3386e65af02b3a86031e7123e10391dc321de2b7559fb83e0639520db56a9
+  data.tar.gz: 440f1bd45fee01d4ed81bbb536672367419e5cef35dc973277d3f12a950124d4
 SHA512:
-  metadata.gz: eb0f6fcdf17d108b75ddd5af587ceb7fe2d6294e8134cfeae90807f62607d49e158754903526f49b22fb6522a4ded0cf2f1522ad9c1305f295b9bd858cad9714
-  data.tar.gz: 8b327f489cfa71d77eca28df39b4408fcf8c7c4c8e7ed233c10f05e242bcfee0936a96f97e5bb8eee0fa4f49a058bc7b754fc549ab47d8e70574e756ccdc1d93
+  metadata.gz: 29397cbfc1807873786d8770fd0b2fe5d2a1712492e1079cb568d6f39e8147abca80240cdd7f7885b16d2c90e4e453b7026cfcdc296ec921ee8bf17a9cd2b411
+  data.tar.gz: ece7843e819e9c4745286f2f77052b9fbdd1a521d3f174fd8d652dd5d7d63650185a09410d457150fca8458f273965c9af6252f5883d56e3e33dcafc9fa8008b

data/README.md

@@ -1,6 +1,6 @@
 # Rafini
 
-* [VERSION 3.0.210112](https://github.com/carlosjhr64/rafini/releases)
+* [VERSION 3.2.221213](https://github.com/carlosjhr64/rafini/releases)
 * [github](https://github.com/carlosjhr64/rafini)
 * [rubygems](https://rubygems.org/gems/rafini)
 
@@ -9,43 +9,79 @@
 Just a collection of useful refinements.
 
 ## INSTALL:
-
 ```shell
 $ gem install rafini
 ```
-
 ## SYNOPSIS:
 
-### using Rafini::Array
+Note that `Rafini` auto-loads assets as requested.
+```ruby
+require 'rafini'
+```
+### include Rafini::Empty
+```ruby
+include Rafini::Empty
 
+s0 #=> ""
+a0 #=> []
+h0 #=> {}
+[s0,a0,h0].all?(&:frozen?) #=> true
+```
+### using Rafini::Array
 ```ruby
-require 'rafini/array'
 using Rafini::Array
 
+# classify(like Set#classify)
+[1, 2.0, 'Three', 4.0].classify #=> {Integer=>[1], Float=>[2.0, 4.0], String=>["Three"]}
+
+# is
+[:a,:b,:c].is(true) #=> {:a=>true, :b=>true, :c=>true}
+
 # joins
 ['Y','M','D','h','m','s'].joins('-','-',' '){':'}
 #=> "Y-M-D h:m:s"
 [1,9,2,8,3,7,4,6,5,5].joins{|a,b|a>b ? '>': a<b ? '<': '='}
 #=> "1<9>2<8>3<7>4<6>5=5"
-
-# is
-[:a,:b,:c].is(true) #=> {:a=>true, :b=>true, :c=>true}
 ```
-### Rafini::Empty
+### using Rafini::Hash
+```ruby
+using Rafini::Hash
 
+# to_struc
+struct = {a:'A',b:'C',c:'C'}.to_struct{ def ok = "OK" }
+struct    #=> #<struct a="A", b="C", c="C">
+struct.a  #=> "A"
+struct.ok #=> "OK"
+
+# 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
 ```ruby
-require 'rafini/empty'
-include Rafini::Empty
-s0 #=> ""
-a0 #=> []
-h0 #=> {}
-[s0,a0,h0].all?(&:frozen?) #=> true
+using Rafini::Integer
+
+# odometer
+123.odometer(10,10) #=> [3, 2, 1]
+30.odometer(2,3,5)  #=> [0, 0, 0, 1]
 ```
+### using Rafini::String
+```ruby
+using Rafini::String
 
-### using Rafini::Exception
+# camelize
+'a_camel_kick'.camelize #=> "ACamelKick"
 
+# semantic
+'1.2.3'.semantic(0..1) #=> "1.2"
+
+# shellescape(like Shellwords.escape)
+'Hello World!'.shellescape #=> "Hello\\ World\\!"
+```
+### using Rafini::Exception
 ```ruby
-require 'rafini/exception'
 using Rafini::Exception
 
 # $!.puts
@@ -76,41 +112,8 @@ end
 # will not re-raise the error(but gives the error).
 thread.value.class #=> RuntimeError
 ```
-
-### using Rafini::Hash
-
-```ruby
-require 'rafini/hash'
-using Rafini::Hash
-
-# to_struc
-struct = {a:'A',b:'C',c:'C'}.to_struct{ def ok = "OK" }
-struct    #=> #<struct a="A", b="C", c="C">
-struct.a  #=> "A"
-struct.ok #=> "OK"
-
-# 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
-
-```ruby
-require 'rafini/integer'
-using Rafini::Integer
-
-# odometer
-123.odometer(10,10) #=> [3, 2, 1]
-30.odometer(2,3,5)  #=> [0, 0, 0, 1]
-```
-
 ### using Rafini::Odometers
-
 ```ruby
-require 'rafini/odometers'
 using Rafini::Odometers
 
 # sec2time
@@ -119,25 +122,25 @@ using Rafini::Odometers
 # illion
 3_512_325.illion.to_s #=> "3.51M"
 ```
-
-### using Rafini::String
-
+### using Rafini::Requires
 ```ruby
-require 'rafini/string'
-using Rafini::String
-
-# camelize
-'a_camel_kick'.camelize #=> "ACamelKick"
-
-# semantic
-'1.2.3'.semantic(0..1) #=> "1.2"
+using Rafini::Requires
+
+requires'
+ruby   ~>3.0
+rafini ~>3.2
+json   ~>2.0' #=> ["json"]
+## You can also say:
+#   require 'rafini/requires'
+#   Rafini.requires...
+## But you wont be able to test for Rafini's VERSION
+## unless you've also required 'rafini'.
 ```
-
 ## LICENSE:
 
 (The MIT License)
 
-Copyright (c) 2021 carlosjhr64
+Copyright (c) 2022 CarlosJHR64
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/rafini/array.rb

@@ -1,13 +1,32 @@
 module Rafini
   module Array
     refine ::Array do
+      # classify:
+      # Like Set#classify
+      def classify(hash: ::Hash.new{|h,k|h[k]=[]}, &block)
+        block ||= lambda{|v|v.class}
+        self.each{|v| hash[block[v]] << v}
+        return hash
+      end
+
+      # is:
+      # [:a,:b,:c].is(true) #=> {:a=>true,:b=>true,:c=>true}
+      #
+      # Updates a hash with the keys given by the array to the given value.
+      def is(value, hash={})
+        each{|key| hash[key]=value}
+        return hash
+      end
+
+      # joins:
       # type _AToS = ::Array[(_AToS|_ToS)]
       # _AToS#joins(*_AToS seps)?{(_ToS,_ToS)->_ToS}
       #
       # Returns a string created by joining the elements of the (flatten) array,
       # separated by the given (flatten) separators.
       # If no separators are given or are used up,
-      # it uses the value of the executed block, which is passed the next neigboring iteration items.
+      # it uses the value of the executed block,
+      # which is passed the next neigboring iteration items.
       # Else, it just joins the items.
       #    ['2021','Jan','09','07','29','05'].joins('-', '-', ' '){':'}
       #    #=> "2021-Jan-09 07:29:05"
@@ -23,20 +42,14 @@ module Rafini
         return string if items.empty?
         seps.flatten!
         while item = items.shift
-          sep = seps.shift&.to_s || block&.call(previous,item).to_s and string << sep
+          if sep = seps.shift&.to_s || block&.call(previous,item)&.to_s
+            string << sep
+          end
           string << item.to_s
           previous = item
         end
         return string
       end
-
-      # [:a,:b,:c].is(true) #=> {:a=>true,:b=>true,:c=>true}
-      #
-      # Updates a hash with the keys given by the array to the given value.
-      def is(value, hash={})
-        each{|key| hash[key]=value}
-        return hash
-      end
     end
   end
 end

data/lib/rafini/exception.rb

@@ -29,7 +29,7 @@ using Rafini::Exception
 #   value = Rafini.bang!('Ooops! Not perfect?') do
 #     # Perfect code here...
 #   end
-def Rafini.bang!(message=nil, bang=Exception, &block)
+def Rafini.bang!(message=nil, bang=::Exception, &block)
   value = nil
   begin
     value = block.call
@@ -52,6 +52,6 @@ end
 #  end
 # With the following below, I'll be able to say
 # Rafini.thread_bang!('blah blah...'){ ...stuff... }
-def Rafini.thread_bang!(header=nil, bang=Exception, &block)
+def Rafini.thread_bang!(header=nil, bang=::Exception, &block)
   Thread.new{Rafini.bang!(header, bang, &block)}
 end

data/lib/rafini/hash.rb

@@ -11,7 +11,8 @@ module Rafini
       #
       # Supplements hash with hashes.
       # Adds missing elements only.
-      #   {a:'A',b:'B'}.supplement({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'B',c:'C',d:'D'}
+      #   {a:'A',b:'B'}.supplement({b:'X',c:'C'},{c:'Y',d:'D'})
+      #   #=> {a:'A',b:'B',c:'C',d:'D'}
       def supplement!(*hashes)
         hashes.each do |hash|
           hash.each do |key, value|
@@ -27,7 +28,8 @@ module Rafini
       # hash0.amend(hash1,...)
       #
       # Ammends hash with hashes.
-      # Overwrites existing keys only with first key value found in amending hashes.
+      # Overwrites existing keys
+      # only with first key value found in amending hashes.
       #   {a:'A',b:'B'}.amend({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {a:'A',b:'X'}
       def amend!(*hashes)
         self.each_key do |key|

data/lib/rafini/integer.rb

@@ -5,7 +5,8 @@ module Rafini
       # Kinda hard to explain...
       #   123.odometer(10,10) #=> [3,2,1]
       #   30.odometer(2,3,5) #=> [0,0,0,1]
-      #   ((60*60*24)*3 + (60*60)*12 + 60*15 + 30).odometer(60,60,24) #=> [30, 15, 12, 3]
+      #   ((60*60*24)*3 + (60*60)*12 + 60*15 + 30).odometer(60,60,24)
+      #   #=> [30, 15, 12, 3]
       # Useful for making clocks, number scales, mayan long count... etc.
       def odometer(*levels, factors: true)
         raise RangeError, 'negative odometer' if self < 0

data/lib/rafini/requires.rb

@@ -0,0 +1,45 @@
+module Rafini
+  module Requires
+    refine ::String do
+      # satisfies?:
+      # "1.2.3".satisfies?('~>1.1') #=> true
+      # "1.2.3".satisfies?('~>2.3') #=> false
+      def satisfies?(*reqs)
+        Gem::Requirement.new(*reqs).satisfied_by? Gem::Version.new(self)
+      end
+    end
+
+    refine ::Kernel do
+      def requires(*list)
+        loaded = []
+        list.each do |gems|
+          gems.lines.each do |gemname_reqs|
+            gemname, *reqs = gemname_reqs.split
+            next unless gemname
+            unless reqs.empty?
+              case gemname
+              when 'rafini'
+                unless VERSION.satisfies?(*reqs)
+                  raise "helpema #{VERSION} not #{reqs.join(', ')}"
+                end
+                next
+              when 'ruby'
+                unless RUBY_VERSION.satisfies?(*reqs)
+                  raise "ruby #{RUBY_VERSION} not #{reqs.join(', ')}"
+                end
+                next
+              else
+                gem gemname, *reqs
+              end
+            end
+            require gemname and loaded.push gemname
+          end
+        end
+        return loaded
+      end
+    end
+  end
+
+  using Requires
+  def Rafini.requires(*list) = Kernel.requires(*list)
+end

data/lib/rafini/string.rb

@@ -16,6 +16,13 @@ module Rafini
       def semantic(v=(0..2), split:'.', join:'.')
         [*self.split(split)[v]].join(join)
       end
+
+      # shellescape:
+      # Same funtionality as Shellword's String#shellescape
+      def shellescape
+        # This is a contraction of Shellwords.escape function
+        self.gsub(/[^\w\-.,:+\/@\n]/,'\\\\\\&').gsub(/\n/,"'\n'")
+      end
     end
   end
 end

data/lib/rafini.rb

@@ -1,12 +1,17 @@
 module Rafini
-  VERSION = '3.0.210112'
+  VERSION = '3.2.221213'
+  # Constants
+  autoload :Empty,     'rafini/empty'
+  # Pure
   autoload :Array,     'rafini/array'
-  autoload :Exception, 'rafini/exception'
   autoload :Hash,      'rafini/hash'
   autoload :Integer,   'rafini/integer'
   autoload :String,    'rafini/string'
+  # Hybrid
+  autoload :Exception, 'rafini/exception'
+  # Mix
   autoload :Odometers, 'rafini/odometers'
-  autoload :Empty,     'rafini/empty'
+  autoload :Requires,  'rafini/requires'
 end
 # Requires:
 #`ruby`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rafini
 version: !ruby/object:Gem::Version
-  version: 3.0.210112
+  version: 3.2.221213
 platform: ruby
 authors:
-- carlosjhr64
-autorequire:
+- CarlosJHR64
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-12 00:00:00.000000000 Z
+date: 2022-12-13 00:00:00.000000000 Z
 dependencies: []
 description: 'Just a collection of useful refinements.
 
@@ -26,12 +26,13 @@ files:
 - lib/rafini/hash.rb
 - lib/rafini/integer.rb
 - lib/rafini/odometers.rb
+- lib/rafini/requires.rb
 - lib/rafini/string.rb
 homepage: https://github.com/carlosjhr64/rafini
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -46,9 +47,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 3.0.0p0 (2020-12-25 revision 95aff21468) [x86_64-linux]'
-rubygems_version: 3.2.3
-signing_key:
+- 'ruby: ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [aarch64-linux]'
+rubygems_version: 3.3.7
+signing_key: 
 specification_version: 4
 summary: Just a collection of useful refinements.
 test_files: []