dispatio 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a460ddbac24649ff60c70b11b27d766a2fb5a748d682ced095e9933604200a96
-  data.tar.gz: 6449b86f7f5269661ed558b37bc3752d91f24f3b4d875ddb561a59f1975ba862
+  metadata.gz: f40f67d97bc67210b29b6509feaf066a36ad196e2580926dd2190b0bdfc201f0
+  data.tar.gz: 3412b4cddd334b45d1969270ba75a7670482b995a44663484693564aedfb3009
 SHA512:
-  metadata.gz: 82ced686161c8adf45614813ad55425f473efbd8af2ebb1438739ab2570d76e0815fda45056b49aee9cede82139a15afa9ab9f85b4495e3c83bb4618a77b606c
-  data.tar.gz: ebf88bb77dcfeecbf073ab56d04543bfe5185b4a938082ab30fb7b3149d9f1fa49b73c0e95773e45cf33cd1a932d8ecd22c4b164f9448a322081d0723f46e042
+  metadata.gz: 1bdd84b304a216c2010e4c5e07539f5896d242775bf3a4b7484dc31a6cb48eec808a3ecb3d4ffe119e3844af3a2c77b1e85b06ac81d508ad54b5d42a46a9c71d
+  data.tar.gz: bcb954aedf93e66e4a04bc21f11c61f8ac771f98af92ba7ae2a28fc2ce137d11b2ef0602b2aeeb7d503b19be40d7575458edd88b6b81e0eb276f05f5faf61ebb

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 # dispatio GHANGELOG.md
 
 
+## 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,42 @@
 
 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, 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 +56,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 +72,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 +103,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 +119,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,38 @@
 
 module Dispatio
 
-  VERSION = '1.1.0'.freeze
+  VERSION = '1.2.0'.freeze
 
   class << self
 
-    def make_table(point, prefix)
+    def make_table(point, prefix_or_opts)
+
+      opts =
+        prefix_or_opts.is_a?(String) ? { prefix: prefix_or_opts } :
+        prefix_or_opts
+
+      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.size..-1]] = point.method(m) if m.to_s.start_with?(px)
+            else; sx = opts[:suffix]
+              h[m.to_s[0, sx.size-2]] = point.method(m) if m.to_s.end_with?(sx)
+            end
             h }
       ).freeze
     end
@@ -22,9 +40,9 @@ module Dispatio
 
   class Table
 
-    def initialize(prefix, table)
+    def initialize(opts, table)
 
-      @prefix = prefix
+      @opts = opts
       @table = table.freeze
     end
 
@@ -35,9 +53,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.0
 platform: ruby
 authors:
 - John Mettraux