Svg::createFromString() - Code Metrics - Inspection of "Fix README" - ocubom/twig-svg-extension - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — main ( 7d39cf...4a07e7 )

by Oscar

created 2023-01-03 18:22 UTC

Svg::createFromString() A

↳ Parent: Svg

Complexity

Conditions	1
Paths	1

Size

Total Lines	5
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	2

Importance

Changes	1
Bugs	0	Features	0

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

<?php

/*
 * This file is part of ocubom/twig-svg-extension
 *
 * © Oscar Cubo Medina <https://ocubom.github.io>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Ocubom\Twig\Extension\Svg;

use function BenTools\IterableFunctions\iterable_merge;
use function BenTools\IterableFunctions\iterable_to_array;

use enshrined\svgSanitize\Sanitizer;

use function Ocubom\Twig\Extension\is_string;

use Ocubom\Twig\Extension\Svg\Exception\FileNotFoundException;
use Ocubom\Twig\Extension\Svg\Exception\ParseException;
use Ocubom\Twig\Extension\Svg\Processor\ClassProcessor;
use Ocubom\Twig\Extension\Svg\Processor\RemoveAttributeProcessor;
use Ocubom\Twig\Extension\Svg\Processor\TitleProcessor;
use Ocubom\Twig\Extension\Svg\Util\DomHelper;
use Symfony\Component\OptionsResolver\Options;
use Symfony\Component\OptionsResolver\OptionsResolver;

class Svg implements SvgInterface
{
    use SvgTrait;

    /** @var array<string, array<string, array<int, callable>|callable>> */
    private static array $processors = [];

    /**
     * @param mixed $data The SVG data
     */
    public function __construct($data, iterable $options = null)
    {
        switch (true) {
            case $data instanceof Svg : // "Copy" constructor
                $node = $this->constructFromString(DomHelper::toXml($data->svg)); // @codeCoverageIgnore
                break; // @codeCoverageIgnore

            case $data instanceof \DOMNode :
                $node = $this->constructFromString(DomHelper::toXml($data));
                break;

            case $data instanceof \SplFileInfo :
                $node = $this->constructFromFile($data);
                break;

            case is_string($data) :
                $node = $this->constructFromString($data);
                break;

            default:
                throw new ParseException(sprintf('Unable to create an SVG from "%s"', get_debug_type($data))); // @codeCoverageIgnore
        }

        // Merge options with SVG attributes
        $options = iterable_to_array(iterable_merge(
            DomHelper::getElementAttributes($node),
            $options ?? /* @scrutinizer ignore-type */ []
        ));

        // Define SVG attributes and resolve options + attributes
        $options = static::configureOptions()
            ->setDefined(array_keys($options)) // enables all optional options
            ->resolve($options);

        // Retrieve processors for this class with a naive cache
        $processors = self::$processors[static::class]
            ?? self::$processors[static::class] = array_map(
                function ($processors): array {
                    return is_iterable($processors) ? $processors : [$processors];
                },
                static::getProcessors()
            );
        if (isset($processors[''])) {
            $options[''] = null; // Force execution of global processors.
        }

        // Apply processors on a flesh clone in new DOM document
        $this->svg = DomHelper::cloneElement($node);
        foreach ($options as $key => $val) {
            if (isset($processors[$key])) {
                // Apply processors
                foreach ($processors[$key] as $processor) {
                    $this->svg = $processor($this->svg, $options);
                }
            } elseif (empty($val)) {
                // Remove empty attributes
                $this->svg->removeAttribute($key);
            } else {
                // Set attribute value
                $this->svg->setAttribute($key, $val);
            }
        }
    }

    protected function constructFromFile(\SplFileInfo $path): \DOMElement
    {
        $path = (string) $path;

        if (!is_file($path)) {
            throw new FileNotFoundException(sprintf('File "%s" does not exist.', $path)); // @codeCoverageIgnore
        }

        if (!is_readable($path)) {
            throw new FileNotFoundException(sprintf('File "%s" cannot be read.', $path)); // @codeCoverageIgnore
        }

        try {
            return $this->constructFromString(file_get_contents($path));
        } catch (ParseException $exc) {
            throw new ParseException(sprintf('File "%s" does not contain a valid SVG.', $path), 0, $exc);
        }
    }

    protected function constructFromString(string $contents): \DOMElement
    {
        // Sanitize contents (if enshrined\svgSanitize is installed)
        if (class_exists(Sanitizer::class)) {
            $contents = (new Sanitizer())->sanitize($contents);
        }

        // Remove all namespaces
        $contents = preg_replace('@xmlns(:.*)?=(\"[^\"]*\"|\'[^\']*\')@Uis', '', $contents);
        if (empty($contents)) {
            throw new ParseException(sprintf('Invalid SVG string "%s".', func_get_arg(0)));
        }

        // Parse contents into DOM
        $doc = DomHelper::createDocument();
        if (false === $doc->loadXML($contents)) {
            throw new ParseException(sprintf('Unable to load SVG string "%s".', func_get_arg(0))); // @codeCoverageIgnore
        }

        // Get first svg item
        $node = $doc->getElementsByTagName('svg')->item(0);
        if ($node instanceof \DOMElement) {
            return $node; // Return first SVG element
        }

        throw new ParseException(sprintf('String "%s" does not contain any SVG.', func_get_arg(0))); // @codeCoverageIgnore
    }

    /**
     * @param mixed $path The path to the SVG file
     *
     * @return static
     *
     * @psalm-suppress UnsafeInstantiation
     *
     * @deprecated since ocubom/twig-svg-extension 1.1, use Svg constructor with SplInfo argument instead
     *
     * @codeCoverageIgnore
     */
    public static function createFromFile($path, iterable $options = null): self
    {
        trigger_deprecation('ocubom/twig-svg-extension', '1.1', 'Using "%s" is deprecated, use "%s" constructor with SplInfo argument instead.', __METHOD__, Svg::class);

        return new static($path instanceof \SplFileInfo ? $path : new \SplFileInfo((string) $path), $options);
    }

    /**
     * @param mixed $contents The SVG contents as an "stringable"
     *
     * @return static
     *
     * @psalm-suppress UnsafeInstantiation
     *
     * @deprecated since ocubom/twig-svg-extension 1.1, use Svg constructor instead
     *
     * @codeCoverageIgnore
     */
    public static function createFromString($contents, iterable $options = null): self
    {
        trigger_deprecation('ocubom/twig-svg-extension', '1.1', 'Using "%s" is deprecated, use "%s" constructor instead.', __METHOD__, Svg::class);

        return new static((string) $contents, $options);
    }

    /**
     * @return array<string, array<int, callable>|callable>
     */
    protected static function getProcessors(): array
    {
        return [
            // Options will be ignored & removed
            'debug' => new RemoveAttributeProcessor('debug'),
            'minimize' => new RemoveAttributeProcessor('minimize'),
            'class_block' => new RemoveAttributeProcessor('class_block'),

            // Custom process
            'class' => new ClassProcessor(),
            'title' => new TitleProcessor(),

            // Ignore attributes that depends on other options
            'aria-labelledby' => [], // generated on TitleProcessor
        ];
    }

    /** @psalm-suppress MissingClosureParamType */
    protected static function configureOptions(OptionsResolver $resolver = null): OptionsResolver
    {
        $resolver = $resolver ?? new OptionsResolver();

        // Options

        $resolver->define('debug')
            ->default(false)
            ->allowedTypes('bool')
            ->info('Enable debug output');

        $resolver->define('minimize')
            ->default(true)
            ->allowedTypes('bool')
            ->info('Minimize output');

        // Attributes

        /** @psalm-suppress MissingClosureParamType */
        $normalizeClass = function (Options $options, $value): array {
            return array_filter(
                is_string($value) ? preg_split('@\s+@Uis', $value) : ($value ?? []),
                function (string $item): bool {
                    return !empty($item);
                }
            );
        };

        $resolver->define('class')
            ->default('')
            ->allowedTypes('null', 'string', 'string[]')
            ->normalize($normalizeClass)
            ->info('Classes to apply');

        $resolver->define('class_block')
            ->default('')
            ->allowedTypes('null', 'string', 'string[]')
            ->normalize($normalizeClass)
            ->info('Classes to block');

        $resolver->define('title')
            ->default(null)
            ->allowedTypes('null', 'string')
            ->normalize(function (Options $options, ?string $value): ?string {
                return empty($value ?? '') ? null : $value;
            })
            ->info('Title of the icon. Used for semantic icons.');

        $resolver->define('focusable')
            ->default('false')
            ->allowedTypes('null', 'bool', 'string')
            ->normalize(function (Options $options, $value): ?string {
                if (is_bool($value)) {
                    return $value ? 'true' : 'false';
                }

                return empty($value) ? null : $value;
            })
            ->info('Indicates if the element can take the focus');

        $resolver->define('role')
            ->default('img')
            ->allowedTypes('null', 'string')
            ->info('Indicates the semantic meaning of the content');

        $resolver->define('aria-hidden')
            ->default(null)
            ->allowedTypes('null', 'bool', 'string')
            ->allowedValues(null, true, 'true', false, 'false')
            ->normalize(function (Options $options, $value): ?string {
                // Decorative icon: no title and not previously defined aria-hidden value
                if (
                    null === $value
                    && empty($options['aria-labelledby'])
                    && empty($options['title'])
                ) {
                    return 'true';
                }

                // Convert bool value into text
                if (is_bool($value)) {
                    return $value ? 'true' : 'false';
                }

                return empty($value)
                    ? null
                    : ('true' === $value ? 'true' : 'false');
            })
            ->info('Indicates whether the element is exposed to an accessibility API');

        $resolver->define('aria-labelledby')
            ->default(null)
            ->allowedTypes('null', 'string')
            ->normalize(function (Options $options, $value): ?string {
                // Decorative icon: no title and not previously defined aria-hidden value
                if (empty($options['title'])) {
                    return null;
                }

                // Generate an identifier based on title contents
                return $value ?? Ident::generate(DomHelper::createElement('title', $options['title']));
            })
            ->info('Identifies the element that labels this element');

        return $resolver;
    }
}


1		<?php
2
3		/*
4		* This file is part of ocubom/twig-svg-extension
5		*
6		* © Oscar Cubo Medina <https://ocubom.github.io>
7		*
8		* For the full copyright and license information, please view the LICENSE
9		* file that was distributed with this source code.
10		*/
11
12		namespace Ocubom\Twig\Extension\Svg;
13
14		use function BenTools\IterableFunctions\iterable_merge;
15		use function BenTools\IterableFunctions\iterable_to_array;
16
17		use enshrined\svgSanitize\Sanitizer;
18
19		use function Ocubom\Twig\Extension\is_string;
20
21		use Ocubom\Twig\Extension\Svg\Exception\FileNotFoundException;
22		use Ocubom\Twig\Extension\Svg\Exception\ParseException;
23		use Ocubom\Twig\Extension\Svg\Processor\ClassProcessor;
24		use Ocubom\Twig\Extension\Svg\Processor\RemoveAttributeProcessor;
25		use Ocubom\Twig\Extension\Svg\Processor\TitleProcessor;
26		use Ocubom\Twig\Extension\Svg\Util\DomHelper;
27		use Symfony\Component\OptionsResolver\Options;
28		use Symfony\Component\OptionsResolver\OptionsResolver;
29
30		class Svg implements SvgInterface
31		{
32		use SvgTrait;
33
34		/** @var array<string, array<string, array<int, callable>\|callable>> */
35		private static array $processors = [];
36
37		/**
38		* @param mixed $data The SVG data
39		*/
40	8	public function __construct($data, iterable $options = null)
41		{
42		switch (true) {
43	8	case $data instanceof Svg : // "Copy" constructor
44		$node = $this->constructFromString(DomHelper::toXml($data->svg)); // @codeCoverageIgnore
45		break; // @codeCoverageIgnore
46
47	8	case $data instanceof \DOMNode :
48	3	$node = $this->constructFromString(DomHelper::toXml($data));
49	3	break;
50
51	5	case $data instanceof \SplFileInfo :
52	5	$node = $this->constructFromFile($data);
53	4	break;
54
55		case is_string($data) :
56		$node = $this->constructFromString($data);
57		break;
58
59		default:
60		throw new ParseException(sprintf('Unable to create an SVG from "%s"', get_debug_type($data))); // @codeCoverageIgnore
61		}
62
63		// Merge options with SVG attributes
64	7	$options = iterable_to_array(iterable_merge(
65	7	DomHelper::getElementAttributes($node),
66	7	$options ?? /* @scrutinizer ignore-type */ []
67	7	));
68
69		// Define SVG attributes and resolve options + attributes
70	7	$options = static::configureOptions()
71	7	->setDefined(array_keys($options)) // enables all optional options
72	7	->resolve($options);
73
74		// Retrieve processors for this class with a naive cache
75	7	$processors = self::$processors[static::class]
76	7	?? self::$processors[static::class] = array_map(
77	7	function ($processors): array {
78	2	return is_iterable($processors) ? $processors : [$processors];
79	7	},
80	7	static::getProcessors()
81	7	);
82	7	if (isset($processors[''])) {
83	2	$options[''] = null; // Force execution of global processors.
84		}
85
86		// Apply processors on a flesh clone in new DOM document
87	7	$this->svg = DomHelper::cloneElement($node);
88	7	foreach ($options as $key => $val) {
89	7	if (isset($processors[$key])) {
90		// Apply processors
91	7	foreach ($processors[$key] as $processor) {
92	7	$this->svg = $processor($this->svg, $options);
93		}
94	7	} elseif (empty($val)) {
95		// Remove empty attributes
96	4	$this->svg->removeAttribute($key);
97		} else {
98		// Set attribute value
99	7	$this->svg->setAttribute($key, $val);
100		}
101		}
102		}
103
104	5	protected function constructFromFile(\SplFileInfo $path): \DOMElement
105		{
106	5	$path = (string) $path;
107
108	5	if (!is_file($path)) {
109		throw new FileNotFoundException(sprintf('File "%s" does not exist.', $path)); // @codeCoverageIgnore
110		}
111
112	5	if (!is_readable($path)) {
113		throw new FileNotFoundException(sprintf('File "%s" cannot be read.', $path)); // @codeCoverageIgnore
114		}
115
116		try {
117	5	return $this->constructFromString(file_get_contents($path));
118	1	} catch (ParseException $exc) {
119	1	throw new ParseException(sprintf('File "%s" does not contain a valid SVG.', $path), 0, $exc);
120		}
121		}
122
123	8	protected function constructFromString(string $contents): \DOMElement
124		{
125		// Sanitize contents (if enshrined\svgSanitize is installed)
126	8	if (class_exists(Sanitizer::class)) {
127	8	$contents = (new Sanitizer())->sanitize($contents);
128		}
129
130		// Remove all namespaces
131	8	$contents = preg_replace('@xmlns(:.)?=(\"[^\"]\"\|\'[^\']*\')@Uis', '', $contents);
132	8	if (empty($contents)) {
133	1	throw new ParseException(sprintf('Invalid SVG string "%s".', func_get_arg(0)));
134		}
135
136		// Parse contents into DOM
137	7	$doc = DomHelper::createDocument();
138	7	if (false === $doc->loadXML($contents)) {
139		throw new ParseException(sprintf('Unable to load SVG string "%s".', func_get_arg(0))); // @codeCoverageIgnore
140		}
141
142		// Get first svg item
143	7	$node = $doc->getElementsByTagName('svg')->item(0);
144	7	if ($node instanceof \DOMElement) {
145	7	return $node; // Return first SVG element
146		}
147
148		throw new ParseException(sprintf('String "%s" does not contain any SVG.', func_get_arg(0))); // @codeCoverageIgnore
149		}
150
151		/**
152		* @param mixed $path The path to the SVG file
153		*
154		* @return static
155		*
156		* @psalm-suppress UnsafeInstantiation
157		*
158		* @deprecated since ocubom/twig-svg-extension 1.1, use Svg constructor with SplInfo argument instead
159		*
160		* @codeCoverageIgnore
161		*/
162		public static function createFromFile($path, iterable $options = null): self
163		{
164		trigger_deprecation('ocubom/twig-svg-extension', '1.1', 'Using "%s" is deprecated, use "%s" constructor with SplInfo argument instead.', __METHOD__, Svg::class);
165
166		return new static($path instanceof \SplFileInfo ? $path : new \SplFileInfo((string) $path), $options);
167		}
168
169		/**
170		* @param mixed $contents The SVG contents as an "stringable"
171		*
172		* @return static
173		*
174		* @psalm-suppress UnsafeInstantiation
175		*
176		* @deprecated since ocubom/twig-svg-extension 1.1, use Svg constructor instead
177		*
178		* @codeCoverageIgnore
179		*/
180		public static function createFromString($contents, iterable $options = null): self
181		{
182		trigger_deprecation('ocubom/twig-svg-extension', '1.1', 'Using "%s" is deprecated, use "%s" constructor instead.', __METHOD__, Svg::class);
183
184		return new static((string) $contents, $options);
185		}
186
187		/**
188		* @return array<string, array<int, callable>\|callable>
189		*/
190	2	protected static function getProcessors(): array
191		{
192	2	return [
193		// Options will be ignored & removed
194	2	'debug' => new RemoveAttributeProcessor('debug'),
195	2	'minimize' => new RemoveAttributeProcessor('minimize'),
196	2	'class_block' => new RemoveAttributeProcessor('class_block'),
197
198		// Custom process
199	2	'class' => new ClassProcessor(),
200	2	'title' => new TitleProcessor(),
201
202		// Ignore attributes that depends on other options
203	2	'aria-labelledby' => [], // generated on TitleProcessor
204	2	];
205		}
206
207		/** @psalm-suppress MissingClosureParamType */
208	7	protected static function configureOptions(OptionsResolver $resolver = null): OptionsResolver
209		{
210	7	$resolver = $resolver ?? new OptionsResolver();
211
212		// Options
213
214	7	$resolver->define('debug')
215	7	->default(false)
216	7	->allowedTypes('bool')
217	7	->info('Enable debug output');
218
219	7	$resolver->define('minimize')
220	7	->default(true)
221	7	->allowedTypes('bool')
222	7	->info('Minimize output');
223
224		// Attributes
225
226		/** @psalm-suppress MissingClosureParamType */
227	7	$normalizeClass = function (Options $options, $value): array {
228	7	return array_filter(
229	7	is_string($value) ? preg_split('@\s+@Uis', $value) : ($value ?? []),
230	7	function (string $item): bool {
231	7	return !empty($item);
232	7	}
233	7	);
234	7	};
235
236	7	$resolver->define('class')
237	7	->default('')
238	7	->allowedTypes('null', 'string', 'string[]')
239	7	->normalize($normalizeClass)
240	7	->info('Classes to apply');
241
242	7	$resolver->define('class_block')
243	7	->default('')
244	7	->allowedTypes('null', 'string', 'string[]')
245	7	->normalize($normalizeClass)
246	7	->info('Classes to block');
247
248	7	$resolver->define('title')
249	7	->default(null)
250	7	->allowedTypes('null', 'string')
251	7	->normalize(function (Options $options, ?string $value): ?string {
252	7	return empty($value ?? '') ? null : $value;
253	7	})
254	7	->info('Title of the icon. Used for semantic icons.');
255
256	7	$resolver->define('focusable')
257	7	->default('false')
258	7	->allowedTypes('null', 'bool', 'string')
259	7	->normalize(function (Options $options, $value): ?string {
260	7	if (is_bool($value)) {
261	1	return $value ? 'true' : 'false';
262		}
263
264	7	return empty($value) ? null : $value;
265	7	})
266	7	->info('Indicates if the element can take the focus');
267
268	7	$resolver->define('role')
269	7	->default('img')
270	7	->allowedTypes('null', 'string')
271	7	->info('Indicates the semantic meaning of the content');
272
273	7	$resolver->define('aria-hidden')
274	7	->default(null)
275	7	->allowedTypes('null', 'bool', 'string')
276	7	->allowedValues(null, true, 'true', false, 'false')
277	7	->normalize(function (Options $options, $value): ?string {
278		// Decorative icon: no title and not previously defined aria-hidden value
279		if (
280	7	null === $value
281	7	&& empty($options['aria-labelledby'])
282	7	&& empty($options['title'])
283		) {
284	5	return 'true';
285		}
286
287		// Convert bool value into text
288	4	if (is_bool($value)) {
289	1	return $value ? 'true' : 'false';
290		}
291
292	4	return empty($value)
293	4	? null
294	4	: ('true' === $value ? 'true' : 'false');
295	7	})
296	7	->info('Indicates whether the element is exposed to an accessibility API');
297
298	7	$resolver->define('aria-labelledby')
299	7	->default(null)
300	7	->allowedTypes('null', 'string')
301	7	->normalize(function (Options $options, $value): ?string {
302		// Decorative icon: no title and not previously defined aria-hidden value
303	7	if (empty($options['title'])) {
304	6	return null;
305		}
306
307		// Generate an identifier based on title contents
308	4	return $value ?? Ident::generate(DomHelper::createElement('title', $options['title']));
309	7	})
310	7	->info('Identifies the element that labels this element');
311
312	7	return $resolver;
313		}
314		}
315

ocubom / twig-svg-extension

Push — main ( 7d39cf...4a07e7 )

Svg::createFromString() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like