franzliedke / rack-remote

Small request intercepting rack middleware to invoke remote calls over HTTP.

Rack::Remote

Rack::Remote is a small request intercepting Rack middleware to invoke remote calls over HTTP. This can be used to invoke e.g. factories on remote services for running integration tests on distributed applications.

Installation

Add this line to your application's Gemfile:

gem 'rack-remote'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rack-remote

Usage

On server/service side

Register available remote calls:

Rack::Remote.register :factory_girl do |params, env, request|
  FactoryGirl.create params[:factory]
end

Return value can be a Rack response array or any object that will be converted to JSON.

On client side

Rack::Remote.add :srv1, url: 'http://serv.domain.tld/proxyed/path'
Rack::Remote.invoke :srv1, :factory_girl, factory: 'user'
Rack::Remote.invoke 'http://serv.domain.tld/proxyed/path', :factory_girl, factory: 'user'

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Add specs
4. Add features
5. Commit your changes (git commit -am 'Add some feature')
6. Push to the branch (git push origin my-new-feature)
7. Create new Pull Request