Add isFloat, isBool, isArray type checking methods and isJson string method with tests and README updates

Author: k2gl

README.md

@@ -169,6 +169,9 @@ fact('hello')->isEmptyString(); // Fails
 
 fact('hello')->isNotEmptyString(); // Passes
 fact('')->isNotEmptyString(); // Fails
+
+fact('{"key": "value"}')->isJson(); // Passes
+fact('invalid json')->isJson(); // Fails
 ```
 
 ### Type Checking assertions
@@ -190,6 +193,15 @@ fact((object)['name' => 'John'])->hasProperty('age'); // Fails
 
 fact(new stdClass())->hasMethod('__construct'); // Passes
 fact(new stdClass())->hasMethod('nonExistentMethod'); // Fails
+
+fact(3.14)->isFloat(); // Passes
+fact(42)->isFloat(); // Fails
+
+fact(true)->isBool(); // Passes
+fact(1)->isBool(); // Fails
+
+fact([1, 2])->isArray(); // Passes
+fact('not array')->isArray(); // Fails
 ```
 
 ## Pull requests are always welcome

src/Traits/StringAssertions.php

@@ -293,5 +293,25 @@ public function isNotEmptyString(string $message = ''): self
         return $this;
     }
 
+    /**
+     * Asserts that a string is valid JSON.
+     *
+     * This method checks if the actual string is valid JSON.
+     *
+     * Example usage:
+     * fact('{"key": "value"}')->isJson(); // Passes
+     * fact('invalid json')->isJson(); // Fails
+     *
+     * @param string $message Optional custom error message.
+     *
+     * @return self Enables fluent chaining of assertion methods.
+     */
+    public function isJson(string $message = ''): self
+    {
+        Assert::assertTrue(json_validate($this->variable), $message ?: 'String is not valid JSON.');
+
+        return $this;
+    }
+
     // endregion Length Methods
 }

src/Traits/TypeCheckingAssertions.php

@@ -135,4 +135,64 @@ public function hasMethod(string $method, string $message = ''): self
 
         return $this;
     }
+
+    /**
+     * Asserts that a variable is of type float.
+     *
+     * This method checks if the actual value is a floating-point number.
+     *
+     * Example usage:
+     * fact(3.14)->isFloat(); // Passes
+     * fact(42)->isFloat(); // Fails
+     *
+     * @param string $message Optional custom error message.
+     *
+     * @return self Enables fluent chaining of assertion methods.
+     */
+    public function isFloat(string $message = ''): self
+    {
+        Assert::assertIsFloat($this->variable, $message);
+
+        return $this;
+    }
+
+    /**
+     * Asserts that a variable is of type bool.
+     *
+     * This method checks if the actual value is a boolean.
+     *
+     * Example usage:
+     * fact(true)->isBool(); // Passes
+     * fact(1)->isBool(); // Fails
+     *
+     * @param string $message Optional custom error message.
+     *
+     * @return self Enables fluent chaining of assertion methods.
+     */
+    public function isBool(string $message = ''): self
+    {
+        Assert::assertIsBool($this->variable, $message);
+
+        return $this;
+    }
+
+    /**
+     * Asserts that a variable is of type array.
+     *
+     * This method checks if the actual value is an array.
+     *
+     * Example usage:
+     * fact([1, 2])->isArray(); // Passes
+     * fact('not array')->isArray(); // Fails
+     *
+     * @param string $message Optional custom error message.
+     *
+     * @return self Enables fluent chaining of assertion methods.
+     */
+    public function isArray(string $message = ''): self
+    {
+        Assert::assertIsArray($this->variable, $message);
+
+        return $this;
+    }
 }

tests/FluentAssertions/Asserts/IsArray/IsArrayTest.php

@@ -0,0 +1,53 @@
+<?php declare(strict_types=1);
+
+namespace K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\Asserts\IsArray;
+
+use K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\FluentAssertionsTestCase;
+use K2gl\PHPUnitFluentAssertions\FluentAssertions;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\DataProvider;
+
+use function K2gl\PHPUnitFluentAssertions\fact;
+
+#[CoversMethod(className: FluentAssertions::class, methodName: 'isArray')]
+final class IsArrayTest extends FluentAssertionsTestCase
+{
+    #[DataProvider('isArrayDataProvider')]
+    public function testIsArray(mixed $variable): void
+    {
+        // act
+        fact($variable)->isArray();
+
+        // assert
+        $this->correctAssertionExecuted();
+    }
+
+    #[DataProvider('notIsArrayDataProvider')]
+    public function testNotIsArray(mixed $variable): void
+    {
+        // assert
+        $this->incorrectAssertionExpected();
+
+        // act
+        fact($variable)->isArray();
+    }
+
+    public static function isArrayDataProvider(): array
+    {
+        return [
+            [[]],
+            [[1, 2, 3]],
+            [['key' => 'value']],
+        ];
+    }
+
+    public static function notIsArrayDataProvider(): array
+    {
+        return [
+            ['string'],
+            [42],
+            [true],
+            [null],
+        ];
+    }
+}

tests/FluentAssertions/Asserts/IsBool/IsBoolTest.php

@@ -0,0 +1,52 @@
+<?php declare(strict_types=1);
+
+namespace K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\Asserts\IsBool;
+
+use K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\FluentAssertionsTestCase;
+use K2gl\PHPUnitFluentAssertions\FluentAssertions;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\DataProvider;
+
+use function K2gl\PHPUnitFluentAssertions\fact;
+
+#[CoversMethod(className: FluentAssertions::class, methodName: 'isBool')]
+final class IsBoolTest extends FluentAssertionsTestCase
+{
+    #[DataProvider('isBoolDataProvider')]
+    public function testIsBool(mixed $variable): void
+    {
+        // act
+        fact($variable)->isBool();
+
+        // assert
+        $this->correctAssertionExecuted();
+    }
+
+    #[DataProvider('notIsBoolDataProvider')]
+    public function testNotIsBool(mixed $variable): void
+    {
+        // assert
+        $this->incorrectAssertionExpected();
+
+        // act
+        fact($variable)->isBool();
+    }
+
+    public static function isBoolDataProvider(): array
+    {
+        return [
+            [true],
+            [false],
+        ];
+    }
+
+    public static function notIsBoolDataProvider(): array
+    {
+        return [
+            [1],
+            [0],
+            ['true'],
+            [null],
+        ];
+    }
+}

tests/FluentAssertions/Asserts/IsFloat/IsFloatTest.php

@@ -0,0 +1,53 @@
+<?php declare(strict_types=1);
+
+namespace K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\Asserts\IsFloat;
+
+use K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\FluentAssertionsTestCase;
+use K2gl\PHPUnitFluentAssertions\FluentAssertions;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\DataProvider;
+
+use function K2gl\PHPUnitFluentAssertions\fact;
+
+#[CoversMethod(className: FluentAssertions::class, methodName: 'isFloat')]
+final class IsFloatTest extends FluentAssertionsTestCase
+{
+    #[DataProvider('isFloatDataProvider')]
+    public function testIsFloat(mixed $variable): void
+    {
+        // act
+        fact($variable)->isFloat();
+
+        // assert
+        $this->correctAssertionExecuted();
+    }
+
+    #[DataProvider('notIsFloatDataProvider')]
+    public function testNotIsFloat(mixed $variable): void
+    {
+        // assert
+        $this->incorrectAssertionExpected();
+
+        // act
+        fact($variable)->isFloat();
+    }
+
+    public static function isFloatDataProvider(): array
+    {
+        return [
+            [3.14],
+            [0.0],
+            [-1.5],
+        ];
+    }
+
+    public static function notIsFloatDataProvider(): array
+    {
+        return [
+            [42],
+            ['3.14'],
+            [true],
+            [null],
+        ];
+    }
+}

tests/FluentAssertions/Asserts/IsJson/IsJsonTest.php

@@ -0,0 +1,55 @@
+<?php declare(strict_types=1);
+
+namespace K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\Asserts\IsJson;
+
+use K2gl\PHPUnitFluentAssertions\Tests\FluentAssertions\FluentAssertionsTestCase;
+use K2gl\PHPUnitFluentAssertions\FluentAssertions;
+use PHPUnit\Framework\Attributes\CoversMethod;
+use PHPUnit\Framework\Attributes\DataProvider;
+
+use function K2gl\PHPUnitFluentAssertions\fact;
+
+#[CoversMethod(className: FluentAssertions::class, methodName: 'isJson')]
+final class IsJsonTest extends FluentAssertionsTestCase
+{
+    #[DataProvider('isJsonDataProvider')]
+    public function testIsJson(mixed $variable): void
+    {
+        // act
+        fact($variable)->isJson();
+
+        // assert
+        $this->correctAssertionExecuted();
+    }
+
+    #[DataProvider('notIsJsonDataProvider')]
+    public function testNotIsJson(mixed $variable): void
+    {
+        // assert
+        $this->incorrectAssertionExpected();
+
+        // act
+        fact($variable)->isJson();
+    }
+
+    public static function isJsonDataProvider(): array
+    {
+        return [
+            ['{"key": "value"}'],
+            ['[1, 2, 3]'],
+            ['"string"'],
+            ['42'],
+            ['true'],
+        ];
+    }
+
+    public static function notIsJsonDataProvider(): array
+    {
+        return [
+            ['invalid json'],
+            ['{key: value}'],
+            [''],
+            ['not json'],
+        ];
+    }
+}