hub_kernel 0.22.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa846ab97d20c75f7e3dd54468262589d42a134aa487f54e4a54216861d73a2f
-  data.tar.gz: 2e85a76639b5cb385446786265d99f73be3fac6a701da33e038f49e8ae85b8df
+  metadata.gz: 278e7929cc3994d1e1149a5fa9ce387922748cb829f615e9bf56e52d960f1d06
+  data.tar.gz: b60a8992e16825e54d1c8f211e9ce09a814bfe4d0215d94bc40d8da77f74a281
 SHA512:
-  metadata.gz: 710c5a3a33ccbba307e5c2cc2327a329de79055dc6f8519f062b33cb3c15d154a458081461e7a72be2ab668bea993baee8804d8730f7b2771cd536e6c5207c54
-  data.tar.gz: 9db5be35d6a50094db6bf76811830b21308fcce941c86caaa4d6bc72adc36583441633a985f07cbea95a00ec895d0f84fdfc71266c1f210bd66b3400ade814d6
+  metadata.gz: 82a223294f8bbe74427019e44a38ef20678e8d6680d4e384e2c68be6322abe05da574dfa47dca5689d0ee31103ff903f841001906378842ed25aa81f1f6e5310
+  data.tar.gz: bb81b8f0de934af592603666605e30349170ac35bd89fe59a6903cf51e62a5e4cf0dc36070dd1dd44d9c201999efddfc46e79c45002698787e3b9015f99c7819

data/README.md

@@ -42,6 +42,11 @@ module may be defined in `app/models/` or in another hub's folder. A host with n
 
 Files under a hub's `lib/` folder, such as its generated event pack, are not loaded.
 
+Every hub module in a hub folder, a module that extends `HubKernel::Ports` or
+`HubKernel::Exposes`, is loaded at boot and again after each code reload, before the
+host's own `to_prepare` code runs. A hub the host's code never names is still on
+`HubKernel::Hubs.list` for the start check, and hub_kernel-interface still serves it.
+
 A hub folder's `views` are searched after the host's `app/views`, so a controller in the
 hub renders its templates from there, any view can render a hub partial by its usual
 path, and a template in `app/views` wins over one at the same path in a hub folder. A

data/lib/hub_kernel/crossings.rb

@@ -3,7 +3,6 @@ require "active_support/core_ext/string/inflections"
 
 module HubKernel
   class Crossings
-    HUB_MODULE = /extend HubKernel::(Ports|Exposes)\b/
     def initialize(owners: {}, shared: [], host_layer: nil, interfaces: {}, namespaces: {}, folder_files: [])
       @owners = owners
       @folder_classes = {}
@@ -27,7 +26,7 @@ module HubKernel
 
     def read_hub_modules(sources)
       sources.each do |path, source|
-        next unless source.match?(HUB_MODULE) && path.match?(HubFolders::CODE_PATH)
+        next unless HubFolders.hub_module?(path, source)
 
         @folder_interfaces[HubFolders.class_of(path)] = HubFolders.hub_of(path)
       end

data/lib/hub_kernel/engine.rb

@@ -15,5 +15,7 @@ module HubKernel
       views = HubFolders.view_paths(app.root)
       ActiveSupport.on_load(:action_controller) { append_view_path(views) }
     end
+
+    config.to_prepare { HubFolders.hub_modules(Rails.root).each(&:constantize) }
   end
 end

data/lib/hub_kernel/hub_folders.rb

@@ -1,10 +1,13 @@
 module HubKernel
   module HubFolders
+    class SharedController < StandardError; end
+
     ROOT = "hubs".freeze
     CODE = "app".freeze
 
     PATH = %r{\A#{ROOT}/([^/]+)/}
     CODE_PATH = %r{\A#{ROOT}/[^/]+/#{CODE}/[^/]+/}
+    HUB_MODULE = /extend HubKernel::(Ports|Exposes)\b/
 
     def self.folder(hub) = "#{ROOT}/#{hub}"
 
@@ -21,5 +24,19 @@ module HubKernel
     def self.view_paths(root) = Dir[root.join("#{code_glob}/views")]
 
     def self.helper_paths(root) = Dir[root.join("#{code_glob}/helpers")]
+
+    def self.hub_module?(path, source) = source.match?(HUB_MODULE) && path.match?(CODE_PATH)
+
+    def self.hub_modules(root)
+      Dir.glob("#{code_glob}/**/*.rb", base: root).select { |path| hub_module?(path, root.join(path).read) }.map { |path| class_of(path) }
+    end
+
+    def self.hub_of_controller(root, page)
+      controllers = Dir[root.join(code_glob, "controllers", "#{page}_controller.rb").to_s].sort
+      hubs = controllers.map { |controller| hub_of(Pathname(controller).relative_path_from(root).to_s) }
+      raise SharedController, "#{page}_controller.rb is in more than one hub folder: #{hubs.map { |hub| folder(hub) }.join(", ")}" if hubs.many?
+
+      hubs.first
+    end
   end
 end

data/lib/hub_kernel/kept_ports.rb

@@ -0,0 +1,24 @@
+require "active_support/concern"
+
+module HubKernel
+  module KeptPorts
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def keep_ports(&block)
+        define_method(:hubs_with_kept_ports) { Array(instance_exec(&block)) }
+      end
+    end
+
+    included do
+      setup { @kept_ports = hubs_with_kept_ports.to_h { |hub| [ hub, fillings_of(hub) ] } }
+      teardown { @kept_ports.each { |hub, fillings| fillings.each { |port, filling| hub.public_send(:"#{port}=", filling) } } }
+    end
+
+    private
+
+    def hubs_with_kept_ports = [ the_hub ]
+
+    def fillings_of(hub) = hub.port_names.to_h { |port| [ port, hub.instance_variable_get(:"@#{port}") ] }
+  end
+end

data/lib/hub_kernel/ports.rb

@@ -13,6 +13,8 @@ module HubKernel
       define_singleton_method(as) { |*args, **options| public_send(name).call(*args, **options) }
     end
 
+    def port_names = declared_ports.dup
+
     def unwired_ports
       declared_ports.reject { |name| instance_variable_get(:"@#{name}") }.map { |name| unwired_message(name) }
     end

data/lib/hub_kernel/records.rb

@@ -3,15 +3,21 @@ module HubKernel
     private
 
     def saved(record)
-      record.save ? record.id : refuse(record)
+      record.save ? record.id : refuse(record, "saved")
     end
 
     def removed(record)
-      record.destroy ? record.id : refuse(record)
+      record.destroy ? record.id : refuse(record, "deleted")
     end
 
-    def refuse(record)
-      raise Refused, record.errors.full_messages.to_sentence
+    def refuse(record, action)
+      raise Refused, refusal(record, action)
+    end
+
+    def refusal(record, action)
+      return record.errors.full_messages.to_sentence if record.errors.any?
+
+      "#{record.model_name.human} could not be #{action}"
     end
   end
 end

data/lib/hub_kernel/version.rb

@@ -1,3 +1,3 @@
 module HubKernel
-  VERSION = "0.22.0"
+  VERSION = "0.24.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hub_kernel
 version: !ruby/object:Gem::Version
-  version: 0.22.0
+  version: 0.24.0
 platform: ruby
 authors:
 - tylercschneider
@@ -64,6 +64,7 @@ files:
 - lib/hub_kernel/follow_up.rb
 - lib/hub_kernel/hub_folders.rb
 - lib/hub_kernel/hubs.rb
+- lib/hub_kernel/kept_ports.rb
 - lib/hub_kernel/markup.rb
 - lib/hub_kernel/ports.rb
 - lib/hub_kernel/records.rb