hub_kernel-interface 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7cdd56bbaa3af1615fe903a0002571152377ba8b56a5c23c86034c9352c4de2
-  data.tar.gz: b90f842a3e3f3b41557cda49bd8c7b9bee47b83c0f1ead77af2519cda26dcbd0
+  metadata.gz: aa94379e01e0ee039f41a4781b67f39ad4ad030ec77f0b4782f7c567b74a8002
+  data.tar.gz: 3b589b03f7b4ebe8d853943297e617aa9179d00fc53d3c0bd46ee428e3f5ca5a
 SHA512:
-  metadata.gz: c31921614b4f23ec6893f283618933eed79fdff334cbf86a09b8531ccbe62d6bcfd7137c16f70ff216bd0923409b11b72ffb56900fd8cc8a8941c1d6c8b19aa4
-  data.tar.gz: 5206997bce3a5916d0ca85e599484541f69fee6e9d08cda7647ac684f539a7dcd23f9fc12e6422be34e6cd48614d5b01e81ea347a33c00d117e7180d47e9247e
+  metadata.gz: 0c4701fdf78fe037fdaf67ac3694ba07ff7d1c6d7bf4479bded9f131f56a886876feba0334cf89a6328da5604a621bec573261d9ff31d6e4b18a5850909d9e6f
+  data.tar.gz: d087e461324a72ac89c1262dd9bae5d84abde0af484a2c894b38b72bb7f8063c604a30a93d8b44947d9b6b83686b95373e196aa2bc725b76ef89318c943c9826

data/README.md

@@ -40,9 +40,11 @@ for a missing person, account or required value. A hub refuses with `HubKernel::
 reason a person can read. A call made while the permission check or the account scope is unset
 raises `HubKernel::UnwiredPortError`.
 
-The host names the hubs every interface serves, once. A hub listed alone is served at its
+Every interface serves every hub that exposes a method, each at its module name in snake
+case, unless the host names the hubs to serve, once. A hub listed alone is served at its
 module name in snake case, and a hub listed as a one-pair hash is served only at the name
-given. An interface gem finds the hub served at a name, or `nil` when none is:
+given. Setting the list to `nil` serves every exposing hub again. An interface gem finds the
+hub served at a name, or `nil` when none is:
 
 ```ruby
 HubKernel::Interface.hubs = [ Supplies, { "money" => Billing::Ledger } ]
@@ -55,6 +57,14 @@ HubKernel::Interface.served           # => { "supplies" => Supplies, "money" =>
 The permission check is still asked about a hub served under a chosen name by its own name,
 such as `ledger:record_spend`.
 
+The host names the methods that give the calling person and account once, here, for an
+interface gem to read:
+
+```ruby
+HubKernel::Interface.person_method = :hub_person
+HubKernel::Interface.account_method = :hub_account
+```
+
 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
@@ -86,6 +96,11 @@ declares an exposed method.
 gem "hub_kernel-interface"
 ```
 
+hub_kernel releases before 0.19.0 define this contract themselves. Loading hub_kernel-interface
+beside one raises `HubKernel::Interface::OlderHubKernelError`, which names the hub_kernel
+release to upgrade to. An app with no hub_kernel, or with hub_kernel 0.19.0 or later, loads it
+as usual.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/hub_kernel/interface/hub_kernel_release.rb

@@ -0,0 +1,15 @@
+module HubKernel
+  module Interface
+    class OlderHubKernelError < StandardError; end
+
+    module HubKernelRelease
+      FIRST_BUILT_ON_INTERFACE = Gem::Version.new("0.19.0")
+
+      def self.refuse_older!(spec)
+        return if spec.nil? || spec.version >= FIRST_BUILT_ON_INTERFACE
+
+        raise OlderHubKernelError, "hub_kernel #{spec.version} still defines the contract hub_kernel-interface holds, so upgrade hub_kernel to #{FIRST_BUILT_ON_INTERFACE} or later"
+      end
+    end
+  end
+end

data/lib/hub_kernel/interface/version.rb

@@ -1,5 +1,5 @@
 module HubKernel
   module Interface
-    VERSION = "0.7.0"
+    VERSION = "0.9.0"
   end
 end

data/lib/hub_kernel/interface.rb

@@ -1,5 +1,8 @@
 require "hub_kernel/interface/version"
+require "hub_kernel/interface/hub_kernel_release"
+HubKernel::Interface::HubKernelRelease.refuse_older!(Gem.loaded_specs["hub_kernel"])
 require "hub_kernel/exposes"
+require "hub_kernel/interface/exposing_hubs"
 require "hub_kernel/interface/call_reasons"
 
 module HubKernel
@@ -7,8 +10,9 @@ module HubKernel
     class UnservableHubError < StandardError; end
 
     singleton_class.attr_writer :hubs
+    singleton_class.attr_accessor :person_method, :account_method
 
-    def self.hubs = @hubs ||= []
+    def self.hubs = @hubs || ExposingHubs.list.dup
 
     def self.find(name) = served[name]
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hub_kernel-interface
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - tylercschneider
@@ -42,6 +42,7 @@ files:
 - lib/hub_kernel/interface.rb
 - lib/hub_kernel/interface/call_reasons.rb
 - lib/hub_kernel/interface/exposing_hubs.rb
+- lib/hub_kernel/interface/hub_kernel_release.rb
 - lib/hub_kernel/interface/version.rb
 - the_local/agents/hub_kernel-interface-develop.md
 - the_local/agents/hub_kernel-interface-info.md