Method: Newman::Filters#subject

Defined in:
lib/newman/filters.rb

#subject(filter_type, pattern, &action) ⇒ Object

‘Newman::Filters#subject` takes a `filter_type`, a `pattern`, and an `action` and then registers a callback which gets run for each new request the application handles. If the filter matches the incoming message, the `action` block gets run in the context of a `Newman::Controller` object. Otherwise, the `action` block does not get run at all.

Currently, the only supported ‘filter_type` is `:match`, which matches the pattern against the full SUBJECT field. This can be used for simple subject based filtering, such as the code shown below:

subject(:match, "what stories do you know?") do
  respond :subject => "All of Jester's stories",
         :body => story_library.map { |e| e.title }.join("\n")
end

Because this method runs the ‘pattern` through `Newman::Application#compile_regex`, it can also be used in combination with `Newman::Application#match` to do more complex matching, such as in the following example:

match :genre, '\S+'
match :title, '.*'

subject(:match, "a {genre} story '{title}'") do
  story_library.add_story(:genre => params[:genre],
                          :title => params[:title],
                          :body => request.body.to_s)

  respond :subject => "Jester saved '#{params[:title]}'"
end

It’d be nice to support more kinds of matching strategies at some point in the future, so be sure to let us know if you have ideas.

Raises:

  • (NotImplementedError) 


109
110
111
112
113
114
115
116
117
118
119
120
121
 
# File 'lib/newman/filters.rb', line 109

def subject(filter_type, pattern, &action)
  raise NotImplementedError unless filter_type == :match

  regex = compile_regex(pattern)

  callback action, ->(controller) {
    subject = controller.request.subject

    return false unless subject

    subject.match(/#{regex}/) || false
  }
end