Flyfinder\Specification\CompositeSpecification

Complexity

Total Complexity

9

Size/Duplication

Total Lines	68
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Test Coverage

Coverage

100%

Importance

Changes

0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	andSpecification()	0	4	1
A	orSpecification()	0	4	1
A	notSpecification()	0	4	1
A	canBeSatisfiedBySomethingBelow()	0	4	1
A	willBeSatisfiedByEverythingBelow()	0	4	1
A	thatCanBeSatisfiedBySomethingBelow()	0	7	2
A	thatWillBeSatisfiedByEverythingBelow()	0	6	2

<?php

declare(strict_types=1);

/**
 * This file is part of phpDocumentor.
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @link      http://phpdoc.org
 */

namespace Flyfinder\Specification;

/**
 * Class CompositeSpecification
 * Base class for specifications, allows for combining specifications
 *
 * @psalm-immutable
 */
abstract class CompositeSpecification implements SpecificationInterface, PrunableInterface
{
    /**
     * Returns a specification that satisfies the original specification
     * as well as the other specification
     * @param SpecificationInterface $other
     * @return AndSpecification
     */
    public function andSpecification(SpecificationInterface $other) : AndSpecification
    {
        return new AndSpecification($this, $other);
    }

    /**
     * Returns a specification that satisfies the original specification
     * or the other specification
     * @param SpecificationInterface $other
     * @return OrSpecification
     */
    public function orSpecification(SpecificationInterface $other) : OrSpecification
    {
        return new OrSpecification($this, $other);
    }

    /**
     * Returns a specification that is the inverse of the original specification
     * i.e. does not meet the original criteria
     */
    public function notSpecification() : NotSpecification
    {
        return new NotSpecification($this);
    }

    /** {@inheritDoc} */
    public function canBeSatisfiedBySomethingBelow(array $value): bool
    {
        return true;
    }

    /** {@inheritDoc} */
    public function willBeSatisfiedByEverythingBelow(array $value): bool
    {
        return false;
    }

    /**
     * Provide default {@see canBeSatisfiedBySomethingBelow()} logic for specification classes
     * that don't implement PrunableInterface
     */
    public static function thatCanBeSatisfiedBySomethingBelow(SpecificationInterface $that, array $value): bool
    {
        return
            $that instanceof PrunableInterface
                ? $that->canBeSatisfiedBySomethingBelow($value)
                : true;
    }

    /**
     * Provide default {@see willBeSatisfiedByEverythingBelow()} logic for specification classes
     * that don't implement PrunableInterface
     */
    public static function thatWillBeSatisfiedByEverythingBelow(SpecificationInterface $that, array $value): bool
    {
        return
            $that instanceof PrunableInterface
            && $that->willBeSatisfiedByEverythingBelow($value);
    }
}