<?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:----gXwxkwGIUtKCmmDb8FNaFRNPurY2P/5XWEJtBSyvj1yeN9wXahgAK4BpYUsJM4QRwyVBGJ4/eMws20oWhj7eOyPtynEDm3IlAc2j7HjRsJHmFkUAeCpM0rXNWg9h4dSOrxV1yzZs9Yo6AZufqcVLVXuOCjkesPcgBcKeJyZiFp8C8hvTFxvYgUSSCZHv4jr3l3H+jmC+3s5fnDfmQWEoxZHa26F+Rzabu5IZmwhiLACcp5tuFrULnWlQ9l4xZAwqHFFfm6C97U+1SeiqyxXxgZO48PansIcAe9YEC+zhnv+/PZr7cgs1kf/Ioh6ioeb8Nc9OZDrj36N2/3yKhDGzs/ueYrnrkMUmJR/qnP5XvbFWnOl/9/lpr68SZia/THH70Nqo14ctGip4vQoLMl7hCxHKCKCcsPaTA65nSVZ0du7lXigyPcy5WLA4WOxK6XnPohPiwjC8RpRgT9/VPyW3tsqI5X1rgXSjrmG4wSAz5zQye0cWdtYuO74085GwaMOzIKGEjw5zwkK4qc3V4q0To52o++x7llMiT+BaKrho0FHX1iSr3Cpax8NN7vP0KFl0WqBe0R5HZxaX1/iHCtGdegh6kyB6xvnGbf/e1SKKcCdJSGiuWvg0QT/Q6GNZ3xHd9fAs0lOKYMDP0NqFtM/z9V5seZXrD/jOy4OGwqp7AzU=----ATTACHMENT:----NDE2OTgxNTUwOTc3OTI4MSA5NTE2MjU2NTY3MjM3MjQ5IDYyNjQ3NDQ4MDAwNTIwOTI=