hub_kernel 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b68695ef96166801769081d8d607907cc32e6d215f798b6404dc8b13a1faab2
-  data.tar.gz: 2fb12e7fa8b2cf1e8246eea5204ae7b38f61c6b41e668e07c753e7f55f899bf1
+  metadata.gz: 8117d21e5e81d6489c16ee5315f636623eafbab7aa0bc9ebe3e25b66fd139cef
+  data.tar.gz: 82f9add4dde24ed15db4be6b649f39b9e9c047292760479b8da9fc8891d72ff5
 SHA512:
-  metadata.gz: 4cecfcff2e7565d73b3c047ff191cc57a1f1f73056727a644a82bcc6f07517678d370c8876abb7c6c97e10197d663d2f0fa046a1430939e38583a5e89dda7f7f
-  data.tar.gz: 7a83ad99b5cc838650469b8e436d6a8a7f3d70e2ac37685206e1a1094f98c987dde0b29044b52dc5def44b2392e2b3eb045332819bbe160581c028c27ae7df36
+  metadata.gz: 7bc2bfa185995e9773224c2d5570e7f7c9d7ed520409524289a40da34132331dfc03546d4c74036f03bad13dfe5d586a9fceac389e00cef0d0ba6456eca0396d
+  data.tar.gz: 7f6465796e50d486e907c0d0d682ca97c1fb69dd0a264ba44d54bb99e133cc78d062b316b4771912d68ca41b7696ad87b78984997ca93acec24392a2ff27aa80

data/README.md

@@ -44,6 +44,23 @@ It raises `HubKernel::UnwiredPortError` naming every unfilled port with its hub,
 line. Running it inside `to_prepare` checks again after every code reload, and a hub
 declared again on a reload stays on the list once.
 
+### The hub check
+A hub's own test can check that the app filled every one of its ports, so a missing
+fill shows in the suite rather than on the next start:
+
+```ruby
+require "hub_kernel/conformance/hub"
+
+class SuppliesHubTest < ActiveSupport::TestCase
+  include HubKernel::Conformance::Hub
+
+  hub { Supplies }
+end
+```
+
+The test fails and names each port the app left unfilled, and each port filled with
+something that cannot be called.
+
 ## Installation
 Add this line to your application's Gemfile:
 

data/lib/hub_kernel/conformance/hub.rb

@@ -0,0 +1,22 @@
+require "active_support/concern"
+
+module HubKernel
+  module Conformance
+    module Hub
+      extend ActiveSupport::Concern
+
+      class_methods do
+        def hub(&block)
+          define_method(:the_hub, &block)
+        end
+      end
+
+      included do
+        test "every port of the hub is filled with something that can be called" do
+          problems = the_hub.unwired_ports + the_hub.uncallable_ports
+          flunk problems.join("\n") if problems.any?
+        end
+      end
+    end
+  end
+end

data/lib/hub_kernel/ports.rb

@@ -17,6 +17,11 @@ module HubKernel
       declared_ports.reject { |name| instance_variable_get(:"@#{name}") }.map { |name| unwired_message(name) }
     end
 
+    def uncallable_ports
+      declared_ports.select { |name| instance_variable_get(:"@#{name}")&.respond_to?(:call) == false }
+        .map { |name| "#{hub_name} #{name.to_s.tr("_", " ")} is filled with something that cannot be called" }
+    end
+
     private
 
     def declared_ports = @declared_ports ||= []

data/lib/hub_kernel/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hub_kernel
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - tylercschneider
@@ -41,6 +41,7 @@ files:
 - lib/hub_kernel/answer.rb
 - lib/hub_kernel/authz.rb
 - lib/hub_kernel/conformance/action.rb
+- lib/hub_kernel/conformance/hub.rb
 - lib/hub_kernel/conformance/partial.rb
 - lib/hub_kernel/context.rb
 - lib/hub_kernel/engine.rb