module Roda::RodaPlugins::MatchAffix

  1. lib/roda/plugins/match_affix.rb

The match_affix plugin allows changing the default prefix and suffix used for match patterns. Roda’s default behavior for a match pattern like "albums" is to use the pattern /\A\/(?:albums)(?=\/|\z)/. This prefixes the pattern with / and suffixes it with (?=\/|\z). With the match_affix plugin, you can change the prefix and suffix to use. So if you want to be explicit and require a leading / in patterns, you can set the prefix to "". If you want to consume a trailing slash instead of leaving it, you can set the suffix to (\/|\z).

You set the prefix and suffix to use by passing arguments when loading the plugin:

plugin :match_affix, ""

will load the plugin and use an empty prefix (instead of a slash).

plugin :match_affix, "", /(\/|\z)/

will use an empty prefix and change the suffix to consume a trailing slash.

plugin :match_affix, nil, /(?:\/\z|(?=\/|\z))/

will not modify the prefix and will change the suffix so that it consumes a trailing slash at the end of the path only.

This plugin automatically loads the placeholder_string_matchers plugin.

Methods

Public Class

  1. configure
  2. load_dependencies

Public Class methods

configure(app, prefix, suffix=nil)

Set the default prefix and suffix to use in match patterns, if a non-nil value is given.

[show source] 
   # File lib/roda/plugins/match_affix.rb
37 def self.configure(app, prefix, suffix=nil)
38   app.opts[:match_prefix] = prefix if prefix
39   app.opts[:match_suffix] = suffix if suffix
40 end
load_dependencies(app, _prefix, _suffix=nil)
[show source] 
   # File lib/roda/plugins/match_affix.rb
31 def self.load_dependencies(app, _prefix, _suffix=nil)
32   app.plugin :placeholder_string_matchers
33 end