HasStates::transitionableStates() - Code Metrics - Inspection of "Get transitionable states from state on Model" - spatie/laravel-model-states - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#17)

unknown

created 2019-10-14 08:33 UTC

HasStates::transitionableStates() A

↳ Parent: HasStates

Complexity

Conditions	4
Paths	3

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
dl	0
loc	16
rs	9.7333
c	0
b	0
f	0
cc	4
nc	3
nop	2

<?php

namespace Spatie\ModelStates;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;
use Spatie\ModelStates\Exceptions\InvalidConfig;
use Spatie\ModelStates\Exceptions\CouldNotPerformTransition;

/**
 * @mixin \Illuminate\Database\Eloquent\Model
 */
trait HasStates
{
    /** @var \Spatie\ModelStates\StateConfig[]|null */
    protected static $stateFields = null;

    abstract protected function registerStates(): void;

    public static function bootHasStates(): void
    {
        $serialiseState = function (StateConfig $stateConfig) {
            return function (Model $model) use ($stateConfig) {
                $value = $model->getAttribute($stateConfig->field);

                if ($value === null) {
                    $value = $stateConfig->defaultStateClass;
                }

                if ($value === null) {
                    return;
                }

                $stateClass = $stateConfig->stateClass::resolveStateClass($value);

                if (! is_subclass_of($stateClass, $stateConfig->stateClass)) {
                    throw InvalidConfig::fieldDoesNotExtendState(
                        $stateConfig->field,
                        $stateConfig->stateClass,
                        $stateClass
                    );
                }

                $model->setAttribute(
                    $stateConfig->field,
                    State::resolveStateName($value)
                );
            };
        };

        $unserialiseState = function (StateConfig $stateConfig) {
            return function (Model $model) use ($stateConfig) {
                $stateClass = $stateConfig->stateClass::resolveStateClass($model->getAttribute($stateConfig->field));

                $defaultState = $stateConfig->defaultStateClass
                    ? new $stateConfig->defaultStateClass($model)
                    : null;

                $model->setAttribute(
                    $stateConfig->field,
                    class_exists($stateClass)
                        ? new $stateClass($model)
                        : $defaultState
                );
            };
        };

        foreach (self::getStateConfig() as $stateConfig) {
            static::retrieved($unserialiseState($stateConfig));
            static::created($unserialiseState($stateConfig));
            static::saved($unserialiseState($stateConfig));

            static::updating($serialiseState($stateConfig));
            static::creating($serialiseState($stateConfig));
            static::saving($serialiseState($stateConfig));
        }
    }

    public function initializeHasStates(): void
    {
        foreach (self::getStateConfig() as $stateConfig) {
            if (! $stateConfig->defaultStateClass) {
                continue;
            }

            $this->{$stateConfig->field} = new $stateConfig->defaultStateClass($this);
        }
    }

    public function scopeWhereState(Builder $builder, string $field, $states): Builder
    {
        self::getStateConfig();

        /** @var \Spatie\ModelStates\StateConfig|null $stateConfig */
        $stateConfig = self::getStateConfig()[$field] ?? null;

        if (! $stateConfig) {
            throw InvalidConfig::unknownState($field, $this);
        }

        $abstractStateClass = $stateConfig->stateClass;

        $stateNames = collect((array) $states)->map(function ($state) use ($abstractStateClass) {
            return $abstractStateClass::resolveStateName($state);
        });

        return $builder->whereIn($field, $stateNames);
    }

    public function scopeWhereNotState(Builder $builder, string $field, $states): Builder
    {
        /** @var \Spatie\ModelStates\StateConfig|null $stateConfig */
        $stateConfig = self::getStateConfig()[$field] ?? null;

        if (! $stateConfig) {
            throw InvalidConfig::unknownState($field, $this);
        }

        $stateNames = collect((array) $states)->map(function ($state) use ($stateConfig) {
            return $stateConfig->stateClass::resolveStateName($state);
        });

        return $builder->whereNotIn($field, $stateNames);
    }

    /**
     * @param \Spatie\ModelStates\State|string $state
     * @param string|null $field
     */
    public function transitionTo($state, string $field = null)
    {
        $stateConfig = self::getStateConfig();

        if ($field === null && count($stateConfig) > 1) {
            throw CouldNotPerformTransition::couldNotResolveTransitionField($this);
        }

        $field = $field ?? reset($stateConfig)->field;

        $this->{$field}->transitionTo($state);
    }

    public function transitionableStates(string $fromClass, ?string $field = null): array
    {
        $stateConfig = self::getStateConfig();

        if ($field === null && count($stateConfig) > 1) {
            throw InvalidConfig::fieldNotFound($fromClass, $this);
        }

        $field = $field ?? reset($stateConfig)->field;

        if (! array_key_exists($field, $stateConfig)) {
            throw InvalidConfig::unknownState($field, $this);
        }

        return $stateConfig[$field]->transitionableStates($fromClass);
    }

    /**
     * @param string $fromClass
     * @param string $toClass
     *
     * @return \Spatie\ModelStates\Transition|string|null
     */
    public function resolveTransitionClass(string $fromClass, string $toClass)
    {
        foreach (static::getStateConfig() as $stateConfig) {
            $transitionClass = $stateConfig->resolveTransition($this, $fromClass, $toClass);

            if ($transitionClass) {
''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
                return $transitionClass;
            }
        }

        throw CouldNotPerformTransition::notFound($fromClass, $toClass, $this);
    }

    protected function addState(string $field, string $stateClass): StateConfig
    {
        $stateConfig = new StateConfig($field, $stateClass);

        static::$stateFields[$stateConfig->field] = $stateConfig;

        return $stateConfig;
    }

    /**
     * @return \Spatie\ModelStates\StateConfig[]
     */
    private static function getStateConfig(): array
    {
        if (static::$stateFields === null) {
            static::$stateFields = [];

            (new static)->registerStates();
        }

        return static::$stateFields ?? [];
    }
}


1			<?php
2
3			namespace Spatie\ModelStates;
4
5			use Illuminate\Database\Eloquent\Model;
6			use Illuminate\Database\Eloquent\Builder;
7			use Spatie\ModelStates\Exceptions\InvalidConfig;
8			use Spatie\ModelStates\Exceptions\CouldNotPerformTransition;
9
10			/**
11			* @mixin \Illuminate\Database\Eloquent\Model
12			*/
13			trait HasStates
14			{
15			/** @var \Spatie\ModelStates\StateConfig[]\|null */
16			protected static $stateFields = null;
17
18			abstract protected function registerStates(): void;
19
20			public static function bootHasStates(): void
21			{
22			$serialiseState = function (StateConfig $stateConfig) {
23			return function (Model $model) use ($stateConfig) {
24			$value = $model->getAttribute($stateConfig->field);
25
26			if ($value === null) {
27			$value = $stateConfig->defaultStateClass;
28			}
29
30			if ($value === null) {
31			return;
32			}
33
34			$stateClass = $stateConfig->stateClass::resolveStateClass($value);
35
36			if (! is_subclass_of($stateClass, $stateConfig->stateClass)) {
37			throw InvalidConfig::fieldDoesNotExtendState(
38			$stateConfig->field,
39			$stateConfig->stateClass,
40			$stateClass
41			);
42			}
43
44			$model->setAttribute(
45			$stateConfig->field,
46			State::resolveStateName($value)
47			);
48			};
49			};
50
51			$unserialiseState = function (StateConfig $stateConfig) {
52			return function (Model $model) use ($stateConfig) {
53			$stateClass = $stateConfig->stateClass::resolveStateClass($model->getAttribute($stateConfig->field));
54
55			$defaultState = $stateConfig->defaultStateClass
56			? new $stateConfig->defaultStateClass($model)
57			: null;
58
59			$model->setAttribute(
60			$stateConfig->field,
61			class_exists($stateClass)
62			? new $stateClass($model)
63			: $defaultState
64			);
65			};
66			};
67
68			foreach (self::getStateConfig() as $stateConfig) {
69			static::retrieved($unserialiseState($stateConfig));
70			static::created($unserialiseState($stateConfig));
71			static::saved($unserialiseState($stateConfig));
72
73			static::updating($serialiseState($stateConfig));
74			static::creating($serialiseState($stateConfig));
75			static::saving($serialiseState($stateConfig));
76			}
77			}
78
79			public function initializeHasStates(): void
80			{
81			foreach (self::getStateConfig() as $stateConfig) {
82			if (! $stateConfig->defaultStateClass) {
83			continue;
84			}
85
86			$this->{$stateConfig->field} = new $stateConfig->defaultStateClass($this);
87			}
88			}
89
90			public function scopeWhereState(Builder $builder, string $field, $states): Builder
91			{
92			self::getStateConfig();
93
94			/** @var \Spatie\ModelStates\StateConfig\|null $stateConfig */
95			$stateConfig = self::getStateConfig()[$field] ?? null;
96
97			if (! $stateConfig) {
98			throw InvalidConfig::unknownState($field, $this);
99			}
100
101			$abstractStateClass = $stateConfig->stateClass;
102
103			$stateNames = collect((array) $states)->map(function ($state) use ($abstractStateClass) {
104			return $abstractStateClass::resolveStateName($state);
105			});
106
107			return $builder->whereIn($field, $stateNames);
108			}
109
110			public function scopeWhereNotState(Builder $builder, string $field, $states): Builder
111			{
112			/** @var \Spatie\ModelStates\StateConfig\|null $stateConfig */
113			$stateConfig = self::getStateConfig()[$field] ?? null;
114
115			if (! $stateConfig) {
116			throw InvalidConfig::unknownState($field, $this);
117			}
118
119			$stateNames = collect((array) $states)->map(function ($state) use ($stateConfig) {
120			return $stateConfig->stateClass::resolveStateName($state);
121			});
122
123			return $builder->whereNotIn($field, $stateNames);
124			}
125
126			/**
127			* @param \Spatie\ModelStates\State\|string $state
128			* @param string\|null $field
129			*/
130			public function transitionTo($state, string $field = null)
131			{
132			$stateConfig = self::getStateConfig();
133
134			if ($field === null && count($stateConfig) > 1) {
135			throw CouldNotPerformTransition::couldNotResolveTransitionField($this);
136			}
137
138			$field = $field ?? reset($stateConfig)->field;
139
140			$this->{$field}->transitionTo($state);
141			}
142
143			public function transitionableStates(string $fromClass, ?string $field = null): array
144			{
145			$stateConfig = self::getStateConfig();
146
147			if ($field === null && count($stateConfig) > 1) {
148			throw InvalidConfig::fieldNotFound($fromClass, $this);
149			}
150
151			$field = $field ?? reset($stateConfig)->field;
152
153			if (! array_key_exists($field, $stateConfig)) {
154			throw InvalidConfig::unknownState($field, $this);
155			}
156
157			return $stateConfig[$field]->transitionableStates($fromClass);
158			}
159
160			/**
161			* @param string $fromClass
162			* @param string $toClass
163			*
164			* @return \Spatie\ModelStates\Transition\|string\|null
165			*/
166			public function resolveTransitionClass(string $fromClass, string $toClass)
167			{
168			foreach (static::getStateConfig() as $stateConfig) {
169			$transitionClass = $stateConfig->resolveTransition($this, $fromClass, $toClass);
170
171			if ($transitionClass) {
			0 ignored issues – show Bug Best Practice introduced 2019-09-27 07:39 UTC by Report Bug Copy Issue Report The expression `$transitionClass` of type `null\|string` is loosely compared to `true`; this is ambiguous if the string can be empty. You might want to explicitly use `!== null` instead. In PHP, under loose comparison (like `==`, or `!=`, or `switch` conditions), values of different types might be equal. For `string` values, the empty string `''` is a special case, in particular the following results might be unexpected: '' == false // true '' == null // true 'ab' == false // false 'ab' == null // false // It is often better to use strict comparison '' === false // false '' === null // false Loading history...
172			return $transitionClass;
173			}
174			}
175
176			throw CouldNotPerformTransition::notFound($fromClass, $toClass, $this);
177			}
178
179			protected function addState(string $field, string $stateClass): StateConfig
180			{
181			$stateConfig = new StateConfig($field, $stateClass);
182
183			static::$stateFields[$stateConfig->field] = $stateConfig;
184
185			return $stateConfig;
186			}
187
188			/**
189			* @return \Spatie\ModelStates\StateConfig[]
190			*/
191			private static function getStateConfig(): array
192			{
193			if (static::$stateFields === null) {
194			static::$stateFields = [];
195
196			(new static)->registerStates();
197			}
198
199			return static::$stateFields ?? [];
200			}
201			}
202

spatie / laravel-model-states

Pull Request — master (#17)

HasStates::transitionableStates() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like