Added mutation testing and readme badge.

Added public constants for constructor default thresholds.

.gitignore

@@ -1,3 +1,4 @@
-/vendor/
-/.*/
-/composer.lock
+/vendor/
+/.*/
+/composer.lock
+/*.log

.travis.yml

@@ -26,7 +26,9 @@ install:
   - composer update --no-progress --no-suggest $DEPENDENCIES
 
 script:
-  - composer test -- --coverage-clover=build/logs/clover.xml
+  - composer test -- --coverage-clover=build/logs/clover.xml --coverage-xml=build/coverage/coverage-xml
+      --log-junit=build/coverage/phpunit.junit.xml
+  - vendor/bin/infection --min-msi=95 --threads="$(($(nproc) * 2))" --coverage=build/coverage
 
 after_success:
   - composer require php-coveralls/php-coveralls:^2

README.md

@@ -4,6 +4,7 @@ Async Throttle
 [![Latest version][Version image]][Releases]
 [![Total downloads][Downloads image]][Downloads]
 [![Build status][Build image]][Build]
+[![Mutation score][MSI image]][Build]
 [![Test coverage][Coverage image]][Coverage]
 [![Code style][Style image]][Style]
 
@@ -16,6 +17,7 @@ Throttles async object throughput.
   [Downloads image]: https://poser.pugx.org/async/throttle/downloads "Total downloads"
   [Build]: https://travis-ci.org/ScriptFUSION/Async-Throttle
   [Build image]: https://travis-ci.org/ScriptFUSION/Async-Throttle.svg?branch=master "Build status"
+  [MSI image]: https://badge.stryker-mutator.io/github.com/ScriptFUSION/Async-Throttle/master
   [Coverage]: https://coveralls.io/github/ScriptFUSION/Async-Throttle
   [Coverage image]: https://coveralls.io/repos/ScriptFUSION/Async-Throttle/badge.svg "Test coverage"
   [Style]: https://styleci.io/repos/131506544

composer.json

@@ -13,7 +13,7 @@
   },
   "require-dev": {
     "amphp/phpunit-util": "^1.1",
-    "infection/infection": "*",
+    "infection/infection": "^0.14",
     "phpunit/phpunit": "^7.5"
   },
   "autoload": {

infection.json.dist → infection.json

@@ -9,7 +9,10 @@
         "configDir": "test"
     },
     "logs": {
-        "text": "infection.log"
+        "text": "infection.log",
+        "badge": {
+            "branch": "master"
+        }
     },
     "mutators": {
         "@default": true

src/Throttle.php

@@ -14,6 +14,16 @@
  */
 class Throttle
 {
+    /**
+     * Maximum number of promises per second.
+     */
+    public const DEFAULT_PER_SECOND = 75;
+
+    /**
+     * Maximum number of concurrent promises.
+     */
+    public const DEFAULT_CONCURRENCY = 30;
+
     /**
      * Milliseconds to wait before reevaluating thresholds when above chrono threshold.
      */
@@ -51,8 +61,10 @@ class Throttle
      * @param int $maxPerSecond Optional. Maximum number of promises per second.
      * @param int $maxConcurrency Optional. Maximum number of concurrent promises.
      */
-    public function __construct(int $maxPerSecond = 75, int $maxConcurrency = 30)
-    {
+    public function __construct(
+        int $maxPerSecond = self::DEFAULT_PER_SECOND,
+        int $maxConcurrency = self::DEFAULT_CONCURRENCY
+    ) {
         $this->maxPerSecond = $maxPerSecond;
         $this->maxConcurrency = $maxConcurrency;
     }

test/ThrottleTest.php

@@ -58,6 +58,9 @@ public function testThroughput(): \Generator
         self::assertLessThanOrEqual(.1, microtime(true) - $start);
     }
 
+    /**
+     * Tests that 100 promises that resolve immediately are throttled only once the chrono threshold is hit.
+     */
     public function testThroughput2(): \Generator
     {
         $this->throttle->setMaxConcurrency(1);