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

Passed

Push — master ( 07b99e...8b173b )

by Alec

created 2019-08-13 09:38 UTC

Spinner::updateMessage() A

↳ Parent: Spinner

Complexity

Conditions	2
Paths	2

Size

Total Lines	6
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	6

Importance

Changes

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

<?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 INTERVAL = SettingsInterface::DEFAULT_INTERVAL;
    protected const SYMBOLS = SpinnerSymbols::DIAMOND;
    protected const STYLES = [];

    /** @var string */
    protected $messageStr;
    /** @var string */
    protected $currentMessage;
    /** @var string */
    protected $currentMessagePrefix;
    /** @var string */
    protected $currentMessageSuffix;
    /** @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|false|SpinnerOutputInterface $output
     * @param mixed $color
     */
    public function __construct($settings = null, $output = null, $color = null)
    {
        $this->output = $this->refineOutput($output);
        $settings = $this->refineSettings($settings);
        $this->interval = $settings->getInterval();
        $this->erasingShift = $settings->getErasingShift();
        $this->inlinePaddingStr = $settings->getInlinePaddingStr();
        $this->currentMessage = $settings->getMessage();
        $this->currentMessagePrefix = $settings->getMessagePrefix();
        $this->currentMessageSuffix = $settings->getMessageSuffix();
        $this->updateMessageStr();
        $this->updateProperties();
        $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|false|SpinnerOutputInterface $output
     * @return null|SpinnerOutputInterface
     */
    protected function refineOutput($output): ?SpinnerOutputInterface
    {
        $this->assertOutput($output);
        if (false === $output) {
            return null;
        }
        return $output ?? new EchoOutputAdapter();
    }

    /**
     * @param mixed $output
     */
    protected function assertOutput($output): void
    {
        if (null !== $output && false !== $output && !$output instanceof SpinnerOutputInterface) {
            $typeOrValue = true === $output ? 'true' : typeOf($output);
            throw new \InvalidArgumentException(
                'Incorrect $output param [null|false|SpinnerOutputInterface] expected "' . $typeOrValue . '" 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)
                ->setSymbols(static::SYMBOLS)
                ->setStyles(static::STYLES);
    }

    protected function updateMessageStr(): void
    {
        $this->messageStr =  $this->currentMessagePrefix . ucfirst($this->currentMessage) . $this->currentMessageSuffix;
    }

    protected function updateProperties(): void
    {
        $this->percentPrefix = $this->getPercentPrefix(); // TODO move to other location - optimize performance
        $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 getPercentPrefix(): 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;
    }

    /** {@inheritDoc} */
    public function getOutput(): ?SpinnerOutputInterface
    {
        return $this->output;
    }

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

    public function inline(bool $inline): SpinnerInterface
    {
        $this->inlinePaddingStr = $inline ? SettingsInterface::ONE_SPACE_SYMBOL : SettingsInterface::EMPTY;
        $this->updateProperties();
        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 $message = null): string
    {
        if (null !== $percent) {
            $this->updatePercent($percent);
        }
        if (null !== $message) {
            $this->updateMessage($message);
        }
        $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->updateProperties();
        }
    }

    protected function updateMessage(string $message): void
    {
        if ($this->currentMessage !== $message) {
            $this->currentMessage = $message;
            $this->updateMessageStr();
            $this->updateProperties();
        }
    }

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

alecrabbit / php-console-spinner

Push — master ( 07b99e...8b173b )

Spinner::updateMessage() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like