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)792.8k↓26.3%1[4 issues](https://github.com/donatj/Boomerang/issues)[4 PRs](https://github.com/donatj/Boomerang/pulls)MITPHPPHP >=5.4.0CI passing

Since Feb 3Pushed 2d 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 yesterday

READMEChangelog (10)Dependencies (6)Versions (35)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

45

—

FairBetter than 91% of packages

Maintenance54

Moderate activity, may be stable

Popularity37

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 96.3% 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

1144d 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] (8 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (2 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.9k](/packages/davidhsianturi-laravel-compass)[imbo/behat-api-extension

API extension for Behat

1092.6M9](/packages/imbo-behat-api-extension)[fr3d/swagger-assertions

Test your API requests and responses against your swagger definition

139874.2k5](/packages/fr3d-swagger-assertions)[sauce/sausage

PHP version of the Sauce Labs API

70808.5k3](/packages/sauce-sausage)[jkudish/plume

X API v2 client for Laravel — facades, typed DTOs, test fakes, and user-scoped operations.

103.7k](/packages/jkudish-plume)

PHPackages © 2026

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