12294614489

Committed 12 Dec 2024 10:35AM UTC coverage: 38.583%. Remained the same

Build # 12294614489

Build Type

Pull #777

github

Committed by

web-flow

Commit Message

Merge 01c6f866e into 428a2ebc8

Pull Request Pull Request #777: [TASK] Upgrade to PHPStan 2.x and Rector 2.x

Run Details

0 of 4 new or added lines in 1 file covered. (0.0%)

779 of 2019 relevant lines covered (38.58%)

5.33 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

16.28

/src/CSSList/Document.php

<?php

declare(strict_types=1);

namespace Sabberworm\CSS\CSSList;

use Sabberworm\CSS\OutputFormat;
use Sabberworm\CSS\Parsing\ParserState;
use Sabberworm\CSS\Parsing\SourceException;
use Sabberworm\CSS\Property\Selector;
use Sabberworm\CSS\RuleSet\DeclarationBlock;
use Sabberworm\CSS\RuleSet\RuleSet;
use Sabberworm\CSS\Value\Value;

/**
 * This class represents the root of a parsed CSS file. It contains all top-level CSS contents: mostly declaration
 * blocks, but also any at-rules encountered (`Import` and `Charset`).
 */
class Document extends CSSBlockList
{
    /**
     * @param int $iLineNo
     */
    public function __construct($iLineNo = 0)
    {
        parent::__construct($iLineNo);
    }

    /**
     * @throws SourceException
     */
    public static function parse(ParserState $oParserState): Document
    {
        $oDocument = new Document($oParserState->currentLine());
        CSSList::parseList($oParserState, $oDocument);
        return $oDocument;
    }

    /**
     * Gets all `DeclarationBlock` objects recursively, no matter how deeply nested the selectors are.
     * Aliased as `getAllSelectors()`.
     *
     * @return array<int, DeclarationBlock>
     */
    public function getAllDeclarationBlocks(): array
    {
        /** @var array<int, DeclarationBlock> $aResult */
        $aResult = [];
        $this->allDeclarationBlocks($aResult);
        return $aResult;
    }

    /**
     * Returns all `RuleSet` objects recursively found in the tree, no matter how deeply nested the rule sets are.
     *
     * @return array<int, RuleSet>
     */
    public function getAllRuleSets(): array
    {
        /** @var array<int, RuleSet> $aResult */
        $aResult = [];
        $this->allRuleSets($aResult);
        return $aResult;
    }

    /**
     * Returns all `Value` objects found recursively in `Rule`s in the tree.
     *
     * @param CSSList|RuleSet|string $mElement
     *        the `CSSList` or `RuleSet` to start the search from (defaults to the whole document).
     *        If a string is given, it is used as rule name filter.
     * @param bool $bSearchInFunctionArguments whether to also return Value objects used as Function arguments.
     *
     * @return array<int, Value>
     *
     * @see RuleSet->getRules()
     */
    public function getAllValues($mElement = null, $bSearchInFunctionArguments = false): array
    {
        $sSearchString = null;
        if ($mElement === null) {
            $mElement = $this;
        } elseif (\is_string($mElement)) {
            $sSearchString = $mElement;
            $mElement = $this;
        }
        /** @var array<int, Value> $aResult */
        $aResult = [];
        $this->allValues($mElement, $aResult, $sSearchString, $bSearchInFunctionArguments);
        return $aResult;
    }

    /**
     * Returns all `Selector` objects with the requested specificity found recursively in the tree.
     *
     * Note that this does not yield the full `DeclarationBlock` that the selector belongs to
     * (and, currently, there is no way to get to that).
     *
     * @param string|null $sSpecificitySearch
     *        An optional filter by specificity.
     *        May contain a comparison operator and a number or just a number (defaults to "==").
     *
     * @return array<int, Selector>
     * @example `getSelectorsBySpecificity('>= 100')`
     */
    public function getSelectorsBySpecificity($sSpecificitySearch = null): array
    {
        /** @var array<int, Selector> $aResult */
        $aResult = [];
        $this->allSelectors($aResult, $sSpecificitySearch);
        return $aResult;
    }

    /**
     * Expands all shorthand properties to their long value.
     *
     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
     */
    public function expandShorthands(): void
    {
        foreach ($this->getAllDeclarationBlocks() as $oDeclaration) {
            $oDeclaration->expandShorthands();
        }
    }

    /**
     * Create shorthands properties whenever possible.
     *
     * @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
     */
    public function createShorthands(): void
    {
        foreach ($this->getAllDeclarationBlocks() as $oDeclaration) {
            $oDeclaration->createShorthands();
        }
    }

    /**
     * Overrides `render()` to make format argument optional.
     *
     * @param OutputFormat|null $oOutputFormat
     */
    public function render(?OutputFormat $oOutputFormat = null): string
    {
        if ($oOutputFormat === null) {
            $oOutputFormat = new OutputFormat();
        }
        return $oOutputFormat->comments($this) . $this->renderListContents($oOutputFormat);
    }

    public function isRootList(): bool
    {
        return true;
    }
}

1	<?php
2
3	declare(strict_types=1);
4
5	namespace Sabberworm\CSS\CSSList;
6
7	use Sabberworm\CSS\OutputFormat;
8	use Sabberworm\CSS\Parsing\ParserState;
9	use Sabberworm\CSS\Parsing\SourceException;
10	use Sabberworm\CSS\Property\Selector;
11	use Sabberworm\CSS\RuleSet\DeclarationBlock;
12	use Sabberworm\CSS\RuleSet\RuleSet;
13	use Sabberworm\CSS\Value\Value;
14
15	/**
16	* This class represents the root of a parsed CSS file. It contains all top-level CSS contents: mostly declaration
17	* blocks, but also any at-rules encountered (`Import` and `Charset`).
18	*/
19	class Document extends CSSBlockList
20	{
21	/**
22	* @param int $iLineNo
23	*/
24	public function __construct($iLineNo = 0)	9✔
25	{
26	parent::__construct($iLineNo);	9✔
27	}	9✔
28
29	/**
30	* @throws SourceException
31	*/
32	public static function parse(ParserState $oParserState): Document	68✔
33	{
34	$oDocument = new Document($oParserState->currentLine());	68✔
35	CSSList::parseList($oParserState, $oDocument);	68✔
36	return $oDocument;	55✔
37	}
38
39	/**
40	* Gets all `DeclarationBlock` objects recursively, no matter how deeply nested the selectors are.
41	* Aliased as `getAllSelectors()`.
42	*
43	* @return array<int, DeclarationBlock>
44	*/
NEW 45	public function getAllDeclarationBlocks(): array	×
46	{
47	/** @var array<int, DeclarationBlock> $aResult */
48	$aResult = [];	×
49	$this->allDeclarationBlocks($aResult);	×
50	return $aResult;	×
51	}
52
53	/**
54	* Returns all `RuleSet` objects recursively found in the tree, no matter how deeply nested the rule sets are.
55	*
56	* @return array<int, RuleSet>
57	*/
NEW 58	public function getAllRuleSets(): array	×
59	{
60	/** @var array<int, RuleSet> $aResult */
61	$aResult = [];	×
62	$this->allRuleSets($aResult);	×
63	return $aResult;	×
64	}
65
66	/**
67	* Returns all `Value` objects found recursively in `Rule`s in the tree.
68	*
69	* @param CSSList\|RuleSet\|string $mElement
70	* the `CSSList` or `RuleSet` to start the search from (defaults to the whole document).
71	* If a string is given, it is used as rule name filter.
72	* @param bool $bSearchInFunctionArguments whether to also return Value objects used as Function arguments.
73	*
74	* @return array<int, Value>
75	*
76	* @see RuleSet->getRules()
77	*/
NEW 78	public function getAllValues($mElement = null, $bSearchInFunctionArguments = false): array	×
79	{
80	$sSearchString = null;	×
81	if ($mElement === null) {	×
82	$mElement = $this;	×
83	} elseif (\is_string($mElement)) {	×
84	$sSearchString = $mElement;	×
85	$mElement = $this;	×
86	}
87	/** @var array<int, Value> $aResult */
88	$aResult = [];	×
89	$this->allValues($mElement, $aResult, $sSearchString, $bSearchInFunctionArguments);	×
90	return $aResult;	×
91	}
92
93	/**
94	* Returns all `Selector` objects with the requested specificity found recursively in the tree.
95	*
96	* Note that this does not yield the full `DeclarationBlock` that the selector belongs to
97	* (and, currently, there is no way to get to that).
98	*
99	* @param string\|null $sSpecificitySearch
100	* An optional filter by specificity.
101	* May contain a comparison operator and a number or just a number (defaults to "==").
102	*
103	* @return array<int, Selector>
104	* @example `getSelectorsBySpecificity('>= 100')`
105	*/
NEW 106	public function getSelectorsBySpecificity($sSpecificitySearch = null): array	×
107	{
108	/** @var array<int, Selector> $aResult */
109	$aResult = [];	×
110	$this->allSelectors($aResult, $sSpecificitySearch);	×
111	return $aResult;	×
112	}
113
114	/**
115	* Expands all shorthand properties to their long value.
116	*
117	* @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
118	*/
119	public function expandShorthands(): void	×
120	{
121	foreach ($this->getAllDeclarationBlocks() as $oDeclaration) {	×
122	$oDeclaration->expandShorthands();	×
123	}
124	}	×
125
126	/**
127	* Create shorthands properties whenever possible.
128	*
129	* @deprecated since 8.7.0, will be removed without substitution in version 9.0 in #511
130	*/
131	public function createShorthands(): void	×
132	{
133	foreach ($this->getAllDeclarationBlocks() as $oDeclaration) {	×
134	$oDeclaration->createShorthands();	×
135	}
136	}	×
137
138	/**
139	* Overrides `render()` to make format argument optional.
140	*
141	* @param OutputFormat\|null $oOutputFormat
142	*/
143	public function render(?OutputFormat $oOutputFormat = null): string	×
144	{
145	if ($oOutputFormat === null) {	×
146	$oOutputFormat = new OutputFormat();	×
147	}
148	return $oOutputFormat->comments($this) . $this->renderListContents($oOutputFormat);	×
149	}
150
151	public function isRootList(): bool	×
152	{
153	return true;	×
154	}
155	}

MyIntervals / PHP-CSS-Parser / 12294614489

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous