Spinner::refineOutput() - Code Metrics - Inspection of "output" - alecrabbit/php-console-spinner - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( df09e5...78d144 )

by Alec

created 2019-04-23 11:02 UTC

Spinner::refineOutput() A

↳ Parent: Spinner

Complexity

Conditions	2
Paths	2

Size

Total Lines	7
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	5
CRAP Score	2

Importance

Changes

Metric	Value
eloc	4
dl	0
loc	7
ccs	5
cts	5
cp	1
rs	10
c	0
b	0
f	0
cc	2
nc	2
nop	1
crap	2

<?php declare(strict_types=1);

namespace AlecRabbit\Spinner\Core;

use AlecRabbit\Accessories\Circular;
use AlecRabbit\Accessories\Pretty;
use AlecRabbit\Cli\Tools\Cursor;
use AlecRabbit\Spinner\Core\Adapters\EchoOutputAdapter;
use AlecRabbit\Spinner\Core\Contracts\SettingsInterface;
use AlecRabbit\Spinner\Core\Contracts\SpinnerInterface;
use AlecRabbit\Spinner\Core\Contracts\SpinnerOutputInterface;
use AlecRabbit\Spinner\Core\Contracts\SpinnerSymbols;
use function AlecRabbit\typeOf;
use const AlecRabbit\ESC;

abstract class Spinner implements SpinnerInterface
{
    protected const ERASING_SHIFT = SettingsInterface::DEFAULT_ERASING_SHIFT;
    protected const INTERVAL = SettingsInterface::DEFAULT_INTERVAL;
    protected const SYMBOLS = SpinnerSymbols::DIAMOND;
    protected const STYLES = [];

    /** @var string */
    protected $messageStr;
    /** @var string */
    protected $percentStr = '';
    /** @var string */
    protected $percentPrefix;
    /** @var string */
    protected $moveBackSequenceStr;
    /** @var string */
    protected $inlinePaddingStr;
    /** @var string */
    protected $eraseBySpacesStr;
    /** @var Style */
    protected $style;
    /** @var float */
    protected $interval;
    /** @var int */
    protected $erasingShift;
    /** @var Circular */
    protected $symbols;
    /** @var null|SpinnerOutputInterface */
    protected $output;

    /**
     * AbstractSpinner constructor.
     * @param mixed $settings
     * @param null|bool|SpinnerOutputInterface $output
     * @param mixed $color
     */
    public function __construct($settings = null, $output = false, $color = null)
    {
        $this->output = $this->refineOutput($output);
        $settings = $this->refineSettings($settings);
        $this->interval = $settings->getInterval();
        $this->erasingShift = $settings->getErasingShift();
        $this->inlinePaddingStr = $settings->getInlinePaddingStr();
        $this->messageStr = $this->getMessageStr($settings);
        $this->setFields();
        $this->symbols = new Circular($settings->getSymbols());
        try {
            $this->style = new Style($settings->getStyles(), $color);
        } catch (\Throwable $e) {
            throw new \InvalidArgumentException(
                '[' . static::class . '] ' . $e->getMessage(),
                (int)$e->getCode(),
                $e
            );
        }
    }

    /**
     * @param null|bool|SpinnerOutputInterface $output
     * @return null|SpinnerOutputInterface
     */
    protected function refineOutput($output): ?SpinnerOutputInterface
    {
        $this->assertOutput($output);
        if (false === $output) {
            return null;
        }
        return $output ?? new EchoOutputAdapter();
    }

    /**
     * @param null|bool|SpinnerOutputInterface $output
     */
    protected function assertOutput($output): void
    {
        if (null !== $output && false !== $output && !$output instanceof SpinnerOutputInterface) {
            dump($output);
            throw new \InvalidArgumentException(
                'Incorrect $output param null|false|SpinnerOutputInterface expected "' . typeOf($output) . '" given'
            );
        }
    }

    /**
     * @param mixed $settings
     * @return SettingsInterface
     */
    protected function refineSettings($settings): SettingsInterface
    {
        $this->assertSettings($settings);
        if (\is_string($settings)) {
            return
                $this->defaultSettings()->setMessage($settings);
        }
        return
            $settings ?? $this->defaultSettings();
    }

    /**
     * @param mixed $settings
     */
    protected function assertSettings($settings): void
    {
        if (null !== $settings && !\is_string($settings) && !$settings instanceof SettingsInterface) {
            throw new \InvalidArgumentException(
                'Instance of SettingsInterface or string expected ' . typeOf($settings) . ' given.'
            );
        }
    }

    /**
     * @return SettingsInterface
     */
    protected function defaultSettings(): SettingsInterface
    {
        return
            (new Settings())
                ->setInterval(static::INTERVAL)
                ->setErasingShift(static::ERASING_SHIFT)
                ->setSymbols(static::SYMBOLS)
                ->setStyles(static::STYLES);
    }

    /**
     * @param SettingsInterface $settings
     * @return string
     */
    protected function getMessageStr(SettingsInterface $settings): string
    {
        return $settings->getPrefix() . ucfirst($settings->getMessage()) . $settings->getSuffix();
    }

    protected function setFields(): void
    {
        $this->percentPrefix = $this->getPrefix();
        $strLen =
            strlen($this->message()) + strlen($this->percent()) + strlen($this->inlinePaddingStr) + $this->erasingShift;
        $this->moveBackSequenceStr = ESC . "[{$strLen}D";
        $this->eraseBySpacesStr = str_repeat(SettingsInterface::ONE_SPACE_SYMBOL, $strLen);
    }

    /**
     * @return string
     */
    protected function getPrefix(): string
    {
        if (strpos($this->messageStr, SettingsInterface::DEFAULT_SUFFIX)) {
            return SettingsInterface::ONE_SPACE_SYMBOL;
        }
        return SettingsInterface::EMPTY;
    }

    /**
     * @return string
     */
    protected function message(): string
    {
        return $this->messageStr;
    }

    /**
     * @return string
     */
    protected function percent(): string
    {
        return $this->percentStr;
    }

    public function interval(): float
    {
        return $this->interval;
    }

    public function inline(bool $inline): SpinnerInterface
    {
        $this->inlinePaddingStr = $inline ? SettingsInterface::ONE_SPACE_SYMBOL : SettingsInterface::EMPTY;
        $this->setFields();
        return $this;
    }

    /** {@inheritDoc} */
    public function begin(?float $percent = null): string
    {
        if ($this->output) {
            $this->output->write(Cursor::hide());
            $this->spin($percent);
            return '';
        }
        return Cursor::hide() . $this->spin($percent);
    }

    /** {@inheritDoc} */
    public function spin(?float $percent = null): string
    {
        if (null !== $percent) {
            $this->updatePercent($percent);
        }
        $str = $this->inlinePaddingStr .
            $this->style->spinner((string)$this->symbols->value()) .
            $this->style->message(
                $this->message()
            ) .
            $this->style->percent(
                $this->percent()
            ) .
            $this->moveBackSequenceStr;
        if ($this->output) {
            $this->output->write($str);
            return '';
        }
        return
            $str;
    }

    /**
     * @param float $percent
     */
    protected function updatePercent(float $percent): void
    {
        if (0 === (int)($percent * 1000) % 10) {
            $this->percentStr = Pretty::percent($percent, 0, $this->percentPrefix);
            $this->setFields();
        }
    }

    /** {@inheritDoc} */
    public function end(): string
    {
        if ($this->output) {
            $this->erase();
            $this->output->write(Cursor::show());
            return '';
        }
        return $this->erase() . Cursor::show();
    }

    /** {@inheritDoc} */
    public function erase(): string
    {
        $str = $this->eraseBySpacesStr . $this->moveBackSequenceStr;
        if ($this->output) {
            $this->output->write($str);
            return '';
        }
        return $str;
    }
}


1		<?php declare(strict_types=1);
2
3		namespace AlecRabbit\Spinner\Core;
4
5		use AlecRabbit\Accessories\Circular;
6		use AlecRabbit\Accessories\Pretty;
7		use AlecRabbit\Cli\Tools\Cursor;
8		use AlecRabbit\Spinner\Core\Adapters\EchoOutputAdapter;
9		use AlecRabbit\Spinner\Core\Contracts\SettingsInterface;
10		use AlecRabbit\Spinner\Core\Contracts\SpinnerInterface;
11		use AlecRabbit\Spinner\Core\Contracts\SpinnerOutputInterface;
12		use AlecRabbit\Spinner\Core\Contracts\SpinnerSymbols;
13		use function AlecRabbit\typeOf;
14		use const AlecRabbit\ESC;
15
16		abstract class Spinner implements SpinnerInterface
17		{
18		protected const ERASING_SHIFT = SettingsInterface::DEFAULT_ERASING_SHIFT;
19		protected const INTERVAL = SettingsInterface::DEFAULT_INTERVAL;
20		protected const SYMBOLS = SpinnerSymbols::DIAMOND;
21		protected const STYLES = [];
22
23		/** @var string */
24		protected $messageStr;
25		/** @var string */
26		protected $percentStr = '';
27		/** @var string */
28		protected $percentPrefix;
29		/** @var string */
30		protected $moveBackSequenceStr;
31		/** @var string */
32		protected $inlinePaddingStr;
33		/** @var string */
34		protected $eraseBySpacesStr;
35		/** @var Style */
36		protected $style;
37		/** @var float */
38		protected $interval;
39		/** @var int */
40		protected $erasingShift;
41		/** @var Circular */
42		protected $symbols;
43		/** @var null\|SpinnerOutputInterface */
44		protected $output;
45
46		/**
47		* AbstractSpinner constructor.
48		* @param mixed $settings
49		* @param null\|bool\|SpinnerOutputInterface $output
50		* @param mixed $color
51		*/
52	19	public function __construct($settings = null, $output = false, $color = null)
53		{
54	19	$this->output = $this->refineOutput($output);
55	19	$settings = $this->refineSettings($settings);
56	18	$this->interval = $settings->getInterval();
57	18	$this->erasingShift = $settings->getErasingShift();
58	18	$this->inlinePaddingStr = $settings->getInlinePaddingStr();
59	18	$this->messageStr = $this->getMessageStr($settings);
60	18	$this->setFields();
61	18	$this->symbols = new Circular($settings->getSymbols());
62		try {
63	18	$this->style = new Style($settings->getStyles(), $color);
64	1	} catch (\Throwable $e) {
65	1	throw new \InvalidArgumentException(
66	1	'[' . static::class . '] ' . $e->getMessage(),
67	1	(int)$e->getCode(),
68	1	$e
69		);
70		}
71	17	}
72
73		/**
74		* @param null\|bool\|SpinnerOutputInterface $output
75		* @return null\|SpinnerOutputInterface
76		*/
77	19	protected function refineOutput($output): ?SpinnerOutputInterface
78		{
79	19	$this->assertOutput($output);
80	19	if (false === $output) {
81	16	return null;
82		}
83	3	return $output ?? new EchoOutputAdapter();
84		}
85
86		/**
87		* @param null\|bool\|SpinnerOutputInterface $output
88		*/
89	19	protected function assertOutput($output): void
90		{
91	19	if (null !== $output && false !== $output && !$output instanceof SpinnerOutputInterface) {
92		dump($output);
93		throw new \InvalidArgumentException(
94		'Incorrect $output param null\|false\|SpinnerOutputInterface expected "' . typeOf($output) . '" given'
95		);
96		}
97	19	}
98
99		/**
100		* @param mixed $settings
101		* @return SettingsInterface
102		*/
103	19	protected function refineSettings($settings): SettingsInterface
104		{
105	19	$this->assertSettings($settings);
106	18	if (\is_string($settings)) {
107		return
108	13	$this->defaultSettings()->setMessage($settings);
109		}
110		return
111	5	$settings ?? $this->defaultSettings();
112		}
113
114		/**
115		* @param mixed $settings
116		*/
117	19	protected function assertSettings($settings): void
118		{
119	19	if (null !== $settings && !\is_string($settings) && !$settings instanceof SettingsInterface) {
120	1	throw new \InvalidArgumentException(
121	1	'Instance of SettingsInterface or string expected ' . typeOf($settings) . ' given.'
122		);
123		}
124	18	}
125
126		/**
127		* @return SettingsInterface
128		*/
129	15	protected function defaultSettings(): SettingsInterface
130		{
131		return
132	15	(new Settings())
133	15	->setInterval(static::INTERVAL)
134	15	->setErasingShift(static::ERASING_SHIFT)
135	15	->setSymbols(static::SYMBOLS)
136	15	->setStyles(static::STYLES);
137		}
138
139		/**
140		* @param SettingsInterface $settings
141		* @return string
142		*/
143	18	protected function getMessageStr(SettingsInterface $settings): string
144		{
145	18	return $settings->getPrefix() . ucfirst($settings->getMessage()) . $settings->getSuffix();
146		}
147
148	18	protected function setFields(): void
149		{
150	18	$this->percentPrefix = $this->getPrefix();
151		$strLen =
152	18	strlen($this->message()) + strlen($this->percent()) + strlen($this->inlinePaddingStr) + $this->erasingShift;
153	18	$this->moveBackSequenceStr = ESC . "[{$strLen}D";
154	18	$this->eraseBySpacesStr = str_repeat(SettingsInterface::ONE_SPACE_SYMBOL, $strLen);
155	18	}
156
157		/**
158		* @return string
159		*/
160	18	protected function getPrefix(): string
161		{
162	18	if (strpos($this->messageStr, SettingsInterface::DEFAULT_SUFFIX)) {
163	15	return SettingsInterface::ONE_SPACE_SYMBOL;
164		}
165	3	return SettingsInterface::EMPTY;
166		}
167
168		/**
169		* @return string
170		*/
171	18	protected function message(): string
172		{
173	18	return $this->messageStr;
174		}
175
176		/**
177		* @return string
178		*/
179	18	protected function percent(): string
180		{
181	18	return $this->percentStr;
182		}
183
184	2	public function interval(): float
185		{
186	2	return $this->interval;
187		}
188
189	4	public function inline(bool $inline): SpinnerInterface
190		{
191	4	$this->inlinePaddingStr = $inline ? SettingsInterface::ONE_SPACE_SYMBOL : SettingsInterface::EMPTY;
192	4	$this->setFields();
193	4	return $this;
194		}
195
196		/** {@inheritDoc} */
197	14	public function begin(?float $percent = null): string
198		{
199	14	if ($this->output) {
200	3	$this->output->write(Cursor::hide());
201	3	$this->spin($percent);
202	3	return '';
203		}
204	11	return Cursor::hide() . $this->spin($percent);
205		}
206
207		/** {@inheritDoc} */
208	14	public function spin(?float $percent = null): string
209		{
210	14	if (null !== $percent) {
211	4	$this->updatePercent($percent);
212		}
213	14	$str = $this->inlinePaddingStr .
214	14	$this->style->spinner((string)$this->symbols->value()) .
215	14	$this->style->message(
216	14	$this->message()
217		) .
218	14	$this->style->percent(
219	14	$this->percent()
220		) .
221	14	$this->moveBackSequenceStr;
222	14	if ($this->output) {
223	3	$this->output->write($str);
224	3	return '';
225		}
226		return
227	11	$str;
228		}
229
230		/**
231		* @param float $percent
232		*/
233	4	protected function updatePercent(float $percent): void
234		{
235	4	if (0 === (int)($percent * 1000) % 10) {
236	4	$this->percentStr = Pretty::percent($percent, 0, $this->percentPrefix);
237	4	$this->setFields();
238		}
239	4	}
240
241		/** {@inheritDoc} */
242	14	public function end(): string
243		{
244	14	if ($this->output) {
245	3	$this->erase();
246	3	$this->output->write(Cursor::show());
247	3	return '';
248		}
249	11	return $this->erase() . Cursor::show();
250		}
251
252		/** {@inheritDoc} */
253	14	public function erase(): string
254		{
255	14	$str = $this->eraseBySpacesStr . $this->moveBackSequenceStr;
256	14	if ($this->output) {
257	3	$this->output->write($str);
258	3	return '';
259		}
260	11	return $str;
261		}
262		}
263

alecrabbit / php-console-spinner

Push — master ( df09e5...78d144 )

Spinner::refineOutput() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like