Skip to content
📦 Some cool extensions for PHPUnit
PHP
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/Runners/SlowestTests Move runners parameters to the beggining Jan 8, 2020
.editorconfig Init commit Jan 4, 2020
.gitattributes Init commit Jan 4, 2020
.gitignore Init commit Jan 4, 2020
.phpunit.result.cache
.scrutinizer.yml
.styleci.yml
.travis.yml
CHANGELOG.md Update changelog Jan 8, 2020
CONTRIBUTING.md
LICENSE.md Init commit Jan 4, 2020
README.md
composer.json
phpunit.xml.dist

README.md

PHPUnit Extensions

Latest Version on Packagist Build Status Quality Score Total Downloads Buy us a tree

This package provides you a few useful extensions for your testsuite in an effort to improve your code.

Installation

You can install the package via composer:

composer require lloople/phpunit-extensions --dev

Add the Extension to your phpunit.xml file:

<extensions>
    <extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\Console" />
</extensions>

Extensions

Console

Output the slowest tests on the console.

<extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\Console"/>
Showing the top 5 slowest tests:
  543 ms: Tests\Feature\ProfileTest::can_upload_new_profile_image
   26 ms: Tests\Feature\ProfileTest::can_visit_profile_page
   25 ms: Tests\Feature\ProfileTest::throws_validation_error_if_password_not_match

Default options are:

  • rows: 5 (Report 5 tests max)
  • min: 200 (Report tests slower than 200ms)

Csv

Write the tests in a CSV file ready for import.

<extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\Csv"/>

Default options are:

  • file: phpunit_results.csv
  • rows: null (all the tests)
  • min: 200

Json

Write the tests in a JSON file ready for import.

<extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\Json"/>

Default options are:

  • file: phpunit_results.json
  • rows: null (all the tests)
  • min: 200

MySQL

Store the test name and the time into a MySQL database. It will override existing records

<extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\MySQL"/>

Default credentials are (as array):

  • database: phpunit_results
  • table: default
  • username: root
  • password: ``
  • host: 127.0.0.1
  • rows: null (all the tests)
  • min: 200

SQLite

Store the test name and the time into a SQLite database. It will override existing records

<extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\SQLite"/>

Default credentials are (as array):

  • database: phpunit_results.db
  • table: default
  • rows: null (all the tests)
  • min: 200

Arguments

To override the default configuration per extension, you need to use <arguments>in your phpunit.xml file

<extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\Json">
  <arguments>
    <string>phpunit_results_as_json.json</string>
    <integer>10</integer> <!-- Max number of tests to report. -->
    <integer>400</integer> <!-- Min miliseconds to report a test. -->
  </arguments>
</extension>

In the case of the MySQL and SQLite, which needs a database connection, configuration goes as array

<extension class="Lloople\PHPUnitExtensions\Runners\SlowestTests\MySQL">
  <arguments>
    <array>
      <element key="database">
        <string>my_phpunit_results</string>
      </element>
      <element key="table">
        <string>project1_test_results</string>
      </element>
      <element key="username">
        <string>homestead</string>
      </element>
      <element key="password">
        <string>secret</string>
      </element>
      <element key="host">
        <string>192.168.12.14</string>
      </element>
    </array>
  </arguments>
</extension>

You don't need to override those credentials that already fit to your usecase, since the class will merge your configuration with the default one

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email d.lloople@icloud.com instead of using the issue tracker.

Credits

Treeware

You're free to use this package, but if it is really useful for you I would highly appreciate you buying the world a tree.

It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to plant trees. If you contribute to James Mill's forest you’ll be creating employment for local families and restoring wildlife habitats.

You can buy trees at for James forest here offset.earth/jamesmills

You can’t perform that action at this time.