3 use MediaWiki\Shell\Command
;
4 use MediaWiki\Shell\Shell
;
5 use Wikimedia\TestingAccessWrapper
;
8 * @covers \MediaWiki\Shell\Shell
11 class ShellTest
extends MediaWikiTestCase
{
13 public function testIsDisabled() {
14 $this->assertInternalType( 'bool', Shell
::isDisabled() ); // sanity
18 * @dataProvider provideEscape
20 public function testEscape( $args, $expected ) {
21 if ( wfIsWindows() ) {
22 $this->markTestSkipped( 'This test requires a POSIX environment.' );
24 $this->assertSame( $expected, call_user_func_array( [ Shell
::class, 'escape' ], $args ) );
27 public function provideEscape() {
29 'simple' => [ [ 'true' ], "'true'" ],
30 'with args' => [ [ 'convert', '-font', 'font name' ], "'convert' '-font' 'font name'" ],
31 'array' => [ [ [ 'convert', '-font', 'font name' ] ], "'convert' '-font' 'font name'" ],
32 'skip nulls' => [ [ 'ls', null ], "'ls'" ],
37 * @covers \MediaWiki\Shell\Shell::makeScriptCommand
38 * @dataProvider provideMakeScriptCommand
40 * @param string $expected
41 * @param string $script
42 * @param string[] $parameters
43 * @param string[] $options
44 * @param callable|null $hook
46 public function testMakeScriptCommand(
53 // Running tests under Vagrant involves MWMultiVersion that uses the below hook
54 $this->setMwGlobals( 'wgHooks', [] );
57 $this->setTemporaryHook( 'wfShellWikiCmd', $hook );
60 $command = Shell
::makeScriptCommand( $script, $parameters, $options );
61 $command->params( 'safe' )
62 ->unsafeParams( 'unsafe' );
64 $this->assertType( Command
::class, $command );
66 $wrapper = TestingAccessWrapper
::newFromObject( $command );
67 $this->assertEquals( $expected, $wrapper->command
);
68 $this->assertEquals( 0, $wrapper->restrictions
& Shell
::NO_LOCALSETTINGS
);
71 public function provideMakeScriptCommand() {
76 "'$wgPhpCli' 'maintenance/foobar.php' 'bar'\\''\"baz' 'safe' unsafe",
77 'maintenance/foobar.php',
81 "'$wgPhpCli' 'changed.php' '--wiki=somewiki' 'bar'\\''\"baz' 'safe' unsafe",
82 'maintenance/foobar.php',
85 function ( &$script, array &$parameters ) {
86 $script = 'changed.php';
87 array_unshift( $parameters, '--wiki=somewiki' );
91 "'/bin/perl' 'maintenance/foobar.php' 'bar'\\''\"baz' 'safe' unsafe",
92 'maintenance/foobar.php',
94 [ 'php' => '/bin/perl' ],
97 "'$wgPhpCli' 'foobinize' 'maintenance/foobar.php' 'bar'\\''\"baz' 'safe' unsafe",
98 'maintenance/foobar.php',
100 [ 'wrapper' => 'foobinize' ],