ThisVessel\Carbonated

Complexity

Total Complexity

89

Size/Duplication

Total Lines	513
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Importance

Changes

0

31 Methods

Rating	Name	Duplication	Size	Complexity
A	carbonatedTimestamps()	0	7	2
A	carbonatedDates()	0	4	2
A	carbonatedTimes()	0	4	2
A	carbonatedAttributes()	0	4	1
A	carbonatedAttributeType()	0	12	4
A	carbonatedTimestampFormat()	0	4	2
A	carbonatedDateFormat()	0	4	2
A	carbonatedTimeFormat()	0	4	2
B	carbonatedTimezone()	0	13	5
A	jsonTimestampFormat()	0	4	2
A	jsonDateFormat()	0	4	2
A	jsonTimeFormat()	0	4	2
A	jsonTimezone()	0	10	2
A	databaseTimestampFormat()	0	4	2
A	databaseDateFormat()	0	4	2
A	databaseTimeFormat()	0	4	2
A	databaseTimezone()	0	10	3
D	carbonInstances()	0	35	10
A	getWithCarbonAttribute()	0	11	1
B	carbonatedAccessor()	0	23	5
B	carbonatedMutator()	0	34	6
A	requestIsJson()	0	4	1
A	getDates()	0	4	1
A	freshTimestamp()	0	6	1
B	toArray()	0	15	5
A	jsonSerialize()	0	4	1
C	getAttributeValue()	0	25	7
B	setAttribute()	0	21	6
A	setCarbonInstances()	0	7	2
A	ensureProperty()	0	13	3
A	useLocalizedFormats()	0	6	1

<?php

namespace ThisVessel;

use Carbon\Carbon;
use Request;

trait Carbonated
{
    /**
     * Store carbon instances for reuse.
     *
     * @var object
     */
    protected $carbonInstances;

    /**
     * Indicate whether accessors should be overridden to return carbon instances.
     *
     * @var bool
     */
    protected $returnCarbon = false;

    /**
     * Get the attributes that should be handled as carbonated timestamps.
     *
     * @return array
     */
    public function carbonatedTimestamps()
    {
        // Add default fields for schema builder's timestamps() and softDeletes().
        $defaults = [static::CREATED_AT, static::UPDATED_AT, 'deleted_at'];

        return $this->ensureProperty($this, 'carbonatedTimestamps') ? array_unique(array_merge($this->carbonatedTimestamps, $defaults)) : $defaults;

The property carbonatedTimestamps does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the attributes that should be handled as carbonated dates.
     *
     * @return array
     */
    public function carbonatedDates()
    {
        return $this->ensureProperty($this, 'carbonatedDates') ? (array) $this->carbonatedDates : [];
    }

    /**
     * Get the attributes that should be handled as carbonated times.
     *
     * @return array
     */
    public function carbonatedTimes()
    {
        return $this->ensureProperty($this, 'carbonatedTimes') ? (array) $this->carbonatedTimes : [];
    }

    /**
     * Get all attributes that should be handled by carbonated.
     *
     * @return array
     */
    public function carbonatedAttributes()
    {
        return array_merge($this->carbonatedTimestamps(), $this->carbonatedDates(), $this->carbonatedTimes());
    }

    /**
     * Get carbonated attribute type.
     *
     * @param string $key
     *
     * @return string
     */
    public function carbonatedAttributeType($key)
    {
        if (in_array($key, $this->carbonatedTimestamps())) {
            return 'timestamp';
        } elseif (in_array($key, $this->carbonatedDates())) {
            return 'date';
        } elseif (in_array($key, $this->carbonatedTimes())) {
            return 'time';
        }

        return false;
    }

    /**
     * Get the intended timestamp format for view output.
     *
     * @return string
     */
    public function carbonatedTimestampFormat()
    {
        return $this->ensureProperty($this, 'carbonatedTimestampFormat') ? (string) $this->carbonatedTimestampFormat : 'M d, Y g:ia';

The property carbonatedTimestampFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended date format for view output.
     *
     * @return string
     */
    public function carbonatedDateFormat()
    {
        return $this->ensureProperty($this, 'carbonatedDateFormat') ? (string) $this->carbonatedDateFormat : 'M d, Y';

The property carbonatedDateFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended date format for view output.
     *
     * @return string
     */
    public function carbonatedTimeFormat()
    {
        return $this->ensureProperty($this, 'carbonatedTimeFormat') ? (string) $this->carbonatedTimeFormat : 'g:ia';

The property carbonatedTimeFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended timezone for view output.
     *
     * @return string
     */
    public function carbonatedTimezone()
    {
        // Check for $carbonatedTimezone property in model.
        if ($this->ensureProperty($this, 'carbonatedTimezone')) {
            return (string) $this->carbonatedTimezone;

The property carbonatedTimezone does not exist. Did you maybe forget to declare it?

        } // If not, check for an authenticated user with a $timezone property.
        elseif (class_exists(\Auth::class) && \Auth::check() && \Auth::user()->timezone) {
            return (string) \Auth::user()->timezone;
        }

        // Otherwise use same timezone as database.
        return $this->databaseTimezone();
    }

    /**
     * Get the intended timestamp for json output.
     *
     * @return string
     */
    public function jsonTimestampFormat()
    {
        return $this->ensureProperty($this, 'jsonTimestampFormat') ? (string) $this->jsonTimestampFormat : $this->databaseTimestampFormat();

The property jsonTimestampFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended date for json output.
     *
     * @return string
     */
    public function jsonDateFormat()
    {
        return $this->ensureProperty($this, 'jsonDateFormat') ? (string) $this->jsonDateFormat : $this->databaseDateFormat();

The property jsonDateFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended time for json output.
     *
     * @return string
     */
    public function jsonTimeFormat()
    {
        return $this->ensureProperty($this, 'jsonTimeFormat') ? (string) $this->jsonTimeFormat : $this->databaseTimeFormat();

The property jsonTimeFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended timezone for json output.
     *
     * @return string
     */
    public function jsonTimezone()
    {
        // Check for $jsonTimezone property in model.
        if ($this->ensureProperty($this, 'jsonTimezone')) {
            return (string) $this->jsonTimezone;

The property jsonTimezone does not exist. Did you maybe forget to declare it?

        }

        // Otherwise use same timezone as database.
        return $this->databaseTimezone();
    }

    /**
     * Get the intended database format for timestamp storage.
     *
     * @return string
     */
    public function databaseTimestampFormat()
    {
        return $this->ensureProperty($this, 'databaseTimestampFormat') ? (string) $this->databaseTimestampFormat : 'Y-m-d H:i:s';

The property databaseTimestampFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended database format for date storage.
     *
     * @return string
     */
    public function databaseDateFormat()
    {
        return $this->ensureProperty($this, 'databaseDateFormat') ? (string) $this->databaseDateFormat : 'Y-m-d';

The property databaseDateFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended database format for time storage.
     *
     * @return string
     */
    public function databaseTimeFormat()
    {
        return $this->ensureProperty($this, 'databaseTimeFormat') ? (string) $this->databaseTimeFormat : 'H:i:s';

The property databaseTimeFormat does not exist. Did you maybe forget to declare it?

    }

    /**
     * Get the intended timezone for database storage.
     *
     * @return string
     */
    public function databaseTimezone()
    {
        // Check for $databaseTimezone property in model.
        if ($this->ensureProperty($this, 'databaseTimezone')) {
            return (string) $this->databaseTimezone;

The property databaseTimezone does not exist. Did you maybe forget to declare it?

        }

        // Otherwise use app's timezone configuration.
        return (string) function_exists('config') ? config('app.timezone') : 'UTC';
    }

    /**
     * Store and return carbon instances for reuse.
     *
     * @return object
     */
    protected function carbonInstances()
    {
        // Check if date/time fields have already been carbonated.
        if ($this->carbonInstances) {
            return $this->carbonInstances;
        }

        // If not, get timezones.
        $databaseTimezone = $this->databaseTimezone();
        $carbonatedTimezone = $this->carbonatedTimezone();

        // Get database field formats.
        foreach ($this->carbonatedTimestamps() as $field) {
            $fieldFormats[$field] = $this->databaseTimestampFormat();

$fieldFormats was never initialized. Although not strictly required by PHP, it is generally a good practice to add $fieldFormats = array(); before regardless.

        }
        foreach ($this->carbonatedDates() as $field) {
            $fieldFormats[$field] = $this->databaseDateFormat();

The variable $fieldFormats does not seem to be defined for all execution paths leading up to this point.

        }
        foreach ($this->carbonatedTimes() as $field) {
            $fieldFormats[$field] = $this->databaseTimeFormat();
        }

        // Create Carbon instances.
        foreach ($fieldFormats as $field => $format) {
            $value = isset($this->attributes[$field]) ? $this->attributes[$field] : null;

The property attributes does not exist. Did you maybe forget to declare it?

            $carbonInstance = $value ? Carbon::createFromFormat($format, $value, $databaseTimezone) : null;
            $carbonInstances[$field] = $carbonInstance ? $carbonInstance->timezone($carbonatedTimezone) : null;

$carbonInstances was never initialized. Although not strictly required by PHP, it is generally a good practice to add $carbonInstances = array(); before regardless.

        }

        // Store Carbon instances for future use.
        $this->carbonInstances = isset($carbonInstances) ? (object) $carbonInstances : null;

        // Return Carbon instances.
        return $this->carbonInstances;
    }

    /**
     * Return a clone of $this object and modify it's accessors.
     *
     * @return $this
     */
    public function getWithCarbonAttribute()
    {
        // Clone $this to preserve it's state.
        $clone = clone $this;

        // Modify clone's accessors.
        $clone->returnCarbon = true;

        // Return clone.
        return $clone;
    }

    /**
     * Access and format for front end.
     *
     * @param string $key
     * @param bool   $json
     *
     * @return string
     */
    public function carbonatedAccessor($key, $json = false)
    {
        // Initial accesor setup.
        $accessorType = $json ? 'json' : 'carbonated';
        $fieldType = $this->carbonatedAttributeType($key);

        // Get output format and timezone for conversion.
        $outputFormat = $this->{$accessorType.ucfirst($fieldType).'Format'}();
        $outputTimezone = $this->{$accessorType.'Timezone'}();

        // Get Carbon instance.
        /** @var Carbon $carbonInstance */
        $carbonInstance = $this->carbonInstances()->$key;

        // Return formatted value.
        $timezonedInstance = $carbonInstance->timezone($outputTimezone);

        if ($this->useLocalizedFormats()) {
            return $carbonInstance ? $timezonedInstance->formatLocalized($outputFormat) : null;
        }

        return $carbonInstance ? $timezonedInstance->format($outputFormat) : null;
    }

    /**
     * Mutate to a storable value for database.
     *
     * @param string $key
     * @param mixed  $value
     *
     * @return string
     */
    public function carbonatedMutator($key, $value)
    {
        // Get type.
        $fieldType = $this->carbonatedAttributeType($key);

        // Get database format and timezone.
        $databaseFormat = $this->{'database'.ucfirst($fieldType).'Format'}();
        $databaseTimezone = $this->databaseTimezone();

        // If value is DateTime instance, convert to Carbon instance.
        if ($value instanceof \DateTime) {
            $value = Carbon::instance($value);
        }

        // It value is Carbon intance, return storable value.
        if ($value instanceof Carbon) {
            return $value->timezone($databaseTimezone)->format($databaseFormat);
        }

        // Otherwise, get input format and timezone for conversion.
        if (static::requestIsJson()) {
            $inputFormat = $this->{'json'.ucfirst($fieldType).'Format'}();
            $inputTimezone = $this->jsonTimezone();
        } else {
            $inputFormat = $this->{'carbonated'.ucfirst($fieldType).'Format'}();
            $inputTimezone = $this->carbonatedTimezone();
        }

        // Convert to Carbon instance.
        $carbonInstance = $value ? Carbon::createFromFormat($inputFormat, $value, $inputTimezone) : null;

        // Return storable value.
        return $carbonInstance ? $carbonInstance->timezone($databaseTimezone)->format($databaseFormat) : null;
    }

    /**
     * Check if request is some type of JSON (purposefully more lenient than current Request::isJson() helper).
     *
     * @return bool
     */
    public static function requestIsJson()
    {
        return str_contains(Request::header('CONTENT_TYPE'), 'json');

It seems like \Request::header('CONTENT_TYPE') targeting Illuminate\Http\Concerns\InteractsWithInput::header() can also be of type array; however, str_contains() does only seem to accept string, maybe add an additional type check?

    }

    /**
     * Override default getDates() to allow created_at and updated_at handling by carbonated.
     *
     * @return array
     */
    public function getDates()
    {
        return (array) $this->dates;
    }

    /**
     * Override default freshTimestamp() to be more explicit in setting timezone for storage.
     *
     * @return \Carbon\Carbon
     */
    public function freshTimestamp()
    {
        $databaseTimezone = $this->databaseTimezone();

        return Carbon::now($databaseTimezone);
    }

    /**
     * Override default toArray() to include our own accessors.
     *
     * @param bool $useJsonAccessors
     *
     * @return array
     */
    public function toArray($useJsonAccessors = false)
    {
        $attributes = $this->attributesToArray();

The method attributesToArray() does not exist on ThisVessel\Carbonated. Did you maybe mean toArray()?

        // If returning JSON output, reference our own accessors for relevant date/time fields.
        if ($useJsonAccessors) {
            foreach ($attributes as $key => $value) {
                if (!$this->hasGetMutator($key) && in_array($key, $this->carbonatedAttributes())) {

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

                    $attributes[$key] = $this->carbonatedAccessor($key, true);
                }
            }
        }

        return array_merge($attributes, $this->relationsToArray());

The method relationsToArray() does not exist on ThisVessel\Carbonated. Did you maybe mean toArray()?

    }

    /**
     * Override default jsonSerialize() to set $useJsonAccessors parameter.
     *
     * @return array
     */
    public function jsonSerialize()
    {
        return $this->toArray(true);
    }

    /**
     * Override default getAttributeValue() to include our own accessors.
     *
     * @param string $key
     *
     * @return mixed
     */
    public function getAttributeValue($key)
    {
        $value = $this->getAttributeFromArray($key);

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

        // Check for the presence of an accessor in our model.
        if ($this->hasGetMutator($key)) {

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

            return $this->mutateAttribute($key, $value);

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

        }

        // If no accessor found, reference our own accessors for relevant date/time fields.
        if (in_array($key, $this->carbonatedAttributes())) {
            $value = $this->returnCarbon ? $this->carbonInstances()->$key : $this->carbonatedAccessor($key);
        }

        // Otherwise, revert to default Eloquent behavour.
        if ($this->hasCast($key)) {

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

            $value = $this->castAttribute($key, $value);

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

        } elseif (in_array($key, $this->getDates())) {
            if (!is_null($value)) {
                return $this->asDateTime($value);

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

            }
        }

        return $value;
    }

    /**
     * Override default setAttribute() to include our own mutators.
     *
     * @param string $key
     * @param mixed  $value
     *
     * @return void
     */
    public function setAttribute($key, $value)
    {
        // Check for the presence of a mutator in our model.
        if ($this->hasSetMutator($key)) {

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

            $method = 'set'.studly_case($key).'Attribute';

            return $this->{$method}($value);
        } // If no mutator found, reference our own mutators for relevant date/time fields.
        elseif (in_array($key, $this->carbonatedAttributes())) {
            $value = $this->carbonatedMutator($key, $value);
        } // Otherwise, revert to default Eloquent behavour.
        elseif (in_array($key, $this->getDates()) && $value) {
            $value = $this->fromDateTime($value);

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

        }

        if ($this->isJsonCastable($key)) {

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

            $value = json_encode($value);
        }

        $this->attributes[$key] = $value;
    }

    /**
     * @param object $carbonInstances
     */
    public function setCarbonInstances($carbonInstances)
    {
        if (!is_object($carbonInstances)) {
            throw new \InvalidArgumentException('carbonInstances must be an object.');
        }
        $this->carbonInstances = $carbonInstances;
    }

    private function ensureProperty($instance, $propertyName)
    {
        if (!property_exists($instance, $propertyName)) {
            return false;
        }

        // Check property value for null and false values
        if (empty($instance->{$propertyName})) {
            return false;
        }

        return true;
    }

    private function useLocalizedFormats()
    {
        $localize = config('carbonated.localization', false);

        return $localize;
    }
}