DataFormatter::addFormat() - Code Metrics - Inspection of "Se separa el renderizado en estrategias. Se agrega..." - derafu/derafu-lib-core - Measure and Improve Code Quality continuously with Scrutinizer

Test Failed

Push — master ( 4516e7...6ee9d0 )

by Esteban De La Fuente

created 2025-01-11 17:00 UTC

DataFormatter::addFormat() A

↳ Parent: DataFormatter

Complexity

Conditions	1
Paths	1

Size

Total Lines	7
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	1
eloc	2
nc	1
nop	2
dl	0
loc	7
ccs	0
cts	3
cp	0
crap	2
rs	10
c	1
b	0
f	0

<?php

declare(strict_types=1);

/**
 * Derafu: Biblioteca PHP (Núcleo).
 * Copyright (C) Derafu <https://www.derafu.org>
 *
 * Este programa es software libre: usted puede redistribuirlo y/o modificarlo
 * bajo los términos de la Licencia Pública General Affero de GNU publicada por
 * la Fundación para el Software Libre, ya sea la versión 3 de la Licencia, o
 * (a su elección) cualquier versión posterior de la misma.
 *
 * Este programa se distribuye con la esperanza de que sea útil, pero SIN
 * GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
 * PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la Licencia Pública
 * General Affero de GNU para obtener una información más detallada.
 *
 * Debería haber recibido una copia de la Licencia Pública General Affero de GNU
 * junto a este programa.
 *
 * En caso contrario, consulte <http://www.gnu.org/licenses/agpl.html>.
 */

namespace Derafu\Lib\Core\Package\Prime\Component\Template\Service;

use Derafu\Lib\Core\Package\Prime\Component\Template\Contract\DataFormatterInterface;
use Derafu\Lib\Core\Support\Store\Contract\RepositoryInterface;

/**
 * Servicio de formateo de datos.
 *
 * Permite recibir un valor y formatearlo según un mapa de formateos predefinido
 * mediante su identificador.
 */
class DataFormatter implements DataFormatterInterface
{
    /**
     * Mapeo de identificadores a la forma que se usará para darle formato a los
     * valores asociados al identificador.
     *
     * @var array<string,string|array|callable|RepositoryInterface>
     */
    private array $formats;

    /**
     * Constructor del servicio.
     *
     * @param array $formats
     */
    public function __construct(array $formats = [])
    {
        $this->setFormats($formats);
    }

    /**
     * @inheritDoc
     */
    public function setFormats(array $formats): static
    {
        $this->formats = $formats;

        return $this;
    }

    /**
     * @inheritDoc
     */
    public function getFormats(): array
    {
        return $this->formats;
    }

    /**
     * @inheritDoc
     */
    public function addFormat(
        string $id,
        string|array|callable|RepositoryInterface $format
    ): static {
        $this->formats[$id] = $format;

        return $this;
    }

    /**
     * @inheritDoc
     */
    public function format(string $id, mixed $value): string
    {
        // Si no hay formato, devolver como string el valor pasado.
        if (!isset($this->formats[$id])) {
            return (string) $value;
        }

        // Obtener el formato que se debe utilizar.
        $format = $this->formats[$id];

        // Si es un string es una máscara de sprint.
        if (is_string($format)) {
            return sprintf($format, $value);
        }

        // Si es un arreglo es el arreglo deberá contener el valor a traducir.
        // Si no existe, se entregará el mismo valor como string.
        if (is_array($format)) {
            return $format[$value] ?? (string) $value;
        }

        // Si es una función se llama directamente y se retorna su resultado.
        if (is_callable($format)) {
            return $format($value);
        }

        // Si es un repositorio se busca la entidad y se retorna el string que
        // representa la interfaz. Cada Entidad deberá implementar __toString().
        if ($format instanceof RepositoryInterface) {
            $entity = $format->find($value);
            return $entity->__toString();
        }
interface ReturnsInt {
    public function returnsIntHinted(): int;
}

class MyClass implements ReturnsInt {
    public function returnsIntHinted(): int
    {
        if (foo()) {
            return 123;
        }
        // here: null is implicitly returned
    }
}
    }
}


1			<?php
2
3			declare(strict_types=1);
4
5			/**
6			* Derafu: Biblioteca PHP (Núcleo).
7			* Copyright (C) Derafu <https://www.derafu.org>
8			*
9			* Este programa es software libre: usted puede redistribuirlo y/o modificarlo
10			* bajo los términos de la Licencia Pública General Affero de GNU publicada por
11			* la Fundación para el Software Libre, ya sea la versión 3 de la Licencia, o
12			* (a su elección) cualquier versión posterior de la misma.
13			*
14			* Este programa se distribuye con la esperanza de que sea útil, pero SIN
15			* GARANTÍA ALGUNA; ni siquiera la garantía implícita MERCANTIL o de APTITUD
16			* PARA UN PROPÓSITO DETERMINADO. Consulte los detalles de la Licencia Pública
17			* General Affero de GNU para obtener una información más detallada.
18			*
19			* Debería haber recibido una copia de la Licencia Pública General Affero de GNU
20			* junto a este programa.
21			*
22			* En caso contrario, consulte <http://www.gnu.org/licenses/agpl.html>.
23			*/
24
25			namespace Derafu\Lib\Core\Package\Prime\Component\Template\Service;
26
27			use Derafu\Lib\Core\Package\Prime\Component\Template\Contract\DataFormatterInterface;
28			use Derafu\Lib\Core\Support\Store\Contract\RepositoryInterface;
29
30			/**
31			* Servicio de formateo de datos.
32			*
33			* Permite recibir un valor y formatearlo según un mapa de formateos predefinido
34			* mediante su identificador.
35			*/
36			class DataFormatter implements DataFormatterInterface
37			{
38			/**
39			* Mapeo de identificadores a la forma que se usará para darle formato a los
40			* valores asociados al identificador.
41			*
42			* @var array<string,string\|array\|callable\|RepositoryInterface>
43			*/
44			private array $formats;
45
46			/**
47			* Constructor del servicio.
48			*
49			* @param array $formats
50			*/
51			public function __construct(array $formats = [])
52			{
53			$this->setFormats($formats);
54			}
55
56			/**
57			* @inheritDoc
58			*/
59			public function setFormats(array $formats): static
60			{
61			$this->formats = $formats;
62
63			return $this;
64			}
65
66			/**
67			* @inheritDoc
68			*/
69			public function getFormats(): array
70			{
71			return $this->formats;
72			}
73
74			/**
75			* @inheritDoc
76			*/
77			public function addFormat(
78			string $id,
79			string\|array\|callable\|RepositoryInterface $format
80			): static {
81			$this->formats[$id] = $format;
82
83			return $this;
84			}
85
86			/**
87			* @inheritDoc
88			*/
89			public function format(string $id, mixed $value): string
90			{
91			// Si no hay formato, devolver como string el valor pasado.
92			if (!isset($this->formats[$id])) {
93			return (string) $value;
94			}
95
96			// Obtener el formato que se debe utilizar.
97			$format = $this->formats[$id];
98
99			// Si es un string es una máscara de sprint.
100			if (is_string($format)) {
101			return sprintf($format, $value);
102			}
103
104			// Si es un arreglo es el arreglo deberá contener el valor a traducir.
105			// Si no existe, se entregará el mismo valor como string.
106			if (is_array($format)) {
107			return $format[$value] ?? (string) $value;
108			}
109
110			// Si es una función se llama directamente y se retorna su resultado.
111			if (is_callable($format)) {
112			return $format($value);
113			}
114
115			// Si es un repositorio se busca la entidad y se retorna el string que
116			// representa la interfaz. Cada Entidad deberá implementar __toString().
117			if ($format instanceof RepositoryInterface) {
118			$entity = $format->find($value);
119			return $entity->__toString();
120			}
			0 ignored issues – show Bug Best Practice introduced 2025-01-11 17:04 UTC by Report Bug Copy Issue Report The function implicitly returns `null` when the `if` condition on line 117 is `false`. This is incompatible with the type-hinted return `string`. Consider adding a return statement or allowing `null` as return value. For hinted functions/methods where all return statements with the correct type are only reachable via conditions, ?null? gets implicitly returned which may be incompatible with the hinted type. Let?s take a look at an example: interface ReturnsInt { public function returnsIntHinted(): int; } class MyClass implements ReturnsInt { public function returnsIntHinted(): int { if (foo()) { return 123; } // here: null is implicitly returned } } Loading history...
121			}
122			}
123

derafu / derafu-lib-core

Push — master ( 4516e7...6ee9d0 )

DataFormatter::addFormat() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like