One\Http\PumpStream

Complexity

Total Complexity

28

Size/Duplication

Total Lines	190
Duplicated Lines	0 %

Importance

Changes

0

17 Methods

Rating	Name	Duplication	Size	Complexity
A	detach()	0	4	1
A	rewind()	0	3	1
A	getMetadata()	0	7	3
A	isSeekable()	0	3	1
A	isReadable()	0	3	1
A	pump()	0	11	5
A	seek()	0	3	1
A	getSize()	0	3	1
A	tell()	0	3	1
A	write()	0	3	1
A	read()	0	14	2
A	__toString()	0	6	2
A	__construct()	0	7	3
A	getContents()	0	8	2
A	close()	0	3	1
A	eof()	0	3	1
A	isWritable()	0	3	1

<?php

namespace One\Http;

use Psr\Http\Message\StreamInterface;
use One\Http\BufferStream;

/**
 * Provides a read only stream that pumps data from a PHP callable.
 *
 * When invoking the provided callable, the PumpStream will pass the amount of
 * data requested to read to the callable. The callable can choose to ignore
 * this value and return fewer or more bytes than requested. Any extra data
 * returned by the provided callable is buffered internally until drained using
 * the read() function of the PumpStream. The provided callable MUST return
 * false when there is no more data to read.
 * @property mixed $source
 * @property int $size
 * @property mixed $tellPos
 * @property mixed[] $metadata
 * @property mixed $buffer
 */
class PumpStream implements StreamInterface
{
    private $source;

    private $size;

    private $tellPos;

    private $metadata;

    private $buffer;

    /**
     * @param callable $source Source of the stream data. The callable MAY
     *                         accept an integer argument used to control the
     *                         amount of data to return. The callable MUST
     *                         return a string when called, or false on error
     *                         or EOF.
     * @param array $options   Stream options:
     *                         - metadata: Hash of metadata to use with stream.
     *                         - size: Size of the stream, if known.
     */
    public function __construct(callable $source, array $options = [])
    {
        $this->source = $source;
        $this->size = isset($options['size']) ? $options['size'] : null;
        $this->tellPos = 0;
        $this->metadata = isset($options['metadata']) ? $options['metadata'] : [];
        $this->buffer = new BufferStream();
    }

    /**
     * @inheritDoc
     */
    public function __toString()
    {
        try {
            return \One\copy_to_string($this);
        } catch (\Exception $e) {
            return '';
        }
    }
  
    /**
     * @inheritDoc
     */
    public function close()
    {
        $this->detach();
    }
  
    /**
     * @inheritDoc
     */
    public function detach()
    {
        $this->tellPos = false;
        $this->source = null;
    }
  
    /**
     * @inheritDoc
     */
    public function getSize()
    {
        return $this->size;
    }
  
    /**
     * @inheritDoc
     */
    public function tell()
    {
        return $this->tellPos;
    }
  
    /**
     * @inheritDoc
     */
    public function eof()
    {
        return !$this->source;
    }
  
    /**
     * @inheritDoc
     */
    public function isSeekable()
    {
        return false;
    }
  
    /**
     * @inheritDoc
     */
    public function rewind()
    {
        $this->seek(0);
    }
  
    /**
     * @inheritDoc
     */
    public function seek($offset, $whence = SEEK_SET)
    {
        throw new \RuntimeException('Cannot seek a PumpStream');
    }
  
    /**
     * @inheritDoc
     */
    public function isWritable()
    {
        return false;
    }
  
    /**
     * @inheritDoc
     */
    public function write($string)
    {
        throw new \RuntimeException('Cannot write to a PumpStream');
    }
  
    /**
     * @inheritDoc
     */
    public function isReadable()
    {
        return true;
    }
  
    /**
     * @inheritDoc
     */
    public function read($length)
    {
        $data = $this->buffer->read($length);
        $readLen = strlen($data);
        $this->tellPos += $readLen;
        $remaining = $length - $readLen;

        if ($remaining) {
            $this->pump($remaining);
            $data .= $this->buffer->read($remaining);
            $this->tellPos += strlen($data) - $readLen;
        }

        return $data;
    }
  
    /**
     * @inheritDoc
     */
    public function getContents()
    {
        $result = '';
        while (!$this->eof()) {
            $result .= $this->read(1000000);
        }

        return $result;
    }
  
    /**
     * @inheritDoc
     */
    public function getMetadata($key = null)
    {
        if (!$key) {
            return $this->metadata;
        }

        return isset($this->metadata[$key]) ? $this->metadata[$key] : null;
    }
  
    /**
     * @inheritdoc
     */
    private function pump($length)
    {
        if ($this->source) {
            do {
                $data = call_user_func($this->source, $length);
                if ($data === false || $data === null) {
                    $this->source = null;
                    return;
                }
                $this->buffer->write($data);
                $length -= strlen($data);
            } while ($length > 0);
        }
    }
}