rack-api 0.1.2 → 0.2.0

data/Gemfile.lock

@@ -1,15 +1,15 @@
 PATH
   remote: .
   specs:
-    rack-api (0.1.2)
-      activesupport (~> 3.0.6)
+    rack-api (0.2.0)
+      activesupport (~> 3.0.7)
       rack (~> 1.2.1)
       rack-mount (~> 0.6.14)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    activesupport (3.0.6)
+    activesupport (3.0.7)
     archive-tar-minitar (0.5.2)
     columnize (0.3.2)
     diff-lcs (1.1.2)
@@ -20,6 +20,7 @@ GEM
       rack (>= 1.0.0)
     rack-test (0.5.7)
       rack (>= 1.0)
+    redis (2.2.0)
     rspec (2.5.0)
       rspec-core (~> 2.5.0)
       rspec-expectations (~> 2.5.0)
@@ -45,5 +46,6 @@ PLATFORMS
 DEPENDENCIES
   rack-api!
   rack-test (~> 0.5.7)
+  redis (~> 2.2.0)
   rspec (~> 2.5.0)
   ruby-debug19

data/README.rdoc

@@ -124,6 +124,108 @@ Your <tt>Helpers</tt> module may look like this:
     end
   end
 
+== Helpers
+
+Every Rack::API action has several helper methods available through the
+Rack::API::App class. Here's some of them:
+
+=== logger
+
+Logs specified message to the STDOUT.
+
+  get "/" do
+    logger.info "Hello index page!"
+    {}
+  end
+
+=== headers
+
+Define custom headers that will be sent to the client.
+
+  get "/" do
+    headers["X-Awesome"] = "U R Awesome"
+    {}
+  end
+
+== params
+
+Return current request parameters.
+
+  get "/" do
+    {:message => "Hello #{params[:name]}"}
+  end
+
+== request
+
+Return an object relative to the current request.
+
+== credentials
+
+This method will return an array container both username and password if client
+sent Basic Authentication headers.
+
+  get "/" do
+    user, pass = credentials
+    {:message => "Hello #{user}"}
+  end
+
+== url_for
+
+Build an URL by merging segments, default URL options and hash with parameters.
+
+  Rack::API.app do
+    default_url_options :host => "example.com", :protocol => "https"
+
+    version "v1" do
+      get "/" do
+        {:url => url_for(:users, User.find(params[:id])), :format => :json}
+      end
+    end
+  end
+
+== Useful middlewares
+
+=== Rack::API::Middleware::SSL
+
+This middleware will accept only HTTPS requests. Any request on HTTP will be dropped.
+
+  Rack::API.app do
+    use Rack::API::Middleware::SSL
+  end
+
+=== Rack::API::Middleware::Limit
+
+This middleware will limit access to API based on requests per hour. It requires a Redis connection.
+
+  Rack::API.app do
+    # Use the default settings.
+    # Will accept 60 requests/hour limited by IP address (REMOTE_ADDR)
+    use Rack::API::Middleware::Limit, :with => Redis.new
+  end
+
+Other usages:
+
+  # Set custom limit/hour.
+  # Will accept ± 1 request/second.
+  use Rack::API::Middleware::Limit, :with => $redis, :limit => 3600
+
+  # Set custom string key.
+  # Will limit by something like env["X-Forwarded-For"].
+  use Rack::API::Middleware::Limit, :with => $redis, :key => "X-Forwarded-For"
+
+  # Set custom block key.
+  # Will limit by credential (Basic Auth).
+  Rack::API.app do
+    basic_auth do |user, pass|
+      User.authorize(user, pass)
+    end
+
+    use Rack::API::Middleware::Limit, :with => $redis, :key => proc {|env|
+      request = Rack::Auth::Basic::Request.new(env)
+      request.credentials[0]
+    }
+  end
+
 == Maintainer
 
 * Nando Vieira (http://nandovieira.com.br)

data/lib/rack/api.rb

@@ -1,23 +1,24 @@
 require "rack"
 require "rack/mount"
 require "active_support/hash_with_indifferent_access"
+require "active_support/core_ext/object/to_query"
 require "json"
 require "logger"
 require "forwardable"
 
 module Rack
   class API
-    autoload :App, "rack/api/app"
-    autoload :Formatter, "rack/api/formatter"
-    autoload :Middleware, "rack/api/middleware"
-    autoload :Runner, "rack/api/runner"
-    autoload :Response, "rack/api/response"
-    autoload :Version, "rack/api/version"
+    autoload :App         , "rack/api/app"
+    autoload :Formatter   , "rack/api/formatter"
+    autoload :Middleware  , "rack/api/middleware"
+    autoload :Runner      , "rack/api/runner"
+    autoload :Response    , "rack/api/response"
+    autoload :Version     , "rack/api/version"
 
     class << self
       extend Forwardable
 
-      def_delegators :runner, :version, :use, :prefix, :basic_auth, :helper, :respond_to
+      def_delegators :runner, *Runner::DELEGATE_METHODS
     end
 
     # A shortcut for defining new APIs. Instead of creating a

data/lib/rack/api/app.rb

@@ -23,13 +23,34 @@ module Rack
       #
       DEFAULT_MIME_TYPE = "application/octet-stream"
 
-      attr_reader :block
-      attr_reader :env
-
       # Hold block that will be executed in case the
       # route is recognized.
       #
+      attr_accessor :handler
+
+      # Hold environment from current request.
+      #
+      attr_accessor :env
+
+      # Define which will be the default format when <tt>format=<format></tt>
+      # is not defined.
+      attr_accessor :default_format
+
+      # Set the default prefix path.
+      #
+      attr_accessor :prefix
+
+      # Specify the API version.
+      #
+      attr_accessor :version
+
+      # Hold url options.
+      #
+      attr_accessor :url_options
+
       def initialize(options)
+        @url_options = {}
+
         options.each do |name, value|
           instance_variable_set("@#{name}", value)
         end
@@ -62,7 +83,7 @@ module Rack
       # Return the requested format. Defaults to JSON.
       #
       def format
-        params.fetch(:format, "json")
+        params.fetch(:format, default_format)
       end
 
       # Stop processing by rendering the provided information.
@@ -126,14 +147,14 @@ module Rack
         end
       end
 
-      # Render the result of block.
+      # Render the result of handler.
       #
       def call(env) # :nodoc:
         reset!
         @env = env
 
         response = catch(:error) do
-          render instance_eval(&block)
+          render instance_eval(&handler)
         end
 
         response.respond_to?(:to_rack) ? response.to_rack : response
@@ -149,6 +170,48 @@ module Rack
         headers.fetch("Content-Type", mime)
       end
 
+      # Return a URL path for all segments.
+      # You can set default options by using the
+      # Rack::API::Runner#default_url_options method.
+      #
+      #   url_for :users
+      #   #=> /users
+      #
+      #   url_for :users, User.first
+      #   #=> /users/1
+      #
+      #   url_for :users, 1, :format => :json
+      #   #=> /users/1?format=json
+      #
+      #   url_for :users, :filters => [:name, :age]
+      #   #=> /users?filters[]=name&filters[]=age
+      #
+      # URL segments can be any kind of object, first checking it responds to the
+      # <tt>to_param</tt> method. If not, converts object to string by using the
+      # <tt>to_s</tt> method.
+      #
+      def url_for(*args)
+        options = {}
+        options = args.pop if args.last.kind_of?(Hash)
+
+        segments = []
+        segments << url_options[:base_path] if url_options[:base_path]
+        segments << prefix if prefix
+        segments << version
+        segments += args.collect {|part| part.respond_to?(:to_param) ? part.to_param : part.to_s }
+
+        url = ""
+        url << url_options.fetch(:protocol, "http").to_s << "://"
+        url << url_options.fetch(:host, env["SERVER_NAME"])
+
+        port = url_options.fetch(:port, env["SERVER_PORT"]).to_i
+        url << ":" << port.to_s if port.nonzero? && port != 80
+
+        url << Rack::Mount::Utils.normalize_path(segments.join("/"))
+        url << "?" << options.to_param if options.any?
+        url
+      end
+
       private
       def render(response) # :nodoc:
         [status, headers.merge("Content-Type" => content_type), [format_response(response)]]

data/lib/rack/api/middleware.rb

@@ -3,6 +3,7 @@ module Rack
     module Middleware
       autoload :Format, "rack/api/middleware/format"
       autoload :SSL, "rack/api/middleware/ssl"
+      autoload :Limit, "rack/api/middleware/limit"
     end
   end
 end

data/lib/rack/api/middleware/format.rb

@@ -2,19 +2,21 @@ module Rack
   class API
     module Middleware
       class Format
-        def initialize(app, formats)
-          @app, @formats = app, formats.collect {|f| f.to_s}
+        def initialize(app, default_format, formats)
+          @app = app
+          @default_format = default_format.to_s
+          @formats = formats.collect {|f| f.to_s}
         end
 
         def call(env)
           request = Rack::Request.new(env)
           params = request.env["rack.routing_args"].merge(request.params)
-          requested_format = params.fetch(:format, "json")
+          requested_format = params.fetch(:format, @default_format)
 
           if @formats.include?(requested_format)
             @app.call(env)
           else
-            [406, {"Content-Type" => "text/plain"}, ["Invalid format"]]
+            [406, {"Content-Type" => "text/plain"}, ["Invalid format. Accepts one of [#{@formats.join(", ")}]"]]
           end
         end
       end

data/lib/rack/api/middleware/limit.rb

@@ -0,0 +1,54 @@
+module Rack
+  class API
+    module Middleware
+      class Limit
+        attr_reader :options, :env
+
+        def initialize(app, options = {})
+          @app = app
+          @options = {
+            :limit  => 60,
+            :key    => "REMOTE_ADDR",
+            :with   => Redis.new
+          }.merge(options)
+        end
+
+        def call(env)
+          @env = env
+
+          if authorized?
+            @app.call(env)
+          else
+            [503, {"Content-Type" => "text/plain"}, ["Over Rate Limit."]]
+          end
+        rescue Exception => e
+          @app.call(env)
+        end
+
+        private
+        def authorized?
+          count = redis.incr(key)
+          redis.expire(key, 3600)
+
+          count <= options[:limit] || redis.sismember("api:whitelist", identifier)
+        end
+
+        def redis
+          options[:with]
+        end
+
+        def identifier
+          @identifier ||= begin
+            options[:key].respond_to?(:call) ? options[:key].call(env).to_s : env[options[:key].to_s]
+          end
+        end
+
+        def key
+          @key ||= begin
+            "api:#{identifier}:#{Time.now.strftime("%Y%m%d%H")}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rack/api/runner.rb

@@ -3,6 +3,11 @@ module Rack
     class Runner
       HTTP_METHODS = %w[get post put delete head]
 
+      DELEGATE_METHODS = %w[
+        version use prefix basic_auth
+        helper respond_to default_url_options
+      ]
+
       attr_accessor :settings
 
       def initialize
@@ -79,6 +84,32 @@ module Rack
         set :helpers, mod, :append
       end
 
+      # Define the server endpoint. Will be used if you call the method
+      # Rack::API::App#url_for.
+      #
+      # The following options are supported:
+      #
+      # * <tt>:host</tt> – Specifies the host the link should be targeted at.
+      # * <tt>:protocol</tt> – The protocol to connect to. Defaults to 'http'.
+      # * <tt>:port</tt> – Optionally specify the port to connect to.
+      # * <tt>:base_path</tt> – Optionally specify a base path.
+      #
+      #   default_url_options :host => "myhost.com"
+      #   #=> http://myhost.com
+      #
+      #   default_url_options :host => "myhost.com", :protocol => "https"
+      #   #=> https://myhost.com
+      #
+      #   default_url_options :host => "myhost.com", :port => 3000
+      #   #=> http://myhost.com:3000
+      #
+      #   default_url_options :host => "myhost.com", :base_path => "my/custom/path"
+      #   #=> http://myhost.com/my/custom/path
+      #
+      def default_url_options(options)
+        set :url_options, options
+      end
+
       # Create a new API version.
       #
       def version(name, &block)
@@ -157,6 +188,13 @@ module Rack
       #
       # The code above will accept only <tt>:json</tt> as format on version <tt>:v1</tt>.
       #
+      # Also, the first value provided to this method will be used as default format,
+      # which means that requests that don't provide the <tt>:format</tt> param, will use
+      # this value.
+      #
+      #   respond_to :fffuuu, :json
+      #   #=> the default format is fffuuu
+      #
       def respond_to(*formats)
         set :formats, formats
       end
@@ -199,8 +237,19 @@ module Rack
         Rack::Mount::Utils.normalize_path([option(:prefix), settings[:version], path].join("/"))
       end
 
-      def build_app(block) # :nodoc:
-        app = App.new(:block => block)
+      def default_format # :nodoc:
+        (option(:formats).first || "json").to_s
+      end
+
+      def build_app(handler) # :nodoc:
+        app = App.new({
+          :handler        => handler,
+          :default_format => default_format,
+          :version        => option(:version),
+          :prefix         => option(:prefix),
+          :url_options    => option(:url_options)
+        })
+
         builder = Rack::Builder.new
 
         # Add middleware for basic authentication.
@@ -208,7 +257,7 @@ module Rack
         builder.use Rack::Auth::Basic, auth[0], &auth[1] if auth && auth != :none
 
         # Add middleware for format validation.
-        builder.use Rack::API::Middleware::Format, option(:formats)
+        builder.use Rack::API::Middleware::Format, default_format, option(:formats)
 
         # Add middlewares to executation stack.
         option(:middlewares, :merge).each {|middleware| builder.use(*middleware)}

data/lib/rack/api/version.rb

@@ -2,8 +2,8 @@ module Rack
   class API
     module Version
       MAJOR = 0
-      MINOR = 1
-      PATCH = 2
+      MINOR = 2
+      PATCH = 0
       STRING = "#{MAJOR}.#{MINOR}.#{PATCH}"
     end
   end

data/rack-api.gemspec

@@ -19,8 +19,9 @@ Gem::Specification.new do |s|
 
   s.add_dependency "rack", "~> 1.2.1"
   s.add_dependency "rack-mount", "~> 0.6.14"
-  s.add_dependency "activesupport", "~> 3.0.6"
+  s.add_dependency "activesupport", "~> 3.0.7"
   s.add_development_dependency "rspec", "~> 2.5.0"
   s.add_development_dependency "rack-test", "~> 0.5.7"
+  s.add_development_dependency "redis", "~> 2.2.0"
   s.add_development_dependency "ruby-debug19" if RUBY_VERSION >= "1.9"
 end

data/spec/rack-api/api_throttling_spec.rb

@@ -0,0 +1,89 @@
+require "spec_helper"
+
+describe Rack::API::Middleware::Limit do
+  let(:action) { proc {|env| [200, {}, ["success"]] } }
+  let(:env) {
+    Rack::MockRequest.env_for("/v1",
+      "REMOTE_ADDR"        => "127.0.0.1",
+      "X-API_KEY"          => "fo7hy7ra",
+      "HTTP_AUTHORIZATION" => basic_auth("admin", "test")
+    )
+  }
+
+  subject { Rack::API::Middleware::Limit.new(action) }
+
+  before do
+    Time.stub :now => Time.parse("2011-04-08 00:00:00")
+    @stamp = Time.now.strftime("%Y%m%d%H")
+
+    begin
+      $redis = Redis.new
+      $redis.del "api:127.0.0.1:#{@stamp}"
+      $redis.del "api:fo7hy7ra:#{@stamp}"
+      $redis.del "api:admin:#{@stamp}"
+      $redis.del "api:whitelist"
+      subject.options.merge!(:with => $redis)
+    rescue Errno::ECONNREFUSED => e
+      pending "Redis is not running"
+    end
+  end
+
+  context "using default options" do
+    it "renders action when limit wasn't exceeded" do
+      results = 60.times.collect { subject.call(env) }
+
+      $redis.get("api:127.0.0.1:#{@stamp}").to_i.should == 60
+      results.last[0].should == 200
+    end
+
+    it "renders 503 when limit was exceeded" do
+      results = 61.times.collect { subject.call(env) }
+
+      $redis.get("api:127.0.0.1:#{@stamp}").to_i.should == 61
+      results.last[0].should == 503
+    end
+  end
+
+  context "using custom options" do
+    it "respects limit" do
+      subject.options.merge!(:limit => 20)
+
+      results = 20.times.collect { subject.call(env) }
+
+      $redis.get("api:127.0.0.1:#{@stamp}").to_i.should == 20
+      results.last[0].should == 200
+    end
+
+    it "uses custom string key" do
+      subject.options.merge!(:key => "X-API_KEY")
+      status, headers, result = subject.call(env)
+
+      $redis.get("api:fo7hy7ra:#{@stamp}").to_i.should == 1
+      status.should == 200
+    end
+
+    it "uses custom block key" do
+      subject.options.merge! :key => proc {|env|
+        request = Rack::Auth::Basic::Request.new(env)
+        request.credentials[0]
+      }
+
+      status, headers, result = subject.call(env)
+
+      $redis.get("api:admin:#{@stamp}").to_i.should == 1
+      status.should == 200
+    end
+  end
+
+  context "whitelist" do
+    it "bypasses API limit" do
+      $redis.sadd("api:whitelist", "127.0.0.1")
+
+      subject.options.merge!(:limit => 5)
+      results = 10.times.collect { subject.call(env) }
+
+      $redis.get("api:127.0.0.1:#{@stamp}").to_i.should == 10
+      results.last[0].should == 200
+    end
+  end
+end

data/spec/rack-api/format_spec.rb

@@ -26,12 +26,39 @@ describe Rack::API, "Format" do
     end
   end
 
+  context "default format" do
+    it "is json" do
+      Rack::API.app do
+        version :v2 do
+          get("/") { {:success => true} }
+        end
+      end
+
+      get "/v2"
+      last_response.headers["Content-Type"].should == "application/json"
+    end
+
+    it "is set to the first respond_to value" do
+      Rack::API::App::MIME_TYPES["fffuuu"] = "application/x-fffuuu"
+
+      Rack::API.app do
+        version :v2 do
+          respond_to :fffuuu, :json
+          get("/") { OpenStruct.new(:to_fffuuu => "Fffuuu") }
+        end
+      end
+
+      get "/v2"
+      last_response.headers["Content-Type"].should == "application/x-fffuuu"
+    end
+  end
+
   context "invalid format" do
     it "renders 406" do
       get "/v1/users.invalid"
 
       last_response.status.should == 406
-      last_response.body.should == "Invalid format"
+      last_response.body.should == "Invalid format. Accepts one of [json, jsonp, awesome, fffuuu, zomg]"
       last_response.headers["Content-Type"].should == "text/plain"
     end
   end

data/spec/rack-api/headers_spec.rb

@@ -6,7 +6,7 @@ describe Rack::API, "Headers" do
       version :v1 do
         get("/users(.:format)") do
           headers["X-Awesome"] = "U R Awesome"
-          headers["Content-Type"] = "application/x-json"
+          headers["Content-Type"] = "application/x-json" # the default json header is application/json
         end
       end
     end

data/spec/rack-api/method_delegation_spec.rb

@@ -0,0 +1,12 @@
+require "spec_helper"
+
+describe Rack::API, "delegators" do
+  subject { Rack::API }
+
+  it { should respond_to(:version) }
+  it { should respond_to(:use) }
+  it { should respond_to(:prefix) }
+  it { should respond_to(:basic_auth) }
+  it { should respond_to(:helper) }
+  it { should respond_to(:default_url_options) }
+end

data/spec/rack-api/runner_spec.rb

@@ -1,6 +1,11 @@
 require "spec_helper"
 
 describe Rack::API::Runner do
+  specify "sanity check for delegate methods" do
+    # remember to update spec/method_delegation_spec.rb
+    Rack::API::Runner::DELEGATE_METHODS.size.should == 7
+  end
+
   it "responds to http methods" do
     subject.should respond_to(:get)
     subject.should respond_to(:post)
@@ -19,6 +24,11 @@ describe Rack::API::Runner do
     subject.option(:prefix).should == "my/awesome/api"
   end
 
+  it "stores default url options" do
+    subject.default_url_options(:host => "example.com")
+    subject.option(:url_options).should == {:host => "example.com"}
+  end
+
   it "stores middleware" do
     subject.use Rack::Auth::Basic
     subject.option(:middlewares, :merge).should == [[Rack::Auth::Basic]]
@@ -30,4 +40,23 @@ describe Rack::API::Runner do
     subject.basic_auth("Get out!", &handler)
     subject.settings[:global][:auth].should == ["Get out!", handler]
   end
+
+  it "initializes application with correct parameters" do
+    expected = {
+      :version => "v1",
+      :url_options => {:host => "mysite.com"},
+      :default_format => "fffuuu",
+      :prefix => "api",
+      :handler => proc {}
+    }
+
+    Rack::API::App.should_receive(:new).with(hash_including(expected)).once
+    subject.version("v1") do
+      respond_to :fffuuu
+      prefix "api"
+      default_url_options :host => "mysite.com"
+
+      get("/", &expected[:handler])
+    end
+  end
 end

data/spec/rack-api/url_for_spec.rb

@@ -0,0 +1,63 @@
+require "spec_helper"
+
+describe Rack::API::App, "#url_for" do
+  subject { Rack::API::App.new(
+    :version => "v1",
+    :url_options => {},
+    :env => Rack::MockRequest.env_for("/v1")
+  )}
+
+  it "returns url considering prefix" do
+    subject.prefix = "api"
+    subject.url_for.should == "http://example.org/api/v1"
+  end
+
+  it "ignores prefix when is not set" do
+    subject.prefix = nil
+    subject.url_for.should == "http://example.org/v1"
+  end
+
+  it "returns host" do
+    subject.url_for.should == "http://example.org/v1"
+  end
+
+  it "uses a different host" do
+    subject.url_options.merge!(:host => "mysite.com")
+    subject.url_for.should == "http://mysite.com/v1"
+  end
+
+  it "uses a different protocol" do
+    subject.url_options.merge!(:protocol => "https")
+    subject.url_for.should == "https://example.org/v1"
+  end
+
+  it "uses a different port" do
+    subject.url_options.merge!(:port => "2345")
+    subject.url_for.should == "http://example.org:2345/v1"
+  end
+
+  it "uses #to_param when available" do
+    subject.url_for("users", mock(:user, :to_param => "1-john-doe")).should == "http://example.org/v1/users/1-john-doe"
+  end
+
+  it "converts other data types" do
+    subject.url_for(:users, 1).should == "http://example.org/v1/users/1"
+  end
+
+  it "adds query string" do
+    actual = subject.url_for(:format => :json, :filters => [:name, :age])
+    actual.should == "http://example.org/v1?filters[]=name&filters[]=age&format=json"
+  end
+
+  it "uses host from request" do
+    env = Rack::MockRequest.env_for("/v1", "SERVER_NAME" => "mysite.com")
+    subject = Rack::API::App.new(:version => "v1", :env => env)
+    subject.url_for.should == "http://mysite.com/v1"
+  end
+
+  it "uses port from request" do
+    env = Rack::MockRequest.env_for("/v1", "SERVER_PORT" => "2345")
+    subject = Rack::API::App.new(:version => "v1", :env => env)
+    subject.url_for.should == "http://example.org:2345/v1"
+  end
+end

data/spec/spec_helper.rb

@@ -2,6 +2,8 @@ require "rack/test"
 require "rspec"
 require "rack/api"
 require "base64"
+require "redis"
+require "ostruct"
 
 Dir[File.dirname(__FILE__) + "/support/**/*.rb"].each {|file| require file}
 

metadata

@@ -2,7 +2,7 @@
 name: rack-api
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors: 
 - Nando Vieira
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-08 00:00:00 Z
+date: 2011-04-19 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rack
@@ -42,7 +42,7 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        version: 3.0.6
+        version: 3.0.7
   type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
@@ -68,16 +68,27 @@ dependencies:
   type: :development
   version_requirements: *id005
 - !ruby/object:Gem::Dependency 
-  name: ruby-debug19
+  name: redis
   prerelease: false
   requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 2.2.0
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug19
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
         version: "0"
   type: :development
-  version_requirements: *id006
+  version_requirements: *id007
 description: Create web app APIs that respond to one or more formats using an elegant DSL.
 email: 
 - fnando.vieira@gmail.com
@@ -110,17 +121,20 @@ files:
 - lib/rack/api/formatter/jsonp.rb
 - lib/rack/api/middleware.rb
 - lib/rack/api/middleware/format.rb
+- lib/rack/api/middleware/limit.rb
 - lib/rack/api/middleware/ssl.rb
 - lib/rack/api/response.rb
 - lib/rack/api/runner.rb
 - lib/rack/api/version.rb
 - rack-api.gemspec
+- spec/rack-api/api_throttling_spec.rb
 - spec/rack-api/basic_auth_spec.rb
 - spec/rack-api/format_spec.rb
 - spec/rack-api/headers_spec.rb
 - spec/rack-api/helpers_spec.rb
 - spec/rack-api/http_methods_spec.rb
 - spec/rack-api/inheritance_spec.rb
+- spec/rack-api/method_delegation_spec.rb
 - spec/rack-api/middlewares_spec.rb
 - spec/rack-api/params_spec.rb
 - spec/rack-api/paths_spec.rb
@@ -128,6 +142,7 @@ files:
 - spec/rack-api/settings_spec.rb
 - spec/rack-api/short_circuit_spec.rb
 - spec/rack-api/ssl_spec.rb
+- spec/rack-api/url_for_spec.rb
 - spec/spec_helper.rb
 - spec/support/awesome_middleware.rb
 - spec/support/core_ext.rb
@@ -162,12 +177,14 @@ signing_key:
 specification_version: 3
 summary: Create web app APIs that respond to one or more formats using an elegant DSL.
 test_files: 
+- spec/rack-api/api_throttling_spec.rb
 - spec/rack-api/basic_auth_spec.rb
 - spec/rack-api/format_spec.rb
 - spec/rack-api/headers_spec.rb
 - spec/rack-api/helpers_spec.rb
 - spec/rack-api/http_methods_spec.rb
 - spec/rack-api/inheritance_spec.rb
+- spec/rack-api/method_delegation_spec.rb
 - spec/rack-api/middlewares_spec.rb
 - spec/rack-api/params_spec.rb
 - spec/rack-api/paths_spec.rb
@@ -175,6 +192,7 @@ test_files:
 - spec/rack-api/settings_spec.rb
 - spec/rack-api/short_circuit_spec.rb
 - spec/rack-api/ssl_spec.rb
+- spec/rack-api/url_for_spec.rb
 - spec/spec_helper.rb
 - spec/support/awesome_middleware.rb
 - spec/support/core_ext.rb