refactor: set type for mimetype aware adapters

.php-cs-fixer.dist.php

@@ -21,7 +21,7 @@
         'no_break_comment' => false,
         'no_extra_blank_lines' => true,
         'no_spaces_around_offset' => true,
-        'no_trailing_comma_in_singleline' => true,
+        'no_trailing_comma_in_singleline_array' => true,
         'no_unused_imports' => true,
         'no_useless_else' => true,
         'no_useless_return' => true,

spec/Gaufrette/FilesystemSpec.php

@@ -322,7 +322,7 @@ function it_delegates_checksum_calculation_to_adapter_when_adapter_is_checksum_c
         $extendedAdapter->read('filename')->shouldNotBeCalled();
         $extendedAdapter->checksum('filename')->shouldBeCalled()->willReturn(12);
 
-        $this->checksum('filename')->shouldReturn("12");
+        $this->checksum('filename')->shouldReturn('12');
     }
 
     function it_delegates_mime_type_resolution_to_adapter_when_adapter_is_mime_type_provider(ExtendedAdapter $extendedAdapter)

src/Gaufrette/Adapter/AsyncAwsS3.php

@@ -176,11 +176,11 @@ public function size(string $key): int
         return (int) $result->getContentLength();
     }
 
-    public function mimeType(string $key): string
+    public function mimeType(string $key): string|bool
     {
         $result = $this->service->headObject($this->getOptions($key));
 
-        return $result->getContentType();
+        return $result->getContentType() ?: false;
     }
 
     /**

src/Gaufrette/Adapter/AwsS3.php

@@ -173,7 +173,7 @@ public function size(string $key): int
         }
     }
 
-    public function mimeType(string $key): string|bool
+    public function mimeType(string $key): bool|string
     {
         try {
             $result = $this->service->headObject($this->getOptions($key));

src/Gaufrette/Adapter/AzureBlobStorage.php

@@ -286,7 +286,7 @@ public function size(string $key): int
     /**
      * {@inheritdoc}
      */
-    public function mimeType(string $key): string
+    public function mimeType(string $key): string|bool
     {
         $this->init();
         list($containerName, $key) = $this->tokenizeKey($key);

src/Gaufrette/Adapter/InMemory.php

@@ -120,7 +120,7 @@ public function isDirectory(string $path): bool
         return false;
     }
 
-    public function mimeType(string $key): string
+    public function mimeType(string $key): bool|string
     {
         $fileInfo = new \finfo(FILEINFO_MIME_TYPE);
 

src/Gaufrette/Adapter/Local.php

@@ -183,11 +183,12 @@ public function size(string $key): int
     }
 
     /**
+     * {@inheritdoc}
      * @throws \OutOfBoundsException     If the computed path is out of the directory
      * @throws \InvalidArgumentException if the directory already exists
      * @throws \RuntimeException         if the directory could not be created
      */
-    public function mimeType(string $key): string
+    public function mimeType(string $key): bool|string
     {
         $fileInfo = new \finfo(FILEINFO_MIME_TYPE);
 

src/Gaufrette/Adapter/MimeTypeProvider.php

@@ -10,7 +10,7 @@
 interface MimeTypeProvider
 {
     /**
-     * Returns the mime type of the specified key.
+     * @return false|string the mime type of the specified key.
      */
-    public function mimeType(string $key): string;
+    public function mimeType(string $key): string|bool;
 }

src/Gaufrette/FilesystemInterface.php

@@ -167,7 +167,7 @@ public function createFile($key);
      *
      * @param string $key
      *
-     * @return string
+     * @return string|false
      *
      * @throws \InvalidArgumentException If $key is invalid
      */