first commit
This commit is contained in:
@@ -0,0 +1,65 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
abstract class AbstractRepresentation implements RepresentationInterface
|
||||
{
|
||||
/** @psalm-readonly */
|
||||
protected string $label;
|
||||
/** @psalm-readonly */
|
||||
protected string $name;
|
||||
/** @psalm-readonly */
|
||||
protected bool $implicit_label;
|
||||
|
||||
public function __construct(string $label, ?string $name = null, bool $implicit_label = false)
|
||||
{
|
||||
$this->label = $label;
|
||||
$this->name = \preg_replace('/[^a-z0-9]+/', '_', \strtolower($name ?? $label));
|
||||
$this->implicit_label = $implicit_label;
|
||||
}
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return $this->label;
|
||||
}
|
||||
|
||||
public function getName(): string
|
||||
{
|
||||
return $this->name;
|
||||
}
|
||||
|
||||
public function labelIsImplicit(): bool
|
||||
{
|
||||
return $this->implicit_label;
|
||||
}
|
||||
|
||||
public function getHint(): ?string
|
||||
{
|
||||
return null;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,50 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
class BinaryRepresentation extends AbstractRepresentation
|
||||
{
|
||||
/** @psalm-readonly */
|
||||
protected string $value;
|
||||
|
||||
public function __construct(string $value, bool $implicit = false)
|
||||
{
|
||||
parent::__construct('Hex dump', 'binary', $implicit);
|
||||
$this->value = $value;
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'binary';
|
||||
}
|
||||
|
||||
public function getValue(): string
|
||||
{
|
||||
return $this->value;
|
||||
}
|
||||
}
|
||||
+157
@@ -0,0 +1,157 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use InvalidArgumentException;
|
||||
|
||||
class CallableDefinitionRepresentation extends AbstractRepresentation
|
||||
{
|
||||
/** @psalm-readonly */
|
||||
protected string $filename;
|
||||
/** @psalm-readonly */
|
||||
protected int $line;
|
||||
/**
|
||||
* @psalm-readonly
|
||||
*
|
||||
* @psalm-var ?non-empty-string
|
||||
*/
|
||||
protected ?string $docstring;
|
||||
|
||||
/**
|
||||
* @psalm-param ?non-empty-string $docstring
|
||||
*/
|
||||
public function __construct(string $filename, int $line, ?string $docstring)
|
||||
{
|
||||
if (null !== $docstring && !\preg_match('%^/\\*\\*.+\\*/$%s', $docstring)) {
|
||||
throw new InvalidArgumentException('Docstring is invalid');
|
||||
}
|
||||
|
||||
parent::__construct('Callable definition', null, true);
|
||||
|
||||
$this->filename = $filename;
|
||||
$this->line = $line;
|
||||
$this->docstring = $docstring;
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'callable';
|
||||
}
|
||||
|
||||
public function getFileName(): string
|
||||
{
|
||||
return $this->filename;
|
||||
}
|
||||
|
||||
public function getLine(): int
|
||||
{
|
||||
return $this->line;
|
||||
}
|
||||
|
||||
/**
|
||||
* @psalm-api
|
||||
*
|
||||
* @psalm-return ?non-empty-string
|
||||
*/
|
||||
public function getDocstring(): ?string
|
||||
{
|
||||
return $this->docstring;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns the representation's docstring without surrounding comments.
|
||||
*
|
||||
* Note that this will not work flawlessly.
|
||||
*
|
||||
* On comments with whitespace after the stars the lines will begin with
|
||||
* whitespace, since we can't accurately guess how much of an indentation
|
||||
* is required.
|
||||
*
|
||||
* And on lines without stars on the left this may eat bullet points.
|
||||
*
|
||||
* Long story short: If you want the docstring read the contents. If you
|
||||
* absolutely must have it without comments (ie renderValueShort) this will
|
||||
* probably do.
|
||||
*/
|
||||
public function getDocstringWithoutComments(): ?string
|
||||
{
|
||||
if (null === ($ds = $this->getDocstring())) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$string = \substr($ds, 3, -2);
|
||||
$string = \preg_replace('/^\\s*\\*\\s*?(\\S|$)/m', '\\1', $string);
|
||||
|
||||
return \trim($string);
|
||||
}
|
||||
|
||||
public function getDocstringFirstLine(): ?string
|
||||
{
|
||||
$ds = $this->getDocstringWithoutComments();
|
||||
|
||||
if (null === $ds) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$ds = \explode("\n", $ds);
|
||||
|
||||
$out = '';
|
||||
|
||||
foreach ($ds as $line) {
|
||||
if (0 === \strlen(\trim($line)) || '@' === $line[0]) {
|
||||
break;
|
||||
}
|
||||
|
||||
$out .= $line.' ';
|
||||
}
|
||||
|
||||
if (\strlen($out)) {
|
||||
return \rtrim($out);
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
public function getDocstringTrimmed(): ?string
|
||||
{
|
||||
if (null === ($ds = $this->getDocstring())) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$docstring = [];
|
||||
foreach (\explode("\n", $ds) as $line) {
|
||||
$line = \trim($line);
|
||||
if (($line[0] ?? null) === '*') {
|
||||
$line = ' '.$line;
|
||||
}
|
||||
$docstring[] = $line;
|
||||
}
|
||||
|
||||
return \implode("\n", $docstring);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,594 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use InvalidArgumentException;
|
||||
use LogicException;
|
||||
|
||||
class ColorRepresentation extends AbstractRepresentation
|
||||
{
|
||||
public const COLOR_NAME = 1;
|
||||
public const COLOR_HEX_3 = 2;
|
||||
public const COLOR_HEX_6 = 3;
|
||||
public const COLOR_RGB = 4;
|
||||
public const COLOR_RGBA = 5;
|
||||
public const COLOR_HSL = 6;
|
||||
public const COLOR_HSLA = 7;
|
||||
public const COLOR_HEX_4 = 8;
|
||||
public const COLOR_HEX_8 = 9;
|
||||
|
||||
/** @psalm-var array<truthy-string, truthy-string> */
|
||||
public static array $color_map = [
|
||||
'aliceblue' => 'f0f8ff',
|
||||
'antiquewhite' => 'faebd7',
|
||||
'aqua' => '00ffff',
|
||||
'aquamarine' => '7fffd4',
|
||||
'azure' => 'f0ffff',
|
||||
'beige' => 'f5f5dc',
|
||||
'bisque' => 'ffe4c4',
|
||||
'black' => '000000',
|
||||
'blanchedalmond' => 'ffebcd',
|
||||
'blue' => '0000ff',
|
||||
'blueviolet' => '8a2be2',
|
||||
'brown' => 'a52a2a',
|
||||
'burlywood' => 'deb887',
|
||||
'cadetblue' => '5f9ea0',
|
||||
'chartreuse' => '7fff00',
|
||||
'chocolate' => 'd2691e',
|
||||
'coral' => 'ff7f50',
|
||||
'cornflowerblue' => '6495ed',
|
||||
'cornsilk' => 'fff8dc',
|
||||
'crimson' => 'dc143c',
|
||||
'cyan' => '00ffff',
|
||||
'darkblue' => '00008b',
|
||||
'darkcyan' => '008b8b',
|
||||
'darkgoldenrod' => 'b8860b',
|
||||
'darkgray' => 'a9a9a9',
|
||||
'darkgreen' => '006400',
|
||||
'darkgrey' => 'a9a9a9',
|
||||
'darkkhaki' => 'bdb76b',
|
||||
'darkmagenta' => '8b008b',
|
||||
'darkolivegreen' => '556b2f',
|
||||
'darkorange' => 'ff8c00',
|
||||
'darkorchid' => '9932cc',
|
||||
'darkred' => '8b0000',
|
||||
'darksalmon' => 'e9967a',
|
||||
'darkseagreen' => '8fbc8f',
|
||||
'darkslateblue' => '483d8b',
|
||||
'darkslategray' => '2f4f4f',
|
||||
'darkslategrey' => '2f4f4f',
|
||||
'darkturquoise' => '00ced1',
|
||||
'darkviolet' => '9400d3',
|
||||
'deeppink' => 'ff1493',
|
||||
'deepskyblue' => '00bfff',
|
||||
'dimgray' => '696969',
|
||||
'dimgrey' => '696969',
|
||||
'dodgerblue' => '1e90ff',
|
||||
'firebrick' => 'b22222',
|
||||
'floralwhite' => 'fffaf0',
|
||||
'forestgreen' => '228b22',
|
||||
'fuchsia' => 'ff00ff',
|
||||
'gainsboro' => 'dcdcdc',
|
||||
'ghostwhite' => 'f8f8ff',
|
||||
'gold' => 'ffd700',
|
||||
'goldenrod' => 'daa520',
|
||||
'gray' => '808080',
|
||||
'green' => '008000',
|
||||
'greenyellow' => 'adff2f',
|
||||
'grey' => '808080',
|
||||
'honeydew' => 'f0fff0',
|
||||
'hotpink' => 'ff69b4',
|
||||
'indianred' => 'cd5c5c',
|
||||
'indigo' => '4b0082',
|
||||
'ivory' => 'fffff0',
|
||||
'khaki' => 'f0e68c',
|
||||
'lavender' => 'e6e6fa',
|
||||
'lavenderblush' => 'fff0f5',
|
||||
'lawngreen' => '7cfc00',
|
||||
'lemonchiffon' => 'fffacd',
|
||||
'lightblue' => 'add8e6',
|
||||
'lightcoral' => 'f08080',
|
||||
'lightcyan' => 'e0ffff',
|
||||
'lightgoldenrodyellow' => 'fafad2',
|
||||
'lightgray' => 'd3d3d3',
|
||||
'lightgreen' => '90ee90',
|
||||
'lightgrey' => 'd3d3d3',
|
||||
'lightpink' => 'ffb6c1',
|
||||
'lightsalmon' => 'ffa07a',
|
||||
'lightseagreen' => '20b2aa',
|
||||
'lightskyblue' => '87cefa',
|
||||
'lightslategray' => '778899',
|
||||
'lightslategrey' => '778899',
|
||||
'lightsteelblue' => 'b0c4de',
|
||||
'lightyellow' => 'ffffe0',
|
||||
'lime' => '00ff00',
|
||||
'limegreen' => '32cd32',
|
||||
'linen' => 'faf0e6',
|
||||
'magenta' => 'ff00ff',
|
||||
'maroon' => '800000',
|
||||
'mediumaquamarine' => '66cdaa',
|
||||
'mediumblue' => '0000cd',
|
||||
'mediumorchid' => 'ba55d3',
|
||||
'mediumpurple' => '9370db',
|
||||
'mediumseagreen' => '3cb371',
|
||||
'mediumslateblue' => '7b68ee',
|
||||
'mediumspringgreen' => '00fa9a',
|
||||
'mediumturquoise' => '48d1cc',
|
||||
'mediumvioletred' => 'c71585',
|
||||
'midnightblue' => '191970',
|
||||
'mintcream' => 'f5fffa',
|
||||
'mistyrose' => 'ffe4e1',
|
||||
'moccasin' => 'ffe4b5',
|
||||
'navajowhite' => 'ffdead',
|
||||
'navy' => '000080',
|
||||
'oldlace' => 'fdf5e6',
|
||||
'olive' => '808000',
|
||||
'olivedrab' => '6b8e23',
|
||||
'orange' => 'ffa500',
|
||||
'orangered' => 'ff4500',
|
||||
'orchid' => 'da70d6',
|
||||
'palegoldenrod' => 'eee8aa',
|
||||
'palegreen' => '98fb98',
|
||||
'paleturquoise' => 'afeeee',
|
||||
'palevioletred' => 'db7093',
|
||||
'papayawhip' => 'ffefd5',
|
||||
'peachpuff' => 'ffdab9',
|
||||
'peru' => 'cd853f',
|
||||
'pink' => 'ffc0cb',
|
||||
'plum' => 'dda0dd',
|
||||
'powderblue' => 'b0e0e6',
|
||||
'purple' => '800080',
|
||||
'rebeccapurple' => '663399',
|
||||
'red' => 'ff0000',
|
||||
'rosybrown' => 'bc8f8f',
|
||||
'royalblue' => '4169e1',
|
||||
'saddlebrown' => '8b4513',
|
||||
'salmon' => 'fa8072',
|
||||
'sandybrown' => 'f4a460',
|
||||
'seagreen' => '2e8b57',
|
||||
'seashell' => 'fff5ee',
|
||||
'sienna' => 'a0522d',
|
||||
'silver' => 'c0c0c0',
|
||||
'skyblue' => '87ceeb',
|
||||
'slateblue' => '6a5acd',
|
||||
'slategray' => '708090',
|
||||
'slategrey' => '708090',
|
||||
'snow' => 'fffafa',
|
||||
'springgreen' => '00ff7f',
|
||||
'steelblue' => '4682b4',
|
||||
'tan' => 'd2b48c',
|
||||
'teal' => '008080',
|
||||
'thistle' => 'd8bfd8',
|
||||
'tomato' => 'ff6347',
|
||||
// To quote MDN:
|
||||
// "Technically, transparent is a shortcut for rgba(0,0,0,0)."
|
||||
'transparent' => '00000000',
|
||||
'turquoise' => '40e0d0',
|
||||
'violet' => 'ee82ee',
|
||||
'wheat' => 'f5deb3',
|
||||
'white' => 'ffffff',
|
||||
'whitesmoke' => 'f5f5f5',
|
||||
'yellow' => 'ffff00',
|
||||
'yellowgreen' => '9acd32',
|
||||
];
|
||||
|
||||
protected int $r;
|
||||
protected int $g;
|
||||
protected int $b;
|
||||
protected float $a;
|
||||
/** @psalm-var self::COLOR_* */
|
||||
protected int $variant;
|
||||
|
||||
public function __construct(string $value)
|
||||
{
|
||||
parent::__construct('Color', null, true);
|
||||
$this->setValues($value);
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'color';
|
||||
}
|
||||
|
||||
/**
|
||||
* @psalm-api
|
||||
*
|
||||
* @psalm-return self::COLOR_*
|
||||
*/
|
||||
public function getVariant(): int
|
||||
{
|
||||
return $this->variant;
|
||||
}
|
||||
|
||||
/**
|
||||
* @psalm-param self::COLOR_* $variant
|
||||
*
|
||||
* @psalm-return ?truthy-string
|
||||
*/
|
||||
public function getColor(?int $variant = null): ?string
|
||||
{
|
||||
$variant ??= $this->variant;
|
||||
|
||||
switch ($variant) {
|
||||
case self::COLOR_NAME:
|
||||
$hex = \sprintf('%02x%02x%02x', $this->r, $this->g, $this->b);
|
||||
$hex_alpha = \sprintf('%02x%02x%02x%02x', $this->r, $this->g, $this->b, \round($this->a * 0xFF));
|
||||
|
||||
return \array_search($hex, self::$color_map, true) ?: \array_search($hex_alpha, self::$color_map, true) ?: null;
|
||||
case self::COLOR_HEX_3:
|
||||
if (0 === $this->r % 0x11 && 0 === $this->g % 0x11 && 0 === $this->b % 0x11) {
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf(
|
||||
'#%1X%1X%1X',
|
||||
\round($this->r / 0x11),
|
||||
\round($this->g / 0x11),
|
||||
\round($this->b / 0x11)
|
||||
);
|
||||
}
|
||||
|
||||
return null;
|
||||
case self::COLOR_HEX_6:
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf('#%02X%02X%02X', $this->r, $this->g, $this->b);
|
||||
case self::COLOR_RGB:
|
||||
if (1.0 === $this->a) {
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf('rgb(%d, %d, %d)', $this->r, $this->g, $this->b);
|
||||
}
|
||||
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf('rgb(%d, %d, %d, %s)', $this->r, $this->g, $this->b, \round($this->a, 4));
|
||||
case self::COLOR_RGBA:
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf('rgba(%d, %d, %d, %s)', $this->r, $this->g, $this->b, \round($this->a, 4));
|
||||
case self::COLOR_HSL:
|
||||
$val = self::rgbToHsl($this->r, $this->g, $this->b);
|
||||
$val[1] = \round($val[1] * 100);
|
||||
$val[2] = \round($val[2] * 100);
|
||||
if (1.0 === $this->a) {
|
||||
/** @psalm-var truthy-string */
|
||||
return \vsprintf('hsl(%d, %d%%, %d%%)', $val);
|
||||
}
|
||||
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf('hsl(%d, %d%%, %d%%, %s)', $val[0], $val[1], $val[2], \round($this->a, 4));
|
||||
case self::COLOR_HSLA:
|
||||
$val = self::rgbToHsl($this->r, $this->g, $this->b);
|
||||
$val[1] = \round($val[1] * 100);
|
||||
$val[2] = \round($val[2] * 100);
|
||||
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf('hsla(%d, %d%%, %d%%, %s)', $val[0], $val[1], $val[2], \round($this->a, 4));
|
||||
case self::COLOR_HEX_4:
|
||||
if (0 === $this->r % 0x11 && 0 === $this->g % 0x11 && 0 === $this->b % 0x11 && 0 === ((int) ($this->a * 255)) % 0x11) {
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf(
|
||||
'#%1X%1X%1X%1X',
|
||||
\round($this->r / 0x11),
|
||||
\round($this->g / 0x11),
|
||||
\round($this->b / 0x11),
|
||||
\round($this->a * 0xF)
|
||||
);
|
||||
}
|
||||
|
||||
return null;
|
||||
|
||||
case self::COLOR_HEX_8:
|
||||
/** @psalm-var truthy-string */
|
||||
return \sprintf('#%02X%02X%02X%02X', $this->r, $this->g, $this->b, \round($this->a * 0xFF));
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
public function hasAlpha(?int $variant = null): bool
|
||||
{
|
||||
$variant ??= $this->variant;
|
||||
|
||||
switch ($variant) {
|
||||
case self::COLOR_NAME:
|
||||
case self::COLOR_RGB:
|
||||
case self::COLOR_HSL:
|
||||
return \abs($this->a - 1) >= 0.0001;
|
||||
case self::COLOR_RGBA:
|
||||
case self::COLOR_HSLA:
|
||||
case self::COLOR_HEX_4:
|
||||
case self::COLOR_HEX_8:
|
||||
return true;
|
||||
default:
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
protected function setValues(string $value): void
|
||||
{
|
||||
$this->a = 1.0;
|
||||
|
||||
$value = \strtolower(\trim($value));
|
||||
// Find out which variant of color input it is
|
||||
if (isset(self::$color_map[$value])) {
|
||||
$this->setValuesFromHex(self::$color_map[$value]);
|
||||
$variant = self::COLOR_NAME;
|
||||
} elseif ('#' === $value[0]) {
|
||||
$variant = $this->setValuesFromHex(\substr($value, 1));
|
||||
} else {
|
||||
$variant = $this->setValuesFromFunction($value);
|
||||
}
|
||||
|
||||
// If something has gone horribly wrong
|
||||
if ($this->r > 0xFF || $this->g > 0xFF || $this->b > 0xFF || $this->a > 1) {
|
||||
throw new LogicException('Something has gone wrong with color parsing'); // @codeCoverageIgnore
|
||||
}
|
||||
$this->variant = $variant;
|
||||
}
|
||||
|
||||
/** @psalm-return self::COLOR_* */
|
||||
protected function setValuesFromHex(string $hex): int
|
||||
{
|
||||
if (!\ctype_xdigit($hex)) {
|
||||
throw new InvalidArgumentException('Hex color codes must be hexadecimal');
|
||||
}
|
||||
|
||||
switch (\strlen($hex)) {
|
||||
case 3:
|
||||
$variant = self::COLOR_HEX_3;
|
||||
break;
|
||||
case 6:
|
||||
$variant = self::COLOR_HEX_6;
|
||||
break;
|
||||
case 4:
|
||||
$variant = self::COLOR_HEX_4;
|
||||
break;
|
||||
case 8:
|
||||
$variant = self::COLOR_HEX_8;
|
||||
break;
|
||||
default:
|
||||
throw new InvalidArgumentException('Hex color codes must have 3, 4, 6, or 8 characters');
|
||||
}
|
||||
|
||||
switch ($variant) {
|
||||
case self::COLOR_HEX_4:
|
||||
$this->a = \hexdec($hex[3]) / 0xF;
|
||||
// no break
|
||||
case self::COLOR_HEX_3:
|
||||
$this->r = \hexdec($hex[0]) * 0x11;
|
||||
$this->g = \hexdec($hex[1]) * 0x11;
|
||||
$this->b = \hexdec($hex[2]) * 0x11;
|
||||
break;
|
||||
case self::COLOR_HEX_8:
|
||||
$this->a = \hexdec(\substr($hex, 6, 2)) / 0xFF;
|
||||
// no break
|
||||
case self::COLOR_HEX_6:
|
||||
$hex = \str_split($hex, 2);
|
||||
$this->r = \hexdec($hex[0]);
|
||||
$this->g = \hexdec($hex[1]);
|
||||
$this->b = \hexdec($hex[2]);
|
||||
break;
|
||||
}
|
||||
|
||||
return $variant;
|
||||
}
|
||||
|
||||
/** @psalm-return self::COLOR_* */
|
||||
protected function setValuesFromFunction(string $value): int
|
||||
{
|
||||
if (!\preg_match('/^((?:rgb|hsl)a?)\\s*\\(([0-9\\.%,\\s\\/\\-]+)\\)$/i', $value, $match)) {
|
||||
throw new InvalidArgumentException('Couldn\'t parse color function string');
|
||||
}
|
||||
|
||||
switch (\strtolower($match[1])) {
|
||||
case 'rgb':
|
||||
$variant = self::COLOR_RGB;
|
||||
break;
|
||||
case 'rgba':
|
||||
$variant = self::COLOR_RGBA;
|
||||
break;
|
||||
case 'hsl':
|
||||
$variant = self::COLOR_HSL;
|
||||
break;
|
||||
case 'hsla':
|
||||
$variant = self::COLOR_HSLA;
|
||||
break;
|
||||
default:
|
||||
// The regex should preclude this from ever happening
|
||||
throw new InvalidArgumentException('Color functions must be one of rgb/rgba/hsl/hsla'); // @codeCoverageIgnore
|
||||
}
|
||||
|
||||
$params = \preg_replace('/[,\\s\\/]+/', ',', \trim($match[2]));
|
||||
$params = \explode(',', $params);
|
||||
$params = \array_map('trim', $params);
|
||||
|
||||
if (\count($params) < 3 || \count($params) > 4) {
|
||||
throw new InvalidArgumentException('Color functions must have 3 or 4 arguments');
|
||||
}
|
||||
|
||||
foreach ($params as $i => &$color) {
|
||||
if (false !== \strpos($color, '%')) {
|
||||
$color = (float) \str_replace('%', '', $color);
|
||||
|
||||
if (\in_array($variant, [self::COLOR_RGB, self::COLOR_RGBA], true) && 3 !== $i) {
|
||||
$color = \round($color / 100 * 0xFF);
|
||||
} else {
|
||||
$color = $color / 100;
|
||||
}
|
||||
}
|
||||
|
||||
$color = (float) $color;
|
||||
|
||||
if (0 === $i && \in_array($variant, [self::COLOR_HSL, self::COLOR_HSLA], true)) {
|
||||
$color = \fmod(\fmod($color, 360) + 360, 360);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* @psalm-var non-empty-array<array-key, float> $params
|
||||
* Psalm bug #746 (wontfix)
|
||||
*/
|
||||
switch ($variant) {
|
||||
case self::COLOR_RGBA:
|
||||
case self::COLOR_RGB:
|
||||
if (\min($params) < 0 || \max($params) > 0xFF) {
|
||||
throw new InvalidArgumentException('RGB function arguments must be between 0 and 255');
|
||||
}
|
||||
break;
|
||||
case self::COLOR_HSLA:
|
||||
case self::COLOR_HSL:
|
||||
if ($params[0] < 0 || $params[0] > 360) {
|
||||
// Should be impossible because of the fmod work
|
||||
throw new InvalidArgumentException('Hue must be between 0 and 360'); // @codeCoverageIgnore
|
||||
}
|
||||
if (\min($params) < 0 || \max($params[1], $params[2]) > 1) {
|
||||
throw new InvalidArgumentException('Saturation/lightness must be between 0 and 1');
|
||||
}
|
||||
break;
|
||||
}
|
||||
|
||||
if (4 === \count($params)) {
|
||||
if ($params[3] > 1) {
|
||||
throw new InvalidArgumentException('Alpha must be between 0 and 1');
|
||||
}
|
||||
|
||||
$this->a = $params[3];
|
||||
}
|
||||
|
||||
if (self::COLOR_HSLA === $variant || self::COLOR_HSL === $variant) {
|
||||
$params = self::hslToRgb($params[0], $params[1], $params[2]);
|
||||
}
|
||||
|
||||
[$this->r, $this->g, $this->b] = [(int) $params[0], (int) $params[1], (int) $params[2]];
|
||||
|
||||
return $variant;
|
||||
}
|
||||
|
||||
/**
|
||||
* Turns HSL color to RGB. Black magic.
|
||||
*
|
||||
* @param float $h Hue
|
||||
* @param float $s Saturation
|
||||
* @param float $l Lightness
|
||||
*
|
||||
* @return int[] RGB array
|
||||
*/
|
||||
public static function hslToRgb(float $h, float $s, float $l): array
|
||||
{
|
||||
if (\min($h, $s, $l) < 0) {
|
||||
throw new InvalidArgumentException('The parameters for hslToRgb should be no less than 0');
|
||||
}
|
||||
|
||||
if ($h > 360 || \max($s, $l) > 1) {
|
||||
throw new InvalidArgumentException('The parameters for hslToRgb should be no more than 360, 1, and 1 respectively');
|
||||
}
|
||||
|
||||
$h /= 360;
|
||||
|
||||
$m2 = ($l <= 0.5) ? $l * ($s + 1) : $l + $s - $l * $s;
|
||||
$m1 = $l * 2 - $m2;
|
||||
|
||||
return [
|
||||
(int) \round(self::hueToRgb($m1, $m2, $h + 1 / 3) * 0xFF),
|
||||
(int) \round(self::hueToRgb($m1, $m2, $h) * 0xFF),
|
||||
(int) \round(self::hueToRgb($m1, $m2, $h - 1 / 3) * 0xFF),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Converts RGB to HSL. Color inversion of previous black magic is white magic?
|
||||
*
|
||||
* @param float $red Red
|
||||
* @param float $green Green
|
||||
* @param float $blue Blue
|
||||
*
|
||||
* @return float[] HSL array
|
||||
*/
|
||||
public static function rgbToHsl(float $red, float $green, float $blue): array
|
||||
{
|
||||
if (\min($red, $green, $blue) < 0) {
|
||||
throw new InvalidArgumentException('The parameters for rgbToHsl should be no less than 0');
|
||||
}
|
||||
|
||||
if (\max($red, $green, $blue) > 0xFF) {
|
||||
throw new InvalidArgumentException('The parameters for rgbToHsl should be no more than 255');
|
||||
}
|
||||
|
||||
$clrMin = \min($red, $green, $blue);
|
||||
$clrMax = \max($red, $green, $blue);
|
||||
$deltaMax = $clrMax - $clrMin;
|
||||
|
||||
$L = ($clrMax + $clrMin) / 510;
|
||||
|
||||
if (0 == $deltaMax) {
|
||||
$H = 0.0;
|
||||
$S = 0.0;
|
||||
} else {
|
||||
if (0.5 > $L) {
|
||||
$S = $deltaMax / ($clrMax + $clrMin);
|
||||
} else {
|
||||
$S = $deltaMax / (510 - $clrMax - $clrMin);
|
||||
}
|
||||
|
||||
if ($clrMax === $red) {
|
||||
$H = ($green - $blue) / (6.0 * $deltaMax);
|
||||
|
||||
if (0 > $H) {
|
||||
$H += 1.0;
|
||||
}
|
||||
} elseif ($clrMax === $green) {
|
||||
$H = 1 / 3 + ($blue - $red) / (6.0 * $deltaMax);
|
||||
} else {
|
||||
$H = 2 / 3 + ($red - $green) / (6.0 * $deltaMax);
|
||||
}
|
||||
}
|
||||
|
||||
return [
|
||||
\fmod($H * 360, 360),
|
||||
$S,
|
||||
$L,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Helper function for hslToRgb. Even blacker magic.
|
||||
*
|
||||
* @return float Color value
|
||||
*/
|
||||
private static function hueToRgb(float $m1, float $m2, float $hue): float
|
||||
{
|
||||
$hue = ($hue < 0) ? $hue + 1 : (($hue > 1) ? $hue - 1 : $hue);
|
||||
if ($hue * 6 < 1) {
|
||||
return $m1 + ($m2 - $m1) * $hue * 6;
|
||||
}
|
||||
if ($hue * 2 < 1) {
|
||||
return $m2;
|
||||
}
|
||||
if ($hue * 3 < 2) {
|
||||
return $m1 + ($m2 - $m1) * (2 / 3 - $hue) * 6;
|
||||
}
|
||||
|
||||
return $m1;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use InvalidArgumentException;
|
||||
use Kint\Value\AbstractValue;
|
||||
|
||||
class ContainerRepresentation extends AbstractRepresentation
|
||||
{
|
||||
/**
|
||||
* @psalm-readonly
|
||||
*
|
||||
* @psalm-var non-empty-array<AbstractValue>
|
||||
*/
|
||||
protected array $contents;
|
||||
|
||||
/** @psalm-param non-empty-array<AbstractValue> $contents */
|
||||
public function __construct(string $label, array $contents, ?string $name = null, bool $implicit_label = false)
|
||||
{
|
||||
if ([] === $contents) {
|
||||
throw new InvalidArgumentException("ContainerRepresentation can't take empty list");
|
||||
}
|
||||
|
||||
parent::__construct($label, $name, $implicit_label);
|
||||
$this->contents = $contents;
|
||||
}
|
||||
|
||||
/** @psalm-return non-empty-array<AbstractValue> */
|
||||
public function getContents(): array
|
||||
{
|
||||
return $this->contents;
|
||||
}
|
||||
|
||||
public function getLabel(): string
|
||||
{
|
||||
return parent::getLabel().' ('.\count($this->contents).')';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,125 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use DateTimeImmutable;
|
||||
use DateTimeInterface;
|
||||
|
||||
class MicrotimeRepresentation extends AbstractRepresentation
|
||||
{
|
||||
/** @psalm-readonly */
|
||||
protected int $seconds;
|
||||
/** @psalm-readonly */
|
||||
protected int $microseconds;
|
||||
/** @psalm-readonly */
|
||||
protected string $group;
|
||||
/** @psalm-readonly */
|
||||
protected ?float $lap_time;
|
||||
/** @psalm-readonly */
|
||||
protected ?float $total_time;
|
||||
protected ?float $avg_time = null;
|
||||
/** @psalm-readonly */
|
||||
protected int $mem;
|
||||
/** @psalm-readonly */
|
||||
protected int $mem_real;
|
||||
/** @psalm-readonly */
|
||||
protected int $mem_peak;
|
||||
/** @psalm-readonly */
|
||||
protected int $mem_peak_real;
|
||||
|
||||
public function __construct(int $seconds, int $microseconds, string $group, ?float $lap_time = null, ?float $total_time = null, int $i = 0)
|
||||
{
|
||||
parent::__construct('Microtime', null, true);
|
||||
|
||||
$this->seconds = $seconds;
|
||||
$this->microseconds = $microseconds;
|
||||
|
||||
$this->group = $group;
|
||||
$this->lap_time = $lap_time;
|
||||
$this->total_time = $total_time;
|
||||
|
||||
if ($i > 0) {
|
||||
$this->avg_time = $total_time / $i;
|
||||
}
|
||||
|
||||
$this->mem = \memory_get_usage();
|
||||
$this->mem_real = \memory_get_usage(true);
|
||||
$this->mem_peak = \memory_get_peak_usage();
|
||||
$this->mem_peak_real = \memory_get_peak_usage(true);
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'microtime';
|
||||
}
|
||||
|
||||
public function getGroup(): string
|
||||
{
|
||||
return $this->group;
|
||||
}
|
||||
|
||||
public function getLapTime(): ?float
|
||||
{
|
||||
return $this->lap_time;
|
||||
}
|
||||
|
||||
public function getTotalTime(): ?float
|
||||
{
|
||||
return $this->total_time;
|
||||
}
|
||||
|
||||
public function getAverageTime(): ?float
|
||||
{
|
||||
return $this->avg_time;
|
||||
}
|
||||
|
||||
public function getMemoryUsage(): int
|
||||
{
|
||||
return $this->mem;
|
||||
}
|
||||
|
||||
public function getMemoryUsageReal(): int
|
||||
{
|
||||
return $this->mem_real;
|
||||
}
|
||||
|
||||
public function getMemoryPeakUsage(): int
|
||||
{
|
||||
return $this->mem_peak;
|
||||
}
|
||||
|
||||
public function getMemoryPeakUsageReal(): int
|
||||
{
|
||||
return $this->mem_peak_real;
|
||||
}
|
||||
|
||||
public function getDateTime(): ?DateTimeInterface
|
||||
{
|
||||
return DateTimeImmutable::createFromFormat('U u', $this->seconds.' '.\str_pad((string) $this->microseconds, 6, '0', STR_PAD_LEFT)) ?: null;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
class ProfileRepresentation extends AbstractRepresentation
|
||||
{
|
||||
/** @psalm-readonly */
|
||||
public int $complexity;
|
||||
public ?int $instance_counts = null;
|
||||
public ?int $instance_complexity = null;
|
||||
|
||||
public function __construct(int $complexity)
|
||||
{
|
||||
parent::__construct('Performance profile', 'profiling', false);
|
||||
$this->complexity = $complexity;
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'profiling';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
interface RepresentationInterface
|
||||
{
|
||||
public function getLabel(): string;
|
||||
|
||||
public function getName(): string;
|
||||
|
||||
public function getHint(): ?string;
|
||||
|
||||
public function labelIsImplicit(): bool;
|
||||
}
|
||||
@@ -0,0 +1,121 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use RuntimeException;
|
||||
|
||||
class SourceRepresentation extends AbstractRepresentation
|
||||
{
|
||||
private const DEFAULT_PADDING = 7;
|
||||
|
||||
/**
|
||||
* @psalm-readonly
|
||||
*
|
||||
* @psalm-var non-empty-array<string>
|
||||
*/
|
||||
protected array $source;
|
||||
/** @psalm-readonly */
|
||||
protected string $filename;
|
||||
/** @psalm-readonly */
|
||||
protected int $line;
|
||||
/** @psalm-readonly */
|
||||
protected bool $showfilename;
|
||||
|
||||
public function __construct(string $filename, int $line, ?int $padding = self::DEFAULT_PADDING, bool $showfilename = false)
|
||||
{
|
||||
parent::__construct('Source');
|
||||
|
||||
$this->filename = $filename;
|
||||
$this->line = $line;
|
||||
$this->showfilename = $showfilename;
|
||||
|
||||
$padding ??= self::DEFAULT_PADDING;
|
||||
|
||||
$start_line = \max($line - $padding, 1);
|
||||
$length = $line + $padding + 1 - $start_line;
|
||||
$this->source = self::readSource($filename, $start_line, $length);
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'source';
|
||||
}
|
||||
|
||||
/**
|
||||
* @psalm-api
|
||||
*
|
||||
* @psalm-return non-empty-string
|
||||
*/
|
||||
public function getSourceSlice(): string
|
||||
{
|
||||
return \implode("\n", $this->source);
|
||||
}
|
||||
|
||||
/** @psalm-return non-empty-array<string> */
|
||||
public function getSourceLines(): array
|
||||
{
|
||||
return $this->source;
|
||||
}
|
||||
|
||||
public function getFileName(): string
|
||||
{
|
||||
return $this->filename;
|
||||
}
|
||||
|
||||
public function getLine(): int
|
||||
{
|
||||
return $this->line;
|
||||
}
|
||||
|
||||
public function showFileName(): bool
|
||||
{
|
||||
return $this->showfilename;
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets section of source code.
|
||||
*
|
||||
* @psalm-return non-empty-array<string>
|
||||
*/
|
||||
private static function readSource(string $filename, int $start_line = 1, ?int $length = null): array
|
||||
{
|
||||
if (!$filename || !\file_exists($filename) || !\is_readable($filename)) {
|
||||
throw new RuntimeException("Couldn't read file");
|
||||
}
|
||||
|
||||
$source = \preg_split("/\r\n|\n|\r/", \file_get_contents($filename));
|
||||
$source = \array_combine(\range(1, \count($source)), $source);
|
||||
$source = \array_slice($source, $start_line - 1, $length, true);
|
||||
|
||||
if (0 === \count($source)) {
|
||||
throw new RuntimeException('File seemed to be empty');
|
||||
}
|
||||
|
||||
return $source;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,180 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use Kint\Utils;
|
||||
use RuntimeException;
|
||||
use SplFileInfo;
|
||||
|
||||
class SplFileInfoRepresentation extends StringRepresentation
|
||||
{
|
||||
public function __construct(SplFileInfo $fileInfo)
|
||||
{
|
||||
$path = $fileInfo->getPathname();
|
||||
|
||||
$perms = 0;
|
||||
$owner = null;
|
||||
$group = null;
|
||||
$mtime = null;
|
||||
$realpath = null;
|
||||
$linktarget = null;
|
||||
$size = null;
|
||||
$is_file = false;
|
||||
$is_dir = false;
|
||||
$is_link = false;
|
||||
$typename = 'Unknown file';
|
||||
|
||||
try {
|
||||
// SplFileInfo::getRealPath will return cwd when path is ''
|
||||
if ('' !== $path && $fileInfo->getRealPath()) {
|
||||
$perms = $fileInfo->getPerms();
|
||||
$size = $fileInfo->getSize();
|
||||
$owner = $fileInfo->getOwner();
|
||||
$group = $fileInfo->getGroup();
|
||||
$mtime = $fileInfo->getMTime();
|
||||
$realpath = $fileInfo->getRealPath();
|
||||
}
|
||||
|
||||
$is_dir = $fileInfo->isDir();
|
||||
$is_file = $fileInfo->isFile();
|
||||
$is_link = $fileInfo->isLink();
|
||||
|
||||
if ($is_link) {
|
||||
$lt = $fileInfo->getLinkTarget();
|
||||
$linktarget = false === $lt ? null : $lt;
|
||||
}
|
||||
} catch (RuntimeException $e) {
|
||||
if (false === \strpos($e->getMessage(), ' open_basedir ')) {
|
||||
throw $e; // @codeCoverageIgnore
|
||||
}
|
||||
}
|
||||
|
||||
$typeflag = '-';
|
||||
|
||||
switch ($perms & 0xF000) {
|
||||
case 0xC000:
|
||||
$typename = 'Socket';
|
||||
$typeflag = 's';
|
||||
break;
|
||||
case 0x6000:
|
||||
$typename = 'Block device';
|
||||
$typeflag = 'b';
|
||||
break;
|
||||
case 0x2000:
|
||||
$typename = 'Character device';
|
||||
$typeflag = 'c';
|
||||
break;
|
||||
case 0x1000:
|
||||
$typename = 'Named pipe';
|
||||
$typeflag = 'p';
|
||||
break;
|
||||
default:
|
||||
if ($is_file) {
|
||||
if ($is_link) {
|
||||
$typename = 'File symlink';
|
||||
$typeflag = 'l';
|
||||
} else {
|
||||
$typename = 'File';
|
||||
$typeflag = '-';
|
||||
}
|
||||
} elseif ($is_dir) {
|
||||
if ($is_link) {
|
||||
$typename = 'Directory symlink';
|
||||
$typeflag = 'l';
|
||||
} else {
|
||||
$typename = 'Directory';
|
||||
$typeflag = 'd';
|
||||
}
|
||||
}
|
||||
break;
|
||||
}
|
||||
|
||||
$flags = [$typeflag];
|
||||
|
||||
// User
|
||||
$flags[] = (($perms & 0400) ? 'r' : '-');
|
||||
$flags[] = (($perms & 0200) ? 'w' : '-');
|
||||
if ($perms & 0100) {
|
||||
$flags[] = ($perms & 04000) ? 's' : 'x';
|
||||
} else {
|
||||
$flags[] = ($perms & 04000) ? 'S' : '-';
|
||||
}
|
||||
|
||||
// Group
|
||||
$flags[] = (($perms & 0040) ? 'r' : '-');
|
||||
$flags[] = (($perms & 0020) ? 'w' : '-');
|
||||
if ($perms & 0010) {
|
||||
$flags[] = ($perms & 02000) ? 's' : 'x';
|
||||
} else {
|
||||
$flags[] = ($perms & 02000) ? 'S' : '-';
|
||||
}
|
||||
|
||||
// Other
|
||||
$flags[] = (($perms & 0004) ? 'r' : '-');
|
||||
$flags[] = (($perms & 0002) ? 'w' : '-');
|
||||
if ($perms & 0001) {
|
||||
$flags[] = ($perms & 01000) ? 's' : 'x';
|
||||
} else {
|
||||
$flags[] = ($perms & 01000) ? 'S' : '-';
|
||||
}
|
||||
|
||||
$contents = \implode($flags).' '.$owner.' '.$group.' '.$size.' ';
|
||||
|
||||
if (null !== $mtime) {
|
||||
if (\date('Y', $mtime) === \date('Y')) {
|
||||
$contents .= \date('M d H:i', $mtime);
|
||||
} else {
|
||||
$contents .= \date('M d Y', $mtime);
|
||||
}
|
||||
}
|
||||
|
||||
$contents .= ' ';
|
||||
|
||||
if ($is_link && null !== $linktarget) {
|
||||
$contents .= $path.' -> '.$linktarget;
|
||||
} elseif (null !== $realpath && \strlen($realpath) < \strlen($path)) {
|
||||
$contents .= $realpath;
|
||||
} else {
|
||||
$contents .= $path;
|
||||
}
|
||||
|
||||
$label = $typename;
|
||||
|
||||
if (null !== $size && $is_file) {
|
||||
$size = Utils::getHumanReadableBytes($size);
|
||||
$label .= ' ('.$size['value'].$size['unit'].')';
|
||||
}
|
||||
|
||||
parent::__construct($label, $contents, 'splfileinfo');
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'splfileinfo';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,57 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use InvalidArgumentException;
|
||||
|
||||
class StringRepresentation extends AbstractRepresentation
|
||||
{
|
||||
/**
|
||||
* @psalm-readonly
|
||||
*
|
||||
* @psalm-var non-empty-string
|
||||
*/
|
||||
protected string $value;
|
||||
|
||||
/** @psalm-assert non-empty-string $value */
|
||||
public function __construct(string $label, string $value, ?string $name = null, bool $implicit = false)
|
||||
{
|
||||
if ('' === $value) {
|
||||
throw new InvalidArgumentException("StringRepresentation can't take empty string");
|
||||
}
|
||||
|
||||
parent::__construct($label, $name, $implicit);
|
||||
$this->value = $value;
|
||||
}
|
||||
|
||||
/** @psalm-return non-empty-string */
|
||||
public function getValue(): string
|
||||
{
|
||||
return $this->value;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,44 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use Kint\Value\AbstractValue;
|
||||
|
||||
class TableRepresentation extends ContainerRepresentation
|
||||
{
|
||||
/** @psalm-param non-empty-array<AbstractValue> $contents */
|
||||
public function __construct(array $contents, ?string $name = null)
|
||||
{
|
||||
parent::__construct('Table', $contents, $name, false);
|
||||
}
|
||||
|
||||
public function getHint(): string
|
||||
{
|
||||
return 'table';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Copyright (c) 2013 Jonathan Vollebregt (jnvsor@gmail.com), Rokas Šleinius (raveren@gmail.com)
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
namespace Kint\Value\Representation;
|
||||
|
||||
use Kint\Value\AbstractValue;
|
||||
|
||||
class ValueRepresentation extends AbstractRepresentation
|
||||
{
|
||||
/** @psalm-readonly */
|
||||
protected AbstractValue $value;
|
||||
|
||||
public function __construct(string $label, AbstractValue $value, ?string $name = null, bool $implicit_label = false)
|
||||
{
|
||||
parent::__construct($label, $name, $implicit_label);
|
||||
$this->value = $value;
|
||||
}
|
||||
|
||||
public function getValue(): AbstractValue
|
||||
{
|
||||
return $this->value;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user