NelsonMartell\Extensions\MethodExtension

Complexity

Total Complexity

4

Size/Duplication

Total Lines	49
Duplicated Lines	0 %

Test Coverage

Coverage

78.56%

Importance

Changes	1
Bugs	0	Features	0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	ensureIsValidName()	0	7	2
A	ensureIsDefined()	0	14	2

<?php

/**
 * PHP: Nelson Martell Library file
 *
 * Copyright © 2021 Nelson Martell (http://nelson6e65.github.io)
 *
 * Licensed under The MIT License (MIT)
 * For full copyright and license information, please see the LICENSE
 * Redistributions of files must retain the above copyright notice.
 *
 * @copyright 2021 Nelson Martell
 * @link      http://nelson6e65.github.io/php_nml/
 * @since     1.0.0
 * @license   http://www.opensource.org/licenses/mit-license.php The MIT License (MIT)
 * */

declare(strict_types=1);

namespace NelsonMartell\Extensions;

use InvalidArgumentException;
use NelsonMartell\IComparer;
use NelsonMartell\StrictObject;

use function NelsonMartell\msg;
use function NelsonMartell\typeof;

/**
 * Provides extension methods to handle `class`, `trait` and `interface` methods.
 *
 * @since 1.0.0
 * @author Nelson Martell <nelson6e65@gmail.com>
 * */
class MethodExtension
{
    /**
     * Ensures that a string is a valid property name.
     *
     * @param string $name Method name to be ensured.
     *
     * @return string
     * @throws InvalidArgumentException if name do not follows the PHP variables naming convention.
     *
     * @see Text::ensureIsValidVarName()
     */
    public static function ensureIsValidName(string $name): string
    {
        try {
            return Text::ensureIsValidVarName($name);
        } catch (InvalidArgumentException $e) {
            $msg = msg('"{0}" is not a valid method name.', $name);
            throw new InvalidArgumentException($msg, 20, $e);
        }
    }

    /**
     * Ensures the method is defined in the specified class.
     *
     * @param string $method
     * @param string $class
     *
     * @return string
     *
     * @throws InvalidArgumentException if `$method` is not valid, `$class` do not exists or `$class` has not the
     *   property.
     *
     * @see PropertyExtension::ensureIsValidName()
     */
    public static function ensureIsDefined(string $method, string $class): string
    {
        $type = typeof($class, true);

        if (!$type->hasMethod(static::ensureIsValidName($method))) {
            $msg = msg(
                '"{method}" method do not exists in "{class}" class or parent classes.',
                compact('method', 'class')
            );

            throw new InvalidArgumentException($msg, 21);
        }

        return $method;
    }
}