Cerbero\Dto\Traits\HasFlags

Complexity

Total Complexity

7

Size/Duplication

Total Lines	89
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	2
Bugs	0	Features	1

6 Methods

Rating	Name	Duplication	Size	Complexity
A	getDefaultFlags()	0	3	1
A	getFlags()	0	3	1
A	hasFlags()	0	3	1
A	addFlags()	0	5	1
A	removeFlags()	0	6	1
A	setFlags()	0	9	2

<?php

namespace Cerbero\Dto\Traits;

use Cerbero\Dto\Dto;

use const Cerbero\Dto\MUTABLE;

The constant Cerbero\Dto\MUTABLE was not found. Maybe you did not declare it correctly or list all dependencies?

use const Cerbero\Dto\NONE;

The constant Cerbero\Dto\NONE was not found. Maybe you did not declare it correctly or list all dependencies?

/**
 * Trait to interact with flags.
 *
 */
trait HasFlags
{
    /**
     * The default flags.
     *
     * @var int
     */
    protected static $defaultFlags = NONE;

    /**
     * The actual flags.
     *
     * @var int
     */
    protected $flags;

    /**
     * Retrieve the default flags
     *
     * @return int
     */
    public static function getDefaultFlags(): int
    {
        return static::$defaultFlags;
    }

    /**
     * Retrieve the DTO flags
     *
     * @return int
     */
    public function getFlags(): int
    {
        return $this->flags;
    }

    /**
     * Determine whether the DTO flags include the given flags
     *
     * @param int $flags
     * @return bool
     */
    public function hasFlags(int $flags): bool
    {
        return ($this->getFlags() & $flags) === $flags;
    }

    /**
     * Set the DTO flags
     *
     * @param int $flags
     * @return Dto
     */
    public function setFlags(int $flags): Dto
    {
        if (!($this->getFlags() & MUTABLE)) {
            return static::make($this->toArray(), $flags);

It seems like toArray() must be provided by classes using this trait. How about adding it as abstract method to this trait?

        }

        $this->flags = $flags;

        return $this;
    }

    /**
     * Add the given flags to the DTO flags
     *
     * @param int $flags
     * @return Dto
     */
    public function addFlags(int $flags): Dto
    {
        $mergedFlags = $this->getFlags() | $flags;

        return $this->setFlags($mergedFlags);
    }

    /**
     * Remove the given flags from the DTO flags
     *
     * @param int $flags
     * @return Dto
     */
    public function removeFlags(int $flags): Dto
    {
        $currentFlags = $this->getFlags();
        $remainingFlags = $currentFlags ^ ($currentFlags & $flags);

        return $this->setFlags($remainingFlags);
    }
}