Restful Route Version

Useful for creating inheritable routes and controllers

Features

• It extends routing API of rails by leting us inherit routes between versions:

  version_namespace :api do
    version_namespace(:v10,:cache_route => true) do
      resources :articles
      resources :comments
      resources :notes
    end     
  
    version_namespace(:v11, :cache_route => true) do
      inherit_routes("/api/v10", :except => %w(articles))
      resources :articles
      resources :tags
    end
  
    version_namespace(:v12) do
      inherit_routes("/api/v11",:except => %w(notes))
      resources :lessons
    end
  end
  

Important thing to remember is only routes which were cached via cache_route => true can be reused for inheritance. Normal namespace blocks aren't cached.

• Dynamically defines controllers between versions. In other words if v11 inherits 'notes' route from v10, and v11 doesn't have its own NotesController defined the, plugin will automatically define Api::V11::NotesController which will inherit from Api::V10::NotesController.

• Inherits view files (such as index.xml.builder) between versions. For example if V11::ArticlesController inherits V10::ArticlesController it will as well inherit all the view files of v10/articles/ and hence there won't be any need to copy the view files around when creating new version of the API.

Template inheritance will work out of box on Rails 3.1, but if you are still on 3.0.x series, you can use it now :

   class Api::V10::BaseController < ActionController::Base
      restful_route_version
   end

• Works with Ruby 1.9.2 and Ruby 1.8.7