RunOpts::getOptionImplementation() - Code Metrics - Inspection of "prepare 0.0.62 release" - ktomk/pipelines - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 503f62...3f0369 )

by Tom

created 2021-12-19 22:40 UTC

RunOpts::getOptionImplementation() A

↳ Parent: RunOpts

Complexity

Conditions	3
Paths	3

Size

Total Lines	14
Code Lines	7

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	8
CRAP Score	3

Importance

Changes

Metric	Value
cc	3
eloc	7
c	0
b	0
f	0
nc	3
nop	1
dl	0
loc	14
ccs	8
cts	8
cp	1
crap	3
rs	10

<?php

/* this file is part of pipelines */

namespace Ktomk\Pipelines\Runner;

use Ktomk\Pipelines\Utility\Options;
use Ktomk\Pipelines\Value\Prefix;

/**
 * Runner options parameter object
 */
class RunOpts
{
    /**
     * @var string
     */
    private $prefix;

    /**
     * @var null|Options
     */
    private $options;

    /**
     * @var null|string
     */
    private $binaryPackage;

    /**
     * @var null|string of step expression or null if not set
     */
    private $steps;

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

    /**
     * @var null|string --user $(id -u):$(id -g)
     */
    private $user;

    /**
     * @var null|true --ssh-auth
     */
    private $ssh;

    /**
     * Static factory method
     *
     * @param string $prefix [optional]
     * @param null|string $binaryPackage [optional] package name or path to binary (string)
     * @param Options $options [optional]
     *
     * @return RunOpts
     */
    public static function create($prefix = null, $binaryPackage = null, Options $options = null)
    {
        null === $options && $options = Options::create();

        return new self($prefix, $options, $binaryPackage);
    }

    /**
     * RunOpts constructor.
     *
     * NOTE: All run options are optional by design (pass NULL), some have defaults
     *       for that, some need to be initialized/set (marked [setter]) before
     *       dedicated use.
     *
     * @param null|string $prefix [optional] null for default, string for prefix
     * @param null|Options $options [optional]
     * @param string $binaryPackage [optional][setter] package name or path to binary (string)
     * @param null|string $user [optional] user option, non-null (string) if set
     * @param null|true $ssh [optional] ssh support for runner, null for none, true for support of ssh agent
     */
    public function __construct(
        $prefix = null,
        Options $options = null,
        $binaryPackage = null,
        $user = null,
        $ssh = null
    ) {
        $this->setPrefix($prefix);
        $this->options = $options;
        $this->binaryPackage = $binaryPackage;
        $this->user = $user;
        $this->ssh = $ssh;
    }

    /**
     * @param string $prefix
     *
     * @return void
     */
    public function setPrefix($prefix = null)
    {
        $this->prefix = Prefix::filter($prefix);
    }

    /**
     * The prefix is used when creating containers for the container name.
     *
     * See --prefix option.
     *
     * @return string
     */
    public function getPrefix()
    {
        return $this->prefix;
    }

    /**
     *
     * FIXME(tk): technically the underlying $this->options->get() can also
     *            return bool, this is somewhat not fully implemented and
     *            should perhaps be delegated {@see getBoolOption()}.
     *
     * @param string $name
     *
     * @return string
     */
    public function getOption($name)
    {
        $buffer = $this->getOptionImplementation($name);

        if (is_bool($buffer)) {
            // @codeCoverageIgnoreStart
            throw new \BadMethodCallException(
                sprintf("use bool for option: '%s'", $name)
            );
            // @codeCoverageIgnoreEnd
        }

        return $buffer;
    }

    /**
     * @param string $name
     *
     * @return bool
     */
    public function getBoolOption($name)
    {
        return (bool)$this->getOptionImplementation($name);
    }

    /**
     * @param string $binaryPackage
     *
     * @return void
     */
    public function setBinaryPackage($binaryPackage)
    {
        $this->binaryPackage = $binaryPackage;
    }

    /**
     * @return string
     */
    public function getBinaryPackage()
    {
        if (null === $this->binaryPackage) {
            // @codeCoverageIgnoreStart
            throw new \BadMethodCallException('binary-package not yet initialized');
            // @codeCoverageIgnoreEnd
        }

        return $this->binaryPackage;
    }

    /**
     * @return null|string
     */
    public function getSteps()
    {
        return $this->steps;
    }

    /**
     * @param null|string $steps
     *
     * @return void
     */
    public function setSteps($steps)
    {
        $this->steps = $steps;
    }

    /**
     * @return bool
     */
    public function isNoManual()
    {
        return $this->noManual;
    }

    /**
     * @param bool $noManual
     *
     * @return void
     */
    public function setNoManual($noManual)
    {
        $this->noManual = (bool)$noManual;
    }

    /**
     * @return null|string
     */
    public function getUser()
    {
        return $this->user;
    }

    /**
     * @param null|string $user
     *
     * @return void
     */
    public function setUser($user)
    {
        $this->user = $user;
    }

    /**
     * @return null|true
     */
    public function getSsh()
    {
        return $this->ssh ? true : null;
    }

    /**
     * @param null|true $ssh
     *
     * @return void
     */
    public function setSsh($ssh)
    {
        $this->ssh = $ssh ? true : null;
    }

    /**
     * @param string $name
     *
     * @return bool|string
     */
    private function getOptionImplementation($name)
    {
        if (!isset($this->options)) {
            throw new \BadMethodCallException('no options');
        }

        $buffer = $this->options->get($name);
        $buffer = $this->options->get($name);
        if (null === $buffer) {
            throw new \InvalidArgumentException(
                sprintf("unknown option: '%s'", $name)
            );
        }

        return $buffer;
    }
}


ktomk / pipelines

Push — master ( 503f62...3f0369 )

RunOpts::getOptionImplementation() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like