<?php

/*

* This file is part of the Symfony package.

*

* (c) Fabien Potencier <[email protected]>

*

* For the full copyright and license information, please view the LICENSE

* file that was distributed with this source code.

*/

namespace Symfony\Component\Translation\Extractor;

use Symfony\Component\Translation\Exception\InvalidArgumentException;

/**

* Base class used by classes that extract translation messages from files.

*

* @author Marcos D. Sánchez <[email protected]>

*/

abstract class AbstractFileExtractor

{

protected function extractFiles(string|iterable $resource): iterable

{

if (is_iterable($resource)) {

$files = [];

foreach ($resource as $file) {

if ($this->canBeExtracted($file)) {

$files[] = $this->toSplFileInfo($file);

}

}

} elseif (is_file($resource)) {

$files = $this->canBeExtracted($resource) ? [$this->toSplFileInfo($resource)] : [];

} else {

$files = $this->extractFromDirectory($resource);

}

return $files;

}

private function toSplFileInfo(string $file): \SplFileInfo

{

return new \SplFileInfo($file);

}

/**

* @throws InvalidArgumentException

*/

protected function isFile(string $file): bool

{

if (!is_file($file)) {

throw new InvalidArgumentException(\sprintf('The "%s" file does not exist.', $file));

}

return true;

}

abstract protected function canBeExtracted(string $file): bool;

abstract protected function extractFromDirectory(string|array $resource): iterable;

}