bootinq 2.0 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1652380ae399a299061b4faa8b2372fec798e02ce9f1fc9b3ab3b1a035d779e
-  data.tar.gz: d2339a8385fad5b4aaca89a5c2992f0adf4c5205bb650a05eb2b92e52daa349f
+  metadata.gz: 6e377cd962a0467e2e6ea056674bae230612b823f667d780c9982d76ff4bbf0c
+  data.tar.gz: 402aef98700c975d26ef975c8e21fef639138dc03b5adb93c54f8e85e3b5a44f
 SHA512:
-  metadata.gz: a08526e07966f344034a18f42d032a996ab5fc97db980b3a356a3b0b4173b6e6d98ecc345a6ab80d77ec7f9e30aca2641e75b029553a3c3d45bfbceaf1ab5c8d
-  data.tar.gz: 850ee258bc77e6889b7a3ee5969f4befdf1ff217cb5eb1f5e70af1a3bce7b0c6c0191d2c0a87a7e5ce3d6d8f42611a3480f19bde7b7b002695133d39413eca60
+  metadata.gz: 78dffcca879fd25017dc6d09fdd33f5bfdbd5878922a7c705d10f0ccd07cd703bede9e2d5e2e06ccc8c18bcdc21e091fc9efb7611e8f7d0b69193bfe4f951676
+  data.tar.gz: e6aeda4ed1293fb720a9998d79dd877bc36cff136fc78b9bcf420b8dd2f9a322fe573014303c4572c0bde882c327d6d66d7c127ec0983403fa0693ab43047d0e

data/lib/bootinq/component.rb

@@ -2,90 +2,306 @@
 
 class Bootinq
   class Component
-    attr_reader :intern, :id2name, :group
+    # @!attribute [r] intern
+    #   @return [Symbol]
 
-    alias :to_sym   :intern
-    alias :to_s     :id2name
-    alias :gem_name :id2name
-    alias :name     :id2name
+    attr_reader :intern
 
+    # @!attribute [r] id2name
+    #   @return [Symbol]
+
+    attr_reader :id2name
+
+    # @!attribute [r] group
+    #   @return [Symbol] Bundle group name
+
+    attr_reader :group
+
+    alias_method :to_sym, :intern
+    alias_method :to_s, :id2name
+    alias_method :gem_name, :id2name
+    alias_method :name, :id2name
+
+    # @see #initialize
+    # @param intern [String, Symbol]
+    # @return [Bootinq::Component] frozen
+    def self.new(intern)
+      super.freeze
+    end
+
+    # @param intern [String, Symbol]
+    # @return [self]
     def initialize(intern)
-      @intern  = intern.to_sym
+      @intern = intern.to_sym
       @id2name = intern.to_s.freeze
-      @group   = :"#@id2name\_boot"
-      freeze
+      @group = :"#{@id2name}_boot"
     end
 
+    # @return [Boolean]
     def mountable?
       false
     end
 
+    # @return [Symbol]
     def module_name
       @id2name.camelcase.to_sym
     end
 
+    # @return [Module]
+    def namespace
+      Object.const_get(module_name)
+    end
+
+    # @return [void]
     def engine
     end
 
+    # @param klass [Class]
+    # @return [Boolean]
     def kind_of?(klass)
       super || @intern.kind_of?(klass)
     end
 
-    def == other
+    ##
+    # @!group Coercing methods
+
+    # Coerces self to other value klass.
+    # @overload coerce_to(string)
+    #   @param string [String]
+    #   @return [String] {#id2name}
+    # @overload coerce_to(symbol)
+    #   @param symbol [Symbol]
+    #   @return [Symbol] {#intern}
+    # @overload coerce_to(other)
+    #   @param other [Any]
+    #   @return [self]
+    def coerce_to(other)
       case other
-      when String then other == @id2name
-      when Symbol then other == @intern
-                  else super
+      when String; @id2name
+      when Symbol; @intern
+      else self
       end
     end
 
-    def ===(other)
+    # Coerces other value
+    # @overload coerce(symbol)
+    #   @param symbol [Symbol]
+    #   @return [Symbol] symbol
+    # @overload coerce(other)
+    #   @param other [String, Any]
+    #   @return [String] other
+    def coerce(other)
       case other
-      when String then other === @id2name
-      when Symbol then other === @intern
-                  else super
+      when String, Symbol; other
+      else other.to_s
       end
     end
 
+    # @!endgroup
+    ##
+
+    ##
+    # @!group Comparation methods
+
+    # @param other [Any]
+    # @return [Boolean]
+    def ==(other)
+      other = coerce(other)
+      other == coerce_to(other)
+    end
+
+    # @param other [Any]
+    # @return [Boolean]
+    def ===(other)
+      other = coerce(other)
+      other === coerce_to(other)
+    end
+
+    # @param other [Any]
+    # @return [Boolean]
     def casecmp(other)
-      case other
-      when String then @id2name.casecmp(other)
-      when Symbol then @intern.casecmp(other)
-      when self.class then casecmp(other.to_s)
-      end
+      other = coerce(other)
+      coerce_to(other).casecmp(other)
     end
 
+    # @param other [Any]
+    # @return [Boolean]
     def casecmp?(other)
-      case other
-      when String then @id2name.casecmp?(other)
-      when Symbol then @intern.casecmp?(other)
-      when self.class then casecmp?(other.to_s)
-      end
+      other = coerce(other)
+      coerce_to(other).casecmp?(other)
+    end
+
+    # @!endgroup
+    ##
+
+    ##
+    # @!group Symbol-delegated methods
+
+    # @return [String] representation of {#intern} as a symbol literal.
+    def inspect
+      @intern.inspect
+    end
+
+    # @return [Proc] responded to the given method by {#intern}
+    def to_proc
+      @intern.to_proc
     end
 
-    %i(inspect to_proc __id__ hash).
-      each { |sym| class_eval %(def #{sym}; @intern.#{sym}; end), __FILE__, __LINE__ + 1 }
+    # @return [Integer] identifier for {#intern}
+    def __id__
+      @intern.__id__
+    end
 
-    %i(encoding empty? length).
-      each { |sym| class_eval %(def #{sym}; @id2name.#{sym}; end), __FILE__, __LINE__ + 1 }
+    # @return [Integer] {#intern}'s hash
+    def hash
+      @intern.hash
+    end
 
-    %i(match match? =~ []).
-      each { |sym| class_eval %(def #{sym}(*args); @id2name.#{sym}(*args); end), __FILE__, __LINE__ + 1 }
+    # @!endgroup
+    ##
 
-    %i(upcase downcase capitalize swapcase succ next).
-      each { |sym| class_eval %(def #{sym}; self.class.new(@intern.#{sym}); end), __FILE__, __LINE__ + 1 }
+    ##
+    # @!group String-delegated methods
 
-    alias :slice :[]
-    alias :size :length
+    # @return [Encoding] of {#id2name}
+    def encoding
+      @id2name.encoding
+    end
+
+    # @return [Boolean]
+    def empty?
+      @id2name.empty?
+    end
+
+    # @return [Integer] length of {#id2name}
+    def length
+      @id2name.length
+    end
+
+    # @param pattern [Regexp, String]
+    # @param start_from [Integer] position in {#id2name} to begin the search
+    # @yield [MatchData] if match succeed
+    # @yieldreturn [Any]
+    # @return [MatchData] unless block given
+    # @return [Any] returned by the given block
+    def match(*args, &block)
+      @id2name.match(*args, &block)
+    end
+
+    # @param pattern [Regexp, String]
+    # @param start_from [Integer] position in {#id2name} to begin the search
+    # @return [Boolean] indicates whether the regexp is matched or not
+    def match?(*args)
+      @id2name.match?(*args)
+    end
+
+    # @overload =~(pattern)
+    #   @param pattern [Regexp]
+    #   @return [Integer] if matched, the position the match starts
+    #   @return [nil] if there is no match
+    # @overload =~(arg)
+    #   @param arg [Object]
+    #   @see Object#=~
+    def =~(arg)
+      @id2name =~ arg
+    end
+
+    # Element reference
+    # @see String#slice
+    def slice(*args)
+      @id2name[*args]
+    end
+
+    alias_method :[], :slice
+
+    # @!endgroup
+    ##
+
+    ##
+    # @!group Symbol-delegated mutation methods
+
+    # @see Symbol#upcase
+    # @return [Bootinq::Component] new instance with upcased {#intern}
+    def upcase
+      self.class.new(@intern.upcase)
+    end
+
+    # @see Symbol#downcase
+    # @return [Bootinq::Component] new instance with downcased {#intern}
+    def downcase
+      self.class.new(@intern.downcase)
+    end
+
+    # @see Symbol#capitalize
+    # @return [Bootinq::Component] new instance with capitalized {#intern}
+    def capitalize
+      self.class.new(@intern.capitalize)
+    end
+
+    # @see Symbol#swapcase
+    # @return [Bootinq::Component] new instance with swapcased {#intern}
+    def swapcase
+      self.class.new(@intern.swapcase)
+    end
+
+    # @see Symbol#succ
+    # @return [Bootinq::Component] new instance with the successor {#intern}
+    def succ
+      self.class.new(@intern.succ)
+    end
+
+    # @see Symbol#next
+    # @return [Bootinq::Component] new instance with the next {#intern}
+    def next
+      self.class.new(@intern.next)
+    end
+
+    # @endgroup
+    ##
   end
 
   class Mountable < Component
+    # @!attribute [r] module_name
+    #   @return [Symbol]
+
+    # @!attribute [r] namespace
+    #   @return [Module]
+
+    def initialize(intern)
+      super
+      @module_name = module_name()
+      @namespace = namespace()
+    end
+
     def mountable?
       true
     end
 
+    def module_name
+      return @module_name if frozen? || defined?(@module_name)
+      super
+    end
+
+    def namespace
+      if frozen? || defined?(@namespace)
+        @namespace.is_a?(Proc) ? @namespace.call : @namespace
+      elsif namespace_defined?
+        super
+      else
+        proc { super }
+      end
+    end
+
+    # @return [Class]
     def engine
-      Object.const_get(module_name)::Engine
+      namespace::Engine
+    end
+
+    private
+
+    # @api private
+    def namespace_defined?
+      Object.const_defined?(module_name)
     end
   end
 end

data/lib/bootinq/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Bootinq
-  VERSION = "2.0"
+  VERSION = "2.0.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bootinq
 version: !ruby/object:Gem::Version
-  version: '2.0'
+  version: 2.0.1
 platform: ruby
 authors:
 - Anton
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-10-26 00:00:00.000000000 Z
+date: 2022-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler