module Roda::RodaPlugins::SymbolMatchers

The symbol_matchers plugin allows you do define custom regexps to use for specific symbols. For example, if you have a route such as:

r.on :username do |username|
  # ...
end

By default this will match all nonempty segments. However, if your usernames must be 6-20 characters, and can only contain a-z and 0-9, you can do:

plugin :symbol_matchers
symbol_matcher :username, /([a-z0-9]{6,20})/

Then the route will only if the path is /foobar123, but not if it is /foo, /FooBar123, or /foobar_123.

By default, this plugin sets up the following symbol matchers:

:d	/(\d+)/, a decimal segment
:rest	/(.*)/, all remaining characters, if any
:w	/(\w+)/, a alphanumeric segment

If the placeholder_string_matchers plugin is loaded, this feature also applies to placeholders in strings, so the following:

r.on "users/:username" do |username|
  # ...
end

Would match /users/foobar123, but not /users/foo, /users/FooBar123, or /users/foobar_123.

If using this plugin with the params_capturing plugin, this plugin should be loaded first.

Methods

Public Class

1. configure
2. load_dependencies

Classes and Modules

1. Roda::RodaPlugins::SymbolMatchers::ClassMethods
2. Roda::RodaPlugins::SymbolMatchers::RequestMethods