tests(archive): add unit tests for internal

Author: roxblnfk

context.yaml

@@ -1,3 +1,5 @@
+---
+
 $schema: 'https://raw.githubusercontent.com/context-hub/generator/refs/heads/main/json-schema.json'
 
 import:

tests/Unit/Module/Archive/Internal/ArchiveTest.php

@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Internal\DLoad\Tests\Unit\Module\Archive\Internal;
+
+use Internal\DLoad\Module\Archive\Internal\Archive;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(Archive::class)]
+final class ArchiveTest extends TestCase
+{
+    public function testConstructorThrowsExceptionWhenFileDoesNotExist(): void
+    {
+        // Arrange
+        $file = $this->createMock(\SplFileInfo::class);
+        $file->method('isFile')->willReturn(false);
+        $file->method('getFilename')->willReturn('non-existent.zip');
+
+        // Assert
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('Archive "non-existent.zip" is not a file.');
+
+        // Act
+        $this->createArchiveInstance($file);
+    }
+
+    public function testConstructorThrowsExceptionWhenFileIsNotReadable(): void
+    {
+        // Arrange
+        $file = $this->createMock(\SplFileInfo::class);
+        $file->method('isFile')->willReturn(true);
+        $file->method('isReadable')->willReturn(false);
+        $file->method('getFilename')->willReturn('unreadable.zip');
+
+        // Assert
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('Archive file "unreadable.zip" is not readable.');
+
+        // Act
+        $this->createArchiveInstance($file);
+    }
+
+    public function testConstructorSucceedsWithValidFile(): void
+    {
+        // Arrange
+        $file = $this->createMock(\SplFileInfo::class);
+        $file->method('isFile')->willReturn(true);
+        $file->method('isReadable')->willReturn(true);
+
+        // Act
+        $archive = $this->createArchiveInstance($file);
+
+        // Assert
+        self::assertInstanceOf(Archive::class, $archive);
+    }
+
+    /**
+     * Creates a concrete implementation of the abstract Archive class for testing
+     */
+    private function createArchiveInstance(\SplFileInfo $file): Archive
+    {
+        return new class($file) extends Archive {
+            public function extract(): \Generator
+            {
+                // Minimal implementation for testing the constructor
+                yield 'test' => new \SplFileInfo('test');
+            }
+        };
+    }
+}

tests/Unit/Module/Archive/Internal/PharAwareArchiveTest.php

@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Internal\DLoad\Tests\Unit\Module\Archive\Internal;
+
+use Internal\DLoad\Module\Archive\Exception\ArchiveException;
+use Internal\DLoad\Module\Archive\Internal\PharAwareArchive;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(PharAwareArchive::class)]
+final class PharAwareArchiveTest extends TestCase
+{
+    private \SplFileInfo $fileInfo;
+
+    public function testExtractThrowsExceptionWhenArchiveIsNotReadable(): void
+    {
+        // Arrange
+        $pharData = $this->createMock(\PharData::class);
+        $pharData->method('isReadable')->willReturn(false);
+        $pharData->method('getPathname')->willReturn('unreadable.phar');
+
+        $archive = $this->createPharAwareArchive($pharData);
+
+        // Assert
+        $this->expectException(ArchiveException::class);
+        $this->expectExceptionMessage('Could not open "unreadable.phar" for reading.');
+
+        // Act
+        \iterator_to_array($archive->extract());
+    }
+
+    protected function setUp(): void
+    {
+        // Arrange
+        $this->fileInfo = $this->createMock(\SplFileInfo::class);
+        $this->fileInfo->method('isFile')->willReturn(true);
+        $this->fileInfo->method('isReadable')->willReturn(true);
+    }
+
+    /**
+     * Creates a concrete implementation of the abstract PharAwareArchive for testing
+     */
+    private function createPharAwareArchive(\PharData $pharData): PharAwareArchive
+    {
+        return new class($this->fileInfo, $pharData) extends PharAwareArchive {
+            private \PharData $testPharData;
+
+            public function __construct(\SplFileInfo $archive, \PharData $pharData)
+            {
+                $this->testPharData = $pharData;
+                parent::__construct($archive);
+            }
+
+            protected function open(\SplFileInfo $file): \PharData
+            {
+                return $this->testPharData;
+            }
+        };
+    }
+}

tests/Unit/Module/Archive/Internal/TarPharArchiveTest.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Internal\DLoad\Tests\Unit\Module\Archive\Internal;
+
+use Internal\DLoad\Module\Archive\Internal\TarPharArchive;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(TarPharArchive::class)]
+final class TarPharArchiveTest extends TestCase
+{
+    public function testConstructorValidatesFile(): void
+    {
+        // Arrange
+        $file = $this->createMock(\SplFileInfo::class);
+        $file->method('isFile')->willReturn(true);
+        $file->method('isReadable')->willReturn(false);
+        $file->method('getFilename')->willReturn('unreadable.tar.gz');
+
+        // Assert
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('Archive file "unreadable.tar.gz" is not readable.');
+
+        // Act
+        new TarPharArchive($file);
+    }
+}

tests/Unit/Module/Archive/Internal/ZipPharArchiveTest.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Internal\DLoad\Tests\Unit\Module\Archive\Internal;
+
+use Internal\DLoad\Module\Archive\Internal\ZipPharArchive;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(ZipPharArchive::class)]
+final class ZipPharArchiveTest extends TestCase
+{
+    public function testConstructorValidatesFile(): void
+    {
+        // Arrange
+        $file = $this->createMock(\SplFileInfo::class);
+        $file->method('isFile')->willReturn(false);
+        $file->method('getFilename')->willReturn('invalid.zip');
+
+        // Assert
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('Archive "invalid.zip" is not a file.');
+
+        // Act
+        new ZipPharArchive($file);
+    }
+}