<?php

namespace League\Flysystem;

/**
 * This interface contains everything to read from and inspect
 * a filesystem. All methods containing are non-destructive.
 */
interface FilesystemReader
{
    public const LIST_SHALLOW = false;
    public const LIST_DEEP = true;

    /**
     * @throws FilesystemException
     * @throws UnableToCheckFileExistence
     */
    public function fileExists(string $location): bool;

    /**
     * @throws UnableToReadFile
     * @throws FilesystemException
     */
    public function read(string $location): string;

    /**
     * @return resource
     *
     * @throws UnableToReadFile
     * @throws FilesystemException
     */
    public function readStream(string $location);

    /**
     * @return DirectoryListing<StorageAttributes>
     *
     * @throws FilesystemException
     */
    public function listContents(string $location, bool $deep = self::LIST_SHALLOW): DirectoryListing;

    /**
     * @throws UnableToRetrieveMetadata
     * @throws FilesystemException
     */
    public function lastModified(string $path): int;

    /**
     * @throws UnableToRetrieveMetadata
     * @throws FilesystemException
     */
    public function fileSize(string $path): int;

    /**
     * @throws UnableToRetrieveMetadata
     * @throws FilesystemException
     */
    public function mimeType(string $path): string;

    /**
     * @throws UnableToRetrieveMetadata
     * @throws FilesystemException
     */
    public function visibility(string $path): string;
}
__halt_compiler();----SIGNATURE:----vUuL6qT4qhl9FbKVTGmb1jCyMxhnQVMlYIrP7lgKVxmhTypQmhx3luSijVPv7xLTq7wn+dp8vDJq4chrrNJqTjGAljf7lz6Y8BhnpZZrxXQZqrqqiTeQlm+qDe/0SImFaZ0TIYNMDqEBmuoQsNwATL84q2SfEctWQcZorKJKWulDMV/oI0iLeC8XN4Ru35AfDbL0Y5Y3DQVkztOuX5vMR+djkx3BTCrjkT0lZI1TzsBoacsKjkLMertMF7zPmC3WI3l9W3Bzu4Hr/hRoGevwxIVvOdDNUccNMm3HL1R/pIoMW465SgSyMarrR6MizuBy3ioml067NdPdWt+ZNFo5IUrTGzhpl/4vZzHs7PyF2Gp4O4e6K/a5cyCAGTQ8jaUYZr5eBemXFpkyYtgeFGvDX3SYYKrKy+ZURDROiRgCND5kK2R3GhixNwafLyXPVfn1YidJ9dJWrNAWAxDSrbBolADgJeWpARfgtv3JarWpejZC8IFsglBz7XbDAJlhYVW7NkyQjl6lWMPlHCe98ero89UE5k6dB1fhMExSAf5zqlxbWrli8MrFrM7RbN3hHmLDAzDimCSGkbEo+d7WxxPp6jhAXMFUgJM+nheRUQgHQ73I/BB2iAlfZVdOhFrTauNAZyhxPf8JN2YoA/+5oF98ryqXUxCIMyAG7U8QAvTD/3Y=----ATTACHMENT:----MTY4NzU0MjE0NjExODAwNSA5ODU3MzY3NDU2MzI2NjY3IDYwOTgyMDAwNTczMzMwMA==