dispatio 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 681d0cd297c65b0faa322d9335759096fdc7f4d872fe92848dd8943c23e8e101
-  data.tar.gz: 8785befaac8bed983b0142271a2f06422c0b34852621acabef8a8ed32e04af83
+  metadata.gz: f40f67d97bc67210b29b6509feaf066a36ad196e2580926dd2190b0bdfc201f0
+  data.tar.gz: 3412b4cddd334b45d1969270ba75a7670482b995a44663484693564aedfb3009
 SHA512:
-  metadata.gz: 335b97d8e0f88b17d625cb6885d4cea39539b23fde270ee70142ab8265fcc3fe8966dff3eee74214690e5ce38fb80ec8b8d28714948cd6df757b723cb3941bf6
-  data.tar.gz: 288bf30fadd914780542e48b0e4836823b9bfa10d9a379ae96715bb0a60b39b4bca58027a4a73b3376287fc69e9ea29b691e5fc9284a8bedcf311e6ee5d69014
+  metadata.gz: 1bdd84b304a216c2010e4c5e07539f5896d242775bf3a4b7484dc31a6cb48eec808a3ecb3d4ffe119e3844af3a2c77b1e85b06ac81d508ad54b5d42a46a9c71d
+  data.tar.gz: bcb954aedf93e66e4a04bc21f11c61f8ac771f98af92ba7ae2a28fc2ce137d11b2ef0602b2aeeb7d503b19be40d7575458edd88b6b81e0eb276f05f5faf61ebb

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 # 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
+
+
 ## dispatio 1.0.0  released 2026-09-11
 
 * First release

data/README.md

@@ -1,16 +1,64 @@
 
 # dispatio
 
+[![Gem Version](https://badge.fury.io/rb/dispatio.svg)](http://badge.fury.io/rb/dispatio)
+
 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
 
 ```ruby
+require 'dispatio'
+
 class Foo
 
   def consume(name, data)
 
-    dtable.dispatch(name, data)
+    dtable.dispatch(name, data) # or
+    #dtable.call(name, data)    #
+    #dtable.(name, data)        #
+    #dtable[name].call(data) # or
+    #dtable[name].(data)     #
+    #dtable[name][data]      #
+      #
+      # just use the one you like
   end
 
   protected
@@ -24,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
@@ -31,19 +81,31 @@ foo = Foo.new
 foo.consume(:foo, 'hello') # ==> [ Foo, :vfoo, 'hello' ]
 foo.consume(:bar, 'world') # ==> [ Foo, :vbar, 'world' ]
 
-foo.consume(:nada, 'nemo') # ==> NoMethodError 'no :validate_nada method'
+foo.consume('foo', 'hello') # ==> [ Foo, :vfoo, 'hello' ]
+foo.consume('bar', 'world') # ==> [ Foo, :vbar, 'world' ]
+
+foo.consume(:nada, 'nemo') # ==> NoMethodError, 'no :validate_nada method'
 ```
 
 ## against a singleton class
 
 ```ruby
+require 'dispatio'
+
 class Bar
 
   class << self
 
     def consume(name, data)
 
-      dtable.dispatch(name, data)
+      dtable.dispatch(name, data) # or
+      #dtable.call(name, data)    #
+      #dtable.(name, data)        #
+      #dtable[name].call(data) # or
+      #dtable[name].(data)     #
+      #dtable[name][data]      #
+        #
+        # just use the one you like
     end
 
     protected
@@ -57,12 +119,17 @@ 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
 
 Bar.consume(:foo, 'hello') # ==> [ Bar, :vfoo, 'hello' ]
 Bar.consume(:bar, 'world') # ==> [ Bar, :vbar, 'world' ]
 
+Bar.consume('foo', 'hello') # ==> [ Bar, :vfoo, 'hello' ]
+Bar.consume('bar', 'world') # ==> [ Bar, :vbar, 'world' ]
+
 Bar.consume(:nada, 'nemo') # ==> NoMethodError, 'no :validate_nada method'
 ```
 

data/lib/dispatio.rb

@@ -1,20 +1,38 @@
 
 module Dispatio
 
-  VERSION = '1.0.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,18 +40,31 @@ module Dispatio
 
   class Table
 
-    def initialize(prefix, table)
+    def initialize(opts, table)
 
-      @prefix = prefix
+      @opts = opts
       @table = table.freeze
     end
 
-    def dispatch(name, *args, **opts, &block)
+    def [](name)
+
+      @table[name.to_s]
+    end
+
+    def call(name, *args, **opts, &block)
+
+      m = self[name]
+
+      fail(
+        NoMethodError,
+        @opts[:prefix] ?
+          "no :#{@opts[:prefix]}#{name} method" :
+          "no :#{name}#{@opts[:suffix]} method"
+            ) unless m
 
-      ( @table[name.to_s] ||
-        fail(NoMethodError.new("no :#{@prefix}#{name} method"))
-          ).call(*args, **opts, &block)
+      m.call(*args, **opts, &block)
     end
+    alias dispatch call
   end
 end
 

metadata

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