summaryrefslogtreecommitdiff
path: root/go/hello-world
diff options
context:
space:
mode:
Diffstat (limited to 'go/hello-world')
-rw-r--r--go/hello-world/README.md58
-rw-r--r--go/hello-world/hello_test.go29
-rw-r--r--go/hello-world/hello_world.go11
3 files changed, 98 insertions, 0 deletions
diff --git a/go/hello-world/README.md b/go/hello-world/README.md
new file mode 100644
index 0000000..42aa266
--- /dev/null
+++ b/go/hello-world/README.md
@@ -0,0 +1,58 @@
+# Hello World
+
+Write a function that greets the user by name, or by saying "Hello, World!" if no name is given.
+
+["Hello, World!"](http://en.wikipedia.org/wiki/%22Hello,_world!%22_program) is the traditional first program for beginning programming in a new language.
+
+**Note:** You can skip this exercise by running:
+
+ exercism skip $LANGUAGE hello-world
+
+## Specification
+
+Write a `Hello World!` function that can greet someone given their name.
+The function should return the appropriate greeting.
+
+For an input of "Alice", the response should be "Hello, Alice!".
+
+If a name is not given, the response should be "Hello, World!"
+
+## Test-Driven Development
+
+As programmers mature, they eventually want to test their code.
+
+Here at Exercism we simulate [Test-Driven Development](http://en.wikipedia.org/wiki/Test-driven_development) (TDD), where you write your tests before writing any functionality. The simulation comes in the form of a pre-written test suite, which will signal that you have solved the problem.
+
+It will also provide you with a safety net to explore other solutions without breaking the functionality.
+
+### A typical TDD workflow on Exercism:
+
+1. Run the test file and pick one test that's failing.
+2. Write some code to fix the test you picked.
+3. Re-run the tests to confirm the test is now passing.
+4. Repeat from step 1.
+5. Submit your solution (`exercism submit /path/to/file`)
+
+## Instructions
+
+Submissions are encouraged to be general, within reason. Having said that, it's also important not to over-engineer a solution.
+
+It's important to remember that the goal is to make code as expressive and readable as we can. However, solutions to the hello-world exercise will not be reviewed by a person, but by rikki- the robot, who will offer an encouraging word.
+
+To run the tests simply run the command `go test` in the exercise directory.
+
+If the test suite contains benchmarks, you can run these with the `-bench`
+flag:
+
+ go test -bench .
+
+For more detailed info about the Go track see the [help
+page](http://exercism.io/languages/go).
+
+## Source
+
+This is an exercise to introduce users to using Exercism [http://en.wikipedia.org/wiki/%22Hello,_world!%22_program](http://en.wikipedia.org/wiki/%22Hello,_world!%22_program)
+
+## Submitting Incomplete Problems
+It's possible to submit an incomplete solution so you can see how others have completed the exercise.
+
diff --git a/go/hello-world/hello_test.go b/go/hello-world/hello_test.go
new file mode 100644
index 0000000..3099d41
--- /dev/null
+++ b/go/hello-world/hello_test.go
@@ -0,0 +1,29 @@
+package hello
+
+import "testing"
+
+// Define a function HelloWorld(string) string.
+//
+// Also define a testVersion with a value that matches
+// the targetTestVersion here.
+
+const targetTestVersion = 2
+
+func TestHelloWorld(t *testing.T) {
+ tests := []struct {
+ name, expected string
+ }{
+ {"", "Hello, World!"},
+ {"Gopher", "Hello, Gopher!"},
+ }
+ for _, test := range tests {
+ observed := HelloWorld(test.name)
+ if observed != test.expected {
+ t.Fatalf("HelloWorld(%s) = %v, want %v", test.name, observed, test.expected)
+ }
+ }
+
+ if testVersion != targetTestVersion {
+ t.Fatalf("Found testVersion = %v, want %v", testVersion, targetTestVersion)
+ }
+}
diff --git a/go/hello-world/hello_world.go b/go/hello-world/hello_world.go
new file mode 100644
index 0000000..590df4e
--- /dev/null
+++ b/go/hello-world/hello_world.go
@@ -0,0 +1,11 @@
+package hello
+
+const testVersion = 2
+
+// HelloWorld greets the World
+func HelloWorld(s string) string {
+ if s == "" {
+ s = "World"
+ }
+ return "Hello, " + s + "!"
+}