rafini 3.1.221212 → 3.3.230213

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8daaac2f079c639abaa892b634f6400f1b0e75ffead282c4551dc8fb7fe45fda
-  data.tar.gz: a383dca85331bc2cf43e443fc909a9612044ea2c0f73a33a7bc9c568f2db0370
+  metadata.gz: 10beafcb6f8375979eba53ce6c8b1bfa75bf43caed120f1f9bc3c9a2275825a2
+  data.tar.gz: e5b55701451aed75917b02de376e8198b56466933fa17ac92e4e9672206496cd
 SHA512:
-  metadata.gz: b169dce8d8edd85971c8e62c433b3485a863fa8327e84430e253d660dbc0ca5a89c0106830ecedbfdb52103fd12bfb0193b07504dbc50b2812ced3a12096595c
-  data.tar.gz: c62702b40d3f826f4a63828e3122dada54376c8cd23f358b17a1c6650e6fc79bec2914f706c55d61c2ba0a087e88c2a848cdaec7410bda5b238d44b33f6b4f9d
+  metadata.gz: 12690de6469959ccbf5b7ad87c739045be1b025a06e94a2c6d585713def66d8c8820f2010d7011a6096abb6d29ab787be822d0576657786ac98ba62793fbcad6
+  data.tar.gz: 76c99a2f7fc92ac6c6a5e8f6bd192abf683c9267181d2ce033d7067f369b1504044effaa4b66f85d49caa2f1ca0d8ba0ef6cf60611768a2b733812e7e5f16f63

data/README.md

@@ -1,6 +1,6 @@
 # Rafini
 
-* [VERSION 3.1.221212](https://github.com/carlosjhr64/rafini/releases)
+* [VERSION 3.3.230213](https://github.com/carlosjhr64/rafini/releases)
 * [github](https://github.com/carlosjhr64/rafini)
 * [rubygems](https://rubygems.org/gems/rafini)
 
@@ -13,6 +13,8 @@ Just a collection of useful refinements.
 $ gem install rafini
 ```
 ## SYNOPSIS:
+
+Note that `Rafini` auto-loads assets as requested.
 ```ruby
 require 'rafini'
 ```
@@ -65,12 +67,22 @@ using Rafini::Integer
 123.odometer(10,10) #=> [3, 2, 1]
 30.odometer(2,3,5)  #=> [0, 0, 0, 1]
 ```
+### using Rafini::Object
+```ruby
+using Rafini::Object
+
+''.as{_1.empty? ? :empty : _1.length}    #=> :empty
+'123'.as{_1.empty? ? :empty : _1.length} #=> 3
+```
 ### using Rafini::String
 ```ruby
 using Rafini::String
 
-# camelize
-'a_camel_kick'.camelize #=> "ACamelKick"
+# cases
+'My name is ruby'.pascal_case #=> MyNameIsRuby
+'My name is ruby'.camel_case  #=> myNameIsRuby
+'My name is ruby'.snake_case  #=> my_name_is_ruby
+'My name is ruby'.kebab_case  #=> my-name-is-ruby
 
 # semantic
 '1.2.3'.semantic(0..1) #=> "1.2"
@@ -126,14 +138,19 @@ using Rafini::Requires
 
 requires'
 ruby   ~>3.0
-rafini ~>3.1
+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) 2022 CarlosJHR64
+Copyright (c) 2023 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

@@ -4,9 +4,9 @@ module Rafini
       # 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
+        block ||= ->(v){v.class}
+        each{|v| hash[block[v]] << v}
+        hash
       end
 
       # is:
@@ -15,7 +15,7 @@ module Rafini
       # 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
+        hash
       end
 
       # joins:
@@ -41,14 +41,14 @@ module Rafini
         string = ::String.new previous.to_s
         return string if items.empty?
         seps.flatten!
-        while item = items.shift
-          if sep = seps.shift&.to_s || block&.call(previous,item)&.to_s
+        while (item=items.shift)
+          if (sep=(seps.shift&.to_s || block&.call(previous,item)&.to_s))
             string << sep
           end
           string << item.to_s
           previous = item
         end
-        return string
+        string
       end
     end
   end

data/lib/rafini/exception.rb

@@ -11,11 +11,11 @@ module Rafini
       #     # exact output depends on $VERBOSE and $DEBUG
       #     $!.puts('Nice message')
       #   end
-      def puts(message=nil)
-        unless $VERBOSE.nil? then
-          $stderr.puts message if message
-          $stderr.puts self.message if $VERBOSE or !message
-          $stderr.puts self.backtrace.to_s if $DEBUG
+      def puts(msg=nil)
+        unless $VERBOSE.nil?
+          warn msg if msg
+          warn message if $VERBOSE || !msg
+          warn backtrace.to_s if $DEBUG
         end
       end
     end
@@ -29,14 +29,14 @@ using Rafini::Exception
 #   value = Rafini.bang!('Ooops! Not perfect?') do
 #     # Perfect code here...
 #   end
-def Rafini.bang!(message=nil, bang=::Exception, &block)
-  value = nil
+def Rafini.bang!(msg=nil, bang=Exception, &block)
+  e = nil
   begin
-    value = block.call
-  rescue bang => value
-    value.puts(message)
+    e = block.call
+  rescue bang => e
+    e.puts(msg)
   end
-  return value
+  e
 end
 
 # The Thread wrapped version of bang!
@@ -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)
-  Thread.new{Rafini.bang!(header, bang, &block)}
+def Rafini.thread_bang!(header=nil, bang=Exception, &)
+  Thread.new{Rafini.bang!(header, bang, &)}
 end

data/lib/rafini/hash.rb

@@ -3,8 +3,8 @@ module Rafini
     refine ::Hash do
       # struct = hash.to_struct
       # Why not?
-      def to_struct(&blk)
-        Struct.new(*keys, &blk).new(*values)
+      def to_struct(&)
+        Struct.new(*keys, &).new(*values)
       end
 
       # hash0.supplement!(hash1,...) #=> hash
@@ -16,13 +16,13 @@ module Rafini
       def supplement!(*hashes)
         hashes.each do |hash|
           hash.each do |key, value|
-            self[key] = value unless self.has_key?(key)
+            self[key] = value unless key?(key)
           end
         end
         self
       end
       def supplement(...)
-        self.dup.supplement!(...)
+        dup.supplement!(...)
       end
 
       # hash0.amend(hash1,...)
@@ -32,13 +32,13 @@ module Rafini
       # 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|
-          value=hashes.find{_1.has_key? key}&.fetch(key) and self[key]=value
+        each_key do |key|
+          value=hashes.find{_1.key? key}&.fetch(key) and self[key]=value
         end
         self
       end
       def amend(...)
-        self.dup.amend!(...)
+        dup.amend!(...)
       end
     end
   end

data/lib/rafini/integer.rb

@@ -9,7 +9,7 @@ module Rafini
       #   #=> [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
+        raise RangeError, 'negative odometer' if negative?
         readings, remainder = [], self
 
         levels = levels.inject([1]){|m, f| m.push(m.last*f)} if factors

data/lib/rafini/object.rb

@@ -0,0 +1,9 @@
+module Rafini
+  module Object
+    refine ::Object do
+      def as
+        yield self
+      end
+    end
+  end
+end

data/lib/rafini/odometers.rb

@@ -47,15 +47,15 @@ module Rafini
       def description
         string = ''
         reverse_each do |key, count|
-          s = (count==1)? '' : 's'
+          s = count==1 ? '' : 's'
           unless string.empty?
-            string << " and #{count} #{key}#{s}" if count > 0
+            string << " and #{count} #{key}#{s}" if count.positive?
             break
           end
-          next if count == 0
+          next if count.zero?
           string << "#{count} #{key}#{s}"
         end
-        return string
+        string
       end
     end
 
@@ -63,9 +63,9 @@ module Rafini
       using Rafini::Integer # Need Rafini::Integer for #odometer
       using Rafini::Hash    # Need Rafini::Hash for #to_struct
 
-      def odoread(scale, **kw, &blk)
+      def odoread(scale, **kw, &)
         counts = odometer(*scale.values, **kw)
-        ::Hash[scale.keys.zip(counts)].to_struct(&blk)
+        scale.keys.zip(counts).to_h.to_struct(&)
       end
 
       # Integer#sec2time
@@ -73,23 +73,24 @@ module Rafini
       #   10_000.sec2time.to_s #=> "2 hours and 46 minutes"
       #   10_000.sec2time.hour #=> 2
       def sec2time
+        # Struct.new(*scale.keys).new(*counts){ method definitions }
         odoread(SEC2TIME, factors:false) do
           def to_s
             string = nil
             SEC2TIME.keys.reverse_each do |key|
               count=self[key]
               if string
-                if count > 0
+                if count.positive?
                   string << " and #{count} #{key}"
                   string << 's' if count > 1
                 end
                 break
               end
-              next if count==0
+              next if count.zero?
               string = "#{count} #{key}"
               string << 's' if count > 1
             end
-            string = "0 #{SEC2TIME.first[0]}s" unless string
+            string ||= "0 #{SEC2TIME.first[0]}s"
             string
           end
           def to_i
@@ -126,16 +127,16 @@ module Rafini
             number = to_i
             return number.to_s if number < 1_000
             if number < 1_000_000
-              precision = (number<10_000)? 2 : (number<100_000)? 1 : 0
+              precision = number<10_000 ? 2 : number<100_000 ? 1 : 0
               return "#{(number/1000.0).round(precision)}K"
             end
             keys = @scale.keys.reverse_each
             loop do
               key = keys.next
               n = self[key]
-              next if n == 0
+              next if n.zero?
               if n < 1_000
-                precision = (n<10)? 2 : (n<100)? 1 : 0
+                precision = n<10 ? 2 : n<100 ? 1 : 0
                 scale = @scale[key].to_f
                 f = (number/scale).round(precision)
                 return "#{f}#{key[0].upcase}"
@@ -149,7 +150,7 @@ module Rafini
         end
         struct.type  = type
         struct.scale = scale
-        return struct
+        struct
       end
     end
   end

data/lib/rafini/requires.rb

@@ -35,8 +35,11 @@ module Rafini
             require gemname and loaded.push gemname
           end
         end
-        return loaded
+        loaded
       end
     end
   end
+
+  using Requires
+  def self.requires(*list) = Kernel.requires(*list)
 end

data/lib/rafini/string.rb

@@ -1,11 +1,33 @@
 module Rafini
   module String
     refine ::String do
+      def name_split
+        split(/[ _-]|(?=[A-Z])/)
+      end
+      # MyNameIsRuby
+      def pascal_case
+        name_split.map(&:capitalize).join
+      end
+      alias_method :title_case, :pascal_case
+      # myNameIsRuby
+      def camel_case
+        pascal_case.tap{_1[0]=_1[0].downcase}
+      end
+      # my_name_is_ruby
+      def snake_case(sep='_')
+        name_split.map(&:downcase).join(sep)
+      end
+      # my-name-is-ruby
+      def kebab_case
+        snake_case('-')
+      end
+
       # camelize:
       # 1) A camel kick, as in "I gotz camelized".
       # 2) "a_camel_kick" => "ACamelKick"
       def camelize(sep='_')
-        self.split(sep).map(&:capitalize).join
+        warn 'DEPRECATED: use #pascal_case instead'
+        split(sep).map(&:capitalize).join
       end
 
       # semantic:
@@ -14,14 +36,14 @@ module Rafini
       # 'a.b.c'.semantic(0..2, join:'/') #=> 'b/c'
       # 'a/b/c'.semantic(0..2, split:'/', join:'.') #=> 'a.b.c'
       def semantic(v=(0..2), split:'.', join:'.')
-        [*self.split(split)[v]].join(join)
+        [*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'")
+        gsub(/[^\w\-.,:+\/@\n]/,'\\\\\\&').gsub(/\n/,"'\n'")
       end
     end
   end

data/lib/rafini.rb

@@ -1,11 +1,12 @@
 module Rafini
-  VERSION = '3.1.221212'
+  VERSION = '3.3.230213'
   # Constants
   autoload :Empty,     'rafini/empty'
   # Pure
   autoload :Array,     'rafini/array'
   autoload :Hash,      'rafini/hash'
   autoload :Integer,   'rafini/integer'
+  autoload :Object,    'rafini/object'
   autoload :String,    'rafini/string'
   # Hybrid
   autoload :Exception, 'rafini/exception'

metadata

@@ -1,15 +1,155 @@
 --- !ruby/object:Gem::Specification
 name: rafini
 version: !ruby/object:Gem::Version
-  version: 3.1.221212
+  version: 3.3.230213
 platform: ruby
 authors:
 - CarlosJHR64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-12-12 00:00:00.000000000 Z
-dependencies: []
+date: 2023-02-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.0.0
+- !ruby/object:Gem::Dependency
+  name: help_parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.2.230210
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.2.230210
+- !ruby/object:Gem::Dependency
+  name: parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.2.1
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.45'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.45.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.45'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.45.1
+- !ruby/object:Gem::Dependency
+  name: stringio
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.5
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.7
 description: 'Just a collection of useful refinements.
 
   '
@@ -25,6 +165,7 @@ files:
 - lib/rafini/exception.rb
 - lib/rafini/hash.rb
 - lib/rafini/integer.rb
+- lib/rafini/object.rb
 - lib/rafini/odometers.rb
 - lib/rafini/requires.rb
 - lib/rafini/string.rb
@@ -47,8 +188,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [aarch64-linux]'
-rubygems_version: 3.3.7
+- 'git: 2.30'
+- 'ruby: 3.2'
+rubygems_version: 3.4.6
 signing_key: 
 specification_version: 4
 summary: Just a collection of useful refinements.