CliMenuBuilder::setTitleSeparator() - Code Metrics - Inspection of "Item-level style example; fixes disappearing style..." - php-school/cli-menu - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Pull Request — master (#203)

unknown
created 2019-12-18 21:29 UTC
CliMenuBuilder::setTitleSeparator() A

↳ Parent: CliMenuBuilder
Complexity

Conditions	1
Paths	1
Size

Total Lines	5
Code Lines	2
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	1
eloc	2
nc	1
nop	1
dl	0
loc	5
rs	10
c	0
b	0
f	0
<?php

namespace PhpSchool\CliMenu\Builder;

use Closure;
use PhpSchool\CliMenu\Action\ExitAction;
use PhpSchool\CliMenu\Action\GoBackAction;
use PhpSchool\CliMenu\Exception\InvalidShortcutException;
use PhpSchool\CliMenu\MenuItem\AsciiArtItem;
use PhpSchool\CliMenu\MenuItem\CheckableItem;
use PhpSchool\CliMenu\MenuItem\LineBreakItem;
use PhpSchool\CliMenu\MenuItem\MenuItemInterface;
use PhpSchool\CliMenu\MenuItem\MenuMenuItem;
use PhpSchool\CliMenu\MenuItem\RadioItem;
use PhpSchool\CliMenu\MenuItem\SelectableInterface;
use PhpSchool\CliMenu\MenuItem\SelectableItem;
use PhpSchool\CliMenu\CliMenu;
use PhpSchool\CliMenu\MenuItem\SplitItem;
use PhpSchool\CliMenu\MenuItem\StaticItem;
use PhpSchool\CliMenu\MenuStyle;
use PhpSchool\CliMenu\Style\CheckableStyle;
use PhpSchool\CliMenu\Style\RadioStyle;
use PhpSchool\CliMenu\Style\SelectableStyle;
use PhpSchool\CliMenu\Terminal\TerminalFactory;
use PhpSchool\Terminal\Terminal;

/**
 * @author Michael Woodward <[email protected]>
 * @author Aydin Hassan <[email protected]>
 */
class CliMenuBuilder
{
    /**
     * @var CliMenu
     */
    private $menu;

    /**
     * @var string
     */
    private $goBackButtonText = 'Go Back';

    /**
     * @var string
     */
    private $exitButtonText = 'Exit';

    /**
     * @var MenuStyle
     */
    private $style;

    /**
     * @var Terminal
     */
    private $terminal;

    /**
     * @var bool
     */
    private $disableDefaultItems = false;

    /**
     * @var bool
     */
    private $disabled = false;

    /**
     * Whether or not to auto create keyboard shortcuts for items
     * when they contain square brackets. Eg: [M]y item
     *
     * @var bool
     */
    private $autoShortcuts = false;

    /**
     * Regex to auto match for shortcuts defaults to looking
     * for a single character encased in square brackets
     *
     * @var string
     */
    private $autoShortcutsRegex = '/\[(.)\]/';

    /**
     * @var bool
     */
    private $subMenu = false;

    public function __construct(Terminal $terminal = null)
    {
        $this->terminal = $terminal ?? TerminalFactory::fromSystem();
        $this->style    = new MenuStyle($this->terminal);
        $this->menu     = new CliMenu(null, [], $this->terminal, $this->style);
    }
    
    public static function newSubMenu(Terminal $terminal) : self
    {
        $instance = new self($terminal);
        $instance->subMenu = true;
        
        return $instance;
    }

    public function setTitle(string $title) : self
    {
        $this->menu->setTitle($title);

        return $this;
    }

    public function addMenuItem(MenuItemInterface $item) : self
    {
        $this->menu->addItem($item);

        $this->processItemShortcut($item);

        return $this;
    }

    public function addItem(
        string $text,
        callable $itemCallable,
        bool $showItemExtra = false,
        bool $disabled = false
    ) : self {
        $item = (new SelectableItem($text, $itemCallable, $showItemExtra, $disabled))
            ->setStyle($this->menu->getSelectableStyle());

        $this->addMenuItem($item);

        return $this;
    }

    public function addItems(array $items) : self
    {
        foreach ($items as $item) {
            $this->addItem(...$item);
                   addItem(...$item);
        }

        return $this;
    }

    public function addCheckableItem(
        string $text,
        callable $itemCallable,
        bool $showItemExtra = false,
        bool $disabled = false
    ) : self {
        $item = (new CheckableItem($text, $itemCallable, $showItemExtra, $disabled))
            ->setStyle($this->menu->getCheckableStyle());

        $this->addMenuItem($item);

        return $this;
    }

    public function addRadioItem(
        string $text,
        callable $itemCallable,
        bool $showItemExtra = false,
        bool $disabled = false
    ) : self {
        $item = (new RadioItem($text, $itemCallable, $showItemExtra, $disabled))
            ->setStyle($this->menu->getRadioStyle());

        $this->addMenuItem($item);

        return $this;
    }

    public function addStaticItem(string $text) : self
    {
        $this->addMenuItem(new StaticItem($text));

        return $this;
    }

    public function addLineBreak(string $breakChar = ' ', int $lines = 1) : self
    {
        $this->addMenuItem(new LineBreakItem($breakChar, $lines));

        return $this;
    }

    public function addAsciiArt(string $art, string $position = AsciiArtItem::POSITION_CENTER, string $alt = '') : self
    {
        $this->addMenuItem(new AsciiArtItem($art, $position, $alt));

        return $this;
    }

    public function addSubMenu(string $text, Closure $callback) : self
    {
        $builder = self::newSubMenu($this->terminal);

        if ($this->autoShortcuts) {
            $builder->enableAutoShortcuts($this->autoShortcutsRegex);
        }

        $callback($builder);

        $menu = $this->createMenuClosure($builder, $this->menu);

        $item = (new MenuMenuItem($text, $menu, $builder->isMenuDisabled()))
            ->setStyle($this->menu->getSelectableStyle());

        $this->menu->addItem($item);

        $this->processItemShortcut($item);

        return $this;
    }

    public function addSubMenuFromBuilder(string $text, CliMenuBuilder $builder) : self
    {
        $menu = $this->createMenuClosure($builder, $this->menu);

        $item = (new MenuMenuItem($text, $menu, $builder->isMenuDisabled()))
            ->setStyle($this->menu->getSelectableStyle());

        $this->menu->addItem($item);

        $this->processItemShortcut($item);

        return $this;
    }

    /**
     * Create the submenu as a closure which is then unpacked in MenuMenuItem::showSubMenu
     * This allows us to wait until all user-provided styles are parsed and apply them to nested items
     *
     * @param CliMenuBuilder|SplitItemBuilder $builder
     * @param CliMenu $parent
     * @return Closure
     */
    protected function createMenuClosure($builder, CliMenu $parent = null) : Closure
    {
        return function () use ($builder, $parent) {
            $menu = $builder->build();

            if ($parent) {
                $menu->setParent($parent);
                       setParent($parent);
            }

            // we apply the parent theme if nothing was changed
            // if no styles were changed in this sub-menu
            if (!$menu->getStyle()->hasChangedFromDefaults()) {
            if (!$menu->/** @scrutinizer ignore-call */ getStyle()->hasChangedFromDefaults()) {
                $menu->setStyle($this->menu->getStyle());
                       setStyle($this->menu->getStyle());
            }

            // If user changed this style, persist to the menu so children CheckableItems may use it
            if ($this->menu->getCheckableStyle()->getIsCustom()) {
                $menu->setCheckableStyle(function (CheckableStyle $style) {
                       setCheckableStyle(function (CheckableStyle $style) {
                    $style->fromArray($this->menu->getCheckableStyle()->toArray());
                });
            }

            // If user changed this style, persist to the menu so children RadioItems may use it
            if ($this->menu->getRadioStyle()->getIsCustom()) {
                $menu->setRadioStyle(function (RadioStyle $style) {
                       setRadioStyle(function (RadioStyle $style) {
                    $style->fromArray($this->menu->getRadioStyle()->toArray());
                });
            }

            // If user changed this style, persist to the menu so children SelectableItems may use it
            if ($this->menu->getSelectableStyle()->getIsCustom()) {
                $menu->setSelectableStyle(function (SelectableStyle $style) {
                       setSelectableStyle(function (SelectableStyle $style) {
                    $style->fromArray($this->menu->getSelectableStyle()->toArray());
                });
            }

            // This will be filled with user-provided items
            foreach ($menu->getItems() as $item) {
                if ($item instanceof SelectableInterface && !$item->getStyle()->getIsCustom()) {
                    $item->setStyle(clone $menu->getSelectableStyle());
                    $item->setStyle(clone $menu->/** @scrutinizer ignore-call */ getSelectableStyle());
                }
            }

            return $menu;
        };
    }

    public function enableAutoShortcuts(string $regex = null) : self
    {
        $this->autoShortcuts = true;

        if (null !== $regex) {
            $this->autoShortcutsRegex = $regex;
        }

        return $this;
    }

    private function extractShortcut(string $title) : ?string
    {
        preg_match($this->autoShortcutsRegex, $title, $match);

        if (!isset($match[1])) {
            return null;
        }

        if (mb_strlen($match[1]) > 1) {
            throw InvalidShortcutException::fromShortcut($match[1]);
        }

        return isset($match[1]) ? strtolower($match[1]) : null;
    }

    private function processItemShortcut(MenuItemInterface $item) : void
    {
        $this->processIndividualShortcut($item, function (CliMenu $menu) use ($item) {
            $menu->executeAsSelected($item);
        });
    }

    private function processSplitItemShortcuts(SplitItem $splitItem) : void
    {
        foreach ($splitItem->getItems() as $item) {
            $this->processIndividualShortcut($item, function (CliMenu $menu) use ($splitItem, $item) {
                $current = $splitItem->getSelectedItemIndex();

                $splitItem->setSelectedItemIndex(
                    array_search($item, $splitItem->getItems(), true)
                    /** @scrutinizer ignore-type */ array_search($item, $splitItem->getItems(), true)
                );

                $menu->executeAsSelected($splitItem);

                if ($current !== null) {
                    $splitItem->setSelectedItemIndex($current);
                }
            });
        }
    }

    private function processIndividualShortcut(MenuItemInterface $item, callable $callback) : void
    {
        if (!$this->autoShortcuts) {
            return;
        }

        if ($shortcut = $this->extractShortcut($item->getText())) {
            $this->menu->addCustomControlMapping(
                $shortcut,
                $callback
            );
        }
    }

    public function addSplitItem(Closure $callback) : self
    {
        $builder = new SplitItemBuilder($this->menu);

        if ($this->autoShortcuts) {
            $builder->enableAutoShortcuts($this->autoShortcutsRegex);
        }

        // If user changed this style, persist to the menu so children CheckableItems may use it
        if ($this->menu->getCheckableStyle()->getIsCustom()) {
            $builder->setCheckableStyle(function (CheckableStyle $style) {
                $style->fromArray($this->menu->getCheckableStyle()->toArray());
            });
        }

        // If user changed this style, persist to the menu so children RadioItems may use it
        if ($this->menu->getRadioStyle()->getIsCustom()) {
            $builder->setRadioStyle(function (RadioStyle $style) {
                $style->fromArray($this->menu->getRadioStyle()->toArray());
            });
        }

        // If user changed this style, persist to the menu so children SelectableItems may use it
        if ($this->menu->getSelectableStyle()->getIsCustom()) {
            $builder->setSelectableStyle(function (SelectableStyle $style) {
                $style->fromArray($this->menu->getSelectableStyle()->toArray());
            });
        }

        $callback($builder);
        
        $this->menu->addItem($splitItem = $builder->build());

        $this->processSplitItemShortcuts($splitItem);

        return $this;
    }

    /**
     * Disable a submenu
     *
     * @throws \InvalidArgumentException
     */
    public function disableMenu() : self
    {
        if (!$this->subMenu) {
            throw new \InvalidArgumentException(
                'You can\'t disable the root menu'
            );
        }

        $this->disabled = true;

        return $this;
    }

    public function isMenuDisabled() : bool
    {
        return $this->disabled;
    }

    public function setGoBackButtonText(string $goBackButtonTest) : self
    {
        $this->goBackButtonText = $goBackButtonTest;

        return $this;
    }

    public function setExitButtonText(string $exitButtonText) : self
    {
        $this->exitButtonText = $exitButtonText;

        return $this;
    }

    public function setBackgroundColour(string $colour, string $fallback = null) : self
    {
        $this->style->setBg($colour, $fallback);

        return $this;
    }

    public function setForegroundColour(string $colour, string $fallback = null) : self
    {
        $this->style->setFg($colour, $fallback);

        return $this;
    }

    public function setWidth(int $width) : self
    {
        $this->style->setWidth($width);

        return $this;
    }

    public function setPadding(int $topBottom, int $leftRight = null) : self
    {
        $this->style->setPadding($topBottom, $leftRight);

        return $this;
    }

    public function setPaddingTopBottom(int $topBottom) : self
    {
        $this->style->setPaddingTopBottom($topBottom);

        return $this;
    }

    public function setPaddingLeftRight(int $leftRight) : self
    {
        $this->style->setPaddingLeftRight($leftRight);

        return $this;
    }

    public function setMarginAuto() : self
    {
        $this->style->setMarginAuto();

        return $this;
    }

    public function setMargin(int $margin) : self
    {
        $this->style->setMargin($margin);

        return $this;
    }

    public function setUnselectedMarker(string $marker) : self
    {
        $this->style->setUnselectedMarker($marker);

        return $this;
    }

    public function setSelectedMarker(string $marker) : self
    {
        $this->style->setSelectedMarker($marker);

        return $this;
    }

    public function setItemExtra(string $extra) : self
    {
        $this->style->setItemExtra($extra);

        //if we customise item extra, it means we most likely want to display it
        $this->displayExtra();

        return $this;
    }

    public function setTitleSeparator(string $separator) : self
    {
        $this->style->setTitleSeparator($separator);

        return $this;
    }

    public function setBorder(int $top, $right = null, $bottom = null, $left = null, string $colour = null) : self
    {
        $this->style->setBorder($top, $right, $bottom, $left, $colour);

        return $this;
    }

    public function setBorderTopWidth(int $width) : self
    {
        $this->style->setBorderTopWidth($width);
        
        return $this;
    }

    public function setBorderRightWidth(int $width) : self
    {
        $this->style->setBorderRightWidth($width);

        return $this;
    }

    public function setBorderBottomWidth(int $width) : self
    {
        $this->style->setBorderBottomWidth($width);

        return $this;
    }

    public function setBorderLeftWidth(int $width) : self
    {
        $this->style->setBorderLeftWidth($width);

        return $this;
    }

    public function setBorderColour(string $colour, $fallback = null) : self
    {
        $this->style->setBorderColour($colour, $fallback);

        return $this;
    }

    public function getStyle() : MenuStyle
    {
        return $this->style;
    }

    public function getTerminal() : Terminal
    {
        return $this->terminal;
    }

    private function getDefaultItems() : array
    {
        $actions = [];
        if ($this->subMenu) {
            $actions[] = (new SelectableItem($this->goBackButtonText, new GoBackAction))
                ->setStyle($this->menu->getSelectableStyle());
        }

        $actions[] = (new SelectableItem($this->exitButtonText, new ExitAction))
                ->setStyle($this->menu->getSelectableStyle());

        return $actions;
    }

    public function disableDefaultItems() : self
    {
        $this->disableDefaultItems = true;

        return $this;
    }

    public function displayExtra() : self
    {
        $this->style->setDisplaysExtra(true);

        return $this;
    }

    private function itemsHaveExtra(array $items) : bool
    {
        return !empty(array_filter($items, function (MenuItemInterface $item) {
            return $item->showsItemExtra();
        }));
    }
    
    public function build() : CliMenu
    {
        if (!$this->disableDefaultItems) {
            $this->menu->addItems($this->getDefaultItems());
        }

        if (!$this->style->getDisplaysExtra()) {
            $this->style->setDisplaysExtra($this->itemsHaveExtra($this->menu->getItems()));
        }

        return $this->menu;
    }

    public function setCheckableStyle(callable $itemCallable) : self
    {
        $this->menu->setCheckableStyle($itemCallable);

        return $this;
    }

    public function setRadioStyle(callable $itemCallable) : self
    {
        $this->menu->setRadioStyle($itemCallable);

        return $this;
    }

    public function setSelectableStyle(callable $itemCallable) : self
    {
        $this->menu->setSelectableStyle($itemCallable);

        return $this;
    }
}

php-school / cli-menu

Pull Request — master (#203)

CliMenuBuilder::setTitleSeparator() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
