<?php

use cli\Colors;

use WP_CLI\Tests\TestCase;

class Test_Cli extends TestCase {

function set_up() {

// Reset enable state

\cli\Colors::enable( null );

// Empty the cache

\cli\Colors::clearStringCache();

}

function test_string_length() {

$this->assertEquals( \cli\Colors::length( 'x' ), 1 );

$this->assertEquals( \cli\Colors::length( '日' ), 1 );

}

function test_string_width() {

$this->assertEquals( \cli\Colors::width( 'x' ), 1 );

$this->assertEquals( \cli\Colors::width( '日' ), 2 ); // Double-width char.

}

function test_encoded_string_length() {

$this->assertEquals( \cli\Colors::length( 'hello' ), 5 );

$this->assertEquals( \cli\Colors::length( 'óra' ), 3 );

$this->assertEquals( \cli\Colors::length( '日本語' ), 3 );

}

function test_encoded_string_width() {

$this->assertEquals( \cli\Colors::width( 'hello' ), 5 );

$this->assertEquals( \cli\Colors::width( 'óra' ), 3 );

$this->assertEquals( \cli\Colors::width( '日本語' ), 6 ); // 3 double-width chars.

}

function test_encoded_string_pad() {

$this->assertEquals( 6, strlen( \cli\Colors::pad( 'hello', 6 ) ) );

$this->assertEquals( 7, strlen( \cli\Colors::pad( 'óra', 6 ) ) ); // special characters take one byte

$this->assertEquals( 9, strlen( \cli\Colors::pad( '日本語', 6 ) ) ); // each character takes two bytes

$this->assertEquals( 17, strlen( \cli\Colors::pad( 'עִבְרִית', 6 ) ) ); // process Hebrew vowels

$this->assertEquals( 6, strlen( \cli\Colors::pad( 'hello', 6, false, false, STR_PAD_RIGHT ) ) );

$this->assertEquals( 7, strlen( \cli\Colors::pad( 'óra', 6, false, false, STR_PAD_LEFT ) ) ); // special characters take one byte

$this->assertEquals( 9, strlen( \cli\Colors::pad( '日本語', 6, false, false, STR_PAD_BOTH ) ) ); // each character takes two bytes

$this->assertSame( 4, strpos( \cli\Colors::pad( 'hello', 10, false, false, STR_PAD_RIGHT ), 'o' ) );

$this->assertSame( 9, strpos( \cli\Colors::pad( 'hello', 10, false, false, STR_PAD_LEFT ), 'o' ) );

$this->assertSame( 6, strpos( \cli\Colors::pad( 'hello', 10, false, false, STR_PAD_BOTH ), 'o' ) );

$this->assertSame( 1, strpos( \cli\Colors::pad( 'hello', 10, false, false, STR_PAD_RIGHT ), 'e' ) );

$this->assertSame( 6, strpos( \cli\Colors::pad( 'hello', 10, false, false, STR_PAD_LEFT ), 'e' ) );

$this->assertSame( 3, strpos( \cli\Colors::pad( 'hello', 10, false, false, STR_PAD_BOTH ), 'e' ) );

}

function test_colorized_string_pad() {

// Colors enabled.

Colors::enable( true );

$x = Colors::colorize( '%Gx%n', true ); // colorized `x` string

$ora = Colors::colorize( "%Góra%n", true ); // colorized `óra` string

$this->assertSame( 22, strlen( Colors::pad( $x, 11 ) ) );

$this->assertSame( 22, strlen( Colors::pad( $x, 11, false /*pre_colorized*/ ) ) );

$this->assertSame( 22, strlen( Colors::pad( $x, 11, true /*pre_colorized*/ ) ) );

$this->assertSame( 23, strlen( Colors::pad( $ora, 11 ) ) ); // +1 for two-byte "ó".

$this->assertSame( 23, strlen( Colors::pad( $ora, 11, false /*pre_colorized*/ ) ) );

$this->assertSame( 23, strlen( Colors::pad( $ora, 11, true /*pre_colorized*/ ) ) );

// Colors disabled.

Colors::disable( true );

$this->assertFalse( Colors::shouldColorize() );

$this->assertSame( 20, strlen( Colors::pad( $x, 20 ) ) );

$this->assertSame( 20, strlen( Colors::pad( $x, 20, false /*pre_colorized*/ ) ) );

$this->assertSame( 31, strlen( Colors::pad( $x, 20, true /*pre_colorized*/ ) ) );

$this->assertSame( 21, strlen( Colors::pad( $ora, 20 ) ) ); // +1 for two-byte "ó".

$this->assertSame( 21, strlen( Colors::pad( $ora, 20, false /*pre_colorized*/ ) ) );

$this->assertSame( 32, strlen( Colors::pad( $ora, 20, true /*pre_colorized*/ ) ) );

}

function test_encoded_substr() {

$this->assertEquals( \cli\safe_substr( \cli\Colors::pad( 'hello', 6), 0, 2 ), 'he' );

$this->assertEquals( \cli\safe_substr( \cli\Colors::pad( 'óra', 6), 0, 2 ), 'ór' );

$this->assertEquals( \cli\safe_substr( \cli\Colors::pad( '日本語', 6), 0, 2 ), '日本' );

$this->assertSame( 'el', \cli\safe_substr( Colors::pad( 'hello', 6 ), 1, 2 ) );

$this->assertSame( 'a ', \cli\safe_substr( Colors::pad( 'óra', 6 ), 2, 2 ) );

$this->assertSame( ' ', \cli\safe_substr( Colors::pad( 'óra', 6 ), 5, 2 ) );

$this->assertSame( '本語', \cli\safe_substr( Colors::pad( '日本語', 8 ), 1, 2 ) );

$this->assertSame( '語 ', \cli\safe_substr( Colors::pad( '日本語', 8 ), 2, 2 ) );

$this->assertSame( ' ', \cli\safe_substr( Colors::pad( '日本語', 8 ), -1 ) );

$this->assertSame( ' ', \cli\safe_substr( Colors::pad( '日本語', 8 ), -1, 2 ) );

$this->assertSame( '語 ', \cli\safe_substr( Colors::pad( '日本語', 8 ), -3, 3 ) );

}

function test_various_substr() {

// Save.

$test_safe_substr = getenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR' );

if ( function_exists( 'mb_detect_order' ) ) {

$mb_detect_order = mb_detect_order();

}

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR' );

// Latin, kana, Latin, Latin combining, Thai combining, Hangul.

$str = 'lムnöม้p를'; // 18 bytes.

// Large string.

$large_str_str_start = 65536 * 2;

$large_str = str_repeat( 'a', $large_str_str_start ) . $str;

$large_str_len = strlen( $large_str ); // 128K + 18 bytes.

if ( \cli\can_use_icu() ) {

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR=1' ); // Tests grapheme_substr().

$this->assertSame( '', \cli\safe_substr( $str, 0, 0 ) );

$this->assertSame( 'l', \cli\safe_substr( $str, 0, 1 ) );

$this->assertSame( 'lム', \cli\safe_substr( $str, 0, 2 ) );

$this->assertSame( 'lムn', \cli\safe_substr( $str, 0, 3 ) );

$this->assertSame( 'lムnö', \cli\safe_substr( $str, 0, 4 ) );

$this->assertSame( 'lムnöม้', \cli\safe_substr( $str, 0, 5 ) );

$this->assertSame( 'lムnöม้p', \cli\safe_substr( $str, 0, 6 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, 0, 7 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, 0, 8 ) );

$this->assertSame( '', \cli\safe_substr( $str, 19 ) ); // Start too large.

$this->assertSame( '', \cli\safe_substr( $str, 19, 7 ) ); // Start too large, with length.

$this->assertSame( '', \cli\safe_substr( $str, 8 ) ); // Start same as length.

$this->assertSame( '', \cli\safe_substr( $str, 8, 0 ) ); // Start same as length, with zero length.

$this->assertSame( '를', \cli\safe_substr( $str, -1 ) );

$this->assertSame( 'p를', \cli\safe_substr( $str, -2 ) );

$this->assertSame( 'ม้p를', \cli\safe_substr( $str, -3 ) );

$this->assertSame( 'öม้p를', \cli\safe_substr( $str, -4 ) );

$this->assertSame( 'öม้p', \cli\safe_substr( $str, -4, 3 ) );

$this->assertSame( 'nö', \cli\safe_substr( $str, -5, 2 ) );

$this->assertSame( 'ム', \cli\safe_substr( $str, -6, 1 ) );

$this->assertSame( 'ムnöม้p를', \cli\safe_substr( $str, -6 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, -7 ) );

$this->assertSame( 'lムnö', \cli\safe_substr( $str, -7, 4 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, -8 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, -9 ) ); // Negative start too large.

$this->assertSame( $large_str, \cli\safe_substr( $large_str, 0 ) );

$this->assertSame( '', \cli\safe_substr( $large_str, $large_str_str_start, 0 ) );

$this->assertSame( 'l', \cli\safe_substr( $large_str, $large_str_str_start, 1 ) );

$this->assertSame( 'lム', \cli\safe_substr( $large_str, $large_str_str_start, 2 ) );

$this->assertSame( 'p를', \cli\safe_substr( $large_str, -2 ) );

}

if ( \cli\can_use_pcre_x() ) {

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR=2' ); // Tests preg_split( '/\X/u' ).

$this->assertSame( '', \cli\safe_substr( $str, 0, 0 ) );

$this->assertSame( 'l', \cli\safe_substr( $str, 0, 1 ) );

$this->assertSame( 'lム', \cli\safe_substr( $str, 0, 2 ) );

$this->assertSame( 'lムn', \cli\safe_substr( $str, 0, 3 ) );

$this->assertSame( 'lムnö', \cli\safe_substr( $str, 0, 4 ) );

$this->assertSame( 'lムnöม้', \cli\safe_substr( $str, 0, 5 ) );

$this->assertSame( 'lムnöม้p', \cli\safe_substr( $str, 0, 6 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, 0, 7 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, 0, 8 ) );

$this->assertSame( '', \cli\safe_substr( $str, 19 ) ); // Start too large.

$this->assertSame( '', \cli\safe_substr( $str, 19, 7 ) ); // Start too large, with length.

$this->assertSame( '', \cli\safe_substr( $str, 8 ) ); // Start same as length.

$this->assertSame( '', \cli\safe_substr( $str, 8, 0 ) ); // Start same as length, with zero length.

$this->assertSame( '를', \cli\safe_substr( $str, -1 ) );

$this->assertSame( 'p를', \cli\safe_substr( $str, -2 ) );

$this->assertSame( 'ม้p를', \cli\safe_substr( $str, -3 ) );

$this->assertSame( 'öม้p를', \cli\safe_substr( $str, -4 ) );

$this->assertSame( 'öม้p', \cli\safe_substr( $str, -4, 3 ) );

$this->assertSame( 'nö', \cli\safe_substr( $str, -5, 2 ) );

$this->assertSame( 'ム', \cli\safe_substr( $str, -6, 1 ) );

$this->assertSame( 'ムnöม้p를', \cli\safe_substr( $str, -6 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, -7 ) );

$this->assertSame( 'lムnö', \cli\safe_substr( $str, -7, 4 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, -8 ) );

$this->assertSame( 'lムnöม้p를', \cli\safe_substr( $str, -9 ) ); // Negative start too large.

$this->assertSame( $large_str, \cli\safe_substr( $large_str, 0 ) );

$this->assertSame( '', \cli\safe_substr( $large_str, $large_str_str_start, 0 ) );

$this->assertSame( 'l', \cli\safe_substr( $large_str, $large_str_str_start, 1 ) );

$this->assertSame( 'lム', \cli\safe_substr( $large_str, $large_str_str_start, 2 ) );

$this->assertSame( 'p를', \cli\safe_substr( $large_str, -2 ) );

}

if ( function_exists( 'mb_substr' ) ) {

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR=4' ); // Tests mb_substr().

$this->assertSame( '', \cli\safe_substr( $str, 0, 0 ) );

$this->assertSame( 'l', \cli\safe_substr( $str, 0, 1 ) );

$this->assertSame( 'lム', \cli\safe_substr( $str, 0, 2 ) );

$this->assertSame( 'lムn', \cli\safe_substr( $str, 0, 3 ) );

$this->assertSame( 'lムno', \cli\safe_substr( $str, 0, 4 ) ); // Wrong.

}

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR=8' ); // Tests substr().

$this->assertSame( '', \cli\safe_substr( $str, 0, 0 ) );

$this->assertSame( 'l', \cli\safe_substr( $str, 0, 1 ) );

$this->assertSame( "l\xe3", \cli\safe_substr( $str, 0, 2 ) ); // Corrupt.

$this->assertSame( '', \cli\safe_substr( $str, strlen( $str ) + 1 ) ); // Return '' not false to match behavior of other methods when `$start` > strlen.

// Non-UTF-8 - both grapheme_substr() and preg_split( '/\X/u' ) will fail.

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR' );

if ( function_exists( 'mb_substr' ) && function_exists( 'mb_detect_order' ) ) {

// Latin-1

mb_detect_order( array( 'UTF-8', 'ISO-8859-1' ) );

$str = "\xe0b\xe7"; // "àbç" in ISO-8859-1

$this->assertSame( "\xe0b", \cli\safe_substr( $str, 0, 2 ) );

$this->assertSame( "\xe0b", mb_substr( $str, 0, 2, 'ISO-8859-1' ) );

}

// Restore.

putenv( false == $test_safe_substr ? 'PHP_CLI_TOOLS_TEST_SAFE_SUBSTR' : "PHP_CLI_TOOLS_TEST_SAFE_SUBSTR=$test_safe_substr" );

if ( function_exists( 'mb_detect_order' ) ) {

mb_detect_order( $mb_detect_order );

}

}

function test_is_width_encoded_substr() {

$this->assertSame( 'he', \cli\safe_substr( Colors::pad( 'hello', 6 ), 0, 2, true /*is_width*/ ) );

$this->assertSame( 'ór', \cli\safe_substr( Colors::pad( 'óra', 6 ), 0, 2, true /*is_width*/ ) );

$this->assertSame( '日', \cli\safe_substr( Colors::pad( '日本語', 8 ), 0, 2, true /*is_width*/ ) );

$this->assertSame( '日', \cli\safe_substr( Colors::pad( '日本語', 8 ), 0, 3, true /*is_width*/ ) );

$this->assertSame( '日本', \cli\safe_substr( Colors::pad( '日本語', 8 ), 0, 4, true /*is_width*/ ) );

$this->assertSame( '日本語', \cli\safe_substr( Colors::pad( '日本語', 8 ), 0, 6, true /*is_width*/ ) );

$this->assertSame( '日本語 ', \cli\safe_substr( Colors::pad( '日本語', 8 ), 0, 7, true /*is_width*/ ) );

$this->assertSame( 'el', \cli\safe_substr( Colors::pad( 'hello', 6 ), 1, 2, true /*is_width*/ ) );

$this->assertSame( 'a ', \cli\safe_substr( Colors::pad( 'óra', 6 ), 2, 2, true /*is_width*/ ) );

$this->assertSame( ' ', \cli\safe_substr( Colors::pad( 'óra', 6 ), 5, 2, true /*is_width*/ ) );

$this->assertSame( '', \cli\safe_substr( '1日4本語90', 0, 0, true /*is_width*/ ) );

$this->assertSame( '1', \cli\safe_substr( '1日4本語90', 0, 1, true /*is_width*/ ) );

$this->assertSame( '1', \cli\safe_substr( '1日4本語90', 0, 2, true /*is_width*/ ) );

$this->assertSame( '1日', \cli\safe_substr( '1日4本語90', 0, 3, true /*is_width*/ ) );

$this->assertSame( '1日4', \cli\safe_substr( '1日4本語90', 0, 4, true /*is_width*/ ) );

$this->assertSame( '1日4', \cli\safe_substr( '1日4本語90', 0, 5, true /*is_width*/ ) );

$this->assertSame( '1日4本', \cli\safe_substr( '1日4本語90', 0, 6, true /*is_width*/ ) );

$this->assertSame( '1日4本', \cli\safe_substr( '1日4本語90', 0, 7, true /*is_width*/ ) );

$this->assertSame( '1日4本語', \cli\safe_substr( '1日4本語90', 0, 8, true /*is_width*/ ) );

$this->assertSame( '1日4本語9', \cli\safe_substr( '1日4本語90', 0, 9, true /*is_width*/ ) );

$this->assertSame( '1日4本語90', \cli\safe_substr( '1日4本語90', 0, 10, true /*is_width*/ ) );

$this->assertSame( '1日4本語90', \cli\safe_substr( '1日4本語90', 0, 11, true /*is_width*/ ) );

$this->assertSame( '日', \cli\safe_substr( '1日4本語90', 1, 2, true /*is_width*/ ) );

$this->assertSame( '日4', \cli\safe_substr( '1日4本語90', 1, 3, true /*is_width*/ ) );

$this->assertSame( '4本語9', \cli\safe_substr( '1日4本語90', 2, 6, true /*is_width*/ ) );

$this->assertSame( '本', \cli\safe_substr( '1日4本語90', 3, 1, true /*is_width*/ ) );

$this->assertSame( '本', \cli\safe_substr( '1日4本語90', 3, 2, true /*is_width*/ ) );

$this->assertSame( '本', \cli\safe_substr( '1日4本語90', 3, 3, true /*is_width*/ ) );

$this->assertSame( '本語', \cli\safe_substr( '1日4本語90', 3, 4, true /*is_width*/ ) );

$this->assertSame( '本語9', \cli\safe_substr( '1日4本語90', 3, 5, true /*is_width*/ ) );

$this->assertSame( '0', \cli\safe_substr( '1日4本語90', 6, 1, true /*is_width*/ ) );

$this->assertSame( '', \cli\safe_substr( '1日4本語90', 7, 1, true /*is_width*/ ) );

$this->assertSame( '', \cli\safe_substr( '1日4本語90', 6, 0, true /*is_width*/ ) );

$this->assertSame( '0', \cli\safe_substr( '1日4本語90', -1, 3, true /*is_width*/ ) );

$this->assertSame( '90', \cli\safe_substr( '1日4本語90', -2, 3, true /*is_width*/ ) );

$this->assertSame( '語9', \cli\safe_substr( '1日4本語90', -3, 3, true /*is_width*/ ) );

$this->assertSame( '本語9', \cli\safe_substr( '1日4本語90', -4, 5, true /*is_width*/ ) );

}

function test_colorized_string_length() {

$this->assertEquals( \cli\Colors::length( \cli\Colors::colorize( '%Gx%n', true ) ), 1 );

$this->assertEquals( \cli\Colors::length( \cli\Colors::colorize( '%G日%n', true ) ), 1 );

}

function test_colorized_string_width() {

// Colors enabled.

Colors::enable( true );

$x = Colors::colorize( '%Gx%n', true );

$dw = Colors::colorize( '%G日%n', true ); // Double-width char.

$this->assertSame( 1, Colors::width( $x ) );

$this->assertSame( 1, Colors::width( $x, false /*pre_colorized*/ ) );

$this->assertSame( 1, Colors::width( $x, true /*pre_colorized*/ ) );

$this->assertSame( 2, Colors::width( $dw ) );

$this->assertSame( 2, Colors::width( $dw, false /*pre_colorized*/ ) );

$this->assertSame( 2, Colors::width( $dw, true /*pre_colorized*/ ) );

// Colors disabled.

Colors::disable( true );

$this->assertFalse( Colors::shouldColorize() );

$this->assertSame( 12, Colors::width( $x ) );

$this->assertSame( 12, Colors::width( $x, false /*pre_colorized*/ ) );

$this->assertSame( 1, Colors::width( $x, true /*pre_colorized*/ ) );

$this->assertSame( 13, Colors::width( $dw ) );

$this->assertSame( 13, Colors::width( $dw, false /*pre_colorized*/ ) );

$this->assertSame( 2, Colors::width( $dw, true /*pre_colorized*/ ) );

}

function test_colorize_string_is_colored() {

$original = '%Gx';

$colorized = "\033[32;1mx";

$this->assertEquals( \cli\Colors::colorize( $original, true ), $colorized );

}

function test_colorize_when_colorize_is_forced() {

$original = '%gx%n';

$this->assertEquals( \cli\Colors::colorize( $original, false ), 'x' );

}

function test_binary_string_is_converted_back_to_original_string() {

$string = 'x';

$string_with_color = '%b' . $string;

$colorized_string = "\033[34m$string";

// Ensure colorization is applied correctly

$this->assertEquals( \cli\Colors::colorize( $string_with_color, true ), $colorized_string );

// Ensure that the colorization is reverted

$this->assertEquals( \cli\Colors::decolorize( $colorized_string ), $string );

}

function test_string_cache() {

$string = 'x';

$string_with_color = '%k' . $string;

$colorized_string = "\033[30m$string";

// Ensure colorization works

$this->assertEquals( \cli\Colors::colorize( $string_with_color, true ), $colorized_string );

// Test that the value was cached appropriately

$test_cache = array(

'passed' => $string_with_color,

'colorized' => $colorized_string,

'decolorized' => $string,

);

$real_cache = \cli\Colors::getStringCache();

// Test that the cache value exists

$this->assertTrue( isset( $real_cache[ md5( $string_with_color ) ] ) );

// Test that the cache value is correctly set

$this->assertEquals( $test_cache, $real_cache[ md5( $string_with_color ) ] );

}

function test_string_cache_colorize() {

$string = 'x';

$string_with_color = '%k' . $string;

$colorized_string = "\033[30m$string";

// Colors enabled.

Colors::enable( true );

// Ensure colorization works

$this->assertSame( $colorized_string, Colors::colorize( $string_with_color ) );

$this->assertSame( $colorized_string, Colors::colorize( $string_with_color ) );

// Colors disabled.

Colors::disable( true );

$this->assertFalse( Colors::shouldColorize() );

// Ensure it doesn't come from the cache.

$this->assertSame( $string, Colors::colorize( $string_with_color ) );

$this->assertSame( $string, Colors::colorize( $string_with_color ) );

// Check that escaped % isn't stripped on putting into cache.

$string = 'x%%n';

$string_with_color = '%k' . $string;

$this->assertSame( 'x%n', Colors::colorize( $string_with_color ) );

$this->assertSame( 'x%n', Colors::colorize( $string_with_color ) );

}

function test_decolorize() {

// Colors enabled.

Colors::enable( true );

$string = '%kx%%n%n';

$colorized_string = Colors::colorize( $string );

$both_string = '%gfoo' . $colorized_string . 'bar%%%n';

$this->assertSame( 'x%n', Colors::decolorize( $string ) );

$this->assertSame( 'x', Colors::decolorize( $colorized_string ) );

$this->assertSame( 'fooxbar%', Colors::decolorize( $both_string ) );

$this->assertSame( $string, Colors::decolorize( $string, 1 /*keep_tokens*/ ) );

$this->assertSame( 'x%n', Colors::decolorize( $colorized_string, 1 /*keep_tokens*/ ) );

$this->assertSame( '%gfoox%nbar%%%n', Colors::decolorize( $both_string, 1 /*keep_tokens*/ ) );

$this->assertSame( 'x%n', Colors::decolorize( $string, 2 /*keep_encodings*/ ) );

$this->assertSame( 'x', Colors::decolorize( $colorized_string, 2 /*keep_encodings*/ ) );

$this->assertSame( 'fooxbar%', Colors::decolorize( $both_string, 2 /*keep_encodings*/ ) );

$this->assertSame( $string, Colors::decolorize( $string, 3 /*noop*/ ) );

$this->assertSame( $colorized_string, Colors::decolorize( $colorized_string, 3 /*noop*/ ) );

$this->assertSame( $both_string, Colors::decolorize( $both_string, 3 /*noop*/ ) );

}

function test_strwidth() {

// Save.

$test_strwidth = getenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH' );

if ( function_exists( 'mb_detect_order' ) ) {

$mb_detect_order = mb_detect_order();

}

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH' );

// UTF-8.

// 4 characters, one a double-width Han = 5 spacing chars, with 2 combining chars. Adapted from http://unicode.org/faq/char_combmark.html#7 (combining acute accent added after "a").

$str = "a\xCC\x81\xE0\xA4\xA8\xE0\xA4\xBF\xE4\xBA\x9C\xF0\x90\x82\x83";

if ( \cli\can_use_icu() ) {

$this->assertSame( 5, \cli\strwidth( $str ) ); // Tests grapheme_strlen().

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH=2' ); // Test preg_split( '/\X/u' ).

$this->assertSame( 5, \cli\strwidth( $str ) );

} else {

$this->assertSame( 5, \cli\strwidth( $str ) ); // Tests preg_split( '/\X/u' ).

}

if ( function_exists( 'mb_strwidth' ) && function_exists( 'mb_detect_order' ) ) {

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH=4' ); // Test mb_strwidth().

mb_detect_order( array( 'UTF-8', 'ISO-8859-1' ) );

$this->assertSame( 5, \cli\strwidth( $str ) );

}

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH=8' ); // Test safe_strlen().

if ( \cli\can_use_icu() || \cli\can_use_pcre_x() ) {

$this->assertSame( 4, \cli\strwidth( $str ) ); // safe_strlen() (correctly) does not account for double-width Han so out by 1.

} elseif ( function_exists( 'mb_strlen' ) && function_exists( 'mb_detect_order' ) ) {

$this->assertSame( 4, \cli\strwidth( $str ) ); // safe_strlen() (correctly) does not account for double-width Han so out by 1.

$this->assertSame( 6, mb_strlen( $str, 'UTF-8' ) );

} else {

$this->assertSame( 16, \cli\strwidth( $str ) ); // strlen() - no. of bytes.

$this->assertSame( 16, strlen( $str ) );

}

// Nepali जस्ट ट॓स्ट गर्दै - 1st word: 3 spacing + 1 combining, 2nd word: 3 spacing + 2 combining, 3rd word: 3 spacing + 2 combining = 9 spacing chars + 2 spaces = 11 chars.

// Note: ICU's grapheme_strlen() treats Devanagari conjuncts (consonant + virama + consonant) as single graphemes.

// Modern ICU versions (54.1+) return 8 for this string, while PCRE \X returns 11.

$str = "\xe0\xa4\x9c\xe0\xa4\xb8\xe0\xa5\x8d\xe0\xa4\x9f \xe0\xa4\x9f\xe0\xa5\x93\xe0\xa4\xb8\xe0\xa5\x8d\xe0\xa4\x9f \xe0\xa4\x97\xe0\xa4\xb0\xe0\xa5\x8d\xe0\xa4\xa6\xe0\xa5\x88";

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH' );

if ( \cli\can_use_icu() ) {

$this->assertSame( 8, \cli\strwidth( $str ) ); // Tests grapheme_strlen() - ICU treats conjuncts as single graphemes.

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH=2' ); // Test preg_split( '/\X/u' ).

$this->assertSame( 11, \cli\strwidth( $str ) );

} else {

$this->assertSame( 11, \cli\strwidth( $str ) ); // Tests preg_split( '/\X/u' ).

}

if ( function_exists( 'mb_strwidth' ) && function_exists( 'mb_detect_order' ) ) {

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH=4' ); // Test mb_strwidth().

mb_detect_order( array( 'UTF-8' ) );

$this->assertSame( 11, \cli\strwidth( $str ) );

}

// Non-UTF-8 - both grapheme_strlen() and preg_split( '/\X/u' ) will fail.

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH' );

if ( function_exists( 'mb_strwidth' ) && function_exists( 'mb_detect_order' ) ) {

// Latin-1

mb_detect_order( array( 'UTF-8', 'ISO-8859-1' ) );

$str = "\xe0b\xe7"; // "àbç" in ISO-8859-1

$this->assertSame( 3, \cli\strwidth( $str ) ); // Test mb_strwidth().

$this->assertSame( 3, mb_strwidth( $str, 'ISO-8859-1' ) );

// Shift JIS.

mb_detect_order( array( 'UTF-8', 'SJIS' ) );

$str = "\x82\xb1\x82\xf1\x82\xc9\x82\xbf\x82\xcd\x90\xa2\x8a\x45!"; // "こャにちは世界!" ("Hello world!") in Shift JIS - 7 double-width chars plus Latin exclamation mark.

$this->assertSame( 15, \cli\strwidth( $str ) ); // Test mb_strwidth().

$this->assertSame( 15, mb_strwidth( $str, 'SJIS' ) );

putenv( 'PHP_CLI_TOOLS_TEST_STRWIDTH=8' ); // Test safe_strlen().

if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_detect_order' ) ) {

$this->assertSame( 8, \cli\strwidth( $str ) ); // mb_strlen() - doesn't allow for double-width.

$this->assertSame( 8, mb_strlen( $str, 'SJIS' ) );

} else {

$this->assertSame( 15, \cli\strwidth( $str ) ); // strlen() - no. of bytes.

$this->assertSame( 15, strlen( $str ) );

}

}

// Restore.

putenv( false == $test_strwidth ? 'PHP_CLI_TOOLS_TEST_STRWIDTH' : "PHP_CLI_TOOLS_TEST_STRWIDTH=$test_strwidth" );

if ( function_exists( 'mb_detect_order' ) ) {

mb_detect_order( $mb_detect_order );

}

}

function test_safe_strlen() {

// Save.

$test_safe_strlen = getenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN' );

if ( function_exists( 'mb_detect_order' ) ) {

$mb_detect_order = mb_detect_order();

}

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN' );

// UTF-8.

// ASCII l, 3-byte kana, ASCII n, ASCII o + 2-byte combining umlaut, 6-byte Thai combining, ASCII, 3-byte Hangul. grapheme length 7, bytes 18.

$str = 'lムnöม้p를';

if ( \cli\can_use_icu() ) {

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN' ); // Test grapheme_strlen().

$this->assertSame( 7, \cli\safe_strlen( $str ) );

if ( \cli\can_use_pcre_x() ) {

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN=2' ); // Test preg_split( '/\X/u' ).

$this->assertSame( 7, \cli\safe_strlen( $str ) );

}

} elseif ( \cli\can_use_pcre_x() ) {

$this->assertSame( 7, \cli\safe_strlen( $str ) ); // Tests preg_split( '/\X/u' ).

} else {

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN=8' ); // Test strlen().

$this->assertSame( 18, \cli\safe_strlen( $str ) ); // strlen() - no. of bytes.

$this->assertSame( 18, strlen( $str ) );

}

if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_detect_order' ) ) {

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN=4' ); // Test mb_strlen().

mb_detect_order( array( 'UTF-8', 'ISO-8859-1' ) );

$this->assertSame( 7, \cli\safe_strlen( $str ) );

$this->assertSame( 9, mb_strlen( $str, 'UTF-8' ) ); // mb_strlen() - counts the 2 combining chars.

}

// Non-UTF-8 - both grapheme_strlen() and preg_split( '/\X/u' ) will fail.

putenv( 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN' );

if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_detect_order' ) ) {

// Latin-1

mb_detect_order( array( 'UTF-8', 'ISO-8859-1' ) );

$str = "\xe0b\xe7"; // "àbç" in ISO-8859-1

$this->assertSame( 3, \cli\safe_strlen( $str ) ); // Test mb_strlen().

$this->assertSame( 3, mb_strlen( $str, 'ISO-8859-1' ) );

}

// Restore.

putenv( false == $test_safe_strlen ? 'PHP_CLI_TOOLS_TEST_SAFE_STRLEN' : "PHP_CLI_TOOLS_TEST_SAFE_STRLEN=$test_safe_strlen" );

if ( function_exists( 'mb_detect_order' ) ) {

mb_detect_order( $mb_detect_order );

}

}

function test_render_with_color_tokens_and_sprintf_args_colors_disabled() {

Colors::disable( true );

// Color tokens in format string must not cause "sprintf(): Too few arguments".

$result = \cli\render( '[%C%k%s%N] Starting!', '2024-01-01 12:00:00' );

$this->assertSame( '[2024-01-01 12:00:00] Starting!', $result );

}

function test_render_with_color_tokens_and_sprintf_args_colors_enabled() {

Colors::enable( true );

$result = \cli\render( '[%C%k%s%N] Starting!', '2024-01-01 12:00:00' );

$this->assertStringContainsString( '2024-01-01 12:00:00', $result );

$this->assertStringContainsString( 'Starting!', $result );

}

}