Merge remote-tracking branch 'origin/main' into issue-1

Author: Gummibeer

README.md

@@ -24,7 +24,7 @@ This will prevent any method name conflicts with core, your custom or other trai
 
 ### Country
 
-`composer require --dev league/iso3166`
+`composer require --dev league/iso3166:^3.0`
 
 ```php
 \Astrotomic\PhpunitAssertions\CountryAssertions::assertCountryName('Germany');
@@ -35,7 +35,7 @@ This will prevent any method name conflicts with core, your custom or other trai
 
 ### Email
 
-`composer require --dev egulias/email-validator`
+`composer require --dev egulias/email-validator:^3.0`
 
 ```php
 \Astrotomic\PhpunitAssertions\EmailAssertions::assertValidLoose('gummibeer@astrotomic.info');
@@ -57,7 +57,7 @@ This will prevent any method name conflicts with core, your custom or other trai
 
 ### HashID
 
-`composer require --dev hashids/hashids`
+`composer require --dev hashids/hashids:^4.0`
 
 ```php
 \Astrotomic\PhpunitAssertions\HashidAssertions::assertHashIds('3kTMd', 2, 'this is my salt');
@@ -76,7 +76,7 @@ This will prevent any method name conflicts with core, your custom or other trai
 
 ### Phone Number
 
-`composer require --dev giggsey/libphonenumber-for-php`
+`composer require --dev giggsey/libphonenumber-for-php:^8.12`
 
 ```php
 \Astrotomic\PhpunitAssertions\PhoneNumberAssertions::assertE164('+498001110550');
@@ -107,7 +107,7 @@ This will prevent any method name conflicts with core, your custom or other trai
 
 ### UUID
 
-`composer require --dev ramsey/uuid`
+`composer require --dev ramsey/uuid:^4.0`
 
 ```php
 \Astrotomic\PhpunitAssertions\UuidAssertions::assertUuid('52d08e38-ad24-4960-af02-22e0f7e0db8d');
@@ -118,12 +118,12 @@ This will prevent any method name conflicts with core, your custom or other trai
 ### Collection
 
 ```php
-\Astrotomic\PhpunitAssertions\Laravel\CollectionAssertions::assertContains('Astrotomic', collect(['Astrotomic', 'Gummibeer']));
+\Astrotomic\PhpunitAssertions\Laravel\CollectionAssertions::assertContains($collection, 'Astrotomic');
 ```
 
 ### HashID
 
-`composer require --dev vinkla/hashids`
+`composer require --dev vinkla/hashids:^9.0`
 
 ```php
 \Astrotomic\PhpunitAssertions\Laravel\HashidAssertions::assertHashIds('3kTMd', 2);
@@ -134,5 +134,17 @@ This will prevent any method name conflicts with core, your custom or other trai
 
 ```php
 \Astrotomic\PhpunitAssertions\Laravel\ModelAssertions::assertExists($model);
-\Astrotomic\PhpunitAssertions\Laravel\ModelAssertions::assertSame($model, Model::first());
+\Astrotomic\PhpunitAssertions\Laravel\ModelAssertions::assertSame($model, \App\Models\User::first());
+```
+
+### Blade
+
+`composer require --dev gajus/dindent:^2.0`
+
+```php
+\Astrotomic\PhpunitAssertions\Laravel\BladeAssertions::assertRenderEquals(
+    "<p>Price: <code>99.99 €</code></p>",
+    '<p>Price: <code>{{ number_format($price, 2) }} €</code></p>',
+    ['price' => 99.99]
+);
 ```

composer.json

@@ -21,6 +21,7 @@
     },
     "require-dev": {
         "egulias/email-validator": "^2.1 || ^3.0",
+        "gajus/dindent": "^2.0",
         "giggsey/libphonenumber-for-php": "^8.12",
         "hashids/hashids": "^4.0",
         "league/iso3166": "^2.1 || ^3.0",
@@ -30,6 +31,7 @@
     },
     "suggest": {
         "egulias/email-validator": "\\Astrotomic\\PhpunitAssertions\\EmailAssertions (^2.1 || ^3.0)",
+        "gajus/dindent": "\\Astrotomic\\PhpunitAssertions\\Laravel\\BladeAssertions (^2.0)",
         "giggsey/libphonenumber-for-php": "\\Astrotomic\\PhpunitAssertions\\PhoneNumberAssertions (^8.12)",
         "hashids/hashids": "\\Astrotomic\\PhpunitAssertions\\HashidAssertions (^4.0)",
         "league/iso3166": "\\Astrotomic\\PhpunitAssertions\\CountryAssertions (^2.1 || ^3.0)",

src/Laravel/BladeAssertions.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions\Laravel;
+
+use Gajus\Dindent\Indenter;
+use Illuminate\Support\Facades\View;
+use Illuminate\Support\Str;
+use PHPUnit\Framework\Assert as PHPUnit;
+
+trait BladeAssertions
+{
+    public static function assertRenderEquals(string $expected, string $template, array $data = []): void
+    {
+        $indenter = new Indenter();
+
+        PHPUnit::assertSame(
+            $indenter->indent($expected),
+            $indenter->indent((string) static::render($template, $data))
+        );
+    }
+
+    protected static function render(string $template, array $data = []): string
+    {
+        $tempDirectory = sys_get_temp_dir();
+
+        if (! in_array($tempDirectory, View::getFinder()->getPaths())) {
+            View::addLocation($tempDirectory);
+        }
+
+        $tempFile = tempnam($tempDirectory, 'laravel-blade').'.blade.php';
+
+        file_put_contents($tempFile, $template);
+
+        return View::make(Str::before(basename($tempFile), '.blade.php'), $data)->render();
+    }
+}

src/Laravel/CollectionAssertions.php

@@ -7,9 +7,8 @@
 
 trait CollectionAssertions
 {
-    public static function assertContains($expected, $actual): void
+    public static function assertContains(Enumerable $collection, $expected): void
     {
-        PHPUnit::assertInstanceOf(Enumerable::class, $actual);
-        PHPUnit::assertTrue($actual->contains($expected));
+        PHPUnit::assertTrue($collection->contains($expected));
     }
 }

tests/Laravel/BladeAssertionsTest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions\Tests\Laravel;
+
+use Astrotomic\PhpunitAssertions\Laravel\BladeAssertions;
+
+final class BladeAssertionsTest extends TestCase
+{
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public function it_can_validate_render(): void
+    {
+        $price = random_int(0, 10000) / 100;
+
+        $string = number_format($price, 2);
+
+        BladeAssertions::assertRenderEquals(
+            "<p>Price: <code>{$string} €</code></p>",
+            '<p>Price: <code>{{ number_format($price, 2) }} €</code></p>',
+            ['price' => $price]
+        );
+    }
+}

tests/Laravel/CollectionAssertionsTest.php

@@ -23,6 +23,6 @@ public function it_can_validate_contains(): void
             self::randomString(),
         ]);
 
-        CollectionAssertions::assertContains($value, $collection);
+        CollectionAssertions::assertContains($collection, $value);
     }
 }