Merge pull request #3 from diamonddevgroup/move-facade-phpdocs

Moves methods to class-level and makes them static

.gitignore

@@ -5,3 +5,4 @@ vendor/
 .phpunit.result.cache
 composer.lock
 phpunit.xml
+coverage/

composer.json

@@ -17,7 +17,8 @@
         "intervention/image": "^3"
     },
     "require-dev": {
-        "phpunit/phpunit": "^9"
+        "phpunit/phpunit": "^9",
+        "orchestra/testbench": "^8.18"
     },
     "autoload": {
         "psr-4": {

config/image.php

@@ -7,7 +7,7 @@
     | Image Driver
     |--------------------------------------------------------------------------
     |
-    | Intervention Image supports "GD Library" and "Imagick" to process images
+    | Intervention Image supports “GD Library” and “Imagick” to process images
     | internally. Depending on your PHP setup, you can choose one of them.
     |
     | Included options:

src/Facades/Image.php

@@ -7,9 +7,9 @@
 use Illuminate\Support\Facades\Facade;
 
 /**
- * @method \Intervention\Image\ImageManager static read(mixed $input, string|array|DecoderInterface $decoders = [])
- * @method \Intervention\Image\ImageManager static create(int $width, int $height)
- * @method \Intervention\Image\ImageManager static animate(callable $callback)
+ * @method static \Intervention\Image\Interfaces\ImageInterface read(mixed $input, string|array|\Intervention\Image\Interfaces\DecoderInterface $decoders = [])
+ * @method static \Intervention\Image\Interfaces\ImageInterface create(int $width, int $height)
+ * @method static \Intervention\Image\Interfaces\ImageInterface animate(callable $callback)
  */
 class Image extends Facade
 {

testbench.yaml

@@ -0,0 +1,2 @@
+providers:
+    - Intervention\Image\Laravel\ServiceProvider

tests/FacadeTest.php

@@ -4,23 +4,75 @@
 
 namespace Intervention\Image\Laravel\Tests;
 
-use PHPUnit\Framework\TestCase;
+use Error;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Facades\Storage;
+use Intervention\Image\Exceptions\DecoderException;
+use Intervention\Image\Interfaces\ImageInterface;
+use Intervention\Image\Laravel\Facades\Image;
 use ReflectionClass;
+use TypeError;
+use ValueError;
 
 class FacadeTest extends TestCase
 {
-    public function testFacade()
+    public function testImageFacadeIsASubclassOfFacade(): void
     {
         $facade = new ReflectionClass('Illuminate\Support\Facades\Facade');
         $reflection = new ReflectionClass('Intervention\Image\Laravel\Facades\Image');
         $this->assertTrue($reflection->isSubclassOf($facade));
     }
 
-    public function testFacadeAccessor()
+    public function testFacadeAccessorReturnsImage(): void
     {
         $reflection = new ReflectionClass('Intervention\Image\Laravel\Facades\Image');
         $method = $reflection->getMethod('getFacadeAccessor');
         $method->setAccessible(true);
         $this->assertSame('image', $method->invoke(null));
     }
+
+    public function testReadAnImage(): void
+    {
+        Storage::fake('images');
+        $input = UploadedFile::fake()->image('image.jpg');
+        $result = Image::read($input);
+        $this->assertInstanceOf(ImageInterface::class, $result);
+    }
+
+    public function testThrowsExceptionWhenReadingNonExistentImage(): void
+    {
+        $this->expectException(DecoderException::class);
+        $input = 'path/to/non_existent_image.jpg';
+        Image::read($input);
+    }
+
+    public function testCreateAnImage(): void
+    {
+        $width = 200;
+        $height = 200;
+        $result = Image::create($width, $height);
+        $this->assertInstanceOf(ImageInterface::class, $result);
+    }
+
+    public function testThrowsExceptionWhenCreatingImageWithInvalidDimensions(): void
+    {
+        $this->expectException(ValueError::class);
+        $width = -200;
+        $height = 200;
+        Image::create($width, $height);
+    }
+
+    public function testAnimateAnImage(): void
+    {
+        $callback = function () {};
+        $result = Image::animate($callback);
+        $this->assertInstanceOf(ImageInterface::class, $result);
+    }
+
+    public function testThrowsExceptionWhenAnimatingImageWithInvalidCallback(): void
+    {
+        $this->expectException(TypeError::class);
+        $callback = 'not_callable';
+        Image::animate($callback);
+    }
 }

tests/TestCase.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Intervention\Image\Laravel\Tests;
+
+use Orchestra\Testbench\Concerns\WithWorkbench;
+use Orchestra\Testbench\TestCase as TestBenchTestCase;
+
+abstract class TestCase extends TestBenchTestCase
+{
+    use WithWorkbench;
+}