SourceSizeList::findImageCandidate() - Code Metrics - Inspection of "Fix source size matching" - jkphl/responsive-images-css - Measure and Improve Code Quality continuously with Scrutinizer

Completed
Push — master ( 5b2b8e...821ba7 )

by Joschi
created 2018-04-07 21:42 UTC
SourceSizeList::findImageCandidate() A

↳ Parent: SourceSizeList
Complexity

Conditions	3
Paths	3
Size

Total Lines	23
Code Lines	11
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	11
CRAP Score	3.0052
Importance

Changes
Metric	Value
cc	3
eloc	11
nc	3
nop	3
dl	0
loc	23
ccs	11
cts	12
cp	0.9167
crap	3.0052
rs	9.0856
c	0
b	0
f	0
<?php

/**
 * responsive-images-css
 *
 * @category   Jkphl
 * @package    Jkphl\Respimgcss
 * @subpackage Jkphl\Respimgcss\Infrastructure
 * @author     Joschi Kuphal <[email protected]> / @jkphl
 * @copyright  Copyright © 2018 Joschi Kuphal <[email protected]> / @jkphl
 * @license    http://opensource.org/licenses/MIT The MIT License (MIT)
 */

/***********************************************************************************
 *  The MIT License (MIT)
 *
 *  Copyright © 2018 Joschi Kuphal <[email protected]> / @jkphl
 *
 *  Permission is hereby granted, free of charge, to any person obtaining a copy of
 *  this software and associated documentation files (the "Software"), to deal in
 *  the Software without restriction, including without limitation the rights to
 *  use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
 *  the Software, and to permit persons to whom the Software is furnished to do so,
 *  subject to the following conditions:
 *
 *  The above copyright notice and this permission notice shall be included in all
 *  copies or substantial portions of the Software.
 *
 *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
 *  FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 *  COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 *  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 *  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ***********************************************************************************/

namespace Jkphl\Respimgcss\Infrastructure;

use Jkphl\Respimgcss\Application\Contract\LengthFactoryInterface;
use Jkphl\Respimgcss\Application\Contract\SourceSizeListInterface;
use Jkphl\Respimgcss\Application\Model\SourceSize;
use Jkphl\Respimgcss\Application\Model\SourceSizeMediaCondition;
use Jkphl\Respimgcss\Domain\Contract\AbsoluteLengthInterface;
use Jkphl\Respimgcss\Domain\Contract\ImageCandidateInterface;
use Jkphl\Respimgcss\Domain\Contract\ImageCandidateSetInterface;
use Jkphl\Respimgcss\Domain\Contract\SourceSizeImageCandidateMatch;
use Jkphl\Respimgcss\Domain\Model\Css\MediaCondition;
use Jkphl\Respimgcss\Domain\Model\ImageCandidateMatch;
use Jkphl\Respimgcss\Ports\InvalidArgumentException;

/**
 * Sizes list
 *
 * @package    Jkphl\Respimgcss
 * @subpackage Jkphl\Respimgcss\Infrastructure
 * @see        http://w3c.github.io/html/semantics-embedded-content.html#ref-for-viewport-based-selection%E2%91%A0
 * @see        http://w3c.github.io/html/semantics-embedded-content.html#valid-source-size-list
 * @see        http://w3c.github.io/html/semantics-embedded-content.html#parse-a-sizes-attribute
 */
class SourceSizeList extends \ArrayObject implements SourceSizeListInterface
{
    /**
     * Length factory
     *
     * @var LengthFactoryInterface
     */
    protected $lengthFactory;

    /**
     * Source size list constructor
     *
     * @param SourceSize[] $sourceSizes             Source sizes
     * @param LengthFactoryInterface $lengthFactory Length factory
     *
     * @throws InvalidArgumentException If the source size is invalid
     */
    public function __construct(array $sourceSizes, LengthFactoryInterface $lengthFactory)
    {
        // Run through all source sizes
        foreach ($sourceSizes as $sourceSize) {
            // If the source size is invalid
            if (!($sourceSize instanceof SourceSize)) {
                throw new InvalidArgumentException(
                    InvalidArgumentException::INVALID_SOURCE_SIZE_STR,
                    InvalidArgumentException::INVALID_SOURCE_SIZE
                );
            }
        }

        usort($sourceSizes, [$this, 'sortSourceSizes']);
        parent::__construct($sourceSizes);

        $this->lengthFactory = $lengthFactory;
    }

    /**
     * Find the optimum image candidate for a particular breakpoint
     *
     * @param ImageCandidateSetInterface $imageCandidates Image candidates
     * @param AbsoluteLengthInterface $breakpoint         Breakpoint
     * @param float $density                              Density
     *
     * @return SourceSizeImageCandidateMatch|null Image candidate match
     */
    public function findImageCandidate(
        ImageCandidateSetInterface $imageCandidates,
        AbsoluteLengthInterface $breakpoint,
        float $density
    ): ?SourceSizeImageCandidateMatch {

        // Run through the source sizes
        /** @var SourceSize $sourceSize */
        $lastMinimumWidth = null;
        foreach ($this->getArrayCopy() as $sourceSize) {
            $mediaCondition = $sourceSize->getMediaCondition();
            if ($mediaCondition->matches($breakpoint, $density)) {
                return $this->findImageCandidateForSourceSize(
                    $sourceSize,
                    $imageCandidates,
                    $breakpoint,
                    $this->getSourceSizeMaximumWidth($mediaCondition, $lastMinimumWidth)
                );
            }
            $lastMinimumWidth = $mediaCondition->getMinimumWidth();
        }

        return null;
    }

    /**
     * Find an image candidate for a particular source size
     *
     * @param SourceSize $sourceSize                      Matching source size
     * @param ImageCandidateSetInterface $imageCandidates Image candidates
     * @param AbsoluteLengthInterface $minWidth           Minimum viewport width
     * @param AbsoluteLengthInterface|null $maxWidth      Maximum viewport width
     *
     * @return SourceSizeImageCandidateMatch|null
     */
    protected function findImageCandidateForSourceSize(
        SourceSize $sourceSize,
        ImageCandidateSetInterface $imageCandidates,
        AbsoluteLengthInterface $minWidth,
        AbsoluteLengthInterface $maxWidth = null
    ): ?SourceSizeImageCandidateMatch {
        // If there's no upper limit: Use the largest image candidate anyway
        if ($maxWidth === null) {
            return $this->createLargestImageCandidateMatch($sourceSize, $imageCandidates);
        }
        // Calculate the effective minimum image width for the current source size and breakpoint
        $minImageWidth = max(
            $sourceSize->getValue()->getValue($minWidth),
            $sourceSize->getValue()->/** @scrutinizer ignore-call */ getValue($minWidth),
            $sourceSize->getValue()->getValue($maxWidth)
        );

        // Run through all image candidates
        /** @var ImageCandidateInterface $imageCandidate */
        foreach ($imageCandidates as $imageCandidate) {
            if ($imageCandidate->getValue() >= $minImageWidth) {
                return $this->createImageCandidateMatch($sourceSize, $imageCandidate);
            }
        }

        return null;
    }

    /**
     * Create and return a match for the largest image candidate
     *
     * @param SourceSize $sourceSize                      Source size
     * @param ImageCandidateSetInterface $imageCandidates Image candidates
     *
     * @return SourceSizeImageCandidateMatch|null Largest image candidate match
     */
    protected function createLargestImageCandidateMatch(
        SourceSize $sourceSize,
        ImageCandidateSetInterface $imageCandidates
    ): ?SourceSizeImageCandidateMatch {
        if (count($imageCandidates)) {
            $largestImageCandidate = $imageCandidates[count($imageCandidates) - 1];
            return $this->createImageCandidateMatch($sourceSize, $largestImageCandidate);
        }

        return null;
    }

    /**
     * Create a source size image candidate match
     *
     * @param SourceSize $sourceSize                  Matching source size
     * @param ImageCandidateInterface $imageCandidate Image candidata
     *
     * @return SourceSizeImageCandidateMatch Source size image candidate match
     */
    protected function createImageCandidateMatch(
        SourceSize $sourceSize,
        ImageCandidateInterface $imageCandidate
    ): SourceSizeImageCandidateMatch {
        $mediaCondition = new MediaCondition('', $sourceSize->getMediaCondition()->getValue());

        return new ImageCandidateMatch($mediaCondition, $imageCandidate);
    }

    /**
     * Get the maximum width for a source size
     *
     * @param SourceSizeMediaCondition $condition Source size media condition
     * @param float|null $lastMinimumWidth        Last source size minimum width
     *
     * @return AbsoluteLengthInterface Maximum width
     */
    protected function getSourceSizeMaximumWidth(
        SourceSizeMediaCondition $condition,
        float $lastMinimumWidth = null
    ): ?AbsoluteLengthInterface {
        $maximumWidth = $condition->getMaximumWidth();
        if (($maximumWidth === null) && ($lastMinimumWidth !== null)) {
            $maximumWidth = max(0, $lastMinimumWidth - 1);
        }
        if ($maximumWidth === null) {
            return null;
        }
        if ($lastMinimumWidth !== null) {
            $maximumWidth = max(0, min($maximumWidth, $lastMinimumWidth - 1));
        }
        return $this->lengthFactory->createAbsoluteLength($maximumWidth);
    }

    /**
     * Compare and sort two source sizes against each other
     *
     * @param SourceSize $sourceSize1 Source size 1
     * @param SourceSize $sourceSize2 Source size 2
     *
     * @return int Sort order
     */
    protected function sortSourceSizes(SourceSize $sourceSize1, SourceSize $sourceSize2): int
    {
        $hasConditions1 = $sourceSize1->hasConditions();
        $hasConditions2 = $sourceSize2->hasConditions();

        // If one of the sources sizes doesn't have conditions: Default source size (move to the end)
        if ($hasConditions1 !== $hasConditions2) {
            return $hasConditions1 ? -1 : 1;
        }

        return $hasConditions1 ? $this->sortSourceSizesByWidth($sourceSize1, $sourceSize2) : 0;
    }

    /**
     * Compare and sort two source sizes by width
     *
     * @param SourceSize $sourceSize1 Source size 1
     * @param SourceSize $sourceSize2 Source size 2
     *
     * @return int Sort order
     */
    protected function sortSourceSizesByWidth(SourceSize $sourceSize1, SourceSize $sourceSize2): int
    {
        // Sort by maximum width
        $maxWidth1 = $sourceSize1->getMediaCondition()->getMaximumWidth();
        $maxWidth2 = $sourceSize2->getMediaCondition()->getMaximumWidth();
        if ($maxWidth1 != $maxWidth2) {
            return ($maxWidth1 > $maxWidth2) ? -1 : 1;
        }

        // Sort by minimum width
        $minWidth1 = $sourceSize1->getMediaCondition()->getMinimumWidth();
        $minWidth2 = $sourceSize2->getMediaCondition()->getMinimumWidth();
        if ($minWidth1 != $minWidth2) {
            return ($minWidth1 > $minWidth2) ? -1 : 1;
        }

        // Sort by resolution
        return $this->sortSourceSizesByResolution($sourceSize1, $sourceSize2);
    }

    /**
     * Compare and sort two source sizes by resolution
     *
     * @param SourceSize $sourceSize1 Source size 1
     * @param SourceSize $sourceSize2 Source size 2
     *
     * @return int Sort order
     */
    protected function sortSourceSizesByResolution(SourceSize $sourceSize1, SourceSize $sourceSize2): int
    {
        // Sort by maximum resolution
        $maxResolution1 = $sourceSize1->getMediaCondition()->getMaximumResolution();
        $maxResolution2 = $sourceSize2->getMediaCondition()->getMaximumResolution();
        if ($maxResolution1 != $maxResolution2) {
            return ($maxResolution1 > $maxResolution2) ? -1 : 1;
        }

        // Sort by minimum resolution
        $minResolution1 = $sourceSize1->getMediaCondition()->getMinimumResolution();
        $minResolution2 = $sourceSize2->getMediaCondition()->getMinimumResolution();
        if ($minResolution1 != $minResolution2) {
            return ($minResolution1 > $minResolution2) ? -1 : 1;
        }

        return 0;
    }
}
jkphl / responsive-images-css

Push — master ( 5b2b8e...821ba7 )

SourceSizeList::findImageCandidate() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
