Palmtree\Csv\Reader

Complexity

Total Complexity

39

Size/Duplication

Total Lines	231
Duplicated Lines	0 %

Test Coverage

Coverage

77.65%

Importance

Changes	17
Bugs	0	Features	0

23 Methods

Rating	Name	Duplication	Size	Complexity
A	valid()	0	5	1
A	getHeaders()	0	7	3
A	toArray()	0	8	2
A	getHeader()	0	3	1
A	getOffset()	0	3	1
A	current()	0	3	1
A	setHeaderNormalizer()	0	5	1
A	getCurrentRow()	0	17	6
A	getNormalizer()	0	13	4
A	rewind()	0	20	4
A	setOffset()	0	5	1
A	setDefaultNormalizer()	0	5	1
A	next()	0	3	1
A	getHeaderNormalizer()	0	7	2
A	setStripBom()	0	5	1
A	getHeaderOffset()	0	3	1
A	getDefaultNormalizer()	0	3	1
A	addNormalizer()	0	5	1
A	read()	0	3	1
A	setHeaderOffset()	0	5	1
A	getOpenMode()	0	3	1
A	key()	0	3	1
A	addNormalizers()	0	7	2

<?php

namespace Palmtree\Csv;

use Palmtree\Csv\Normalizer\NormalizerInterface;
use Palmtree\Csv\Normalizer\NullNormalizer;
use Palmtree\Csv\Row\Row;
use Palmtree\Csv\Util\StringUtil;

/**
 * Reads a CSV file by loading each line into memory one at a time.
 */
class Reader extends AbstractCsvDocument implements \Iterator
{
    /** @var string */
    private $defaultNormalizer = NullNormalizer::class;
    /** @var NormalizerInterface|null */
    private $headerNormalizer;
    /** @var NormalizerInterface[] */
    private $normalizers = [];
    /** @var Row|null */
    private $headers;
    /** @var Row */
    private $row;
    /** @var string|null */
    private $stripBom = StringUtil::BOM_UTF8;
    /** @var int */
    private $offset = 0;
    /** @var int */
    private $headerOffset = 0;

    public static function read(string $filePath, bool $hasHeaders = true): self
    {
        return new self($filePath, $hasHeaders);
    }

    public function getHeaders(): ?Row
    {
        if ($this->hasHeaders && $this->headers === null) {
            $this->rewind();
        }

        return $this->headers;
    }

    /**
     * @param string|int $key
     *
     * @return string|int
     */
    public function getHeader($key)
    {
        return $this->headers[$key] ?? $key;
    }

    public function setHeaderNormalizer(NormalizerInterface $headerNormalizer): self
    {
        $this->headerNormalizer = $headerNormalizer;

        return $this;
    }

    public function getHeaderNormalizer(): NormalizerInterface
    {
        if ($this->headerNormalizer === null) {
            $this->headerNormalizer = new NullNormalizer();
        }

        return $this->headerNormalizer;
    }

    public function addNormalizer(string $key, NormalizerInterface $normalizer): self
    {
        $this->normalizers[$key] = $normalizer;

        return $this;
    }

    public function addNormalizers(iterable $normalizers): self
    {
        foreach ($normalizers as $key => $normalizer) {
            $this->addNormalizer($key, $normalizer);
        }

        return $this;
    }

    /**
     * @param string|int $key
     */
    public function getNormalizer($key): NormalizerInterface
    {
        if ($this->hasHeaders && \is_int($key)) {
            $this->normalizers[$key] = $this->getHeaderNormalizer();
        }

        if (!isset($this->normalizers[$key])) {
            $class = $this->getDefaultNormalizer();

            $this->normalizers[$key] = new $class();
        }

        return $this->normalizers[$key];
    }

    /**
     * Reads the next line in the CSV file and returns a Row object from it.
     */
    private function getCurrentRow(): ?Row
    {
        $cells = $this->getDocument()->current();

        if (!\is_array($cells) || $cells == [null]) {
            return null;
        }

        if ($this->key() === 0 && $this->stripBom) {
            $stripped = StringUtil::stripBom($cells[0], $this->stripBom);

            if ($stripped !== $cells[0]) {
                $cells[0] = \trim($stripped, $this->enclosure);
            }
        }

        return new Row($cells, $this);
    }

    /**
     * @inheritDoc
     */
    public function current(): Row
    {
        return $this->row;
    }

    /**
     * @inheritDoc
     */
    public function next(): void
    {
        $this->getDocument()->next();
    }

    /**
     * @inheritDoc
     */
    public function key(): int
    {
        return $this->getDocument()->key();
    }

    /**
     * @inheritDoc
     */
    public function valid(): bool
    {
        $this->row = $this->getCurrentRow();

        return $this->row instanceof Row;
    }

    /**
     * @inheritDoc
     */
    public function rewind(): void
    {
        $this->getDocument()->rewind();

        $dataOffset = $this->offset + $this->headerOffset;
        if ($this->hasHeaders) {
            if ($this->headerOffset) {
                $this->getDocument()->seek($this->headerOffset);
            }

            // Set headers to null first so the header row is a zero-based array and can be used
            // to set the array keys of all other rows.
            $this->headers = null;
            $this->headers = $this->getCurrentRow();

            ++$dataOffset;
        }

        if ($dataOffset > 0) {
            $this->getDocument()->seek($dataOffset);
        }
    }

    public function setDefaultNormalizer(string $defaultNormalizer): self
    {
        $this->defaultNormalizer = $defaultNormalizer;

        return $this;
    }

    public function getDefaultNormalizer(): string
    {
        return $this->defaultNormalizer;
    }

    public function setStripBom(?string $stripBom): self
    {
        $this->stripBom = $stripBom;

        return $this;
    }

    public function setOffset(int $offset): self
    {
        $this->offset = $offset;

        return $this;
    }

    public function getOffset(): int
    {
        return $this->offset;
    }

    public function setHeaderOffset(int $headerOffset): self
    {
        $this->headerOffset = $headerOffset;

        return $this;
    }

    public function getHeaderOffset(): int
    {
        return $this->headerOffset;
    }

    public function toArray(): array
    {
        $result = [];
        foreach ($this as $row) {
            $result[] = $row->toArray();
        }

        return $result;
    }

    protected function getOpenMode(): string
    {
        return 'r';
    }
}