bootinq 1.2.0 → 1.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 266e204b1e16ba81aaaf17e2ab6b638f2c33b1717a9c728e65332b6b2274e98d
-  data.tar.gz: 0f8210ddf0aae40d21ccc68b3964df30b7102ea35cb76c04779e3a2f48d0f9dd
+  metadata.gz: 4bbde8bd5a9047488c41a60788b57c99ffba1de61217a0e5ac6613a856e5fc66
+  data.tar.gz: 6932d67aa5b2f484726331b5f1483352bc1f6bd535ea187dabe13d7e909630ae
 SHA512:
-  metadata.gz: d8d3172c9a7a38e335585b0b1a35dc7bdaccbb993076095cd414a317f891d0506e6b0995b5e7eb4cdea9f885553658cd175219273a788db797994d63eca59a44
-  data.tar.gz: 182655c54c91a0a4cac2d7c17e5750e59e8941309a9ce492faddc1204f30e72a90c847f5e48e23ffb549cc9dc60ad4ed0c0b064eb92348960a6b85286380321b
+  metadata.gz: 48c42edfe5b1a4475ad65b5cec66e6a5a124073b6aea9b6fceeea94cc76ce3ddac1786c30f4c0290cbe677e40a677e4ce4350e080867d3a8032fd36a0552d12e
+  data.tar.gz: 95db837f38266267c0fe733edcd91ad51694ff8c5a90c849e1f28335637a385cda2de1ea1c285e5a6e8f8bb5f00be2e121b5ef27bbfe9213a3ecf17e97454c22

data/lib/bootinq.rb

@@ -4,6 +4,7 @@ require "yaml"
 require "singleton"
 require "forwardable"
 require "bootinq/component"
+require "bootinq/switch"
 
 # = Bootinq
 #
@@ -66,28 +67,36 @@ class Bootinq
   # :call-seq:
   #   Bootinq.require(*groups, verbose: false, &block)
   #
-  # The helper method to bootstrap the Bootinq.
-  # Sets the BOOTINQ_PATH enviroment variable if it is missing,
-  # invokes the <tt>Bootinq.setup</tt> method with the given verbose key argument & block,
-  # and, finally, gets Bundler to require the given groups.
+  # Invokes the <tt>Bootinq.init</tt> method with the given verbose key argument & block,
+  # and, finally, makes Bundler to require the given groups.
   def self.require(*groups, verbose: false, &block) # :yields: Bootinq.instance
-    ENV['BOOTINQ_PATH'] ||= File.expand_path('../bootinq.yml', caller_locations(1..1)[0].path)
-
-    setup(verbose: verbose, &block)
-
+    init(verbose: verbose, &block)
     Bundler.require(*instance.groups(*groups))
   end
 
   # :call-seq:
-  #   Bootinq.setup(verbose: false, &block) -> true or false
+  #   Bootinq.setup(*groups, verbose: false, &block)
   #
-  # Initializes itself. To track inquired components use <tt>verbose: true</tt> key argument.
+  # Invokes the <tt>Bootinq.init</tt> method with the given verbose key argument & block,
+  # and, finally, makes Bundler to setup the given groups.
+  def self.setup(*groups, verbose: false, &block) # :yields: Bootinq.instance
+    init(verbose: verbose, &block)
+    Bundler.setup(*instance.groups(*groups))
+  end
+
+  # :call-seq:
+  #   Bootinq.init(verbose: false, &block) -> true or false
+  #
+  # Initializes itself. Sets the BOOTINQ_PATH enviroment variable if it is missing.
+  # To track inquired components use <tt>verbose: true</tt> key argument.
   # Optionally yields block within the own instance's binding.
-  def self.setup(verbose: false, &block) # :yields: Bootinq.instance
+  def self.init(verbose: false, &block) # :yields: Bootinq.instance
+    ENV['BOOTINQ_PATH'] ||= File.expand_path('../bootinq.yml', caller_locations(2, 1)[0].path)
+
     instance
+    instance.instance_variable_set(:@_on_ready, block.to_proc) if block_given?
     puts "Bootinq: loading components #{instance.components.join(', ')}" if verbose
-    instance.instance_exec(&block) if block_given?
-    instance
+    instance.ready!
   end
 
   attr_reader :flags
@@ -110,6 +119,25 @@ class Bootinq
     config['mount'].each { |flag, name| enable_component(name, flag: flag, as: Mountable) }
   end
 
+  delegated def ready? # :no-doc:
+    !!@ready
+  end
+
+  # :call-seq:
+  #   Bootinq.ready! -> nil or self
+  #
+  # At the first call marks Bootinq as ready and returns the instance,
+  # otherwise returns nil.
+  delegated def ready!
+    return if ready?
+    @ready = true
+    if defined?(@_on_ready)
+      instance_exec(&@_on_ready)
+      remove_instance_variable :@_on_ready
+    end
+    freeze
+  end
+
   # :call-seq:
   #   Bootinq.enable_component(name, flag: [, as: Component])
   #
@@ -228,6 +256,22 @@ class Bootinq
     is_matched
   end
 
+  # :call-seq:
+  #   Bottinq.switch(*parts) { block } -> nil
+  #
+  # Collector method.
+  #
+  # Example:
+  #
+  #   Bootinq.switch do |part|
+  #     part.frontend { … }
+  #     part.backend { … }
+  #   end
+  delegated def switch # :yields: Bootinq::Switch.new
+    yield(Switch.new)
+    nil
+  end
+
   # Freezes every instance variables and the instance itself.
   def freeze
     @_value.freeze
@@ -236,10 +280,4 @@ class Bootinq
     @components.freeze
     super
   end
-
-  def self.new
-    super.freeze
-  end
-
-  private_class_method :new
 end

data/lib/bootinq/switch.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+class Bootinq
+  class Switch < ::BasicObject # :no-doc:
+    undef_method :==
+    undef_method :equal?
+
+    def raise(*args) # :no-doc:
+      ::Object.send(:raise, *args)
+    end
+
+    def method_missing(name, *)
+      if ::Bootinq.enabled?(name)
+        yield()
+      else
+        nil
+      end
+    end
+  end
+end

data/lib/bootinq/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bootinq
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.4.2
 platform: ruby
 authors:
 - Anton
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-24 00:00:00.000000000 Z
+date: 2020-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -58,6 +58,7 @@ files:
 - lib/bootinq.rb
 - lib/bootinq.yml
 - lib/bootinq/component.rb
+- lib/bootinq/switch.rb
 - lib/bootinq/version.rb
 homepage: https://github.com/estum/bootinq
 licenses:
@@ -78,8 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: Rails Boot Inquirer