PHPackages                             boomerang/boomerang - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. boomerang/boomerang

ActiveLibrary[Testing & Quality](/categories/testing)

boomerang/boomerang
===================

The Boomerang API Endpoint Testing Framework.

v0.4.3(3y ago)787.7k↑52.3%1[1 issues](https://github.com/donatj/Boomerang/issues)[3 PRs](https://github.com/donatj/Boomerang/pulls)MITPHPPHP >=5.4.0CI passing

Since Feb 3Pushed 5mo ago2 watchersCompare

[ Source](https://github.com/donatj/Boomerang)[ Packagist](https://packagist.org/packages/boomerang/boomerang)[ Docs](https://boomerang.work/)[ Fund](https://www.paypal.me/donatj/15)[ GitHub Sponsors](https://github.com/donatj)[ RSS](/packages/boomerang-boomerang/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (32)Used By (0)

Boomerang!
==========

[](#boomerang)

[![Latest Stable Version](https://camo.githubusercontent.com/1f15f53f3fe41fb6e0d140cc52a146b69556522467b93ff2426c9da134ead316/68747470733a2f2f706f7365722e707567782e6f72672f626f6f6d6572616e672f626f6f6d6572616e672f762f737461626c652e737667)](https://packagist.org/packages/boomerang/boomerang)[![Total Downloads](https://camo.githubusercontent.com/525deb42bea7eb8ccf9cd9d2dc149d51facd968aa39a31ccf6de36853ea0069c/68747470733a2f2f706f7365722e707567782e6f72672f626f6f6d6572616e672f626f6f6d6572616e672f646f776e6c6f6164732e737667)](https://packagist.org/packages/boomerang/boomerang)[![Latest Unstable Version](https://camo.githubusercontent.com/dd320f64daaa9814bd927924eb46826fedf6766e43420017b90ad620d51137bb/68747470733a2f2f706f7365722e707567782e6f72672f626f6f6d6572616e672f626f6f6d6572616e672f762f756e737461626c652e737667)](https://packagist.org/packages/boomerang/boomerang)[![License](https://camo.githubusercontent.com/c330d18ffe458eb919102bd85b67f45f348abb0952e2604b5a3155bd48502370/68747470733a2f2f706f7365722e707567782e6f72672f626f6f6d6572616e672f626f6f6d6572616e672f6c6963656e73652e737667)](https://packagist.org/packages/boomerang/boomerang)[![CI](https://github.com/donatj/Boomerang/workflows/CI/badge.svg)](https://github.com/donatj/Boomerang/workflows/CI/badge.svg)

Boomerang! is a simple Frisby.js inspired API E2E 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 active development and more info is coming soon!

Documentation and more information is availible at

Requirements
------------

[](#requirements)

- PHP 5.4.0+ with CLI and SPL
- \*nix or cygwin on windows.

Installation
------------

[](#installation)

Using composer, `boomerang` can be installed globally via:

```
$ composer global require 'boomerang/boomerang'
```

Or if you are using composer for the project you wish to test, you can simply add it as a [vendor binary](https://getcomposer.org/doc/articles/vendor-binaries.md):

```
{
  "require-dev": {
      "boomerang/boomerang": "~0.2.0"
  }
}
```

Development
-----------

[](#development)

```
$ git clone https://github.com/donatj/Boomerang.git Boomerang
$ cd Boomerang
$ composer.phar install
```

### Basic Execution

[](#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

[](#building-a-phar)

You will need Composer to fetch the requirements

```
$ php create-phar.php
```

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance46

Moderate activity, may be stable

Popularity36

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~178 days

Recently: every ~276 days

Total

20

Last Release

1098d ago

Major Versions

v0.3.0 → v1.x-dev2020-05-07

PHP version history (3 changes)v0.1.1-alphaPHP >=5.3.2

v0.2.0PHP >=5.4.0

v1.x-devPHP >=7.1.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/a57a02ba022451a54d4b65e227ce3d032cadc638a644c2d4b56f0313632ee656?d=identicon)[donatj](/maintainers/donatj)

---

Top Contributors

[![donatj](https://avatars.githubusercontent.com/u/133747?v=4)](https://github.com/donatj "donatj (341 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![bitdeli-chef](https://avatars.githubusercontent.com/u/3092978?v=4)](https://github.com/bitdeli-chef "bitdeli-chef (1 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")

---

Tags

api-testingphptestingtestingapi

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/boomerang-boomerang/health.svg)

```
[![Health](https://phpackages.com/badges/boomerang-boomerang/health.svg)](https://phpackages.com/packages/boomerang-boomerang)
```

###  Alternatives

[davidhsianturi/laravel-compass

An elegant REST assistent for the Laravel framework.

1.3k84.5k](/packages/davidhsianturi-laravel-compass)[imbo/behat-api-extension

API extension for Behat

1082.5M9](/packages/imbo-behat-api-extension)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)