Sha256: 1942a1d30ace698d80754065d250c33e160fe749e1bb07a401dbc35a36fbaf6a

Contents?: true

Size: 1.69 KB

Versions: 61

Compression:

Stored size: 1.69 KB

Contents

# frozen-string-literal: true

#
class Roda
  module RodaPlugins
    # The class_matchers plugin allows you do define custom regexps and
    # conversion procs to use for specific classes.  For example, if you
    # have multiple routes similar to:
    #
    #   r.on /(\d\d\d\d)-(\d\d)-(\d\d)/ do |y, m, d|
    #     date = Date.new(y.to_i, m.to_i, d.to_i)
    #     # ...
    #   end
    #
    # You can register a Date class matcher for that regexp (note that
    # the block must return an array):
    #
    #   class_matcher(Date, /(\d\d\d\d)-(\d\d)-(\d\d)/) do |y, m, d|
    #     [Date.new(y.to_i, m.to_i, d.to_i)]
    #   end
    #
    # And then use the Date class as a matcher, and it will yield a Date object:
    #
    #   r.on Date do |date|
    #     # ...
    #   end
    #
    # This is useful to DRY up code if you are using the same type of pattern and
    # type conversion in multiple places in your application.
    #
    # This plugin does not work with the params_capturing plugin, as it does not
    # offer the ability to associate block arguments with named keys.
    module ClassMatchers
      module ClassMethods
        # Set the regexp to use for the given class.  The block given will be
        # called with all matched values from the regexp, and should return an
        # array with the captures to yield to the match block.
        def class_matcher(klass, re, &block)
          meth = :"_match_class_#{klass}"
          self::RodaRequest.class_eval do
            consume_re = consume_pattern(re)
            define_method(meth){consume(consume_re, &block)}
            private meth
          end
        end
      end
    end

    register_plugin(:class_matchers, ClassMatchers)
  end
end

Version data entries

61 entries across 61 versions & 1 rubygems

Version Path
roda-3.61.0 lib/roda/plugins/class_matchers.rb
roda-3.60.0 lib/roda/plugins/class_matchers.rb
roda-3.59.0 lib/roda/plugins/class_matchers.rb
roda-3.58.0 lib/roda/plugins/class_matchers.rb
roda-3.57.0 lib/roda/plugins/class_matchers.rb
roda-3.56.0 lib/roda/plugins/class_matchers.rb
roda-3.55.0 lib/roda/plugins/class_matchers.rb
roda-3.54.0 lib/roda/plugins/class_matchers.rb
roda-3.53.0 lib/roda/plugins/class_matchers.rb
roda-3.52.0 lib/roda/plugins/class_matchers.rb
roda-3.51.0 lib/roda/plugins/class_matchers.rb
roda-3.50.0 lib/roda/plugins/class_matchers.rb
roda-3.49.0 lib/roda/plugins/class_matchers.rb
roda-3.48.0 lib/roda/plugins/class_matchers.rb
roda-3.47.0 lib/roda/plugins/class_matchers.rb
roda-3.46.0 lib/roda/plugins/class_matchers.rb
roda-3.45.0 lib/roda/plugins/class_matchers.rb
roda-3.44.0 lib/roda/plugins/class_matchers.rb
roda-3.43.1 lib/roda/plugins/class_matchers.rb
roda-3.43.0 lib/roda/plugins/class_matchers.rb