def resources(name, options = {}, &blk)
      Routing::Resources.new(self, name, options.merge(separator: @router.action_separator), &blk)
    end
def resources(name, options = {}, &blk)
      Routing::Resources.new(self, name, options.merge(separator: @router.action_separator), &blk)
    end
Defines a set of named routes for a plural RESTful resource.
 It has a built-in integration for Hanami::Controller.

 @param name [String] the name of the resource
 @param options [Hash] a set of options to customize the routes
 @option options [Array<Symbol>] :only a subset of the default routes
   that we want to generate
 @option options [Array<Symbol>] :except prevent the given routes to be
   generated
 @param blk [Proc] a block of code to generate additional routes

 @return [Hanami::Routing::Resources]

 @since 0.1.0

 @see Hanami::Routing::Resources
 @see Hanami::Routing::Resources::Action
 @see Hanami::Routing::Resource::Options

 @example Default usage
   require 'hanami/router'

   Hanami::Router.new do
     resources 'articles'
   end

   # It generates:
   
   # +--------+--------------------+-------------------+----------+----------------+
   # | Verb   | Path               | Action            | Name     | Named Route    |
   # +--------+--------------------+-------------------+----------+----------------+
   # | GET    | /articles          | Articles::Index   | :index   | :articles      |
   # | GET    | /articles/:id      | Articles::Show    | :show    | :articles      |
   # | GET    | /articles/new      | Articles::New     | :new     | :new_articles  |
   # | POST   | /articles          | Articles::Create  | :create  | :articles      |
   # | GET    | /articles/:id/edit | Articles::Edit    | :edit    | :edit_articles |
   # | PATCH  | /articles/:id      | Articles::Update  | :update  | :articles      |
   # | DELETE | /articles/:id      | Articles::Destroy | :destroy | :articles      |
   # +--------+--------------------+-------------------+----------+----------------+



 @example Limit the generated routes with :only
   require 'hanami/router'

   Hanami::Router.new do
     resources 'articles', only: [:index]
   end

   # It generates:
   
   # +------+-----------+-----------------+--------+-------------+
   # | Verb | Path      | Action          | Name   | Named Route |
   # +------+-----------+-----------------+--------+-------------+
   # | GET  | /articles | Articles::Index | :index | :articles   |
   # +------+-----------+-----------------+--------+-------------+



 @example Limit the generated routes with :except
   require 'hanami/router'

   Hanami::Router.new do
     resources 'articles', except: [:edit, :update]
   end

   # It generates:
   
   # +--------+--------------------+-------------------+----------+----------------+
   # | Verb   | Path               | Action            | Name     | Named Route    |
   # +--------+--------------------+-------------------+----------+----------------+
   # | GET    | /articles          | Articles::Index   | :index   | :articles      |
   # | GET    | /articles/:id      | Articles::Show    | :show    | :articles      |
   # | GET    | /articles/new      | Articles::New     | :new     | :new_articles  |
   # | POST   | /articles          | Articles::Create  | :create  | :articles      |
   # | DELETE | /articles/:id      | Articles::Destroy | :destroy | :articles      |
   # +--------+--------------------+-------------------+----------+----------------+



 @example Additional single routes
   require 'hanami/router'

   Hanami::Router.new do
     resources 'articles', only: [] do
       member do
         patch 'publish'
       end
     end
   end

   # It generates:
   
   # +--------+-----------------------+-------------------+------+-------------------+
   # | Verb   | Path                  | Action            | Name | Named Route       |
   # +--------+-----------------------+-------------------+------+-------------------+
   # | PATCH  | /articles/:id/publish | Articles::Publish |      | :publish_articles |
   # +--------+-----------------------+-------------------+------+-------------------+



 @example Additional collection routes
   require 'hanami/router'

   Hanami::Router.new do
     resources 'articles', only: [] do
       collection do
         get 'search'
       end
     end
   end

   # It generates:
   
   # +------+------------------+------------------+------+------------------+
   # | Verb | Path             | Action           | Name | Named Route      |
   # +------+------------------+------------------+------+------------------+
   # | GET  | /articles/search | Articles::Search |      | :search_articles |
   # +------+------------------+------------------+------+------------------+