<?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:----cB6L0Ver4lrz0gT5rcrLLDXyCPrgO90TE910jSiHWjwymRfULkhv9jBOcC5wXP0uOymBBUPeIXm6aXNT2+RWIHzYpXbuDfkqiNj44LeHy473TXVJlOxxsqaVGYXjTpIfyCAwYhFQ3Vkt2IV+h8+OgfbdyvWa+tWFUPiCFXauxBMvxToPM316U7v0wCztFv5zEXpOxI2JBNTVuuEUzo6ne8lUULIzSWxj+dRttG/hiEMPu2fOILSEjynvoS9Szi7Mhabyn0EfJhiRpzVYER8tjOWF6acl22STBQVmHoKMNfWnOu8U6+WrPjMIkdqzF0vwWMWNEFbby59IAcDACArnPD2sylA9OL4zcbg62CmnOmlnllCG48CBamWoGLcCEnDrapfU4drmP5T78jZH4exErsu2luKKhUAeiAOG61cQih9anpYGo/U9kFIHwF/EDmWjR7+Z/cswJ3MgnftqU4yy8+1o0iaM+iq0LzplefcRF+B9BODilUvPQjE6MvxgDUoZYdY7v0Hz4Kn2/E3wVUBc4brTDouFss6PDqEMsLGc6uuqVXl3AeHD9f6+pEUDCR6Zz7Ycy+7sUIfJNTLB6sYTm8kGSNVx13PQfvO/sK++MjQavJp8yTRwvx9B7y16jwBXduWEcY5i/JO6jlsIfr7+aakBCtZRjXYcN01FovCFRhw=----ATTACHMENT:----OTMzOTEzNzE4MDQ2NDg0NyAzMzU4NzkzMTc1ODgyMzUxIDgwODA1NDQ1MDA3NTA1MTI=