And the plan begins to reveal itself.

Author: Michael Bleigh

.rspec

@@ -1,3 +1,3 @@
 --color
 --format=nested
---backtrace
+--fail-fast

.rvmrc

@@ -1 +1 @@
-rvm use ree@rails3 --passenger
+rvm use ree@rails3

Gemfile

@@ -2,15 +2,16 @@ gem 'rack'
 gem 'rack-mount'
 gem 'rack-jsonp'
 
-gem 'activesupport', '~> 3.0.0'
+gem 'multi_json'
+gem 'multi_xml'
 
 group :development do
   gem 'rake'
   gem 'jeweler'
 end
 
 group :test do
-  gem 'rspec', '>= 2.0.0.beta.20'
+  gem 'rspec', '>= 2.1.0'
   gem 'rack-test'
   gem 'cucumber', '>= 0.8.5'
 end

Gemfile.lock

@@ -1,6 +1,5 @@
 GEM
   specs:
-    activesupport (3.0.0)
     builder (2.1.2)
     cucumber (0.8.5)
       builder (~> 2.1.2)
@@ -18,21 +17,23 @@ GEM
       git (>= 1.2.5)
       rubyforge (>= 2.0.0)
     json_pure (1.4.3)
+    multi_json (0.0.4)
+    multi_xml (0.0.1)
     rack (1.2.1)
     rack-jsonp (1.0.0)
     rack-mount (0.6.9)
       rack (>= 1.0.0)
     rack-test (0.5.4)
       rack (>= 1.0)
     rake (0.8.7)
-    rspec (2.0.0.beta.20)
-      rspec-core (= 2.0.0.beta.20)
-      rspec-expectations (= 2.0.0.beta.20)
-      rspec-mocks (= 2.0.0.beta.20)
-    rspec-core (2.0.0.beta.20)
-    rspec-expectations (2.0.0.beta.20)
-      diff-lcs (>= 1.1.2)
-    rspec-mocks (2.0.0.beta.20)
+    rspec (2.1.0)
+      rspec-core (~> 2.1.0)
+      rspec-expectations (~> 2.1.0)
+      rspec-mocks (~> 2.1.0)
+    rspec-core (2.1.0)
+    rspec-expectations (2.1.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.1.0)
     rubyforge (2.0.4)
       json_pure (>= 1.1.7)
     term-ansicolor (1.0.5)
@@ -42,12 +43,13 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  activesupport (~> 3.0.0)
   cucumber (>= 0.8.5)
   jeweler
+  multi_json
+  multi_xml
   rack
   rack-jsonp
   rack-mount
   rack-test
   rake
-  rspec (>= 2.0.0.beta.20)
+  rspec (>= 2.1.0)

README.rdoc

@@ -4,7 +4,7 @@
 
 Grape is a REST-like API micro-framework for Ruby. It is built to complement existing web application frameworks such as Rails and Sinatra by providing a simple DSL to easily provide APIs. It has built-in support for common conventions such as multiple formats, subdomain/prefix restriction, and versioning.
 
-    class Twitter < Grape::Base
+    class Twitter::API < Grape::Base
       subdomain 'api'
       version '1'
       formats :xml, :json
@@ -30,6 +30,12 @@ Grape is a REST-like API micro-framework for Ruby. It is built to complement exi
       end
     end
 
+    class Twitter::API::User < Grape::Resource::ActiveRecord
+      represents ::User
+      
+      property :status, lambda{|u| u.latest_status}, Twitter::API::Status
+    end
+    
 == Note on Patches/Pull Requests
 
 * Fork the project.

lib/grape.rb

@@ -1,10 +1,21 @@
 require 'rack'
 require 'rack/builder'
 
-require 'grape/middleware/base'
-require 'grape/middleware/prefixer'
-require 'grape/middleware/versioner'
-require 'grape/middleware/formatter'
-require 'grape/middleware/error'
-
-require 'grape/middleware/auth/oauth2'
+module Grape
+  autoload :API, 'grape/api'
+  autoload :Endpoint, 'grape/endpoint'
+  autoload :MiddlewareStack, 'grape/middleware_stack'
+  
+  module Middleware
+    autoload :Base,      'grape/middleware/base'
+    autoload :Prefixer,  'grape/middleware/prefixer'
+    autoload :Versioner, 'grape/middleware/versioner'
+    autoload :Formatter, 'grape/middleware/formatter'
+    autoload :Error,     'grape/middleware/error'
+    
+    module Auth
+      autoload :OAuth2, 'grape/middleware/auth/oauth2'
+      autoload :Basic,  'grape/middleware/auth/basic'
+    end
+  end
+end

lib/grape/api.rb

@@ -0,0 +1,84 @@
+require 'rack/mount'
+
+module Grape
+  class API
+    class << self
+      attr_reader :route_set
+      
+      def reset!
+        @settings = [{}]
+        @route_set = Rack::Mount::RouteSet.new
+        @prototype = nil
+      end
+      
+      def call(env)
+        route_set.freeze.call(env)
+      end
+      
+      # Settings are a stack, so when we
+      # want to access them they are merged
+      # in the order pushed.
+      def settings
+        @settings.inject({}){|f,h| f.merge!(h); f}
+      end
+      
+      def set(key, value)
+        @settings.last[key.to_sym] = value
+      end
+      
+      # Define a root prefix for your entire
+      # API. For instance, if you had an api
+      # that you wanted to be namespaced at
+      # `/api/` you would do this:
+      # 
+      #   prefix '/api'
+      def prefix(prefix = nil)
+        prefix ? set(:root_prefix, prefix) : settings[:root_prefix]
+      end
+      
+      def version(new_version = nil)
+        new_version ? set(:version, new_version) : settings[:version]
+      end
+      
+      def default_format(new_format = nil)
+        new_format ? set(:default_format, new_format.to_sym) : settings[:default_format]
+      end
+      
+      def route_set
+        @route_set ||= Rack::Mount::RouteSet.new
+      end
+      
+      def compile_path(path)
+        parts = []
+        parts << prefix if prefix
+        parts << version if version
+        parts << path
+        Rack::Mount::Utils.normalize_path(parts.join('/'))
+      end
+
+      def route(method, path_info, &block)
+        route_set.add_route(build_endpoint(&block), :path_info => compile_path(path_info))
+      end
+      
+      def build_endpoint(&block)
+        builder = Rack::Builder.new
+        builder.use Grape::Middleware::Error
+        builder.use Grape::Middleware::Prefixer, :prefix => prefix if prefix        
+        builder.use Grape::Middleware::Versioner if version
+        builder.use Grape::Middleware::Formatter, :default_format => default_format || :json
+        builder.run Grape::Endpoint.new(&block)
+        builder.to_app
+      end
+      
+      def get(path_info, &block); route('GET', path_info, &block) end
+      def post(path_info, &block); route('POST', path_info, &block) end
+      def put(path_info, &block); route('PUT', path_info, &block) end
+      
+      def inherited(subclass)
+        subclass.reset!
+      end
+    end  
+    
+    reset! 
+  end
+end

lib/grape/endpoint.rb

@@ -0,0 +1,21 @@
+require 'rack'
+require 'grape'
+
+module Grape
+  class Endpoint
+    def initialize(&block)
+      @block = block
+    end
+    
+    attr_reader :env, :request
+        
+    def call(env)
+      @env = env
+      @request = Rack::Request.new(@env)
+      @headers = {}
+      
+      response_text = instance_eval &@block
+      [200, {}, [response_text]]
+    end
+  end
+end

lib/grape/middleware/base.rb

@@ -3,6 +3,8 @@ module Middleware
     class Base
       attr_reader :app, :env, :options
 
+      # @param [Rack Application] app The standard argument for a Rack middleware.
+      # @param [Hash] options A hash of options, simply stored for use by subclasses.
       def initialize(app, options = {})
         @app = app
         @options = default_options.merge(options)
@@ -21,7 +23,12 @@ def call!(env)
         after || @app_response
       end
 
+      # @abstract
+      # Called before the application is called in the middleware lifecycle.
       def before; end
+      # @abstract
+      # Called after the application is called in the middleware lifecycle.
+      # @returns [Response, nil] a Rack SPEC response or nil to call the application afterwards.
       def after; end
 
       def request

lib/grape/middleware/error.rb

@@ -5,11 +5,12 @@ module Middleware
     class Error < Base
       def call!(env)
         @env = env
-        err = catch :error do
+        result = catch :error do
           @app.call(@env)
         end
 
-        error_response(err)
+        result ||= {}
+        result.is_a?(Hash) ? error_response(result) : result
       end
 
       def error_response(error = {})