mruby binding for libr3, a high-performance path dispatching library.
tree << '/users/{user_id}/feeds/{feed_id}' tree.match '/users/1/feeds/2' # => { user_id: '1', feed_id: '2' }Add the line below to your build_config.rb:
MRuby::Build.new do |conf| # ... (snip) ... conf.gem mgem: 'mruby-regexp-pcre' # Optional conf.gem mgem: 'mruby-r3' endOr add this line to your aplication's mrbgem.rake:
MRuby::Gem::Specification.new('your-mrbgem') do |spec| # ... (snap) ... spec.add_dependency 'mruby-regexp-pcre' # Optional spec.add_dependency 'mruby-r3' endFirst of all a tree object has to be created.
tree = R3::Tree.newThe size grows dynamically. However the initializer accepts an optional initial size. The default initial size is up to 5 routes.
tree = R3::Tree.new(100)The pattern syntax for routes is the following. Enhanced support for regular expression requires mruby-regexp-pcre to be installed!
/blog/post/{id} use [^/]+ regular expression by default. /blog/post/{id:\d+} use `\d+` regular expression instead of default. Routes can be added to the tree at any time, however dont forget to call compile before using them.
tree << '/' tree << '/blog/post' tree << '/blog/post/{id}' tree << '/user/{user_id}/feeds/{feed_id}'Its also possible to specify the HTML method rather then to allow any.
tree.add('/blog/post/{id:\\d+}', R3::DELETE)Once the tree has been compiled he's ready for dispatching.
tree << '/' tree.add '/users', R3::ANY tree.add '/posts', R3::GET tree.add '/users/{user_id}/feeds/{feed_id}', R3::GET tree.compile tree.routes # => ['GET /users/{user_id}/feeds/{feed_id}', ...] tree.match? '/' # => true tree.match '/' # => {} tree.match? '/other' # => false tree.match '/other' # => nil tree.match? '/users', R3::POST # => true tree.match? '/posts', R3::POST # => false tree.match '/users/1/feeds/2' # => { user_id: '1', feed_id: '2' } tree.match '/users/1/feeds/2', R3::POST # => nilBefore you're writing your own URL map, you can make use of the built-in feature to add any kind of data with the route.
tree.add('/user/{name}', R3::ANY, -> { 'callback handler' }) tree.compile params, handler = tree.match('/user/bernd') handler.call # => 'callback handler'Clone the repo:
$ git clone https://github.com/katzer/mruby-r3.git && cd mruby-r3/ Compile the source:
$ rake compile Run the tests:
$ rake test - Add a route for multiple HTTP methods.
- missing asprintf() for MingGW 32-bit compiler.
- Sebastián Katzer, Fa. appPlant GmbH
The mgem is available as open source under the terms of the MIT License.
Made with 😋 in Leipzig
© 2017 appPlant GmbH