PHPackages                             mehr-als-nix/assumptions - 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. mehr-als-nix/assumptions

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

mehr-als-nix/assumptions
========================

Assumptions can be used to skip tests when common preconditions, like the PHP Version or installed extensions, are not met.

v4.0.0(8y ago)28.9k21MITPHPPHP >=7.1

Since May 17Pushed 8y ago2 watchersCompare

[ Source](https://github.com/MehrAlsNix/Assumptions)[ Packagist](https://packagist.org/packages/mehr-als-nix/assumptions)[ Docs](http://mehralsnix.github.io/Assumptions)[ RSS](/packages/mehr-als-nix-assumptions/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (7)Dependencies (4)Versions (9)Used By (1)

Assumptions (not only) for PHPUnit.
===================================

[](#assumptions-not-only-for-phpunit)

[![Build Status](https://camo.githubusercontent.com/3349b763ce74c2ce7938d6f238fba70f3e29a55507839f119298690b5e5a502e/68747470733a2f2f7472617669732d63692e6f72672f4d656872416c734e69782f417373756d7074696f6e732e7376673f6272616e63683d646576656c6f70)](https://travis-ci.org/MehrAlsNix/Assumptions) [![Code Climate](https://camo.githubusercontent.com/9c1ba23901e031b1f9b79c582152ac20ec4dbc87ead2548c42e809cc211c7b7e/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f4d656872416c734e69782f417373756d7074696f6e732f6261646765732f6770612e737667)](https://codeclimate.com/github/MehrAlsNix/Assumptions) [![Test Coverage](https://camo.githubusercontent.com/51f9237739a88bab2c793d38e7d2efcb2abd16df58bf42a109ab6f90b5535792/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f4d656872416c734e69782f417373756d7074696f6e732f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/MehrAlsNix/Assumptions/coverage) [![Dependency Status](https://camo.githubusercontent.com/16774b81507b3ff02dd12ab0b35d3917a85d8d7b1d16de3971e1e161b975d45f/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f757365722f70726f6a656374732f3535353861613665623266663664326563633030303336382f62616467652e7376673f7374796c653d666c6174)](https://www.versioneye.com/user/projects/5558aa6eb2ff6d2ecc000368)[![Latest Stable Version](https://camo.githubusercontent.com/b044a8843b6a8aac6363c5622875a56d7a98c51647f04a85f32420912b651a75/68747470733a2f2f706f7365722e707567782e6f72672f6d6568722d616c732d6e69782f617373756d7074696f6e732f762f737461626c65)](https://packagist.org/packages/mehr-als-nix/assumptions) [![Latest Unstable Version](https://camo.githubusercontent.com/ea35d9c6db74ef44d8ab8be137182f924db20896f1415beeb1e6d7c3880e6fc7/68747470733a2f2f706f7365722e707567782e6f72672f6d6568722d616c732d6e69782f617373756d7074696f6e732f762f756e737461626c65)](https://packagist.org/packages/mehr-als-nix/assumptions) [![License](https://camo.githubusercontent.com/0d0ca03c5aff5da47d2e4d8de6eac24fd843b977307befcaf4f56f68ba2c82b6/68747470733a2f2f706f7365722e707567782e6f72672f6d6568722d616c732d6e69782f617373756d7074696f6e732f6c6963656e7365)](https://packagist.org/packages/mehr-als-nix/assumptions) [![Total Downloads](https://camo.githubusercontent.com/c04ba77dcbc4d77c5fe21103aa56f08b4c34e463b759339f08c4b2d5b49a8605/68747470733a2f2f706f7365722e707567782e6f72672f6d6568722d616c732d6e69782f617373756d7074696f6e732f646f776e6c6f616473)](https://packagist.org/packages/mehr-als-nix/assumptions)[![Build status](https://camo.githubusercontent.com/212646c9b0bbbe5d2b6d01cc957693722430b3c056bdaa635e653bc1267e26bb/68747470733a2f2f63692e6170707665796f722e636f6d2f6170692f70726f6a656374732f7374617475732f78716364726c38623632643671726c652f6272616e63682f646576656c6f703f7376673d74727565)](https://ci.appveyor.com/project/siad007/assumptions/branch/develop)

Introduction
------------

[](#introduction)

Assumptions can be used to skip tests when common preconditions, like the PHP Version or installed extensions, are not met.

The default PHPUnit runner treats tests with failing assumptions as skipped. Custom runners may behave differently.

We have included several assumptions like `assumeTrue`, `assumeExtensionLoaded`,... by default. All of those functions are subsumed in assumeThat, with the appropriate `Hamcrest` matcher.

A failing assumption in a `@before` or `@beforeClass` method will have the same effect as a failing assumption in each `@test` method of the class.

---

The concept behind **Assumptions for PHPUnit** is based on the adequate junit feature, which is documented on their [wiki - Assumptions with assume](https://github.com/junit-team/junit/wiki/Assumptions-with-assume)

Note
----

[](#note)

There is a similar feature in PHPUnit called [@requires](https://phpunit.de/manual/current/en/appendixes.annotations.html#appendixes.annotations.requires)!

If you are familiar in using `@requires` annotation to dedicate that a given [requirement](https://phpunit.de/manual/current/en/incomplete-and-skipped-tests.html#incomplete-and-skipped-tests.requires.tables.api) would be given and you are happy about, then you just do not need the use of **Assumption for PHPUnit**.

But if you want to have

- code completion
- better readability
- finer control
- more requirement abilities

then you should give **Assumption for PHPUnit** a try.

---

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

[](#requirements)

- PHP >= 7.1

if you are looking for a version which supports PHP < 7.0.7 just use the v2.0.0

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

[](#installation)

[see wiki:installation](https://github.com/MehrAlsNix/Assumptions/wiki/1.-Installation)

Assumptions
-----------

[](#assumptions)

[see wiki:assumptions](https://github.com/MehrAlsNix/Assumptions/wiki/2.-Assumptions)

Examples
--------

[](#examples)

[see wiki:examples](https://github.com/MehrAlsNix/Assumptions/wiki/3.-Examples)

ResultPrinter
-------------

[](#resultprinter)

[see wiki:result-printer](https://github.com/MehrAlsNix/Assumptions/wiki/4.-ResultPrinter)

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~167 days

Recently: every ~249 days

Total

7

Last Release

3017d ago

Major Versions

v1.1.0 → v2.0.02015-10-10

v2.0.0 → v3.0.02017-06-05

v3.0.0 → v4.0.02018-02-12

PHP version history (4 changes)v1.0.0PHP >=5.6

v1.1.0PHP >=5.4

v3.0.0PHP >=7.0.7

v4.0.0PHP >=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/197f7436c47067343def1d182dd597dbd104774fe17071e0b983487dc3652fe8?d=identicon)[siad007](/maintainers/siad007)

---

Top Contributors

[![siad007](https://avatars.githubusercontent.com/u/2149445?v=4)](https://github.com/siad007 "siad007 (105 commits)")

---

Tags

phpunittestingtestingphpunit

### Embed Badge

![Health badge](/badges/mehr-als-nix-assumptions/health.svg)

```
[![Health](https://phpackages.com/badges/mehr-als-nix-assumptions/health.svg)](https://phpackages.com/packages/mehr-als-nix-assumptions)
```

###  Alternatives

[brianium/paratest

Parallel testing for PHP

2.5k118.8M754](/packages/brianium-paratest)[spatie/phpunit-snapshot-assertions

Snapshot testing with PHPUnit

69617.9M510](/packages/spatie-phpunit-snapshot-assertions)[phpunit/phpunit-selenium

Selenium Server integration for PHPUnit

59610.9M150](/packages/phpunit-phpunit-selenium)[yoast/phpunit-polyfills

Set of polyfills for changed PHPUnit functionality to allow for creating PHPUnit cross-version compatible tests

18438.5M841](/packages/yoast-phpunit-polyfills)[ta-tikoma/phpunit-architecture-test

Methods for testing application architecture

10745.9M13](/packages/ta-tikoma-phpunit-architecture-test)[matthiasnoback/symfony-config-test

Library for testing user classes related to the Symfony Config Component

1679.8M395](/packages/matthiasnoback-symfony-config-test)

PHPackages © 2026

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