Adds API.route_param for quick declaration of route parameters.

[mbleigh]

I've found myself often implementing this pattern:

namespace :users do
  namespace ':id', requirements: {id: /[0-9]+/} do
    get { }
    put { }
  end
end

And thought that it might be useful to implement a little bit of syntactical sugar for it:

namespace :users do
  route_param :id, requirements: /[0-9]+/ do
    get { }
    put { }
  end
end

Thoughts?

[dblock]

I find the name a bit confusing. Is it a route or a parameter? Or a route parameter? Maybe just param? Curious what others think.

[dblock]

I don't think you want to be modifying the hash that is being passed in.

namespace_options = {}
namespace_options.merge! options
namespace_options[:requirements] = ... if options[:requirements].is_a? Regexp
...

[mbleigh]

Agreed. Did a quick dup instead but same effect.

[mbleigh]

I thought about the name for a bit and couldn't think of a better one, though I'm open to suggestions. You are declaring a parameter in the route, but I can also see how it's slightly confusing.

param would be confusing since we already have the params method, param_segment doesn't work as well for me. Any other ideas?

[dblock]

Merged, updated CHANGELOG.