hub_kernel-interface 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fcf68ba40018916adda2764b12c9b576a9650aa5c3c954fae85e0e59c63a6d32
-  data.tar.gz: 531acede6b1476e7847f2ede96bafb3cfb2685cb2c30c5fe816f71250f739951
+  metadata.gz: 9385ca6b5908cfc7854200c351dd6f6cbe30a90c850d14a7519c4e73a5d2eeeb
+  data.tar.gz: 199574b3bc71a071a97670a97dd8ab08747945b45216d1eac24d21f22ffa965a
 SHA512:
-  metadata.gz: f9d0f6e042f40f9aece6780b756505ae52047dabe7d64a1e54c893f9508c861a4763d1babfb8dfa766ccb60f39ef6d5e2606b1d0b8114243fbc62f7fdbc1aca4
-  data.tar.gz: 6d41d5ddbbfa3ce0e315e22604ac85a8312b95ee0cdb19f7bf5b9c60a9a47791f996b74e0dc06b0dc4a6b8a940131f5222cfb343e1722fe4df915edccc1e8d77
+  metadata.gz: 96ef67da95a65e5fd1f26c3fc6ef25e9ad0a9fb28a742b03ce2399aefb5360ccddcb4c764c04a2255b685b542a1d612937163b252b47ee7c2eb7cc2888688618
+  data.tar.gz: e36173e0a4b7f957323969718216df7c7c0ca5083ba1852ac094c77d75579b9da986e64c8c11c996e4efb139379d77a08862b773f557820f0b1f13532df09fc3

data/README.md

@@ -49,11 +49,17 @@ HubKernel::Interface.hubs = [ Supplies, { "money" => Billing::Ledger } ]
 
 HubKernel::Interface.find("supplies") # => Supplies
 HubKernel::Interface.find("money")    # => Billing::Ledger
+HubKernel::Interface.served           # => { "supplies" => Supplies, "money" => Billing::Ledger }
 ```
 
 The permission check is still asked about a hub served under a chosen name by its own name,
 such as `ledger:record_spend`.
 
+An interface gem's boot check runs `HubKernel::Interface.check!`, which raises
+`HubKernel::Interface::UnservableHubError` naming every problem in the served list at once:
+an entry that exposes no methods, two entries that answer at the same name, and each
+problem in a served hub's exposed list.
+
 `Supplies.exposure_problems` names each exposed method the hub has no method for, or lists
 with values it does not take. `HubKernel::Interface::ExposingHubs.list` holds every hub that
 declares an exposed method.

data/lib/hub_kernel/interface/version.rb

@@ -1,5 +1,5 @@
 module HubKernel
   module Interface
-    VERSION = "0.2.0"
+    VERSION = "0.4.0"
   end
 end

data/lib/hub_kernel/interface.rb

@@ -3,13 +3,32 @@ require "hub_kernel/exposes"
 
 module HubKernel
   module Interface
+    class UnservableHubError < StandardError; end
+
     singleton_class.attr_writer :hubs
 
     def self.hubs = @hubs ||= []
 
-    def self.find(name) = served.to_h[name]
+    def self.find(name) = served[name]
+
+    def self.check!
+      problems = unexposed_hubs + shared_names + exposure_problems
+      raise UnservableHubError, problems.join("\n") if problems.any?
+    end
+
+    def self.unexposed_hubs = served.values.reject { |hub| hub.respond_to?(:exposures) && hub.exposures.any? }.map { |hub| "#{hub.name} exposes no methods to serve" }
+
+    def self.shared_names
+      served_pairs.group_by(&:first).select { |_name, pairs| pairs.size > 1 }.map do |name, pairs|
+        "#{pairs.map { |_name, hub| hub.name }.join(" and ")} both answer at #{name}"
+      end
+    end
+
+    def self.exposure_problems = served.values.select { |hub| hub.respond_to?(:exposure_problems) }.flat_map(&:exposure_problems)
+
+    def self.served_pairs = hubs.flat_map { |entry| entry.is_a?(Hash) ? entry.to_a : [ [ entry.name.demodulize.underscore, entry ] ] }
+    private_class_method :unexposed_hubs, :shared_names, :exposure_problems, :served_pairs
 
-    def self.served = hubs.flat_map { |entry| entry.is_a?(Hash) ? entry.to_a : [ [ entry.name.demodulize.underscore, entry ] ] }
-    private_class_method :served
+    def self.served = served_pairs.to_h
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hub_kernel-interface
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - tylercschneider