Traits_Optionable::getStringOption() - Code Metrics - Inspection of "Enforcing an int value." - Mistralys/application-utils - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( bd22ef...ebe470 )

by Sebastian
created 2019-12-21 18:14 UTC
Traits_Optionable::getStringOption() A

↳ Parent: Traits_Optionable
Complexity

Conditions	4
Paths	2
Size

Total Lines	9
Code Lines	4
Duplication

Lines	0
Ratio	0 %
Importance

Changes	1
Bugs	0	Features	0
Metric	Value
cc	4
eloc	4
c	1
b	0
f	0
nc	2
nop	2
dl	0
loc	9
rs	10
<?php
/**
 * File containing the {@see AppUtils\Traits_Optionable} trait,
 * and the matching interface.
 * 
 * @package Application Utils
 * @subpackage Traits
 * @see Traits_Optionable
 * @see Interface_Optionable
 */

namespace AppUtils;

/**
 * Trait for adding options to a class: allows setting
 * and getting options of all types.
 * 
 * NOTE: To add this to a class, it must use the trait, 
 * but also implement the interface.
 * 
 * @package Application Utils
 * @subpackage Traits
 * @author Sebastian Mordziol <[email protected]>
 * 
 * @see Interface_Optionable
 */
trait Traits_Optionable
{
   /**
    * @var array
    */
    protected $options;
    
   /**
    * Sets an option to the specified value. This can be any
    * kind of variable type, including objects, as needed.
    * 
    * @param string $name
    * @param mixed $default
    * @return mixed
    */
    public function setOption(string $name, $value) : Interface_Optionable
    {
        if(!isset($this->options)) {
            $this->options = $this->getDefaultOptions();
            $this->options = $this->getDefaultOptions();
        }
        
        $this->options[$name] = $value;
        return $this;

    }
    
   /**
    * Sets a collection of options at once, from an
    * associative array.
    * 
    * @param array $options
    * @return Interface_Optionable
    */
    public function setOptions(array $options) : Interface_Optionable
    {
        foreach($options as $name => $value) {
            $this->setOption($name, $value);
        }
        
        return $this;

    }
    
   /**
    * Retrieves an option's value.
    * 
    * NOTE: Use the specialized type getters to ensure an option
    * contains the expected type (for ex. getArrayOption()). 
    * 
    * @param string $name
    * @param mixed $default The default value to return if the option does not exist.
    * @return mixed
    */
    public function getOption(string $name, $default=null)
    {
        if(!isset($this->options)) {
            $this->options = $this->getDefaultOptions();
        }
        
        if(isset($this->options[$name])) {
            return $this->options[$name];
        }
        
        return $default;
    }
    
   /**
    * Enforces that the option value is a string. Numbers are converted
    * to string, strings are passed through, and all other types will 
    * return the default value. The default value is also returned if
    * the string is empty.
    * 
    * @param string $name
    * @param string $default Used if the option does not exist, is invalid, or empty.
    * @return string
    */
    public function getStringOption(string $name, string $default='') : string
    {
        $value = $this->getOption($name, false);
        
        if((is_string($value) || is_numeric($value)) && !empty($value)) {
            return (string)$value;
        }
        
        return $default;
    }
    
   /**
    * Treats the option value as a boolean value: will return
    * true if the value actually is a boolean true.
    * 
    * NOTE: boolean string representations are not accepted.
    * 
    * @param string $name
    * @return bool
    */
    public function getBoolOption(string $name, bool $default=false) : bool
    {
        if($this->getOption($name) === true) {
            return true;
        }
        
        return $default;
    }
    
   /**
    * Treats the option value as an integer value: will return
    * valid integer values (also from integer strings), or the
    * default value otherwise.
    * 
    * @param string $name
    * @param int $default
    * @return int
    */
    public function getIntOption(string $name, int $default=0) : int
    {
        $value = $this->getOption($name);
        if(ConvertHelper::isInteger($value)) {
            return (int)$value;
        }
        
        return $default;
    }
    
   /**
    * Treats an option as an array, and returns its value
    * only if it contains an array - otherwise, an empty
    * array is returned.
    * 
    * @param string $name
    * @return array
    */
    public function getArrayOption(string $name) : array
    {
        $val = $this->getOption($name);
        if(is_array($val)) {
            return $val;
        }
        
        return array();
    }
    
   /**
    * Checks whether the specified option exists - even
    * if it has a NULL value.
    * 
    * @param string $name
    * @return bool
    */
    public function hasOption(string $name) : bool
    {
        if(!isset($this->options)) {
            $this->options = $this->getDefaultOptions();
        }
        
        return array_key_exists($name, $this->options);
    }
    
   /**
    * Returns all options in one associative array.
    * @return array
    */
    public function getOptions() : array
    {
        if(!isset($this->options)) {
            $this->options = $this->getDefaultOptions();
        }
        
        return $this->options;
    }
    
   /**
    * Checks whether the option's value is the one specified.
    * 
    * @param string $name
    * @param mixed $value
    * @return bool
    */
    public function isOption(string $name, $value) : bool
    {
        return $this->getOption($name) === $value;
    }
}

/**
 * Interface for classes that use the optionable trait.
 * The trait itself fulfills most of the interface, but
 * it is used to guarantee internal type checks will work,
 * as well as ensure the abstract methods are implemented.
 *
 * @package Application Utils
 * @subpackage Traits
 * @author Sebastian Mordziol <[email protected]>
 *
 * @see Traits_Optionable
 */
interface Interface_Optionable
{
    function setOption(string $name, $value) : Interface_Optionable;
    function getOption(string $name, $default=null);
    function setOptions(array $options) : Interface_Optionable;
    function getOptions() : array;
    function isOption(string $name, $value) : bool;
    function hasOption(string $name) : bool;
    function getDefaultOptions() : array;
}

Mistralys / application-utils

Push — master ( bd22ef...ebe470 )

Traits_Optionable::getStringOption() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
