Add the examples for the testrunner.RunCode() function

Author: thewizardplusplus

README.md

@@ -29,6 +29,8 @@ $ dep ensure -vendor-only
 
 ## Example
 
+`coderunner.RunCode`:
+
 ```go
 package main
 
@@ -76,6 +78,104 @@ func main() {
 }
 ```
 
+`testrunner.RunCode` (success):
+
+```go
+package main
+
+import (
+	"fmt"
+	"log"
+	"os"
+	"path/filepath"
+
+	coderunner "github.com/thewizardplusplus/go-code-runner"
+	testrunner "github.com/thewizardplusplus/go-code-runner/test-runner"
+)
+
+func main() {
+	const code = `
+		package main
+
+		func main() {
+			var x, y int
+			fmt.Scan(&x, &y)
+
+			fmt.Println(x + y)
+		}
+	`
+
+	pathToCode, err := coderunner.SaveTemporaryCode(code)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer os.RemoveAll(filepath.Dir(pathToCode)) // nolint: errcheck
+
+	pathToExecutable, err := coderunner.CompileCode(pathToCode)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	err = testrunner.RunCode(pathToExecutable, []testrunner.TestCase{
+		{Input: "5 12", ExpectedOutput: "17\n"},
+		{Input: "23 42", ExpectedOutput: "65\n"},
+	})
+	fmt.Printf("%v\n", err)
+
+	// Output:
+	// <nil>
+}
+```
+
+`testrunner.RunCode` (error):
+
+```go
+package main
+
+import (
+	"fmt"
+	"log"
+	"os"
+	"path/filepath"
+
+	coderunner "github.com/thewizardplusplus/go-code-runner"
+	testrunner "github.com/thewizardplusplus/go-code-runner/test-runner"
+)
+
+func main() {
+	const code = `
+		package main
+
+		func main() {
+			var x, y int
+			fmt.Scan(&x, &y)
+
+			fmt.Println(x + y)
+		}
+	`
+
+	pathToCode, err := coderunner.SaveTemporaryCode(code)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer os.RemoveAll(filepath.Dir(pathToCode)) // nolint: errcheck
+
+	pathToExecutable, err := coderunner.CompileCode(pathToCode)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	err = testrunner.RunCode(pathToExecutable, []testrunner.TestCase{
+		{Input: "5 12", ExpectedOutput: "17\n"},
+		{Input: "23 42", ExpectedOutput: "100\n"},
+	})
+	fmt.Printf("%v\n", err)
+
+	// Output:
+	// unexpected output (input - "23 42"): expected - "100\n", actual - "65\n"
+}
+```
+
 ## License
 
 The MIT License (MIT)

test-runner/examples_test.go

@@ -0,0 +1,77 @@
+package testrunner_test
+
+import (
+	"fmt"
+	"log"
+	"os"
+	"path/filepath"
+
+	coderunner "github.com/thewizardplusplus/go-code-runner"
+	testrunner "github.com/thewizardplusplus/go-code-runner/test-runner"
+)
+
+func ExampleRunCode_success() {
+	const code = `
+		package main
+
+		func main() {
+			var x, y int
+			fmt.Scan(&x, &y)
+
+			fmt.Println(x + y)
+		}
+	`
+
+	pathToCode, err := coderunner.SaveTemporaryCode(code)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer os.RemoveAll(filepath.Dir(pathToCode)) // nolint: errcheck
+
+	pathToExecutable, err := coderunner.CompileCode(pathToCode)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	err = testrunner.RunCode(pathToExecutable, []testrunner.TestCase{
+		{Input: "5 12", ExpectedOutput: "17\n"},
+		{Input: "23 42", ExpectedOutput: "65\n"},
+	})
+	fmt.Printf("%v\n", err)
+
+	// Output:
+	// <nil>
+}
+
+func ExampleRunCode_error() {
+	const code = `
+		package main
+
+		func main() {
+			var x, y int
+			fmt.Scan(&x, &y)
+
+			fmt.Println(x + y)
+		}
+	`
+
+	pathToCode, err := coderunner.SaveTemporaryCode(code)
+	if err != nil {
+		log.Fatal(err)
+	}
+	defer os.RemoveAll(filepath.Dir(pathToCode)) // nolint: errcheck
+
+	pathToExecutable, err := coderunner.CompileCode(pathToCode)
+	if err != nil {
+		log.Fatal(err)
+	}
+
+	err = testrunner.RunCode(pathToExecutable, []testrunner.TestCase{
+		{Input: "5 12", ExpectedOutput: "17\n"},
+		{Input: "23 42", ExpectedOutput: "100\n"},
+	})
+	fmt.Printf("%v\n", err)
+
+	// Output:
+	// unexpected output (input - "23 42"): expected - "100\n", actual - "65\n"
+}