add url assertions

Author: Gummibeer

src/UrlAssertions.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions;
+
+use PHPUnit\Framework\Assert as PHPUnit;
+
+trait UrlAssertions
+{
+    public static function assertValidLoose($actual): void
+    {
+        PHPUnit::assertIsString($actual);
+        PHPUnit::assertNotFalse(filter_var($actual, FILTER_VALIDATE_URL));
+    }
+
+    public static function assertSameScheme(string $expected, $actual): void
+    {
+        self::assertSameComponent($expected, $actual, PHP_URL_SCHEME);
+    }
+
+    public static function assertSameHost(string $expected, $actual): void
+    {
+        self::assertSameComponent($expected, $actual, PHP_URL_HOST);
+    }
+
+    public static function assertSamePath(string $expected, $actual): void
+    {
+        self::assertSameComponent($expected, $actual, PHP_URL_PATH);
+    }
+
+    public static function assertSameComponent($expected, $actual, $component): void
+    {
+        self::assertValidLoose($actual);
+        PHPUnit::assertSame($expected, parse_url($actual, $component));
+    }
+}

tests/UrlAssertionsTest.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace Astrotomic\PhpunitAssertions\Tests;
+
+use Astrotomic\PhpunitAssertions\UrlAssertions;
+
+final class UrlAssertionsTest extends TestCase
+{
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_loose(): void
+    {
+        UrlAssertions::assertValidLoose('https://'.self::randomString().'.com');
+    }
+
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_scheme(): void
+    {
+        $scheme = self::randomElement([
+            'http',
+            'https',
+            'ftp',
+            'ssh',
+            'file',
+            'git',
+            'imap',
+            'irc',
+        ]);
+
+        UrlAssertions::assertSameScheme($scheme, $scheme.'://'.self::randomString().'.com');
+    }
+
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_host(): void
+    {
+        $host = self::randomString().'.com';
+
+        UrlAssertions::assertSameHost($host, 'https://'.$host);
+    }
+
+    /**
+     * @test
+     * @dataProvider hundredTimes
+     */
+    public static function it_can_validate_path(): void
+    {
+        $path = '/'.self::randomString().'/'.self::randomString();
+
+        UrlAssertions::assertSamePath($path, 'https://'.self::randomString().'.com'.$path);
+    }
+}