Merge pull request #25 from faissaloux/tobeminof

`toBeMinOf()`

Author: faissaloux

Diff for: README.md

@@ -24,6 +24,12 @@ This plugin afford math related expectations.
     expect(5.5)->not->toBeMaxOf([2, 4.2, 5.5, 6]);
 ```
 
+#### `toBeMinOf()`
+```php
+    expect(-6)->toBeMinOf([-6, 0, 1]);
+    expect(5.5)->not->toBeMinOf([2, 4.2, 5.5, 6]);
+```
+
 #### `toBeEven()`
 ```php
     expect(6)->toBeEven();

Diff for: src/Expectation.php

@@ -144,4 +144,13 @@ public function toBeMaxOf(array $stack): PestExpectation
     {
         return expect($this->value === max($stack))->toBeTrue();
     }
+
+    /**
+     * @param  array<int|float>  $stack
+     * @return PestExpectation<TValue>
+     */
+    public function toBeMinOf(array $stack): PestExpectation
+    {
+        return expect($this->value === min($stack))->toBeTrue();
+    }
 }

Diff for: tests/toBeMinOf.php

@@ -0,0 +1,27 @@
+<?php
+
+use PHPUnit\Framework\ExpectationFailedException;
+
+it('passes', function (int|float $value, array $stack): void {
+    expect($value)->toBeMinOf($stack);
+})->with([
+    [-6, [-6, 0, 1]],
+    [-6, [-6, -2, -1]],
+    [2.4, [2.4, 4.2, 6]],
+]);
+
+it('passes not', function (int|float $value, array $stack): void {
+    expect($value)->not->toBeMinOf($stack);
+})->with([
+    [4, [2, 4, 6]],
+    [0, [2, 4]],
+    [5.5, [2, 4.2, 5.5, 6]],
+]);
+
+test('failures', function (): void {
+    expect(4)->toBeMinOf([2, 4, 6]);
+})->throws(ExpectationFailedException::class);
+
+test('failures not', function (): void {
+    expect(2)->not->toBeMinOf([2, 4, 6]);
+})->throws(ExpectationFailedException::class);