dispatio 1.1.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a460ddbac24649ff60c70b11b27d766a2fb5a748d682ced095e9933604200a96
-  data.tar.gz: 6449b86f7f5269661ed558b37bc3752d91f24f3b4d875ddb561a59f1975ba862
+  metadata.gz: 1291fe6d6ec352d090a78afae44e98656c14026566448a039065f7b58cd9cdf2
+  data.tar.gz: 4e70a7cfd9125425d432c70d5eeb3df8829163ce19496378db877b9e8e7edbd2
 SHA512:
-  metadata.gz: 82ced686161c8adf45614813ad55425f473efbd8af2ebb1438739ab2570d76e0815fda45056b49aee9cede82139a15afa9ab9f85b4495e3c83bb4618a77b606c
-  data.tar.gz: ebf88bb77dcfeecbf073ab56d04543bfe5185b4a938082ab30fb7b3149d9f1fa49b73c0e95773e45cf33cd1a932d8ecd22c4b164f9448a322081d0723f46e042
+  metadata.gz: '08a3866d4918d6124b60399e0657e3e307647635a0105c9ff2ed54cb679eee236854e7e68ef6bee18939997bf7700cbe50fec87120dbe022b9f6c314da57a81f'
+  data.tar.gz: eb83b8f0fb6a6609f44e0f21333645269617c55dd952d43e85c6ae3a6800b020db65d606d629f4efc97e4d770472204a7c81d4a5f7e8bba29fc58b52c9c098f8

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 # dispatio GHANGELOG.md
 
 
+## dispatio 1.2.1  released 2026-09-13
+
+* Accept implicit `_suffix`
+* Fix suffix:
+
+
+## dispatio 1.2.0  released 2026-09-13
+
+* Introduce prefix: or suffix:
+
+
 ## dispatio 1.1.0  released 2026-09-12
 
 * Focus on #call, alias #dispatch to it

data/README.md

@@ -5,6 +5,44 @@
 
 A stupid dispatch table tool.
 
+```ruby
+require 'dispatio'
+
+class MyClass
+
+  def consume(type, msg)
+
+    (@ctable ||= Dispatio.make_table(self, 'consume_').call(type, msg)
+      # or
+    #(@ctable ||= Dispatio.make_table(self, prefix: 'consume_').call(type, msg)
+  end
+
+  def post(type, msg)
+
+    (@ptable ||= Dispatio.make_table(self, '_post').call(type, msg)
+      # or, more explicitely
+    #(@ptable ||= Dispatio.make_table(self, suffix: '_post').call(type, msg)
+  end
+
+  protected
+
+  def consume_this(msg)
+    # ...
+  end
+  def consume_that(msg)
+    # ...
+  end
+  def this_post(msg)
+    # ...
+  end
+  def that_post(msg)
+    # ...
+  end
+end
+```
+
+The `Dispatio.make_table(klass, prefix_or_opts)` creates a dispatch table by enumerating the matching (prefix or suffix) methods. One can then `call` (or `dispatch`) the table to call the corresponding method.
+
 
 ## against an instance
 
@@ -20,6 +58,7 @@ class Foo
     #dtable.(name, data)        #
     #dtable[name].call(data) # or
     #dtable[name].(data)     #
+    #dtable[name][data]      #
       #
       # just use the one you like
   end
@@ -35,6 +74,8 @@ class Foo
   end
 
   def dtable; @dtable ||= Dispatio.make_table(self, 'validate_'); end
+    # or
+  #def dtable; @dtable ||= Dispatio.make_table(self, prefix: 'validate_'); end
 end
 
 foo = Foo.new
@@ -64,6 +105,7 @@ class Bar
       #dtable.(name, data)        #
       #dtable[name].call(data) # or
       #dtable[name].(data)     #
+      #dtable[name][data]      #
         #
         # just use the one you like
     end
@@ -79,6 +121,8 @@ class Bar
     end
 
     def dtable; @dtable ||= Dispatio.make_table(self, 'validate_'); end
+      # or
+    #def dtable; @dtable ||= Dispatio.make_table(self, prefix: 'validate_'); end
   end
 end
 

data/lib/dispatio.rb

@@ -1,20 +1,42 @@
 
 module Dispatio
 
-  VERSION = '1.1.0'.freeze
+  VERSION = '1.2.1'.freeze
 
   class << self
 
-    def make_table(point, prefix)
+    def make_table(point, prefix_or_opts)
+
+      opts =
+        case poo = prefix_or_opts
+        when /\A_/ then { suffix: poo }
+        when String then { prefix: poo }
+        else poo; end
+
+      fail(
+        ArgumentError,
+        "2nd arg to Dispatio.make_table must be a string or option hash"
+      ) unless opts.is_a?(Hash)
+
+      optklas = [ opts[:prefix], opts[:suffix] ].compact.map(&:class).uniq
+        #
+      fail(
+        ArgumentError,
+        "missing or invalid prefix: or suffix: option"
+      ) unless optklas == [ String ]
 
       Dispatio::Table.new(
-        prefix,
+        opts,
         point
           .methods
-          .select { |m|
-            m.to_s.start_with?(prefix) }
           .inject({}) { |h, m|
-            h[m.to_s[prefix.length..-1]] = point.method(m)
+            if px = opts[:prefix]
+              h[m.to_s[px.length..-1]] = point.method(m) \
+                if m.to_s.start_with?(px)
+            else; sx = opts[:suffix]
+              h[m.to_s[0..-(sx.length + 1)]] = point.method(m) \
+                if m.to_s.end_with?(sx)
+            end
             h }
       ).freeze
     end
@@ -22,9 +44,9 @@ module Dispatio
 
   class Table
 
-    def initialize(prefix, table)
+    def initialize(opts, table)
 
-      @prefix = prefix
+      @opts = opts
       @table = table.freeze
     end
 
@@ -35,9 +57,16 @@ module Dispatio
 
     def call(name, *args, **opts, &block)
 
-      ( self[name] ||
-        fail(NoMethodError.new("no :#{@prefix}#{name} method"))
-          ).call(*args, **opts, &block)
+      m = self[name]
+
+      fail(
+        NoMethodError,
+        @opts[:prefix] ?
+          "no :#{@opts[:prefix]}#{name} method" :
+          "no :#{name}#{@opts[:suffix]} method"
+            ) unless m
+
+      m.call(*args, **opts, &block)
     end
     alias dispatch call
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dispatio
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.1
 platform: ruby
 authors:
 - John Mettraux