The Boomerang API Endpoint Testing Framework.

Installs: 7 968

Dependents: 0

Stars: 6

Watchers: 1

Open Issues: 5

v0.1.8-alpha 2015-07-30 22:34 UTC


Latest Stable Version Total Downloads Latest Unstable Version License Build Status Dependency Status Scrutinizer Code Quality

Boomerang! is a simple Frisby.js inspired API endpoint testing framework, providing the tools you need to validate REST responses.

Boomerang! consumes your API and validates your defined set of expectations, alerting you to any problems that arise.

Boomerang! is still in development and more info is coming soon!


  • PHP 5.3.0+ with CLI and SPL
  • *nix or cygwin on windows.


Using composer, boomerang can be installed globally via:

$ composer global require 'boomerang/boomerang=dev-master'

Or if you are using composer for the project you wish to test, you can simply add it as a vendor binary:

  "require-dev": {
      "boomerang/boomerang": "dev-master"


$ git clone Boomerang
$ cd Boomerang
$ composer.phar install

Basic Execution

The easiest way to test is simply using the composer executable.

From the root of the cloned project, execute

$ ./vendor/bin/boomerang

Building a Phar

You will need Composer to fetch the requirements

$ php create-phar.php