System Command Runner #

A testable wrapper around Process.run for executing system commands.

Why? #

Process.run is hard to mock. This package provides a simple, injectable wrapper that makes your code testable.

Installation #

dependencies:
  system_command_runner: ^0.1.0

Usage #

import 'package:system_command_runner/system_command_runner.dart';

final runner = const SystemCommandRunner();

// Basic command
final result = await runner.run('echo', ['Hello, World!']);
print(result.stdout); // Hello, World!

// With working directory and environment
final result2 = await runner.run(
  'git',
  ['status'],
  workingDirectory: '/path/to/repo',
  environment: {'GIT_CONFIG': '/custom/config'},
);

Testing #

class MockSystemCommandRunner extends Mock implements SystemCommandRunner {}

// In your test
when(() => mockRunner.run('git', ['status'])).thenAnswer(
  (_) async => CommandResult(exitCode: 0, stdout: 'clean', stderr: ''),
);

API #

SystemCommandRunner #

• run(String executable, List<String> arguments, {String? workingDirectory, Map<String, String>? environment})

CommandResult #

• exitCode - Exit code
• stdout - Standard output
• stderr - Standard error