hub_kernel-api 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e54d19b67798c82119ecff94f0f294353cd927da83a55282b2f61ffbf111061d
-  data.tar.gz: 1d48fc7eb9520cb6300315462a74159b68a0e236c797f87d97964c4455eefce1
+  metadata.gz: 005a2ef443ca851aa60b1e07bbf00d20f36ad682a7dcba572fcb2c5847181831
+  data.tar.gz: 3da76e3b5993936cc999d4641e2d4b70476a8fb7d86451294a7a5f583b85fb0c
 SHA512:
-  metadata.gz: fa3f514ecb094b92a30e80fc390414abf616e68c8b479485462d5f7298d77cab57f3d813ced143fbafc58330f8685a7cac2d94aad14693a006730ff0c0ba6060
-  data.tar.gz: 07c3ae8786feb3ad091474071d2dc7699ee8cc0b7ebb798f95cd53c7afaac53096e7df8d261bbd5c1e01ba4f13a613998b40cea868c4afccabcc12a0789c0fe9
+  metadata.gz: 36883d22bb606c36eca8c7e80620d1a8c07105254f41152a87e28c4317f91ff23ec58f5a6aa17971d106577695f25f2e8c5e3aa8b329108303a0ca8f341326fb
+  data.tar.gz: 78348ad9a3c18cffff53beadc24f99a15a5d0b4524a592da883e807966648bef9f550945bd059cacc60e03d60084bed3c0d8a8ead26c7d702baaca0c43eabaeb

data/README.md

@@ -17,9 +17,15 @@ HubKernel::Api.account_method = :current_account
 
 Rails.application.config.to_prepare do
   HubKernel::Api.hubs = [ Supplies ]
+  HubKernel::Api.check!
 end
 ```
 
+`HubKernel::Api.check!` raises `HubKernel::Api::UnservableHubError` when a served entry
+exposes no methods, when two served hubs answer at the same address, or when a served
+hub's exposed list has a problem, naming each. Inside `to_prepare` it runs again after
+every code reload.
+
 The base controller's own sign-in runs before every call. hub_kernel's permission check
 and account scope must also be set, as hub_kernel's readme describes. Mount the engine:
 

data/lib/hub_kernel/api/version.rb

@@ -1,5 +1,5 @@
 module HubKernel
   module Api
-    VERSION = "0.4.0"
+    VERSION = "0.5.0"
   end
 end

data/lib/hub_kernel/api.rb

@@ -4,6 +4,8 @@ require "hub_kernel/api/engine"
 
 module HubKernel
   module Api
+    class UnservableHubError < StandardError; end
+
     mattr_accessor :hubs, default: []
     mattr_accessor :base_controller, default: "ActionController::API"
     mattr_accessor :person_method
@@ -11,6 +13,24 @@ module HubKernel
 
     def self.find(name) = addresses[name]
 
-    def self.addresses = hubs.reduce({}) { |found, entry| found.merge(entry.is_a?(Hash) ? entry : { entry.name.demodulize.underscore => entry }) }
+    def self.check!
+      problems = unexposed_hubs + shared_addresses + exposure_problems
+      raise UnservableHubError, problems.join("\n") if problems.any?
+    end
+
+    def self.addresses = served.to_h
+
+    def self.served = hubs.flat_map { |entry| entry.is_a?(Hash) ? entry.to_a : [ [ entry.name.demodulize.underscore, entry ] ] }
+
+    def self.unexposed_hubs = served.map(&:last).reject { |hub| hub.respond_to?(:exposures) }.map { |hub| "#{hub.name} exposes no methods to serve" }
+
+    def self.shared_addresses
+      served.group_by(&:first).select { |_address, entries| entries.size > 1 }.map do |address, entries|
+        "#{entries.map { |_address, hub| hub.name }.join(" and ")} both answer at #{address}"
+      end
+    end
+
+    def self.exposure_problems = served.map(&:last).select { |hub| hub.respond_to?(:exposure_problems) }.flat_map(&:exposure_problems)
+    private_class_method :served, :unexposed_hubs, :shared_addresses, :exposure_problems
   end
 end

metadata

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