rake-commander 0.3.6 → 0.4.1

data/lib/rake-commander/options/name.rb

@@ -3,31 +3,34 @@ class RakeCommander
     module Name
       BOOLEAN_TOKEN       = '[no-]'.freeze
       # Substitions
-      HYPHEN_START_REGEX  = /^-+/.freeze
-      HYPEN_REGEX         = /-+/.freeze
-      UNDERSCORE_REGEX    = /_+/.freeze
-      WORD_DELIMITER      = /[\s=]+/.freeze
+      HYPHEN_START_REGEX  = /^-+/
+      HYPEN_REGEX         = /-+/
+      UNDERSCORE_REGEX    = /_+/
+      WORD_DELIMITER      = /[\s=]+/
       # Checkers / Capturers
-      OPTIONAL_REGEX      = /\[\w+\]$/.freeze
-      SINGLE_HYPHEN_REGEX = /^-(?<options>[^- ][^ ]*)/.freeze
-      DOUBLE_HYPHEN_REGEX = /^(?:--\[?no-\]?|--)(?<option>[^- ][^ \r\n]*).*$/.freeze
-      BOOLEAN_NAME_REGEX  = /^[^ ]*#{Regexp.escape(BOOLEAN_TOKEN)}[^ ]{2,}/.freeze
+      OPTIONAL_REGEX      = /\[\w+\]$/
+      SINGLE_HYPHEN_REGEX = /^-(?<options>[^- ][^ ]*)/
+      DOUBLE_HYPHEN_REGEX = /^(?:--\[?no-\]?|--)(?<option>[^- ][^ \r\n]*).*$/
+      BOOLEAN_NAME_REGEX  = /^[^ ]*#{Regexp.escape(BOOLEAN_TOKEN)}[^ ]{2,}/
 
       # @return [Boolean]
       def single_hyphen?(value)
         return false unless value.respond_to?(:to_s)
+
         !!value.to_s.match(SINGLE_HYPHEN_REGEX)
       end
 
       # @return [Boolean]
       def double_hyphen?(value)
         return false unless value.respond_to?(:to_s)
+
         !!value.to_s.match(DOUBLE_HYPHEN_REGEX)
       end
 
       # @return [Boolean] whether the name has the boolean switch `[no-]`
       def boolean_name?(value)
         return false unless value.respond_to?(:to_s)
+
         !!value.to_s.match(BOOLEAN_NAME_REGEX)
       end
 
@@ -35,9 +38,11 @@ class RakeCommander
       # @return [Boolean]
       def valid_short?(value, strict: false)
         return false unless value.respond_to?(:to_s)
+
         value = value.to_s.strip
         return false if value.empty?
         return false if strict && !single_hyphen?(value)
+
         value = value.gsub(HYPHEN_START_REGEX, '')
         value.length == 1
       end
@@ -46,9 +51,11 @@ class RakeCommander
       # @return [Boolean]
       def valid_name?(value, strict: false)
         return false unless value.respond_to?(:to_s)
+
         value = value.to_s.strip
         return false if value.empty?
         return false if strict && !double_hyphen?(value)
+
         name_sym(value).to_s.length > 1
       end
 
@@ -59,6 +66,7 @@ class RakeCommander
         capture_argument_with!(args) do |arg|
           next false unless arg.is_a?(String) || arg.is_a?(Symbol)
           next false if symbol && !arg.is_a?(Symbol)
+
           valid_short?(arg, strict: strict)
         end
       end
@@ -70,6 +78,7 @@ class RakeCommander
         capture_argument_with!(args) do |arg|
           next false unless arg.is_a?(String) || arg.is_a?(Symbol)
           next false if symbol && !arg.is_a?(Symbol)
+
           valid_name?(arg, strict: strict)
         end
       end
@@ -79,13 +88,16 @@ class RakeCommander
       # @return [String, Symbol, NilClass] the arg candidate
       def capture_argument_with!(args)
         raise ArgumentError, "Expecting Array. Given: #{args.class}" unless args.is_a?(Array)
+
         args.dup.find.with_index do |arg, i|
           yield(arg).tap do |valid|
             next unless valid
+
             args.slice!(i)
             return arg
           end
         end
+
         nil
       end
 
@@ -94,10 +106,12 @@ class RakeCommander
       #   * `"-d"` becomes `:d`
       # @return [Symbol, NilClass]
       def short_sym(value)
-        return nil unless value
+        return unless value
+
         value = value.to_s.gsub(BOOLEAN_TOKEN, '')
         value = value.gsub(HYPHEN_START_REGEX, '')
-        return nil unless value = value.chars.first
+        return unless value = value.chars.first
+
         value.to_sym
       end
 
@@ -110,11 +124,13 @@ class RakeCommander
       #   3. Replaces any multi-spacing by single space ` `
       # @return [Symbol, NilClass]
       def name_sym(value)
-        return nil unless value
+        return unless value
+
         value = value.to_s.gsub(HYPHEN_START_REGEX, '')
         value = value.gsub(HYPEN_REGEX, '_')
         value = value.gsub(WORD_DELIMITER, ' ')
-        return nil if value.empty?
+        return if value.empty?
+
         value.to_sym
       end
 
@@ -128,14 +144,16 @@ class RakeCommander
       # @return [Symbol, NilClass]
       def name_word_sym(value)
         value = value.to_s.gsub(BOOLEAN_TOKEN, '')
-        return nil unless value = name_sym(value)
-        return nil unless value = name_words(value).first
+        return unless (value = name_sym(value))
+        return unless (value = name_words(value).first)
+
         value.downcase.to_sym
       end
 
       # @return [String, NilClass] it returns the hyphened (`-`) version of a short `value`
       def short_hyphen(value)
-        return nil unless value = short_sym(value)
+        return unless (value = short_sym(value))
+
         "-#{value}"
       end
 
@@ -146,9 +164,11 @@ class RakeCommander
       #   * `:there_we_go` becomes `"--there-we-go"`
       # @return [String, NilClass] option `name` alone double hypened (`--`)
       def name_hyphen(value)
-        return nil unless value = name_sym(value)
+        return unless value = name_sym(value)
+
         value = value.to_s.gsub(UNDERSCORE_REGEX, '-')
-        return nil if value.empty?
+        return if value.empty?
+
         "--#{value}"
       end
 
@@ -174,6 +194,7 @@ class RakeCommander
       # @return [Boolean] `true` if `value` does NOT end with `[String]`
       def argument_required?(value)
         return false unless value
+
         !argument_optional?(value)
       end
 
@@ -185,6 +206,7 @@ class RakeCommander
       # @return [Boolean] `true` if `value` ends with `[String]`
       def argument_optional?(value)
         return true unless value
+
         !!value.match(OPTIONAL_REGEX)
       end
 
@@ -194,7 +216,8 @@ class RakeCommander
       #   * `"--there-we-go   [ARGUMENT]"` returns `["there-we-go","[ARGUMENT]"]`
       # @return [Array<String>] the words of `value` without hyphen start
       def name_words(value)
-        return nil unless value
+        return unless value
+
         value = value.to_s.gsub(HYPHEN_START_REGEX, '')
         value.to_s.split(WORD_DELIMITER)
       end

data/lib/rake-commander/options/result.rb

@@ -3,7 +3,7 @@ class RakeCommander
     module Result
       class << self
         def included(base)
-          super(base)
+          super
           base.extend ClassMethods
           base.attr_inheritable :options_with_defaults
         end
@@ -46,7 +46,7 @@ class RakeCommander
         #   2. We use `task_context` to open up extensibility.
         # @todo think if it should rather raise an `ArgumentError` when the task
         #   was not defined in an instance object of his class.
-        def install_task(&task_method)
+        def install_task(&task_method) # rubocop:disable Naming/BlockForwarding
           super(&task_context(&task_method))
         end
 
@@ -57,6 +57,7 @@ class RakeCommander
         def task_context(&task_method)
           instance = eval('self', task_method.binding, __FILE__, __LINE__)
           return task_method unless instance.is_a?(self)
+
           proc do |*task_args|
             # launch `ARGV` parsing
             instance.options
@@ -72,6 +73,7 @@ class RakeCommander
         # @return [Proc] the results collector that wraps the middleware.
         def results_collector(results, &middleware)
           results = result_defaults(results)
+
           proc do |value, default, short, name, opt|
             middleware&.call(value, default, short, name, opt)
             results[name] = results[short] = value.nil?? default : value
@@ -91,12 +93,21 @@ class RakeCommander
         end
       end
 
+      # INSTANCE METHODS
+
       # Launches the options parsing of this class.
       # @return [Hash] keyed by short.
-      def options(argv = ARGV, &block)
+      def options(argv = ARGV, &block) # rubocop:disable Naming/BlockForwarding
         return @options if instance_variable_defined?(:@options)
+
         @options = {}
-        self.class.parse_options(argv, results: @options, leftovers: options_leftovers, &block)
+        self.class.parse_options(
+          argv,
+          results:   @options,
+          leftovers: options_leftovers,
+          &block
+        )
+
         @options
       end
 

data/lib/rake-commander/options/set.rb

@@ -9,11 +9,13 @@ class RakeCommander
         # Name of the `Options::Set`
         def name(value = :not_used)
           return @name if value == :not_used
+
           @name = value.to_sym
         end
 
         def each(&block)
           return to_enum(:each) unless block
+
           options.each(&block)
         end
       end

data/lib/rake-commander/options/type.rb

@@ -0,0 +1,28 @@
+class RakeCommander
+  module Options
+    module Type
+      ALLOWED_TYPES = [
+        Class,
+        Array
+      ].freeze
+
+      private
+
+      def fetch_type!(args)
+        args.dup.select do |arg|
+          allowed_type?(arg).tap do |is_type|
+            next unless is_type
+
+            args.delete(arg)
+          end
+        end.first
+      end
+
+      def allowed_type?(value)
+        ALLOWED_TYPES.any? do |allowed|
+          value.is_a?(allowed)
+        end
+      end
+    end
+  end
+end

data/lib/rake-commander/options.rb

@@ -1,5 +1,6 @@
 require_relative 'options/name'
 require_relative 'options/description'
+require_relative 'options/type'
 require_relative 'options/arguments'
 require_relative 'options/result'
 require_relative 'options/error'
@@ -9,16 +10,20 @@ class RakeCommander
   module Options
     class << self
       def included(base)
-        super(base)
+        super
+
         base.extend RakeCommander::Base::ClassHelpers
         base.extend RakeCommander::Base::ClassInheritable
         base.extend ClassMethods
         base.attr_inheritable :banner
+
         base.attr_inheritable(:options_hash) do |value, subclass|
-          next nil unless value
+          next unless value
+
           value.values.uniq.each {|opt| subclass.send :add_to_options, opt.dup}
           subclass.send(:options_hash)
         end
+
         base.class_resolver :option_class, RakeCommander::Option
         base.send :include, RakeCommander::Options::Result
         base.send :include, RakeCommander::Options::Error
@@ -30,15 +35,17 @@ class RakeCommander
       # Overrides the auto-generated banner
       def banner(desc = :not_used)
         return @banner = desc unless desc == :not_used
-        return @banner if @banner
-        return task_options_banner if respond_to?(:task_options_banner, true)
+        return @banner        if @banner
+
+        task_options_banner   if respond_to?(:task_options_banner, true)
       end
 
       # Defines a new option or opens for edition an existing one if `reopen: true` is used.
       # @note
       #   - If override is `true`, it will with a Warning when same `short` or `name` clashes.
-      def option(*args, override: true, reopen: false, **kargs, &block)
+      def option(*args, override: true, reopen: false, **kargs, &block) # rubocop:disable Naming/BlockForwarding, Style/ArgumentsForwarding
         return option_reopen(*args, override: override, **kargs, &block) if reopen
+
         opt = option_class.new(*args, **kargs, &block)
         add_to_options(opt, override: override)
       end
@@ -52,13 +59,15 @@ class RakeCommander
       #   2. It will have the effect of overriding existing options
       # @note when `short` and `name` are provided, `name` takes precedence over `short`
       #   in the lookup (to identify the existing option)
-      def option_reopen(*args, override: false, **kargs, &block)
-        aux = option_class.new(*args, **kargs, sample: true, &block)
+      def option_reopen(*args, override: false, **kargs, &block) # rubocop:disable Naming/BlockForwarding, Style/ArgumentsForwarding
+        aux = option_class.new(*args, **kargs, sample: true, &block) # rubocop:disable Naming/BlockForwarding, Style/ArgumentsForwarding
         opt = options_hash.values_at(aux.name, aux.short).compact.first
         return option(*args, **kargs, &block) unless opt
+
         mod = {}.tap do |mkargs|
           mkargs.merge!(name: opt.name_full) if aux.name_full.is_a?(Symbol)
         end
+
         replace_in_options(opt, opt.merge(aux, **mod), override: override)
       end
 
@@ -77,10 +86,13 @@ class RakeCommander
       #   should be overriden, may they clash
       # @param options [Enumerable<RakeCommander::Option>]
       def options_use(opts, override: true)
-        raise "Could not obtain list of RakeCommander::Option from #{opts.class}" unless opts = to_options(opts)
+        msg = "Could not obtain list of RakeCommander::Option from #{opts.class}"
+        raise msg unless (opts = to_options(opts))
+
         opts.each do |opt|
           add_to_options(opt.deep_dup, override: override)
         end
+
         self
       end
 
@@ -103,6 +115,7 @@ class RakeCommander
       def options_hash(with_implicit: false)
         @options_hash ||= {}
         return @options_hash unless with_implicit
+
         @options_hash.merge(implicit_shorts)
       end
 
@@ -153,7 +166,7 @@ class RakeCommander
       end
 
       # @return [OptionParser]
-      def new_options_parser(&block)
+      def new_options_parser(&block) # rubocop:disable Naming/BlockForwarding
         require 'optparse'
         OptionParser.new(&block)
       end
@@ -180,6 +193,7 @@ class RakeCommander
       # @param opts [OptionParser] where the help will be added.
       def option_help(opts)
         return false if option?(:help) || option?(:h)
+
         option(:h, :help, 'Prints this help') do
           puts opts
           exit(0)
@@ -212,16 +226,19 @@ class RakeCommander
       # @return [RakeCommander::Option, NilClass] the option that was added, `nil` is returned otherwise.
       def add_to_options(opt, override: true)
         name_ref = respond_to?(:name)? " (#{name})" : ''
-        if sprev = option_get(opt.short)
+        if (sprev = option_get(opt.short))
           return nil unless override
           puts "Warning#{name_ref}: Overriding option '#{sprev.name}' with short '#{sprev.short}' ('#{opt.name}')"
           delete_from_options(sprev)
         end
-        if nprev = option_get(opt.name)
-          return nil unless override
+
+        if (nprev = option_get(opt.name))
+          return unless override
+
           puts "Warning#{name_ref}: Overriding option '#{nprev.short}' with name '#{nprev.name}' ('#{opt.short}')"
           delete_from_options(nprev)
         end
+
         options_hash[opt.name] = options_hash[opt.short] = opt
       end
 
@@ -245,6 +262,7 @@ class RakeCommander
         add_to_options(opt, override: override).tap do |added_opt|
           # restore previous status
           next options_hash[ref.short] = options_hash[ref.name] = ref unless added_opt
+
           delete_empty_keys(options_hash)
         end
       end
@@ -254,6 +272,7 @@ class RakeCommander
         hash.tap do |_h|
           hash.dup.each do |k, v|
             next unless v.nil?
+
             hash.delete(k)
           end
         end

data/lib/rake-commander/patcher/application/top_level_resume.rb

@@ -11,11 +11,13 @@ class RakeCommander
 
           def patch_prepend(_invoked_by)
             return unless target_defined?
+
             Rake::Application.prepend Patch
           end
 
           def target_defined?
             return true if defined?(target)
+
             puts "Warning (#{self}): undefined target #{target}"
             false
           end

data/lib/rake-commander/patcher/debug.rb

@@ -5,14 +5,17 @@ class RakeCommander
       # Helper for debugging
       def rake_comm_debug(msg, prefix = '', num: nil, pid: false)
         return unless RakeCommander::Patcher.debug?
+
         rake_comm_debug_random_object_id
         num = num ? "#{num}. " : nil
+
         if pid
           meta = "(PID: #{Process.pid} ++ Thread: #{Thread.current.object_id} ++ Ruby 'main': #{rake_comm_debug_main_object_id})"
           msg  = "#{prefix}( #{num}#{Rake.application.object_id})   #{msg}   #{meta}"
         elsif num
           msg  = "#{prefix}( #{num})   #{msg}   "
         end
+
         puts msg
       end
 
@@ -22,9 +25,11 @@ class RakeCommander
 
       def rake_comm_debug_random_object_id
         return false if @rake_comm_debug_random_object_id
+
         @rake_comm_debug_random_object_id = Array(1..20).sample.times.map do |i|
           i.to_s.tap(&:object_id)
         end
+
         true
       end
     end

data/lib/rake-commander/rake_task.rb

@@ -2,12 +2,13 @@ require_relative 'rake_context/wrapper'
 
 class RakeCommander
   module RakeTask
-    NAMESPACE_DELIMITER = /:/.freeze
+    NAMESPACE_DELIMITER = /:/
     INHERITABLE_ATTRS   = [:namespace].freeze
 
     class << self
       def included(base)
-        super(base)
+        super
+
         base.extend RakeCommander::Base::ClassHelpers
         base.extend RakeCommander::Base::ClassInheritable
         base.extend ClassMethods
@@ -25,6 +26,7 @@ class RakeCommander
       # @return [String] the description of the task
       def desc(str = :not_used)
         return @desc if str == :not_used
+
         @desc = str.to_s
       end
 
@@ -32,6 +34,7 @@ class RakeCommander
       # @return [Symbol] the task name
       def task(name = :not_used)
         return @task if name == :not_used
+
         @task = name.to_sym
       end
 
@@ -39,6 +42,7 @@ class RakeCommander
       # @return [String] the namespace defined for this `RakeCommander` class.
       def namespace(name = :not_used)
         return @namespace if name == :not_used
+
         @namespace = namespace_str(name)
       end
 
@@ -65,6 +69,7 @@ class RakeCommander
         block  = spaces.reverse.reduce(block) do |blk, nm|
           namespace_block(nm, &blk)
         end
+
         rake.namespace top, &block
       end
 
@@ -97,7 +102,10 @@ class RakeCommander
       def namespace_str(name)
         name = name.to_s   if name.is_a?(Symbol)
         name = name.to_str if name.respond_to?(:to_str)
-        raise ArgumentError, "Expected a String or Symbol for a namespace name. Given: #{name.class}" unless name.is_a?(String)
+
+        msg = "Expected a String or Symbol for a namespace name. Given: #{name.class}"
+        raise ArgumentError, msg unless name.is_a?(String)
+
         name
       end
 
@@ -144,7 +152,8 @@ class RakeCommander
     protected
 
     def install_task
-      return unless task_block = task_method
+      return unless (task_block = task_method)
+
       self.class.install_task(&task_block)
     end
 

data/lib/rake-commander/version.rb

@@ -1,3 +1,3 @@
 class RakeCommander
-  VERSION = '0.3.6'.freeze
+  VERSION = '0.4.1'.freeze
 end

data/rake-commander.gemspec

@@ -12,17 +12,18 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/rellampec/rake-commander"
   spec.licenses      = %w[MIT]
 
-  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.required_ruby_version = '>= 3.2.2'
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
   end
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = '>= 2.7.2'
-
-  spec.add_development_dependency "bundler",   ">= 2.4.9",  "< 3"
-  spec.add_development_dependency 'dotenv',    '>= 2.7.6',  '< 3'
+  spec.add_development_dependency 'dotenv',    '~> 3'
   spec.add_development_dependency "rake",      ">= 13.0.6", "< 14"
   spec.add_development_dependency "redcarpet", ">= 3.6.0",  "< 4"
   spec.add_development_dependency "rspec",     ">= 3.10.0", "< 4"

metadata

@@ -1,53 +1,27 @@
 --- !ruby/object:Gem::Specification
 name: rake-commander
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.4.1
 platform: ruby
 authors:
 - Oscar Segura Samper
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-15 00:00:00.000000000 Z
+date: 2025-02-20 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.4.9
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.4.9
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3'
 - !ruby/object:Gem::Dependency
   name: dotenv
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.7.6
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 2.7.6
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3'
 - !ruby/object:Gem::Dependency
@@ -158,8 +132,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".markdownlint.json"
 - ".rspec"
 - ".rubocop.yml"
+- ".ruby-version"
 - ".yardopts"
 - CHANGELOG.md
 - Gemfile
@@ -198,6 +174,7 @@ files:
 - lib/rake-commander/options/name.rb
 - lib/rake-commander/options/result.rb
 - lib/rake-commander/options/set.rb
+- lib/rake-commander/options/type.rb
 - lib/rake-commander/patcher.rb
 - lib/rake-commander/patcher/README.md
 - lib/rake-commander/patcher/application.rb
@@ -212,7 +189,8 @@ files:
 homepage: https://github.com/rellampec/rake-commander
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -221,14 +199,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.2
+      version: 3.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.12
+rubygems_version: 3.5.23
 signing_key:
 specification_version: 4
 summary: Classing rake tasks with options. Creating re-usable tasks, options and samples