create-prisma-php-app 1.0.0

package/vendor/ramsey/uuid/tests/Provider/Node/SystemNodeProviderTest.php

@@ -0,0 +1,950 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Ramsey\Uuid\Test\Provider\Node;
+
+use Ramsey\Uuid\Exception\InvalidArgumentException;
+use Ramsey\Uuid\Exception\NodeException;
+use Ramsey\Uuid\Provider\Node\SystemNodeProvider;
+use Ramsey\Uuid\Test\TestCase;
+use phpmock\spy\Spy;
+
+use function array_shift;
+use function array_walk;
+use function gettype;
+use function is_array;
+use function strlen;
+use function vsprintf;
+
+use const GLOB_NOSORT;
+
+/**
+ * Tests for the SystemNodeProvider class
+ *
+ * The class under test make use of various native functions who's output is
+ * dictated by which environment PHP runs on. Instead of having to run these
+ * tests on each of these environments, the related functions are mocked. The
+ * following functions are concerned:
+ *
+ * - glob
+ * - constant
+ * - passthru
+ * - file_get_contents
+ * - ini_get
+ *
+ * On Linux systems `glob` would normally provide one or more paths were mac
+ * address can be retrieved (using `file_get_contents`). On non-linux systems,
+ * or when the `glob` fails, `passthru` is used to read the mac address from the
+ * command for the relevant environment as provided by `constant('PHP_OS')`.
+ *
+ * Please note that, in order to have robust tests, (the output of) these
+ * functions should ALWAYS be mocked and the amount of times each function
+ * should be run should ALWAYS be specified.
+ *
+ * This will make the tests more verbose but also more bullet-proof.
+ */
+class SystemNodeProviderTest extends TestCase
+{
+    private const MOCK_GLOB = 'glob';
+    private const MOCK_CONSTANT = 'constant';
+    private const MOCK_PASSTHRU = 'passthru';
+    private const MOCK_FILE_GET_CONTENTS = 'file_get_contents';
+    private const MOCK_INI_GET = 'ini_get';
+    private const MOCK_IS_READABLE = 'is_readable';
+
+    private const PROVIDER_NAMESPACE = 'Ramsey\\Uuid\\Provider\\Node';
+
+    /**
+     * @var Spy[]
+     */
+    private $functionProxies = [];
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     * @dataProvider provideValidNetStatOutput
+     */
+    public function testGetNodeReturnsSystemNodeFromMacAddress(string $netstatOutput, string $expected): void
+    {
+        /* Arrange mocks for native functions */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function () use ($netstatOutput): void {
+                echo $netstatOutput;
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act upon the system under test */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+
+        /* Assert the result match expectations */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+
+        $this->assertSame($expected, $node->toString());
+
+        $message = vsprintf(
+            'Node should be a hexadecimal string of 12 characters. Actual node: %s (length: %s)',
+            [$node->toString(), strlen($node->toString()),]
+        );
+        $this->assertMatchesRegularExpression('/^[A-Fa-f0-9]{12}$/', $node->toString(), $message);
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     * @dataProvider provideInvalidNetStatOutput
+     */
+    public function testGetNodeShouldNotReturnsSystemNodeForInvalidMacAddress(string $netstatOutput): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function () use ($netstatOutput): void {
+                echo $netstatOutput;
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $exception = null;
+        $provider = new SystemNodeProvider();
+
+        try {
+            $provider->getNode();
+        } catch (NodeException $exception) {
+            // do nothing
+        }
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+        $this->assertInstanceOf(NodeException::class, $exception);
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     * @dataProvider provideNotationalFormats
+     */
+    public function testGetNodeReturnsNodeStrippedOfNotationalFormatting(string $formatted, string $expected): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function () use ($formatted): void {
+                echo "\n{$formatted}\n";
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+
+        $this->assertSame($expected, $node->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     * @dataProvider provideInvalidNotationalFormats
+     */
+    public function testGetNodeDoesNotAcceptIncorrectNotationalFormatting(string $formatted): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function () use ($formatted): void {
+                echo "\n{$formatted}\n";
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $exception = null;
+        $provider = new SystemNodeProvider();
+
+        try {
+            $provider->getNode();
+        } catch (NodeException $exception) {
+            // do nothing
+        }
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+        $this->assertInstanceOf(NodeException::class, $exception);
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testGetNodeReturnsFirstMacAddressFound(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function (): void {
+                echo "\nAA-BB-CC-DD-EE-FF\n00-11-22-33-44-55\nFF-11-EE-22-DD-33\n";
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+
+        $this->assertSame('aabbccddeeff', $node->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testGetNodeReturnsFalseWhenNodeIsNotFound(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function (): void {
+                echo 'some string that does not match the mac address';
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $exception = null;
+        $provider = new SystemNodeProvider();
+
+        try {
+            $provider->getNode();
+        } catch (NodeException $exception) {
+            // do nothing
+        }
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+        $this->assertInstanceOf(NodeException::class, $exception);
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testGetNodeWillNotExecuteSystemCallIfFailedFirstTime(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function (): void {
+                echo 'some string that does not match the mac address';
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $exception1 = null;
+        $exception2 = null;
+        $provider = new SystemNodeProvider();
+
+        try {
+            $provider->getNode();
+        } catch (NodeException $exception1) {
+            // do nothing
+        }
+
+        try {
+            $provider->getNode();
+        } catch (NodeException $exception2) {
+            // do nothing
+        }
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+        $this->assertInstanceOf(NodeException::class, $exception1);
+        $this->assertInstanceOf(NodeException::class, $exception2);
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     * @dataProvider provideCommandPerOs
+     */
+    public function testGetNodeGetsNetworkInterfaceConfig(string $os, string $command): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            'whatever',
+            ['mock address path'],
+            'whatever',
+            $os,
+            'nothing disabled',
+            true
+        );
+
+        /* Act */
+        $exception = null;
+        $provider = new SystemNodeProvider();
+
+        try {
+            $provider->getNode();
+        } catch (NodeException $exception) {
+            // do nothing
+        }
+
+        /* Assert */
+        $globBodyAssert = null;
+        $fileGetContentsAssert = null;
+        $isReadableAssert = null;
+        if ($os === 'Linux') {
+            $globBodyAssert = [['/sys/class/net/*/address', GLOB_NOSORT]];
+            $fileGetContentsAssert = ['mock address path'];
+            $isReadableAssert = $fileGetContentsAssert;
+        }
+        $this->assertMockFunctions(
+            $fileGetContentsAssert,
+            $globBodyAssert,
+            [$command],
+            ['PHP_OS'],
+            ['disable_functions'],
+            $isReadableAssert
+        );
+
+        $this->assertInstanceOf(NodeException::class, $exception);
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testGetNodeReturnsSameNodeUponSubsequentCalls(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function (): void {
+                echo "\nAA-BB-CC-DD-EE-FF\n";
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+        $node2 = $provider->getNode();
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+
+        $this->assertSame($node->toString(), $node2->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testSubsequentCallsToGetNodeDoNotRecallIfconfig(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            function (): void {
+                echo "\nAA-BB-CC-DD-EE-FF\n";
+            },
+            'NOT LINUX',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+        $node2 = $provider->getNode();
+
+        /* Assert */
+        $this->assertMockFunctions(null, null, ['netstat -ie 2>&1'], ['PHP_OS'], ['disable_functions']);
+
+        $this->assertSame($node->toString(), $node2->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     * @dataProvider provideCommandPerOs
+     */
+    public function testCallGetsysfsOnLinux(string $os, string $command): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            function () {
+                static $macs = ["00:00:00:00:00:00\n", "01:02:03:04:05:06\n"];
+
+                return array_shift($macs);
+            },
+            ['mock address path 1', 'mock address path 2'],
+            function (): void {
+                echo "\n01-02-03-04-05-06\n";
+            },
+            $os,
+            'nothing disabled',
+            true
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+
+        /* Assert */
+        $fileGetContentsAssert = null;
+        $globBodyAssert = null;
+        $passthruBodyAssert = [$command];
+        $constantBodyAssert = ['PHP_OS'];
+        $iniGetDisableFunctionsAssert = ['disable_functions'];
+        $isReadableAssert = null;
+
+        if ($os === 'Linux') {
+            $fileGetContentsAssert = [['mock address path 1'], ['mock address path 2']];
+            $globBodyAssert = [['/sys/class/net/*/address', GLOB_NOSORT]];
+            $passthruBodyAssert = null;
+            $constantBodyAssert = ['PHP_OS'];
+            $iniGetDisableFunctionsAssert = null;
+            $isReadableAssert = $fileGetContentsAssert;
+        }
+        $this->assertMockFunctions(
+            $fileGetContentsAssert,
+            $globBodyAssert,
+            $passthruBodyAssert,
+            $constantBodyAssert,
+            $iniGetDisableFunctionsAssert,
+            $isReadableAssert
+        );
+
+        $this->assertSame('010203040506', $node->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testCallGetsysfsOnLinuxWhenGlobReturnsFalse(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            false,
+            function (): void {
+                echo "\n01-02-03-04-05-06\n";
+            },
+            'Linux',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+
+        /* Assert */
+        $this->assertMockFunctions(
+            null,
+            [['/sys/class/net/*/address', GLOB_NOSORT]],
+            ['netstat -ie 2>&1'],
+            ['PHP_OS'],
+            ['disable_functions']
+        );
+
+        $this->assertSame('010203040506', $node->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testCallGetsysfsOnLinuxWhenGlobReturnsEmptyArray(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            [],
+            function (): void {
+                echo "\n01-02-03-04-05-06\n";
+            },
+            'Linux',
+            'nothing disabled'
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+
+        /* Assert */
+        $this->assertMockFunctions(
+            null,
+            [['/sys/class/net/*/address', GLOB_NOSORT]],
+            ['netstat -ie 2>&1'],
+            ['PHP_OS'],
+            ['disable_functions']
+        );
+
+        $this->assertSame('010203040506', $node->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testCallGetsysfsOnLinuxWhenGlobFilesAreNotReadable(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            ['mock address path 1', 'mock address path 2'],
+            function (): void {
+                echo "\n01-02-03-04-05-06\n";
+            },
+            'Linux',
+            'nothing disabled',
+            false
+        );
+
+        /* Act */
+        $provider = new SystemNodeProvider();
+        $node = $provider->getNode();
+
+        /* Assert */
+        $this->assertMockFunctions(
+            null,
+            [['/sys/class/net/*/address', GLOB_NOSORT]],
+            ['netstat -ie 2>&1'],
+            ['PHP_OS'],
+            ['disable_functions'],
+            ['mock address path 1', 'mock address path 2']
+        );
+
+        $this->assertSame('010203040506', $node->toString());
+    }
+
+    /**
+     * @runInSeparateProcess
+     * @preserveGlobalState disabled
+     */
+    public function testGetNodeReturnsFalseWhenPassthruIsDisabled(): void
+    {
+        /* Arrange */
+        $this->arrangeMockFunctions(
+            null,
+            null,
+            null,
+            'NOT LINUX',
+            'PASSTHRU,some_other_function'
+        );
+
+        /* Act */
+        $exception = null;
+        $provider = new SystemNodeProvider();
+
+        try {
+            $provider->getNode();
+        } catch (NodeException $exception) {
+            // do nothing
+        }
+
+        /* Assert */
+        $this->assertMockFunctions(
+            null,
+            null,
+            null,
+            ['PHP_OS'],
+            ['disable_functions']
+        );
+
+        $this->assertInstanceOf(NodeException::class, $exception);
+    }
+
+    /**
+     * Replaces the return value for functions with the given value or callback.
+     *
+     * @param callback|mixed|null $fileGetContentsBody
+     * @param callback|mixed|null $globBody
+     * @param callback|mixed|null $passthruBody
+     * @param callback|mixed|null $constantBody
+     * @param callback|mixed|null $iniGetDisableFunctionsBody
+     * @param callback|mixed|null $isReadableBody
+     */
+    private function arrangeMockFunctions(
+        $fileGetContentsBody,
+        $globBody,
+        $passthruBody,
+        $constantBody,
+        $iniGetDisableFunctionsBody,
+        $isReadableBody = true
+    ): void {
+        $mockFunction = [
+            self::MOCK_FILE_GET_CONTENTS => $fileGetContentsBody,
+            self::MOCK_GLOB => $globBody,
+            self::MOCK_PASSTHRU => $passthruBody,
+            self::MOCK_CONSTANT => $constantBody,
+            self::MOCK_INI_GET => $iniGetDisableFunctionsBody,
+            self::MOCK_IS_READABLE => $isReadableBody,
+        ];
+
+        array_walk($mockFunction, function ($body, $key): void {
+            if (!is_callable($body)) {
+                $body = function () use ($body) {
+                    return $body;
+                };
+            }
+
+            $spy = new Spy(self::PROVIDER_NAMESPACE, $key, $body);
+            $spy->enable();
+
+            $this->functionProxies[$key] = $spy;
+        });
+    }
+
+    /**
+     * Verifies that each function was called exactly once for each assert given.
+     *
+     * Provide a NULL to assert a function is never called.
+     *
+     * @param array<int, string>|array<int, array<int,string>>|null $fileGetContentsAssert
+     * @param array<int, array<int, int|string>>|null $globBodyAssert
+     * @param array<int, string>|array<int, array<int,string>>|null $passthruBodyAssert
+     * @param array<int, string>|array<int, array<int,string>>|null $constantBodyAssert
+     * @param array<int, string>|array<int, array<int,string>>|null $iniGetDisableFunctionsAssert
+     * @param array<int, string>|array<int, array<int,string>>|null $isReadableAssert
+     */
+    private function assertMockFunctions(
+        ?array $fileGetContentsAssert,
+        ?array $globBodyAssert,
+        ?array $passthruBodyAssert,
+        ?array $constantBodyAssert,
+        ?array $iniGetDisableFunctionsAssert,
+        ?array $isReadableAssert = null
+    ): void {
+        $mockFunctionAsserts = [
+            self::MOCK_FILE_GET_CONTENTS => $fileGetContentsAssert,
+            self::MOCK_GLOB => $globBodyAssert,
+            self::MOCK_PASSTHRU => $passthruBodyAssert,
+            self::MOCK_CONSTANT => $constantBodyAssert,
+            self::MOCK_INI_GET => $iniGetDisableFunctionsAssert,
+            self::MOCK_IS_READABLE => $isReadableAssert,
+        ];
+
+        array_walk($mockFunctionAsserts, function ($asserts, $key): void {
+            if ($asserts === null) {
+                // Assert the function was never invoked.
+                $this->assertEmpty($this->functionProxies[$key]->getInvocations());
+            } elseif (is_array($asserts)) {
+                // Assert there was at least one invocation for this function.
+                $this->assertNotEmpty($this->functionProxies[$key]->getInvocations());
+
+                $invokedArgs = [];
+                foreach ($this->functionProxies[$key]->getInvocations() as $invocation) {
+                    $invokedArgs[] = $invocation->getArguments();
+                }
+
+                foreach ($asserts as $assert) {
+                    // Assert these args were used to invoke the function.
+                    $assert = is_array($assert) ? $assert : [$assert];
+                    $this->assertContains($assert, $invokedArgs);
+                }
+            } else {
+                $error = vsprintf(
+                    'Given parameter for %s must be an array or NULL, "%s" given.',
+                    [$key, gettype($asserts)]
+                );
+
+                throw new InvalidArgumentException($error);
+            }
+        });
+    }
+
+    /**
+     * Provides the command that should be executed per supported OS
+     *
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideCommandPerOs(): array
+    {
+        return [
+            'windows' => ['Windows', 'ipconfig /all 2>&1'],
+            'mac' => ['Darwhat', 'ifconfig 2>&1'],
+            'linux' => ['Linux', 'netstat -ie 2>&1'],
+            'freebsd' => ['FreeBSD', 'netstat -i -f link 2>&1'],
+            'anything_else' => ['someotherxyz', 'netstat -ie 2>&1'],
+            'Linux when `glob` fails' => ['LIN', 'netstat -ie 2>&1'],
+        ];
+    }
+
+    /**
+     * Values that are NOT parsed to a mac address by the class under test
+     *
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideInvalidNetStatOutput(): array
+    {
+        return [
+            'Not an octal value' => [
+                "The program 'netstat' is currently not installed. " .
+                "You can install it by typing:\nsudo apt install net-tools\n",
+            ],
+            'One character too short' => ["\nA-BB-CC-DD-EE-FF\n"],
+            'One tuple too short' => ["\nBB-CC-DD-EE-FF\n"],
+            'With colon, with linebreak, without space' => ["\n:AA-BB-CC-DD-EE-FF\n"],
+            'With colon, without linebreak, with space' => [' : AA-BB-CC-DD-EE-FF'],
+            'With colon, without linebreak, without space' => [':AA-BB-CC-DD-EE-FF'],
+            'Without colon, without linebreak, without space' => ['AA-BB-CC-DD-EE-FF'],
+            'Without leading linebreak' => ["AA-BB-CC-DD-EE-FF\n"],
+            'Without leading whitespace' => ['AA-BB-CC-DD-EE-FF '],
+            'Without trailing linebreak' => ["\nAA-BB-CC-DD-EE-FF"],
+            'Without trailing whitespace' => [' AA-BB-CC-DD-EE-FF'],
+            'All zero MAC address' => ['00-00-00-00-00-00'],
+        ];
+    }
+
+    /**
+     * Provides notations that the class under test should NOT attempt to strip
+     *
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideInvalidNotationalFormats(): array
+    {
+        return [
+            ['01:23-45-67-89-ab'],
+            ['01:23:45-67-89-ab'],
+            ['01:23:45:67-89-ab'],
+            ['01:23:45:67:89-ab'],
+            ['01-23:45:67:89:ab'],
+            ['01-23-45:67:89:ab'],
+            ['01-23-45-67:89:ab'],
+            ['01-23-45-67-89:ab'],
+            ['00:00:00:00:00:00'],
+        ];
+    }
+
+    /**
+     * Provides mac addresses that the class under test should strip notational format from
+     *
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideNotationalFormats(): array
+    {
+        return [
+            ['01-23-45-67-89-ab', '0123456789ab'],
+            ['01:23:45:67:89:ab', '0123456789ab'],
+        ];
+    }
+
+    /**
+     * Values that are parsed to a mac address by the class under test
+     *
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingTraversableTypeHintSpecification
+     */
+    public function provideValidNetStatOutput(): array
+    {
+        return [
+            /* Full output of related command */
+            'Full output - Linux' => [<<<'TXT'
+                Kernel Interface table
+                docker0   Link encap:Ethernet  HWaddr 01:23:45:67:89:ab
+                          inet addr:172.17.0.1  Bcast:0.0.0.0  Mask:255.255.0.0
+                          UP BROADCAST MULTICAST  MTU:1500  Metric:1
+                          RX packets:0 errors:0 dropped:0 overruns:0 frame:0
+                          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
+                          collisions:0 txqueuelen:0
+                          RX bytes:0 (0.0 B)  TX bytes:0 (0.0 B)
+
+                enp3s0    Link encap:Ethernet  HWaddr fe:dc:ba:98:76:54
+                          inet addr:10.0.0.1  Bcast:10.0.0.255  Mask:255.255.255.0
+                          inet6 addr: ffee::ddcc:bbaa:9988:7766/64 Scope:Link
+                          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
+                          RX packets:943077 errors:0 dropped:0 overruns:0 frame:0
+                          TX packets:2168039 errors:0 dropped:0 overruns:0 carrier:0
+                          collisions:0 txqueuelen:1000
+                          RX bytes:748596414 (748.5 MB)  TX bytes:2930448282 (2.9 GB)
+
+                lo        Link encap:Local Loopback
+                          inet addr:127.0.0.1  Mask:255.0.0.0
+                          inet6 addr: ::1/128 Scope:Host
+                          UP LOOPBACK RUNNING  MTU:65536  Metric:1
+                          RX packets:8302 errors:0 dropped:0 overruns:0 frame:0
+                          TX packets:8302 errors:0 dropped:0 overruns:0 carrier:0
+                          collisions:0 txqueuelen:1000
+                          RX bytes:1094983 (1.0 MB)  TX bytes:1094983 (1.0 MB)
+TXT
+                , '0123456789ab',
+            ],
+            'Full output - MacOS' => [<<<'TXT'
+                lo0: flags=8049<UP,LOOPBACK,RUNNING,MULTICAST> mtu 16384
+                    options=1203<RXCSUM,TXCSUM,TXSTATUS,SW_TIMESTAMP>
+                    inet 127.0.0.1 netmask 0xff000000
+                    inet6 ::1 prefixlen 128
+                    inet6 fe80::1%lo0 prefixlen 64 scopeid 0x1
+                    nd6 options=201<PERFORMNUD,DAD>
+                gif0: flags=8010<POINTOPOINT,MULTICAST> mtu 1280
+                stf0: flags=0<> mtu 1280
+                EHC29: flags=0<> mtu 0
+                XHC20: flags=0<> mtu 0
+                EHC26: flags=0<> mtu 0
+                aa0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+                    options=10b<RXCSUM,TXCSUM,VLAN_HWTAGGING,AV>
+                    ether 00:00:00:00:00:00
+                    status: active
+                en0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+                    options=10b<RXCSUM,TXCSUM,VLAN_HWTAGGING,AV>
+                    ether 10:dd:b1:b4:e4:8e
+                    inet6 fe80::c70:76f5:aa1:5db1%en0 prefixlen 64 secured scopeid 0x7
+                    inet 10.53.8.112 netmask 0xfffffc00 broadcast 10.53.11.255
+                    nd6 options=201<PERFORMNUD,DAD>
+                    media: autoselect (1000baseT <full-duplex>)
+                    status: active
+                en1: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+                    ether ec:35:86:38:c8:c2
+                    inet6 fe80::aa:d44f:5f5f:7fd4%en1 prefixlen 64 secured scopeid 0x8
+                    inet 10.53.17.196 netmask 0xfffffc00 broadcast 10.53.19.255
+                    nd6 options=201<PERFORMNUD,DAD>
+                    media: autoselect
+                    status: active
+                p2p0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 2304
+                    ether 0e:35:86:38:c8:c2
+                    media: autoselect
+                    status: inactive
+                awdl0: flags=8943<UP,BROADCAST,RUNNING,PROMISC,SIMPLEX,MULTICAST> mtu 1484
+                    ether ea:ab:ae:25:f5:d0
+                    inet6 fe80::e8ab:aeff:fe25:f5d0%awdl0 prefixlen 64 scopeid 0xa
+                    nd6 options=201<PERFORMNUD,DAD>
+                    media: autoselect
+                    status: active
+                en2: flags=8963<UP,BROADCAST,SMART,RUNNING,PROMISC,SIMPLEX,MULTICAST> mtu 1500
+                    options=60<TSO4,TSO6>
+                    ether 32:00:18:9b:dc:60
+                    media: autoselect <full-duplex>
+                    status: inactive
+                en3: flags=8963<UP,BROADCAST,SMART,RUNNING,PROMISC,SIMPLEX,MULTICAST> mtu 1500
+                    options=60<TSO4,TSO6>
+                    ether 32:00:18:9b:dc:61
+                    media: autoselect <full-duplex>
+                    status: inactive
+                bridge0: flags=8822<BROADCAST,SMART,SIMPLEX,MULTICAST> mtu 1500
+                    options=63<RXCSUM,TXCSUM,TSO4,TSO6>
+                    ether 32:00:18:9b:dc:60
+                    Configuration:
+                        id 0:0:0:0:0:0 priority 0 hellotime 0 fwddelay 0
+                        maxage 0 holdcnt 0 proto stp maxaddr 100 timeout 1200
+                        root id 0:0:0:0:0:0 priority 0 ifcost 0 port 0
+                        ipfilter disabled flags 0x2
+                    member: en2 flags=3<LEARNING,DISCOVER>
+                            ifmaxaddr 0 port 11 priority 0 path cost 0
+                    member: en3 flags=3<LEARNING,DISCOVER>
+                            ifmaxaddr 0 port 12 priority 0 path cost 0
+                    media: <unknown type>
+                    status: inactive
+                utun0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST> mtu 2000
+                    options=6403<RXCSUM,TXCSUM,CHANNEL_IO,PARTIAL_CSUM,ZEROINVERT_CSUM>
+                    inet6 fe80::57c6:d692:9d41:d28f%utun0 prefixlen 64 scopeid 0xe
+                    nd6 options=201<PERFORMNUD,DAD>
+TXT
+                , '10ddb1b4e48e',
+            ],
+            'Full output - Window' => [<<<'TXT'
+                Windows IP Configuration
+
+                   Host Name . . . . . . . . . . . . : MSEDGEWIN10
+                   Primary Dns Suffix  . . . . . . . :
+                   Node Type . . . . . . . . . . . . : Hybrid
+                   IP Routing Enabled. . . . . . . . : No
+                   WINS Proxy Enabled. . . . . . . . : No
+                   DNS Suffix Search List. . . . . . : network.lan
+
+                Some kind of adapter:
+
+                   Connection-specific DNS Suffix  . : network.foo
+                   Description . . . . . . . . . . . : Some Adapter
+                   Physical Address. . . . . . . . . : 00-00-00-00-00-00
+
+                Ethernet adapter Ethernet:
+
+                   Connection-specific DNS Suffix  . : network.lan
+                   Description . . . . . . . . . . . : Intel(R) PRO/1000 MT Desktop Adapter
+                   Physical Address. . . . . . . . . : 08-00-27-B8-42-C6
+                   DHCP Enabled. . . . . . . . . . . : Yes
+                   Autoconfiguration Enabled . . . . : Yes
+                   Link-local IPv6 Address . . . . . : fe80::606a:ae33:7ce1:b5e9%3(Preferred)
+                   IPv4 Address. . . . . . . . . . . : 10.0.2.15(Preferred)
+                   Subnet Mask . . . . . . . . . . . : 255.255.255.0
+                   Lease Obtained. . . . . . . . . . : Tuesday, January 30, 2018 11:25:31 PM
+                   Lease Expires . . . . . . . . . . : Wednesday, January 31, 2018 11:25:27 PM
+                   Default Gateway . . . . . . . . . : 10.0.2.2
+                   DHCP Server . . . . . . . . . . . : 10.0.2.2
+                   DHCPv6 IAID . . . . . . . . . . . : 34078759
+                   DHCPv6 Client DUID. . . . . . . . : 00-01-00-01-21-40-72-3F-08-00-27-B8-42-C6
+                   DNS Servers . . . . . . . . . . . : 10.0.2.3
+                   NetBIOS over Tcpip. . . . . . . . : Enabled
+
+                Tunnel adapter isatap.network.lan:
+
+                   Media State . . . . . . . . . . . : Media disconnected
+                   Connection-specific DNS Suffix  . : network.lan
+                   Description . . . . . . . . . . . : Microsoft ISATAP Adapter
+                   Physical Address. . . . . . . . . : 00-00-00-00-00-00-00-E0
+                   DHCP Enabled. . . . . . . . . . . : No
+                   Autoconfiguration Enabled . . . . : Yes
+TXT
+                , '080027b842c6',
+            ],
+            'Full output - FreeBSD' => [<<<'TXT'
+                Name    Mtu Network       Address              Ipkts Ierrs Idrop    Opkts Oerrs  Coll
+                aa0       0 <Link#0>      00:00:00:00:00:00        0     0     0        0     0     0
+                em0    1500 <Link#1>      08:00:27:71:a1:00    65514     0     0    42918     0     0
+                em1    1500 <Link#2>      08:00:27:d0:60:a0     1199     0     0      535     0     0
+                lo0   16384 <Link#3>      lo0                      4     0     0        4     0     0
+TXT
+                , '08002771a100',
+            ],
+
+            /* The single line that is relevant */
+            'Linux  - single line' => ["\ndocker0   Link encap:Ethernet  HWaddr 01:23:45:67:89:ab\n", '0123456789ab'],
+            'MacOS  - Single line ' => ["\nether 10:dd:b1:b4:e4:8e\n", '10ddb1b4e48e'],
+            'Window - single line' => ["\nPhysical Address. . . . . . . . . : 08-00-27-B8-42-C6\n", '080027b842c6'],
+
+            /* Minimal subsets of the single line to show the differences */
+            'with colon, with linebreak, with space' => ["\n : AA-BB-CC-DD-EE-FF\n", 'aabbccddeeff'],
+            'without colon, with linebreak, with space' => ["\n AA-BB-CC-DD-EE-FF \n", 'aabbccddeeff'],
+            'without colon, with linebreak, without space' => ["\nAA-BB-CC-DD-EE-FF\n", 'aabbccddeeff'],
+            'without colon, without linebreak, with space' => [' AA-BB-CC-DD-EE-FF ', 'aabbccddeeff'],
+
+            /* Other accepted variations */
+            'Actual mac - 1' => ["\n52:54:00:14:91:69\n", '525400149169'],
+            'Actual mac - 2' => ["\n00:16:3e:a9:73:f0\n", '00163ea973f0'],
+            'FF:FF:FF:FF:FF:FF' => ["\nFF:FF:FF:FF:FF:FF\n", 'ffffffffffff'],
+
+            /* Incorrect variations that are also accepted */
+            'Too long -- extra character' => ["\nABC-01-23-45-67-89\n", 'bc0123456789'],
+            'Too long -- extra tuple' => ["\n01-AA-BB-CC-DD-EE-FF\n", '01aabbccddee'],
+        ];
+    }
+}