Bump version to 3.97.0

Author: jeremyevans

CHANGELOG

@@ -1,4 +1,4 @@
-=== master
+=== 3.97.0 (2025-10-13)
 
 * Add map_matcher plugin, for matching next segment in request path to a hash key, yielding hash value (jeremyevans)
 

doc/release_notes/3.97.0.txt

@@ -0,0 +1,41 @@
+= New Features
+
+* A map_matcher plugin has been added, for matching the next segment
+  in the request path to a hash key, yielding the hash value.  This
+  allows for a better approach for metaprogramming routes.
+
+  When dealing with many similar routes, it is common to use a hash
+  keyed by route segment, and then match against an array of the keys:
+    
+    map = {
+      'album' => Album,
+      'artist' => Artist,
+      # ...
+    }.freeze
+    
+    keys = map.keys.freeze
+    
+    route do |r|
+      r.on "type", keys do |key|
+        value = map[key]
+        # ...
+      end
+    end
+
+  For large maps, this approach is suboptimal, since the array matcher
+  will iterate over each element in the array, checking whether it
+  matches.
+
+  The map_matcher plugin allows for:
+    
+    plugin :map_matcher
+
+    route do |r|
+      r.on "type", map: map do |value|
+        # ...
+      end
+    end
+    
+  This gets the next route segment and checks whether it is a key in 
+  the map, instead of iterating over an array of hash keys, so it is
+  more efficient for large maps. It also results in simpler code.

lib/roda/version.rb

@@ -4,7 +4,7 @@ class Roda
   RodaMajorVersion = 3
 
   # The minor version of Roda, updated for new feature releases of Roda.
-  RodaMinorVersion = 96
+  RodaMinorVersion = 97
 
   # The patch version of Roda, updated only for bug fixes from the last
   # feature release.