Gskema\TypeSniff\Inspection\Subject\AbstractTypeSubject

Complexity

Total Complexity

20

Size/Duplication

Total Lines	133
Duplicated Lines	0 %

Test Coverage

Coverage

78.26%

Importance

Changes

0

16 Methods

Rating	Name	Duplication	Size	Complexity
A	hasDefinedDocType()	0	3	2
A	getFnTypeWarnings()	0	3	1
A	writeWarningsTo()	0	10	3
A	__construct()	0	16	1
A	hasDefinedDocBlock()	0	3	1
A	getName()	0	3	1
A	getDocTypeWarnings()	0	3	1
A	getFnTypeLine()	0	3	1
A	hasDefinedFnType()	0	3	2
A	addDocTypeWarning()	0	3	1
A	addFnTypeWarning()	0	3	1
A	getDocType()	0	3	1
A	getValueType()	0	3	1
A	getDocTypeLine()	0	3	1
A	getFnType()	0	3	1
A	getDocBlock()	0	3	1

<?php

namespace Gskema\TypeSniff\Inspection\Subject;

use Gskema\TypeSniff\Core\DocBlock\DocBlock;
use Gskema\TypeSniff\Core\DocBlock\UndefinedDocBlock;
use Gskema\TypeSniff\Core\Type\Common\UndefinedType;
use Gskema\TypeSniff\Core\Type\TypeInterface;
use PHP_CodeSniffer\Files\File;

abstract class AbstractTypeSubject
{
    /** @var TypeInterface|null */
    protected $docType; // null = missing in PHPDoc

    /** @var TypeInterface */
    protected $fnType;

    /** @var TypeInterface|null */
    protected $valueType; // null = could not be detected

    /** @var int|null */
    protected $docTypeLine; // null = missing in PHPDoc

    /** @var int */
    protected $fnTypeLine;

    /** @var string */
    protected $name; // "parameter $param1", "property $prop1", "constant CONST1"

    /** @var DocBlock */
    protected $docBlock;

    /** @var string[] */
    protected $docTypeWarnings = [];

    /** @var string[] */
    protected $fnTypeWarnings = [];

    public function __construct(
        ?TypeInterface $docType,
        TypeInterface $fnType,
        ?TypeInterface $valueType,
        ?int $docTypeLine,
        int $fnTypeLine,
        string $name,
        DocBlock $docBlock
    ) {
        $this->docType = $docType;
        $this->fnType = $fnType;
        $this->valueType = $valueType;
        $this->docTypeLine = $docTypeLine;
        $this->fnTypeLine = $fnTypeLine;
        $this->name = $name;
        $this->docBlock = $docBlock;
    }

    public function getDocType(): ?TypeInterface
    {
        return $this->docType;
    }

    public function getFnType(): TypeInterface
    {
        return $this->fnType;
    }

    public function getValueType(): ?TypeInterface
    {
        return $this->valueType;
    }

    public function getDocTypeLine(): ?int
    {
        return $this->docTypeLine;
    }

    public function getFnTypeLine(): int
    {
        return $this->fnTypeLine;
    }

    public function getName(): string
    {
        return $this->name;
    }

    public function getDocBlock(): DocBlock
    {
        return $this->docBlock;
    }

    /**
     * @return string[]
     */
    public function getDocTypeWarnings(): array
    {
        return $this->docTypeWarnings;
    }

    /**
     * @return string[]
     */
    public function getFnTypeWarnings(): array
    {
        return $this->fnTypeWarnings;
    }

    public function hasDefinedDocType(): bool
    {
        return $this->docType && !($this->docType instanceof UndefinedType);
    }

    public function hasDefinedFnType(): bool
    {
        return $this->fnType && !($this->fnType instanceof UndefinedType);
    }

    public function hasDefinedDocBlock(): bool
    {
        return !($this->docBlock instanceof UndefinedDocBlock);
    }

    public function addDocTypeWarning(string $warning): void
    {
        $this->docTypeWarnings[] = $warning;
    }

    public function addFnTypeWarning(string $warning): void
    {
        $this->fnTypeWarnings[] = $warning;
    }

    public function writeWarningsTo(File $file, string $sniffCode): void
    {
        foreach ($this->docTypeWarnings as $docTypeWarning) {
            $warning = str_replace(':subject:', $this->name, $docTypeWarning);
            $file->addWarningOnLine($warning, $this->docTypeLine ?? $this->fnTypeLine, $sniffCode);
        }

        foreach ($this->fnTypeWarnings as $fnTypeWarning) {
            $warning = str_replace(':subject:', $this->name, $fnTypeWarning);
            $file->addWarningOnLine($warning, $this->fnTypeLine, $sniffCode);
        }
    }
}