cerbero90 / json-parser

src/Sources/AnySource.php

<?php

namespace Cerbero\JsonParser\Sources;

use Cerbero\JsonParser\Exceptions\UnsupportedSourceException;
use Generator;
use Traversable;

/**
 * The handler of any JSON source.
 *
 */
class AnySource extends Source
{
    /**
     * The supported sources.
     *
     * @var class-string<Source>[]

The doc comment class-string<Source>[] at position 0 could not be parsed: Unknown type name 'class-string' at position 0 in class-string<Source>[].

     */
    protected array $supportedSources = [
        CustomSource::class,
        Endpoint::class,
        Filename::class,
        IterableSource::class,
        Json::class,
        JsonResource::class,
        LaravelClientResponse::class,
        Psr7Message::class,
        Psr7Request::class,
        Psr7Stream::class,
    ];

    /**
     * The matching source.
     *
     * @var Source|null
     */
    protected ?Source $matchingSource;

    /**
     * Retrieve the JSON fragments
     *
     * @return Traversable<int, string>
     * @throws UnsupportedSourceException
     */
    public function getIterator(): Traversable
    {
        return $this->matchingSource();
    }

    /**
     * Retrieve the matching source
     *
     * @return Source
     * @throws UnsupportedSourceException
     */
    protected function matchingSource(): Source
    {
        if (isset($this->matchingSource)) {
            return $this->matchingSource;
        }

        foreach ($this->sources() as $source) {
            if ($source->matches()) {
                return $this->matchingSource = $source;
            }
        }

        throw new UnsupportedSourceException($this->source);
    }

    /**
     * Retrieve all available sources
     *
     * @return Generator<int, Source>
     */
    protected function sources(): Generator
    {
        foreach ($this->supportedSources as $source) {
            yield new $source($this->source, $this->config);
        }
    }

    /**
     * Determine whether the JSON source can be handled
     *
     * @return bool
     */
    public function matches(): bool
    {
        return true;
    }

    /**
     * Retrieve the calculated size of the JSON source
     *
     * @return int|null
     */
    protected function calculateSize(): ?int
    {
        return $this->matchingSource()->size();
    }
}