<?php

/*
 * This file is part of Chevere.
 *
 * (c) Rodolfo Berrios <rodolfo@chevere.org>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

declare(strict_types=1);

namespace Chevere\Filesystem;

use Chevere\Filesystem\Exceptions\FilesystemException;
use Chevere\Filesystem\Interfaces\DirectoryInterface;
use Chevere\Filesystem\Interfaces\FileInterface;
use Chevere\Filesystem\Interfaces\FilePhpInterface;
use Chevere\Filesystem\Interfaces\FilePhpReturnInterface;
use Chevere\Filesystem\Interfaces\PathInterface;
use RecursiveDirectoryIterator;

/**
 * @codeCoverageIgnore
 */
function getFilesystemInstanceMessage(string $instance, string $path): string
{
    return strtr(
        'Unable to create a `%instance%` for `%path%`',
        [
            '%instance%' => $instance,
            '%path%' => $path,
        ]
    );
}

function tailDirectoryPath(string|PathInterface $path): string
{
    if ($path instanceof PathInterface) {
        $path = $path->__toString();
    }
    if (substr($path, -1) === '\\') {
        $path = substr($path, 0, -1);
    }
    $path .= substr($path, -1) === '/'
        ? ''
        : '/';

    return $path;
}

/**
 * @codeCoverageIgnore
 */
function directoryForPath(string|PathInterface $path): DirectoryInterface
{
    $path = tailDirectoryPath($path);

    return new Directory(new Path($path));
}

/**
 * @codeCoverageIgnore
 */
function fileForPath(string|PathInterface $path): FileInterface
{
    return new File(
        $path instanceof PathInterface
            ? $path
            : new Path($path)
    );
}

/**
 * @codeCoverageIgnore
 * @throws FilesystemException
 */
function filePhpForPath(string|PathInterface $path): FilePhpInterface
{
    return new FilePhp(fileForPath($path));
}

/**
 * @codeCoverageIgnore
 * @throws FilesystemException
 */
function filePhpReturnForPath(string|PathInterface $path): FilePhpReturnInterface
{
    return new FilePhpReturn(filePhpForPath($path));
}

function resolvePath(string $path): string
{
    $path = str_replace(['/', '\\'], DIRECTORY_SEPARATOR, $path);
    $parts = explode(DIRECTORY_SEPARATOR, $path);
    $out = [];
    foreach ($parts as $part) {
        if ($part === '.') {
            continue;
        }
        if ($part === '..') {
            array_pop($out);

            continue;
        }
        $out[] = $part;
    }

    return implode(DIRECTORY_SEPARATOR, $out);
}

/**
 * @codeCoverageIgnore
 */
function recursiveDirectoryIteratorFor(DirectoryInterface $directory, int $flags): RecursiveDirectoryIterator
{
    return new RecursiveDirectoryIterator(
        $directory->path()->__toString(),
        $flags
    );
}