Kristuff\AbuseIPDB\ShellUtils

Complexity

Total Complexity

31

Size/Duplication

Total Lines	318
Duplicated Lines	0 %

Importance

Changes	2
Bugs	0	Features	0

13 Methods

Rating	Name	Duplication	Size	Complexity
A	clearTempMessage()	0	4	1
A	printTempMessage()	0	3	1
A	printTitle()	0	5	1
A	printResult()	0	11	3
A	printVersion()	0	19	1
A	printLogo()	0	10	1
A	printBanner()	0	7	1
A	getNumericParameter()	0	13	3
B	printErrors()	0	38	10
A	getScoreBadge()	0	16	3
A	printFooter()	0	18	2
A	error()	0	11	1
A	validate()	0	9	3

<?php

/**
 *     _    _                    ___ ____  ____  ____
 *    / \  | |__  _   _ ___  ___|_ _|  _ \|  _ \| __ )
 *   / _ \ | '_ \| | | / __|/ _ \| || |_) | | | |  _ \
 *  / ___ \| |_) | |_| \__ \  __/| ||  __/| |_| | |_) |
 * /_/   \_\_.__/ \__,_|___/\___|___|_|   |____/|____/
 *
 * This file is part of Kristuff\AbsuseIPDB.
 *
 * (c) Kristuff <contact@kristuff.fr>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @version    0.9.9
 * @copyright  2020-2021 Kristuff
 */
namespace Kristuff\AbuseIPDB;

use Kristuff\Mishell\Console;
use Kristuff\AbuseIPDB\ApiHandler;

/**
 * Class ShellUtils
 * 
 * Absract base class for main cli program
 */
abstract class ShellUtils
{
    /**
     * helper functions
     */
    use UtilsTrait;
    
    /**
     * Prints title action banner 
     * 
     * @access protected
     * @static
     * @param array $arguments
     * 
     * @return void
     */
    protected static function printTitle(string $title)
    {
        Console::log();
        Console::log($title);
        Console::log();
    }
  
    /**
     * Print temp message during api request 
     * 
     * @access protected
     * @static
     * @param array $arguments
     * 
     * @return void
     */
    protected static function printTempMessage()
    {
        Console::reLog(Console::text('   ? ', 'green') . Console::text('waiting for api response', 'white') . Console::text(' ... ', 'green'));
    }

    /**
     * Clear the temp message set during api request 
     * 
     * @access protected
     * @static
     * @param array $arguments
     * 
     * @return void
     */
    protected static function clearTempMessage()
    {
        // long blank string to overwrite previous message
        Console::reLog('                                                     ');
    }

    /**
     * Print to banner 
     * 
     * @access protected
     * @static
     * @param array $arguments
     * 
     * @return void
     */
    protected static function printLogo()
    {
        //Console::log("   _       _    _         __  __                   ", "darkgray");
        //Console::log("  | |___ _(_)__| |_ _  _ / _|/ _|                  ", "darkgray");
        //Console::log("  | / / '_| (_-<  _| || |  _|  _|                  ", "darkgray");
        //Console::log("  |_\_\_| |_/__/\__|\_,_|_| |_|                    ", "darkgray");
        Console::log("        _                 ___ ___ ___  ___        ", "darkgray");
        Console::log("   __ _| |__ _  _ ___ ___|_ _| _ \   \| _ )       ", "darkgray");
        Console::log("  / _` | '_ \ || (_-</ -_)| ||  _/ |) | _ \       ", "darkgray");
        Console::log("  \__,_|_.__/\_,_/__/\___|___|_| |___/|___/       ", "darkgray");
    }

    /**
     * Print version 
     * 
     * @access protected
     * @static
     * @param array $arguments
     * 
     * @return void
     */
    protected static function printVersion()
    {
        self::printLogo();
        Console::log();
        Console::log(Console::text('  Kristuff/AbuseIPDB Client version: ', 'darkgray') . Console::text(AbuseIPDBClient::VERSION, 'lightgray'));
        Console::log(Console::text('  Kristuff/AbuseIPDB Core version:   ', 'darkgray') . Console::text(ApiHandler::VERSION, 'lightgray')); 
        Console::log(Console::text('  --------------------------------------------------', 'darkgray'));    
        //Console::log(Console::text('  __________________________________________________', 'darkgray'));    
        //Console::log();
        //Console::log(Console::text('  --------------------------------------------------', 'darkgray'));    
        Console::log(Console::text('  Released under the MIT licence', 'darkgray'));
        Console::log(Console::text('  Made with ', 'darkgray') . Console::text('♥', 'red') . Console::text(' in France', 'darkgray'));
        Console::log(
            Console::text('  © 2020-2021 Kristuff (', 'darkgray').
            Console::text('https://github.com/kristuff', 'darkgray', 'underlined').
            Console::text(')', 'darkgray')
        );
        Console::log(Console::text('  --------------------------------------------------', 'darkgray'));    
        Console::log();
    }

    /**
     * Print app banner
     * 
     * @access protected
     * @static
     * 
     * @return void
     */
    protected static function printBanner()
    {
        Console::log();    
        Console::log( Console::text(' Kristuff\AbuseIPDB ', 'darkgray') . Console::text(' ' . AbuseIPDBClient::VERSION . ' ', 'white', 'blue')); 
        Console::log(Console::text(' Made with ', 'darkgray') . Console::text('♥', 'red') . Console::text(' in France', 'darkgray')); 
        Console::log(' © 2020-2021 Kristuff', 'darkgray'); 
        Console::log();    
    }

    /**
     * Print footer
     * 
     * @access protected
     * @static
     * 
     * @return void
     */
    protected static function printFooter(string $requestTime = '')
    {
        if (!empty($requestTime)){
            $date_utc = new \DateTime("now", new \DateTimeZone("UTC"));
            Console::log(
                Console::text('  Request time: ', 'darkgray') . Console::text($requestTime . 's', 'lightgray'). 
                Console::text(' | UTC time: ', 'darkgray') . Console::text($date_utc->format('Y-m-d H:i:s'), 'lightgray')
            );
        }
        Console::log(Console::text('  ------------------------------------------------------------------------------------------------------', 'darkgray')); 
        Console::log(
            Console::text('  Kristuff\AbuseIPDB ', 'darkgray') . 
            Console::text(AbuseIPDBClient::VERSION, 'lightgray') . 
            Console::text(' | Made with ', 'darkgray') . 
            Console::text('♥', 'red') .
            Console::text(' in France | © 2020-2021 Kristuff (https://github.com/kristuff)', 'darkgray')
        ); 
        Console::log();    
    }

    /**
     * Prints/gets a result value 
     * 
     * @access protected
     * @static
     * 
     * @return string
     */
    protected static function printResult($text, $value, string $foregroundColor = 'lightred', string $backgroundColor = '', bool $print = true)
    {
        // do not print null/blank values
        if (isset($value)){
            $line = Console::text($text, 'white') . Console::text($value, $foregroundColor, $backgroundColor); 
            if ($print){
                Console::log($line);
            }
            return $line;
        }
        return '';
    }
 
    /**
     * Prints score badge 
     * 
     * @access protected
     * @static
     * @param string    $text       
     * @param int       $score     
     * @param string    $textColor
     * 
     * @return string
     */
    protected static function getScoreBadge(int $score, string $padding = ' ')
    {
        $scoreforegroundColor = 'white';
        $scoreBackgroundColor = 'green';

        if (intval($score) > 0 ){
            $scoreforegroundColor = 'black';
            $scoreBackgroundColor = 'yellow';
        } 
        if (intval($score) > 50 ){
            $scoreforegroundColor = 'white';
            $scoreBackgroundColor = 'red';
        } 
  
        $badge = str_pad($score, 3, ' ',STR_PAD_LEFT); 
        return Console::text($padding.$badge.$padding, $scoreforegroundColor, $scoreBackgroundColor);
    }

    /**
     * Check and print errors in API response
     * 
     * @access protected
     * @static
     * @param object     $response       
     * @param bool       $checkForEmpty     
     * 
     * @return bool     
     */
    protected static function printErrors($response, bool $checkForEmpty = true)
    {
        if (isset($response) && isset($response->errors)){

            // top error badge    
            Console::log('  ' .   Console::text(' ERROR ','white', 'red'));

            $num = 0;
            // errors is an array, could have more than one error..
            foreach ($response->errors as $err){
                $num++;

                Console::log(Console::text('   ✗', 'red') .  self::printResult(' Number:    ', $num, 'lightyellow','', false));
                self::printResult('     Status:    ', $err->status ?? null, 'lightyellow','');    
                
                if (!empty($err->source) && !empty($err->source->parameter)){
                    self::printResult('     Parameter: ', $err->source->parameter, 'lightyellow');    
                }
                self::printResult('     Title:     ', $err->title ?? null, 'lightyellow');    
                self::printResult('     Detail:    ', $err->detail ?? null, 'lightyellow');    

                // separate errors
                if (count($response->errors) > 1){
                    Console::log('   ---');
                }

            }
            Console::log();
            return true;
        }

        // check for empty response ?
        if ( $checkForEmpty && ( empty($response) || empty($response->data)) ){
            self::error('An unexpected error occurred.');
            return true;
        }

        return false;    
    }

    /**
     * Print a single error
     * 
     * @access protected
     * @static
     * @param string    $error      The error message
     * 
     * @return void
     */
    protected static function error($error)
    {
        // ✗
        Console::log('  ' .   Console::text(' ERROR ','white', 'red'));
        Console::log(
            Console::text('   ✗', 'red') . 
            Console::text(' Detail:    ', 'white') . 
            Console::text($error, 'lightyellow') . 
            Console::text('', 'white')
        );    
        Console::log();    
    }
    
    /**
     * helper to validate a condition or exit with an error
     * 
     * @access protected
     * @static
     * @param bool      $condition      The condition to evaluate
     * @param string    $message        Error message
     * @param bool      $print          True to print error. Default is true
     * 
     * @return bool
     */
    protected static function validate(bool $condition, string $message, bool $print = true)
    {
        if ( !$condition ){
            if ($print) {
                Console::log();
                self::error($message);
                self::printFooter();
            }
            exit(1);

Using exit here is not recommended.

        }
    }

        /**
     * Get numeric parameter and exit on error
     * 
     * @access protected
     * @static
     * @param array     $arguments
     * @param string    $shortArg           The short argument name
     * @param string    $longArg            The long argument name
     * @param int       $defaultValue
     * 
     * @return int
     */
    protected static function getNumericParameter(array $arguments, string $shortArg, string $longArg, int $defaultValue)
    {
         if (self::inArguments($arguments,$shortArg, $longArg)){
            $val = self::getArgumentValue($arguments,$shortArg, $longArg);

            if (!is_numeric($val)){
                self::error("Invalid parameter: $longArg must be a numeric value.");
                self::printFooter();
                exit(1);

Using exit here is not recommended.

            }
            return intval($val);
        }
        return $defaultValue;
    }

}