Ktomk\Pipelines\File\ImageName

Complexity

Total Complexity

5

Size/Duplication

Total Lines	56
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	validate()	0	12	1
A	parse()	0	10	2
A	__toString()	0	3	1
A	__construct()	0	3	1

<?php

/* this file is part of pipelines */

namespace Ktomk\Pipelines\File;

/**
 * image name parser and value object
 */
class ImageName
{
    /**
     * @var string
     */
    private $name;

    /**
     * Is a Docker image name (optionally with a tag) syntactically
     * valid?
     *
     * @see doc/DOCKER-NAME-TAG.md
     *
     * @param string $name of docker image
     * @return bool
     */
    public static function validate($name)
    {
        $pattern =
            '{^' .
            '([a-zA-Z0-9.-]+(:[0-9]+)?/)?' . # <prefix>
            '([a-z0-9]+(?:(?:\.|__?|-+)[a-z0-9]+)*)(/[a-z0-9]+(?:(?:\.|__?|-+)[a-z0-9]+)*)*' . # <name-components>
            '(:[a-zA-Z0-9_][a-zA-Z0-9_.-]{0,127})?' . # <tag-name>
            '$}';

        $result = preg_match($pattern, $name);

        return 1 === $result;
    }

    /**
     * @param string $name
     */
    public function __construct($name)
    {
        $this->parse($name);
    }

    /**
     * @param string $name
     */
    private function parse($name)
    {
        if (!self::validate($name)) {
            ParseException::__(sprintf(
                "'image' invalid Docker image name: '%s'",
                $name
            ));
        }

        $this->name = (string)$name;
    }

    public function __toString()
    {
        return $this->name;
    }
}