Code Coverage |
||||||||||
Classes and Traits |
Functions and Methods |
Lines |
||||||||
| Total | |
100.00% |
1 / 1 |
|
100.00% |
4 / 4 |
CRAP | |
100.00% |
49 / 49 |
| Util | |
100.00% |
1 / 1 |
|
100.00% |
4 / 4 |
26 | |
100.00% |
49 / 49 |
| assertAllInstanceOf | |
100.00% |
1 / 1 |
4 | |
100.00% |
7 / 7 |
|||
| assertAllTokensOfType | |
100.00% |
1 / 1 |
5 | |
100.00% |
11 / 11 |
|||
| findFirstNonWhitespace | |
100.00% |
1 / 1 |
6 | |
100.00% |
6 / 6 |
|||
| stringify | |
100.00% |
1 / 1 |
11 | |
100.00% |
25 / 25 |
|||
| <?php | |
| /** | |
| * @file | |
| * @license https://opensource.org/licenses/Apache-2.0 Apache-2.0 | |
| */ | |
| namespace Wikimedia\CSS; | |
| use InvalidArgumentException; | |
| use Wikimedia\CSS\Objects\ComponentValue; | |
| use Wikimedia\CSS\Objects\ComponentValueList; | |
| use Wikimedia\CSS\Objects\CSSObject; | |
| use Wikimedia\CSS\Objects\Token; | |
| use Wikimedia\CSS\Objects\TokenList; | |
| /** | |
| * Static utility functions | |
| */ | |
| class Util { | |
| /** | |
| * Check that all elements in an array implement a particular class | |
| * @param array $array | |
| * @param string $class | |
| * @param string $what Describe the array being checked | |
| * @throws InvalidArgumentException | |
| */ | |
| public static function assertAllInstanceOf( array $array, $class, $what ) { | |
| foreach ( $array as $k => $v ) { | |
| if ( !$v instanceof $class ) { | |
| $vtype = is_object( $v ) ? get_class( $v ) : gettype( $v ); | |
| throw new InvalidArgumentException( | |
| "$what may only contain instances of $class" . | |
| " (found $vtype at index $k)" | |
| ); | |
| } | |
| } | |
| } | |
| /** | |
| * Check that a set of tokens are all the same type | |
| * @param Token[] $array | |
| * @param string $type | |
| * @param string $what Describe the array being checked | |
| * @throws InvalidArgumentException | |
| */ | |
| public static function assertAllTokensOfType( array $array, $type, $what ) { | |
| foreach ( $array as $k => $v ) { | |
| if ( !$v instanceof Token ) { | |
| $vtype = is_object( $v ) ? get_class( $v ) : gettype( $v ); | |
| throw new InvalidArgumentException( | |
| "$what may only contain instances of " . Token::class . | |
| " (found $vtype at index $k)" | |
| ); | |
| } | |
| if ( $v->type() !== $type ) { | |
| throw new InvalidArgumentException( | |
| "$what may only contain \"$type\" tokens" . | |
| " (found \"{$v->type()}\" at index $k)" | |
| ); | |
| } | |
| } | |
| } | |
| /** | |
| * Find the first non-whitespace ComponentValue in a list | |
| * @param TokenList|ComponentValueList $list | |
| * @return ComponentValue|null | |
| */ | |
| public static function findFirstNonWhitespace( $list ) { | |
| if ( !$list instanceof TokenList && !$list instanceof ComponentValueList ) { | |
| throw new InvalidArgumentException( 'List must be TokenList or ComponentValueList' ); | |
| } | |
| foreach ( $list as $v ) { | |
| if ( !$v instanceof Token || $v->type() !== Token::T_WHITESPACE ) { | |
| return $v; | |
| } | |
| } | |
| return null; | |
| } | |
| /** | |
| * Turn a CSSObject into a string | |
| * @param CSSObject|CSSObject[] $object | |
| * @param array $options Serialziation options: | |
| * - minify: (bool) Skip comments and insignificant tokens | |
| * @return string | |
| */ | |
| public static function stringify( $object, $options = [] ) { | |
| if ( is_array( $object ) ) { | |
| $tokens = array_reduce( $object, static function ( array $carry, CSSObject $item ) { | |
| return array_merge( $carry, $item->toTokenArray() ); | |
| }, [] ); | |
| } else { | |
| $tokens = $object->toTokenArray(); | |
| } | |
| if ( !$tokens ) { | |
| return ''; | |
| } | |
| if ( !empty( $options['minify'] ) ) { | |
| // Last second check for significant whitespace | |
| $e = count( $tokens ) - 1; | |
| for ( $i = 1; $i < $e; $i++ ) { | |
| $t = $tokens[$i]; | |
| if ( $t->type() === Token::T_WHITESPACE && !$t->significant() && | |
| Token::separate( $tokens[$i - 1], $tokens[$i + 1] ) | |
| ) { | |
| $tokens[$i] = $t->copyWithSignificance( true ); | |
| } | |
| } | |
| // Filter! | |
| $tokens = array_filter( $tokens, static function ( $t ) { | |
| return $t->significant(); | |
| } ); | |
| } | |
| $prev = reset( $tokens ); | |
| $ret = (string)$prev; | |
| $urangeHack = 0; | |
| while ( ( $token = next( $tokens ) ) !== false ) { | |
| // Avoid serializing tokens that are part of a <urange> with extraneous comments | |
| // by checking for a hack-flag in the type. | |
| // @see Wikimedia\CSS\Matcher\UrangeMatcher | |
| $urangeHack = max( $urangeHack, $prev->urangeHack() ); | |
| if ( --$urangeHack <= 0 && Token::separate( $prev, $token ) ) { | |
| // Per https://www.w3.org/TR/2019/CR-css-syntax-3-20190716/#serialization | |
| $ret .= '/**/'; | |
| } | |
| $ret .= (string)$token; | |
| $prev = $token; | |
| } | |
| return $ret; | |
| } | |
| } |