toolrack 0.8.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 82f8e6d4659caa4af54db81593a98505aeb00348e104bc796fe6acf4278f7ca6
-  data.tar.gz: a3fed1a24257ac29df830858a03a7c41c575b31407b90f8414e73324d890a094
+  metadata.gz: 42fd35a5442e9aaae8d559536346c0de0228db4d93aa40d1d4720eeacf5c7c31
+  data.tar.gz: 02efc3e79b36480a037174d7005cbcbfddc217688e71b2ebc7b41e0d66bfe12b
 SHA512:
-  metadata.gz: 61304df1637d1c47f49612361a26a7bed6e7b79243c5769546104a3aec5c5517c95a09e6dc8da339f92c75de932d6db9240d2ba0d01bc86d6fa0eedf6e690af0
-  data.tar.gz: 670b9c3ee72b20e470b1ba1f1850b58765072712b6dda0049e712cf7217244882696f4b7bb8e41195a240aa6bb8ec2cf7a87fe7ed0b81777b3303961574b3b5b
+  metadata.gz: 54354902f0f97ca0c7c0295ec8ca9b7e25912fcb69954f4d290793ed5a4732e7ec5806ef35c4a5a08e8cc6e68552ce9744023680c5d14d960bfcef09931b0f62
+  data.tar.gz: 861b791fa8f1396d111f13f21cb91a4375ef9a5c565bcd7c842dca1cae1550d6919a14daf6d8d393009ff3bf44502d8d4b64bd678d813412f89d9e4167b2f686

data/README.md

@@ -1,6 +1,6 @@
 # Toolrack
 
-Toolrack just the collection of utilities that helps in my code clarity
+Toolrack just the collection of utilities that helps in my code clarity and assistance since those utils too small to be a gem on its own.
 
 ## Installation
 
@@ -40,10 +40,21 @@ class EditController
   # enable instance method to access those uitilities
   include ToolRack::ConditionUtils
   include ToolRack::ExceptionUtils
+  include ToolRack::PasswordUtils
+  include ToolRack::RuntimeUtils
+  include ToolRack::DataConversionUtils
+
+  # there is also shortcut since I write it so often
+  include TR::CondUtils
+  include TR::ExpUtils
+  include TR::PassUtils
+  include TR::RTUtils
+  include TR::DataConvUtils
 end
 ```
 
-Currently it has 3 modules:
+Currently it has 5 modules:
+
 * Condition Utilities
   * is\_empty?(obj) - I found that I've type the condition if not (x.nil? and x.empty?) too frequent that I think this is very best to turn this into a function. The empty test shall take the following test in sequence:
     * First test is x.nil?. If it is return true
@@ -77,6 +88,45 @@ Currently it has 3 modules:
   * raise\_if\_false(obj, message, error) - As the name implied
   * raise\_if\_true(obj, message, error) -  As the name implied
 
-
- 
+* Runtime utils - Tired rewriting this in other project. Detect if the running system is on which operating system / runtime. The function is pretty self descriptive
+  * RuntimeUtils.on\_windows?
+  * RuntimeUtils.on\_mac?
+  * RuntimeUtils.on\_linux?
+  * RuntimeUtils.on\_ruby?
+  * RuntimeUtils.on\_jruby?
+
+* Password utils - Generate random password with designated complexity
+  * generate\_random\_password(length, options = { complexity: \<value\>, enforce\_quality: \<true/false\> })
+    * length - length of the required generated password
+    * options[:complexity]:
+      * 1 - lowercase alphabet
+      * 2 - lower + upper case alphabet [alpha]
+      * 3 - lower + upper + number [alpha numeric]
+      * 4 - lower + upper + number + symbol
+    * options[:enforce\_quality]
+      * true - generated password is guaranteed to contain the required complexity. E.g. if complexity 4 is required, the password MUST contain lower, upper, number and symbol as its output or a new password that comply to the complexity shall be regenerated. This process is repeated until the required complexity is achieved
+      * false - The rules of the complexity is relexed. E.g. if complexity 4 is requested, the output might not have symbol in it.
+  * gen\_rand\_pass(length, options = { }) & gen\_pass(length, options = { })
+    * Alias for method generate\_random\_password
+
+  * all\_lowercase\_alpha?(str)
+  * all\_uppercase\_alpha?(str)
+  * all\_alpha?(str)
+  * all\_number?(str)
+  * all\_symbol?(str)
+  * all\_alpha\_numeric?(str)
+  * all\_alpha\_numeric\_and\_symbol?(str)
+    * All methods above starts with all_\* is to check for strict compliance to the required output. E.g. if all\_alpha?(str) is used, the input str MUST be all alpha to get a true status
+
+  * has\_lowercase\_alpha?(str)
+  * has\_uppercase\_alpha?(str)
+  * has\_alpha?(str)
+  * has\_number?(str)
+  * has\_symbol?(str)
+  * has\_alpha\_numeric?(str)
+  * has\_alpha\_numeric\_or\_symbol?(str)
+    * All methods above start with has_\* is just to check if the given str contains the required specification. E.g string 'abcdE' will still get true status if pass to has\_lowercase\_alpha?(str). But value 1234 or '1234' or '$%^&' pass to has\_lowercase\_alpha?(str) shall return false.
+
+
+Check out the rspec folder for usage
 

data/lib/toolrack/password_utils.rb

@@ -0,0 +1,301 @@
+
+require 'securerandom'
+
+module Antrapol
+  module ToolRack
+    module PasswordUtils
+      include Antrapol::ToolRack::ConditionUtils
+      
+      class PasswordUtilsError < StandardError; end
+
+      # complexity
+      # 1 : lowercase alphabet
+      # 2 : lower + upper alphabet
+      # 3 : lower + upper + number
+      # 4 : lower + upper + number + symbol
+      def generate_random_password(length = 12, opts = { complexity: 4, enforce_quality: true })
+       
+
+        length = 12 if is_empty?(length)
+        length = length.to_i
+        length = 12 if length <= 0
+
+        logger.debug "Length : #{length}"
+
+        if not_empty?(opts)
+          complexity = opts[:complexity] || 4
+          
+          raise PasswordUtilsError, "Password length too short but complexity too high. Not able generate the password with required complexity." if length <= complexity
+          
+          enforce_quality = opts[:enforce_quality] || true
+        end
+
+        complexity = 4 if is_empty?(complexity)
+        complexity = 4 if complexity > 4
+        complexity = 1 if complexity < 1
+
+        logger.debug "Complexity : #{complexity}"
+
+        enforce_quality = true if is_empty?(enforce_quality) or not is_bool?(enforce_quality)
+
+        res = []
+        antropy = [("a".."z"),("A".."Z"),(0..9),("!".."?")]
+        selection = antropy[0..complexity-1].map { |s| s.to_a }.flatten
+
+        fres = nil
+        loop do
+
+          len = length
+          processed = 0
+          loop do
+            #res += selection.sample(length)
+            res += selection.sort_by { SecureRandom.random_number }
+            break if res.length >= length
+          end
+
+          fres = res[0...length].join
+
+          if enforce_quality
+            case complexity
+            when 1
+              if all_lowercase_alpha?(fres)
+                break
+              else
+                logger.debug "Failed lowercase alpha quality check. #{fres} - Regenerating..."
+                res.clear
+              end
+            when 2
+              st, dst = all_alpha?(fres)
+              if st
+                break
+              else
+                logger.debug "Failed all alpha quality check. #{dst} - Regenerating..."
+                res.clear
+              end
+            when 3
+              st, dst = all_alpha_numeric?(fres)
+              if st
+                break
+              else
+                logger.debug "Failed alpha numeric quality check. #{dst} - Regenerating"
+                res.clear
+              end
+            when 4
+              st, dst = all_alpha_numeric_and_symbol?(fres)
+              if st
+                break
+              else
+                logger.debug "Failed alpha numeric + symbol quality check. #{fres} / #{dst} - Regenerating"
+                res.clear
+              end
+            else
+              logger.debug "Unknown complexity?? #{complexity}"
+              break
+            end
+          else
+            break
+          end
+
+        end
+
+        fres
+
+        #length = 12 if is_empty?(length)
+        #length = length.to_i
+        #length = 12 if length <= 0
+
+        #antropy = ('!'..'~').to_a
+        #antropy.sort_by { SecureRandom.random_number }.join[0...length]
+      end
+      alias_method :gen_rand_pass, :generate_random_password
+      alias_method :gen_pass, :generate_random_password
+
+      def all_lowercase_alpha?(str)
+        return false if is_empty?(str) or not str.is_a?(String)
+
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+      
+        (s.difference(lalpha).length == 0)
+      end
+
+      def has_lowercase_alpha?(str)
+        return false if is_empty?(str) or not str.is_a?(String)
+
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+      
+        (s & lalpha).length > 0
+      end
+
+      def all_uppercase_alpha?(str)
+        return false if is_empty?(str) or not str.is_a?(String)
+
+        s = str.split("")
+        ualpha = ('A'..'Z').to_a
+
+        s.difference(ualpha).length == 0
+      end
+
+      def has_uppercase_alpha?(str)
+        return false if is_empty?(str) or not str.is_a?(String)
+
+        s = str.split("")
+        ualpha = ('A'..'Z').to_a
+
+        (s & ualpha).length > 0
+      end
+
+      def all_alpha?(str)
+        return false if is_empty?(str) or not str.is_a?(String)
+
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+        ualpha = ('A'..'Z').to_a
+        num = ('0'..'9').to_a
+        sym = ('!'..'?').to_a
+        
+        alpha = [lalpha, ualpha].flatten
+
+        t1 = (alpha.difference(s).length == 0)
+        t2 = (alpha.difference(s).length == 0)
+
+        t3 = (s & num).length > 0
+        t4 = (s & sym).length > 0
+        
+        [!(t1 or t2 or t3 or t4), res = { has_lower_alpha: t1, has_upper_alpha: t2, has_num: t3, has_symbol: t4 }]
+      end
+
+      def has_alpha?(str)
+        return false if is_empty?(str) or not str.is_a?(String)
+
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+        ualpha = ('A'..'Z').to_a
+        alpha = [lalpha, ualpha].flatten
+
+        (alpha & s).length > 0
+      end
+
+      def has_number?(str)
+        return false if is_empty?(str)
+
+        str = str.to_s if not str.is_a?(String)
+
+        s = str.split("")
+        num = ('0'..'9').to_a
+
+        (s & num).length > 0
+        
+      end
+
+      def all_number?(str)
+        return false if is_empty?(str)
+
+        str = str.to_s if not str.is_a?(String)
+
+        s = str.split("")
+        num = ('0'..'9').to_a
+
+        !(s.difference(num).length > 0)
+        
+      end
+
+      def all_symbol?(str)
+        return false if is_empty?(str)
+
+        s = str.split("")
+        sym = ('!'..'?').to_a
+        !(s.difference(sym).length > 0)
+        
+      end
+
+      def has_symbol?(str)
+        return false if is_empty?(str)
+
+        s = str.split("")
+        sym = ('!'..'?').to_a
+       
+        p (s & sym)
+        (s & sym).length > 0
+      end
+
+
+      def all_alpha_numeric?(str)
+        return false if is_empty?(str)
+
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+        ualpha = ('A'..'Z').to_a
+        num = ('0'..'9').to_a
+        sym = ('!'..'?').to_a
+        sym = sym.difference(num)
+
+        t1 = ((s & lalpha).length > 0)
+        t2 = ((s & ualpha).length > 0)
+        t3 = ((s & num).length > 0)
+
+        t4 = ((s & sym).length > 0)
+
+        [(t1 and t2 and t3 and !t4), res = { has_lower_alpha: t1, has_upper_alpha: t2, has_num: t3, has_symbol: t4 }]
+      end
+
+      def has_alpha_numeric?(str)
+        return false if is_empty?(str)
+        
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+        ualpha = ('A'..'Z').to_a
+        num = ('0'..'9').to_a
+        alphanum = [lalpha, ualpha, num].flatten
+
+        (s & alphanum).length > 0
+        
+      end
+
+      def all_alpha_numeric_and_symbol?(str)
+        return false if is_empty?(str)
+
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+        ualpha = ('A'..'Z').to_a
+        num = ('0'..'9').to_a
+        sym = ('!'..'?').to_a
+        sym = sym.difference(num)
+
+        t1 = ((s & lalpha).length > 0)
+        t2 = ((s & ualpha).length > 0)
+        t3 = ((s & num).length > 0)
+        t4 = ((s & sym).length > 0)
+
+        [(t1 and t2 and t3 and t4), res = { has_lower_alpha: t1, has_upper_alpha: t2, has_num: t3, has_symbol: t4 }]
+      end
+
+      def has_alpha_numeric_or_symbol?(str)
+        return false if is_empty?(str)
+        
+        s = str.split("")
+        lalpha = ('a'..'z').to_a
+        ualpha = ('A'..'Z').to_a
+        num = ('0'..'9').to_a
+        sym = ('!'..'?').to_a
+        sym = sym.difference(num)
+
+        t1 = ((s & lalpha).length > 0)
+        t2 = ((s & ualpha).length > 0)
+        t3 = ((s & num).length > 0)
+        t4 = ((s & sym).length > 0)
+        
+        [(t1 or t2 or t3 or t4), res = { has_lower_alpha: t1, has_upper_alpha: t2, has_num: t3, has_symbol: t4 }]
+      end
+
+      private
+      def logger
+        logger = Antrapol::ToolRack::Logger.instance.glogger
+        logger.tag = :pass_utils
+        logger
+      end
+
+    end
+  end
+end

data/lib/toolrack/version.rb

@@ -1,6 +1,6 @@
 module Antrapol
   module ToolRack
-    VERSION = "0.8.2"
+    VERSION = "0.9.3"
   end
 end
 

data/lib/toolrack.rb

@@ -11,6 +11,7 @@ require_relative 'toolrack/condition_utils'
 require_relative 'toolrack/process_utils'
 require_relative 'toolrack/runtime_utils'
 require_relative 'toolrack/data_conversion_utils'
+require_relative 'toolrack/password_utils'
 
 module Antrapol
   module ToolRack
@@ -21,6 +22,20 @@ module Antrapol
 end
 
 ToolRack = Antrapol::ToolRack
-ToolRack::DataConv = Antrapol::ToolRack::DataConversionUtils
+TR = ToolRack
 
+ToolRack::DataConvUtils = Antrapol::ToolRack::DataConversionUtils
+TR::DataConvUtils = ToolRack::DataConvUtils
+
+ToolRack::CondUtils = ToolRack::ConditionUtils
+TR::CondUtils = ToolRack::ConditionUtils
+
+ToolRack::PassUtils = ToolRack::PasswordUtils
+TR::PassUtils = ToolRack::PasswordUtils
+
+ToolRack::ExpUtils = ToolRack::ExceptionUtils
+TR::ExpUtils = ToolRack::ExpUtils
+
+ToolRack::RTUtils = ToolRack::RuntimeUtils
+TR::RTUtils = ToolRack::RTUtils
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toolrack
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.3
 platform: ruby
 authors:
 - Chris
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-08-31 00:00:00.000000000 Z
+date: 2021-09-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tlogger
@@ -73,6 +73,7 @@ files:
 - lib/toolrack/data_conversion_utils.rb
 - lib/toolrack/exception_utils.rb
 - lib/toolrack/global.rb
+- lib/toolrack/password_utils.rb
 - lib/toolrack/process_utils.rb
 - lib/toolrack/runtime_utils.rb
 - lib/toolrack/utils.rb