Endpointer

Endpointer is a small gem that tries to act as a caching proxy between your dev machine and any web service. The motivation was to provide an easy to configure and use fake web service that is able to host any amount of resources, returning canned responses, that are easy to modify. Please note the gem is still in early and active development and as such some features may be missing. For a list of features that are still missing consult the list at the end of this readme. If you would like a feature please feel free to raise an issue or a pull request. All contributions are welcome.

Requirements

• Ruby 2.2+ (Tests running against MRI 2.4.0, 2.3.3, and JRuby 9.1.6.0)

Installation

Add this line to your Gemfile:

gem 'endpointer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install endpointer

Usage

In order to use Endpointer you need to create a JSON configuration file with the following format

[
  {
    "id": "some_unique_identifier_for_the_resource",
    "method": "get",
    "url": "http://httpbin.org/get",
    "headers": {
      "Authorization": "Bearer test",
      "Accept": "application/json"
    }
  },
  ...
]

You can then invoke endpointer by executing

$ endpointer [--invalidate] <path_to_json_config_file>

Or, include it in a config.ru

#config.ru
require 'endpointer'

run Endpointer.app(['--invalidate', '<path_to_json_file>'])

Endpointer will attempt to return a cached resource, if one is found to match the request. Otherwise, a call to the real service will be performed and the response, if successful, persisted.

A simple example request to endpointer using cURL:

$ curl http://localhost:4567/get

If the request is to be executed against the real service the headers defined in the config will be used with their default values unless overridden. An example request overriding the Accept header follows.

$ curl -H "Accept: text/plain" http://localhost:4567/get

Caching

By default endpointer will use your operating system's temp directory to store its cache files (TMP_DIR/endpointer_cache). In order to configure the cache path you need to pass the --cache-dir=<path> argument.

$ endpointer [--invalidate] [--cache-dir=/path/to/cache] <path_to_json_config_file>

You can provide the --invalidate flag to the command line to invalidate the cache. This empties the endpointer_cache directory.

Development

After checking out the repo, run bundle install to install dependencies. Then, run rake to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/zenonas/endpointer. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Upcoming features

As mentioned above I'm actively going to work on improving endpointer and the following are a few features that I would like to see implemented. Feel free to suggest new ones or work on one yourself.

• The ability to easily edit cached files. Maybe a second executable that allows you to edit the canned responses in a pretty JSON format
• A --debug flag to the command line that will give a pry window on every request allowing you to play with the Request and Response objects.
• Configurable port(this can already be done if using config.ru)
• Support multiple key/value stores for caching. Currently only uses local YAML files. One Suggestion is Redis support.

License

The gem is available as open source under the terms of the MIT License.