Add examples

Author: clue

README.md

@@ -13,18 +13,39 @@ as [Streams](https://github.com/reactphp/stream).
 
 **Table of contents**
 
+* [Quickstart example](#quickstart-example)
 * [Processes](#processes)
   * [EventEmitter Events](#eventemitter-events)
   * [Methods](#methods)
   * [Stream Properties](#stream-properties)
-* [Usage](#usage)
   * [Prepending Commands with `exec`](#prepending-commands-with-exec)
   * [Sigchild Compatibility](#sigchild-compatibility)
   * [Command Chaining](#command-chaining)
 * [Install](#install)
 * [Tests](#tests)
 * [License](#license)
 
+## Quickstart example
+
+```php
+$loop = React\EventLoop\Factory::create();
+
+$process = new React\ChildProcess\Process('echo foo');
+$process->start($loop);
+
+$process->stdout->on('data', function ($chunk) {
+    echo $chunk;
+});
+
+$process->on('exit', function($exitCode, $termSignal) {
+    echo 'Process exited with code ' . $exitCode . PHP_EOL;
+});
+
+$loop->run();
+```
+
+See also the [examples](examples).
+
 ## Processes
 
 ### EventEmitter Events
@@ -81,26 +102,6 @@ $process->stdin->close();
 For more details, see the
 [`DuplexStreamInterface`](https://github.com/reactphp/stream#duplexstreaminterface).
 
-## Usage
-```php
-    $loop = React\EventLoop\Factory::create();
-
-    $process = new React\ChildProcess\Process('echo foo');
-
-    $process->on('exit', function($exitCode, $termSignal) {
-        // ...
-    });
-
-    $loop->addTimer(0.001, function($timer) use ($process) {
-        $process->start($timer->getLoop());
-
-        $process->stdout->on('data', function($output) {
-            // ...
-        });
-    });
-
-    $loop->run();
-```
 ### Prepending Commands with `exec`
 
 Symfony pull request [#5759](https://github.com/symfony/symfony/issues/5759)

examples/01-stdio.php

@@ -0,0 +1,32 @@
+<?php
+
+use React\EventLoop\Factory;
+use React\ChildProcess\Process;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$loop = Factory::create();
+
+$process = new Process('cat');
+$process->start($loop);
+
+$process->stdout->on('data', function ($chunk) {
+    echo $chunk;
+});
+
+$process->on('exit', function ($code) {
+    echo 'EXIT with code ' . $code . PHP_EOL;
+});
+
+// periodically send something to stream
+$periodic = $loop->addPeriodicTimer(0.2, function () use ($process) {
+    $process->stdin->write('hello');
+});
+
+// stop sending after a few seconds
+$loop->addTimer(2.0, function () use ($periodic, $loop, $process) {
+    $loop->cancelTimer($periodic);
+    $process->stdin->end();
+});
+
+$loop->run();

examples/02-race.php

@@ -0,0 +1,24 @@
+<?php
+
+use React\EventLoop\Factory;
+use React\ChildProcess\Process;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$loop = Factory::create();
+
+$first = new Process('sleep 2; echo welt');
+$first->start($loop);
+
+$second = new Process('sleep 1; echo hallo');
+$second->start($loop);
+
+$first->stdout->on('data', function ($chunk) {
+    echo $chunk;
+});
+
+$second->stdout->on('data', function ($chunk)  {
+    echo $chunk;
+});
+
+$loop->run();

examples/03-stdout-stderr.php

@@ -0,0 +1,25 @@
+<?php
+
+use React\EventLoop\Factory;
+use React\ChildProcess\Process;
+
+require __DIR__ . '/../vendor/autoload.php';
+
+$loop = Factory::create();
+
+$process = new Process('echo hallo;sleep 1;echo welt >&2;sleep 1;echo error;sleep 1;nope');
+$process->start($loop);
+
+$process->stdout->on('data', function ($chunk) {
+    echo '(' . $chunk . ')';
+});
+
+$process->stderr->on('data', function ($chunk) {
+    echo '[' . $chunk . ']';
+});
+
+$process->on('exit', function ($code) {
+    echo 'EXIT with code ' . $code . PHP_EOL;
+});
+
+$loop->run();