[process_run] v0.14.1

packages/process_run/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.14.1
+
+* add `runSync` and `runExecutableArgumentsSync` to global space and to `Shell`
+
 ## 0.14.0+1
 
 * No longer replace `\` by `\\` before splitting arguments

packages/process_run/doc/shell.md

@@ -41,23 +41,20 @@ await run('echo "Hello world"');
 await run('echo ${shellArgument('Hello world')}');
 ```
 
-### Changing directory
+## Running the script in synchronous mode
 
-You can pushd/popd a directory
+The synchronous mode is useful for testing. It is not recommended for production use as
+it is a synchronous call and will block until the child process terminates.
 
-```dart
-shell = shell.pushd('example');
-
-await shell.run('''
-
-# Listing directory in the example folder
-dir
-
-''');
-shell = shell.popd();
+```dart     
+var shell = Shell();
+// This is a synchronous call and will block until the child process terminates.
+var results = shell.runSync('echo "Hello world"');
+var result = results.first;
+print('output: "${result.outText.trim()}" exitCode: ${result.exitCode}');
+// should display: output: "Hello world" exitCode: 0
 ```
 
-
 ### Handling errors
 
 By default, `run` will throw an error if the `exitCode` is not 0. You can prevent that

packages/process_run/example/demo_sync.dart

@@ -3,6 +3,13 @@ import 'dart:io';
 import 'package:process_run/process_run.dart';
 
 void main() {
+  var shell = Shell();
+  // This is a synchronous call and will block until the child process terminates.
+  var results = shell.runSync('echo "Hello world"');
+  var result = results.first;
+  print('output: "${result.outText.trim()}" exitCode: ${result.exitCode}');
+  // should display: output: "Hello world" exitCode: 0
+
   // Run the command
   runExecutableArgumentsSync('echo', ['hello world']);
 

packages/process_run/pubspec.yaml

@@ -1,5 +1,5 @@
 name: process_run
-version: 0.14.0+1
+version: 0.14.1
 description: Process run helpers for Linux/Win/Mac and which like feature for finding executables.
 homepage: https://github.com/tekartik/process_run.dart/blob/master/packages/process_run