hub_kernel-interface 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0080a27457d5f374c3c92fbbeeecbd3ad8e1c6543e2274634cb14df708626c0
-  data.tar.gz: 76609fd82439a9b52510439ab93ed23d81f222edd14a3aa9f2d3276a5bc7aa76
+  metadata.gz: a110bf3b15c7fbe91d280d688cadadb134e3e2ab7bbf2ef513d56b23ccbb94d6
+  data.tar.gz: eed0d2ced815810fb69566fcf8d23782855a9034c5ff4e9d498c9b18c82ca165
 SHA512:
-  metadata.gz: 1c9820a93999b13cf6895dc4b5a10622210aa656b9ec078650790886079dee7a149f507e47c973275e7ab41ceb375e08f0d5fa8246dc62ad39f02f8a84811af0
-  data.tar.gz: 7c9f45f51ebac824991737b2170e48c7665788d5ed30d4f3d2f98b6bd5db820e1fa2afa278abc48e7bc9d10ab8bcfe8d01644823d5682bd6f74dde37dc8fe16b
+  metadata.gz: ce020e02f3fb14ac881793f935ddb4f2e25f5f9a848da3c15a7ebb8e64a285dcda66f235fe19bcda4fee37316e0d34bc00cbb191de458f08c890083644a6190c
+  data.tar.gz: e3468ec19dc532b3a6092084f9e7bb07d20a78072679f86976a946be4dd2ad439d4934add1168d2338a28b450659910f6ccd8a06c425ce3f72214c326a72f316

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

data/lib/hub_kernel/exposes.rb

@@ -12,11 +12,16 @@ module HubKernel
   class Refused < StandardError; end
 
   module Exposes
-    Exposed = Data.define(:name, :takes, :writes)
+    Exposed = Data.define(:name, :takes, :writes, :earlier_answers, :answer_shape) do
+      def earlier_answer(major) = earlier_answers.find { |earlier| earlier.major == major }
+    end
+    EarlierAnswer = Data.define(:major, :translation, :answer_shape) do
+      def translate(answer) = translation.call(answer)
+    end
 
-    def exposes(name, takes:, writes:)
+    def exposes(name, takes:, writes:, earlier_answers: {}, answer_shape: nil)
       Interface::ExposingHubs.add(self)
-      exposed_methods[name.to_s] = Exposed.new(name: name, takes: takes, writes: writes)
+      exposed_methods[name.to_s] = Exposed.new(name: name, takes: takes, writes: writes, earlier_answers: earlier_answers.map { |major, declared| earlier_answer_from(major, declared) }, answer_shape: answer_shape)
     end
 
     def exposed(name) = exposed_methods[name.to_s]
@@ -54,6 +59,12 @@ module HubKernel
 
     def exposing_hub = name.demodulize
 
+    def earlier_answer_from(major, declared)
+      return EarlierAnswer.new(major: major, translation: declared, answer_shape: nil) if declared.respond_to?(:call)
+
+      EarlierAnswer.new(major: major, translation: declared[:translation], answer_shape: declared[:answer_shape])
+    end
+
     def refuse_without_caller(person, account)
       raise MissingArgumentError, "A call by name needs a person" if person.nil?
       raise MissingArgumentError, "A call by name needs an account" if account.nil?

data/lib/hub_kernel/interface/version.rb

@@ -1,5 +1,5 @@
 module HubKernel
   module Interface
-    VERSION = "0.8.0"
+    VERSION = "0.10.0"
   end
 end

data/lib/hub_kernel/interface.rb

@@ -2,6 +2,7 @@ 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
@@ -9,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.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - tylercschneider