hub_kernel 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e433f46a0cd33d7236e9f57f150a4c8e59b778a320c4dcf1252093a405fbcce
-  data.tar.gz: c8898bc61f4c65dd72a0008ca1dd75e36508102089636964c68da9ec4863115a
+  metadata.gz: d0aadeed46c5d7c19209c32b3fb4de077a80ebb2670d5f5545918fe3f9421e14
+  data.tar.gz: d3f57b2de645c719357101e13752b464b67c31ea38fa169281c7213c95c6f273
 SHA512:
-  metadata.gz: a453b3e41b68ba7f7b9c06b31546fb92ec0d840e6f949657a5a5ec6a8d4b4708d88c3fd21963bd37fe9ebb224362a69e4d287d20f65c24eb275d557dacdee923
-  data.tar.gz: 1eb7d7a09b26da2997ebee5145d148c5f98111fe8372b868e3bdb1290bc2decb401aa406fe6405844d9b0aa00527ef03101939482c970f0f7e3de35ad40da4d1
+  metadata.gz: 2b78566e883135e653f2638c2986ba74e14153443b56fd923a14a6dae50eef107acbdc9ccf6c96774d8c96fce7802497a2643f66c316f3186ef976a5bb031a85
+  data.tar.gz: a939a5363771f77fedf2f4c647a5e67287a6bef22fac61665a5d818f5667ed6a066fda7227efbd8b8a115f17ddbd197e14a271b8d82005d559df2bd5a19d0fdc

data/README.md

@@ -1,8 +1,32 @@
 # HubKernel
-Short description and motivation.
+Gives every hub in a Rails app one way to declare what it needs from another hub.
 
 ## Usage
-How to use my plugin.
+
+### Ports
+A port is something a hub needs from outside itself. The hub declares it by name,
+with the method its own code calls:
+
+```ruby
+module Supplies
+  extend HubKernel::Ports
+
+  port :spend_recorder, as: :record_spend
+end
+```
+
+The app fills each port with any callable, usually another hub's method:
+
+```ruby
+Rails.application.config.to_prepare do
+  Supplies.spend_recorder = Finance.method(:record_spend)
+end
+```
+
+`Supplies.record_spend(amount: 5)` then calls what the app filled the port with and
+returns its answer. An error it raises reaches the caller unchanged. Calling a port the
+app left unfilled raises `HubKernel::UnwiredPortError`, such as "Supplies' spend
+recorder is not wired".
 
 ## Installation
 Add this line to your application's Gemfile:

data/lib/hub_kernel/ports.rb

@@ -0,0 +1,21 @@
+require "active_support/core_ext/string/inflections"
+
+module HubKernel
+  class UnwiredPortError < StandardError; end
+
+  module Ports
+    def port(name, as:)
+      singleton_class.attr_writer name
+      define_singleton_method(name) { instance_variable_get(:"@#{name}") || unwired(name) }
+      define_singleton_method(as) { |*args, **options| public_send(name).call(*args, **options) }
+    end
+
+    private
+
+    def unwired(name)
+      ->(*, **) { raise UnwiredPortError, "#{hub_name} #{name.to_s.tr("_", " ")} is not wired" }
+    end
+
+    def hub_name = self.name.demodulize.then { |hub| hub.end_with?("s") ? "#{hub}'" : "#{hub}'s" }
+  end
+end

data/lib/hub_kernel/version.rb

@@ -1,3 +1,3 @@
 module HubKernel
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/hub_kernel.rb

@@ -4,6 +4,7 @@ require "hub_kernel/action"
 require "hub_kernel/answer"
 require "hub_kernel/follow_up"
 require "hub_kernel/markup"
+require "hub_kernel/ports"
 
 module HubKernel
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hub_kernel
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - tylercschneider
@@ -47,6 +47,7 @@ files:
 - lib/hub_kernel/events.rb
 - lib/hub_kernel/follow_up.rb
 - lib/hub_kernel/markup.rb
+- lib/hub_kernel/ports.rb
 - lib/hub_kernel/version.rb
 homepage: https://github.com/tylercschneider/hub_kernel
 licenses: