rus-admin 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b18c7ccfa78f51109d5412f24af5609e410e1f78056d8db6c015deb680779a77
-  data.tar.gz: 7b05b29fd765252bf3993aea482890fdffdbf46825ded3afbdc491d2b48ab0d9
+  metadata.gz: 23d0abb77618bbe1a1feb2895816c72ad3c63647e1e95a3c9a2a5fb4c731dc38
+  data.tar.gz: deb32c1c3018052056805c39d54fe0ab010c4f9e13fbd7d74a10fbe5da2f6661
 SHA512:
-  metadata.gz: 1593a7f05ff37a2c0ce8f9dcf0539332f25189ae1273ad07403f75a799acee85079fa0c865a1523fe764edbb13f50d5a28254ef7dce7f7fe839ff431bc1608ef
-  data.tar.gz: 8c0259c1da8c5734c81e99e87294a2d2406e671e85b6f6c9b8a9a85f78a37dcb2a98455a7c6f4980141d36ed063e9638df4e85008b2da08bb812aff69ebb8508
+  metadata.gz: d799d43186de40ca4429ec46c37a3ebf0408384abbd5b64082a1aee0ebb22d15a3109dd1d5c47cd1d336ffacf49683915014a557b6c908792d4c6dc27a9cf378
+  data.tar.gz: db5355c99c963e7eb83d2d8665f7e2084db2781949b9d24e98b6fbb2fd5645b36ae871b06fbaa980ad7cbc39f8f49d79e969c326d1df6fc3e844b3d7113b5b7f

data/README.md

@@ -4,9 +4,21 @@ Set of helpers for system administration with IRB
 
 ## How to install
 
+Download from GitHub, build gem and install locally
+
+```
+git clone https://www.github.com/alx3dev/rus-admin.git \
+cd rus-admin \
+rake build \
+gem install pkg/rus-admin-0.1.1.gem
+```
+
+Install from rubygems
+
 ```
 gem install rus-admin
 ```
+
 Open IRB shell with:
 ```
 rus-admin
@@ -53,13 +65,14 @@ pp Find.info.result if Find.info.result.any?
 How to use:
 
 ```ruby
-Randompass[20]
+Randpass[20]
 => "0!ZNiAUZCbjo!#hHeX+XX$eAC=!p"
 ```
 
 **Override**  
 Override method `capitalize!`, make it work without downcase of other characters.
 Available in classes: `String, Symbol, Array`. If used in array, hashes and integers are skipped.
+Read source code for documentation
 
 ```ruby
 # override method #capitalize!

data/lib/rus/admin/find.rb

@@ -29,7 +29,7 @@
 #     puts "No match for #{action.params}"
 #   end
 #
-class Find
+module Find
   Result = Struct.new(:params, :path, :result)
 
   COMPARATION = %i[equal include start_with end_with].freeze
@@ -105,6 +105,7 @@ class Find
       add string, line_no if add_to
     end
 
+    # rubocop:disable Metrics/CyclomaticComplexity
     def check_line(line, string, type)
       case type
       when :include    then true if line.include? string
@@ -113,6 +114,7 @@ class Find
       when :end_with   then true if line.end_with? string
       end
     end
+    # rubocop:enable Metrics/CyclomaticComplexity
 
     def add(param, line_no)
       @found[param] = Array(@found[param]) | Array(line_no)

data/lib/rus/admin/randpass.rb

@@ -2,36 +2,45 @@
 
 require 'securerandom'
 
+# Generate random password with SecureRandom#base64 and a few
+# random special characters. Method #randpass is defined as
+# class and instance method, so you can call it or include it.
+#
+# @note Always shuffle #base64 if it has less than 16 chars, because they end with '=='
+#
 module Randpass
+  # allowed specials. xxx is flag for #add_special_chars
+  ARRAY = %w[! # * $ % _ @ xxx].freeze
+
+  # Random number of times try to add random special character.
+  # Transform to array, shuffle, and join back to string
+  #
+  # @param [Integer] number_of_chars **Required**. Number of password characters.
+  # @return [String]
+  #
+  def randpass(number_of_chars)
+    Randpass[number_of_chars]
+  end
+
   class << self
-    attr_reader :pass
-
-    # Get random password
-    # Add special characters to SecureRandom#base64 random string, and shuffle it
-    #
-    # @note Always shuffle base64 if it has less than 16 chars, because they end with '=='
-    #
-    def [](number_of_chars = 18)
-      random = SecureRandom.base64(number_of_chars)
-      rand(5..10).times { random = add_special_chars(random) }
-      @pass = random.split('').shuffle.join
+    # @return [String]
+    def randpass(number_of_chars)
+      param = SecureRandom.base64(number_of_chars)
+      rand(5..10).times do
+        param = add_special_chars(param)
+      end
+      param.split('').shuffle.join
     end
-    alias get []
+
+    alias [] randpass
 
     private
 
     def add_special_chars(param)
-      count = SecureRandom.random_number 15_000
-      char = case count
-             when 1...1000    then '_'
-             when 1000...2000 then '!'
-             when 2000...3000 then '#'
-             when 3000...4000 then '$'
-             when 4000...5000 then '%'
-             when 6000...7000 then '?'
-             else return param
-             end
-      param[rand(param.size)] = char
+      char = ARRAY.shuffle[rand(ARRAY.size)]
+      return param if char == 'xxx'
+
+      param[rand(param.size)] = char.to_s
       param
     end
   end

data/lib/rus/admin.rb

@@ -1,20 +1,8 @@
 # frozen_string_literal: true
 
 require_relative 'version' unless defined? Rus::Admin::VERSION
+
 require_relative 'admin/find' unless defined? Find
 require_relative 'admin/randpass' unless defined? Randpass
 
-module Rus
-  module Admin
-    class << self
-      def override?
-        @override == true
-      end
-
-      def override!
-        require_relative 'override/override'
-        @override = true
-      end
-    end
-  end
-end
+require_relative 'override' unless defined? Rus.override?

data/lib/rus/override/main.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Ruby capitalize! upcase first character, but perform
+# downcase on other characters. This is my workaround.
+class String
+  def capitalize!
+    self[0] = self[0].upcase
+    self
+  end
+end
+
+# Ruby capitalize! upcase first character, but perform
+# downcase on other characters. Also, when capitalizing :symbols,
+# I mostly need String to be returned.
+class Symbol
+  def capitalize!
+    to_s.capitalize!
+  end
+end
+
+# Ruby capitalize! upcase first character, but perform
+# downcase on other characters. And we cant capitalize array.
+# This method convert all to strings, and capitalize.
+class Array
+  def capitalize!
+    map! do |x|
+      x = x.to_s if x.is_a? Integer
+      x.capitalize!
+    end
+  end
+end

data/lib/rus/override.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+# rubocop:disable Style/Documentation
+module Rus
+  class << self
+    # check if default classes are overridden
+    def override?
+      @override == true
+    end
+    alias overridden? override?
+
+    # Override default classes: *string, symbol, array*
+    # with capitalize! method - without any downcase.
+    # @return [Boolean] False if already overridden, otherwise true.
+    def override
+      return false if override?
+
+      require_relative 'override/main'
+      @override = true
+    end
+    alias override! override
+  end
+end
+# rubocop:enable Style/Documentation

data/lib/rus/version.rb

@@ -2,6 +2,6 @@
 
 module Rus
   module Admin
-    VERSION = '0.1.0'
+    VERSION = '0.1.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rus-admin
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - alx3dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-20 00:00:00.000000000 Z
+date: 2022-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -40,7 +40,8 @@ files:
 - lib/rus/admin.rb
 - lib/rus/admin/find.rb
 - lib/rus/admin/randpass.rb
-- lib/rus/override/override.rb
+- lib/rus/override.rb
+- lib/rus/override/main.rb
 - lib/rus/version.rb
 homepage: https://www.github.com/alx3dev/rus-admin
 licenses:
@@ -49,7 +50,7 @@ metadata:
   homepage_uri: https://www.github.com/alx3dev/rus-admin
   source_code_uri: https://www.github.com/alx3dev/rus-admin
   changelog_uri: https://www.github.com/alx3dev/rus-admin/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/rus-admin/0.1.0
+  documentation_uri: https://www.rubydoc.info/gems/rus-admin/0.1.1
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -58,7 +59,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '2.6'
   - - "<"
     - !ruby/object:Gem::Version
       version: '3.2'

data/lib/rus/override/override.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-class String
-  def capitalize!
-    self[0] = self[0].upcase
-    self
-  end
-end
-
-class Symbol
-  def capitalize!
-    String.new(name).capitalize!.to_sym
-  end
-end
-
-class Array
-  def capitalize!
-    each do |x|
-      x.capitalize! if x.instance_of?(String) || x.instance_of?(Symbol)
-    end
-  end
-end