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 &amp; Quality](/categories/testing)
4. /
5. boomerang/boomerang

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

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

The Boomerang API Endpoint Testing Framework.

v0.4.3(3y ago)794.7k↓18.7%1[3 issues](https://github.com/donatj/Boomerang/issues)[2 PRs](https://github.com/donatj/Boomerang/pulls)MITPHPPHP &gt;=5.4.0CI passing

Since Feb 3Pushed 1w 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 2w ago

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 7.4+ with the CLI, cURL, SPL, and JSON extensions
- A Unix-like environment (or Cygwin on Windows)

Continuous integration tests PHP 7.4 through PHP 8.5.

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

[](#installation)

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

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

Or add it to the project you wish to test as a [vendor binary](https://getcomposer.org/doc/articles/vendor-binaries.md):

```
$ composer require --dev boomerang/boomerang
```

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

[](#development)

```
$ git clone https://github.com/donatj/Boomerang.git Boomerang
$ cd Boomerang
$ composer 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

Maintenance56

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 95.5% 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

1189d ago

Major Versions

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

PHP version history (3 changes)v0.1.1-alphaPHP &gt;=5.3.2

v0.2.0PHP &gt;=5.4.0

v1.x-devPHP &gt;=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 (360 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (3 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.3k85.5k](/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

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

PHP version of the Sauce Labs API

67808.8k3](/packages/sauce-sausage)[shahghasiadil/laravel-bruno-generator

Generate Bruno API collections from Laravel routes with automatic request body inference and environment support

262.0k](/packages/shahghasiadil-laravel-bruno-generator)[jkudish/plume

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

105.4k](/packages/jkudish-plume)

PHPackages © 2026

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