Initial Commit

racket/hello-world/README.md

@@ -0,0 +1,67 @@
+# Hello World
+
+Write a program 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
+
+The `Hello World!` program will greet me, the caller.
+
+If I tell the program my name is Alice, it will greet me by saying "Hello, Alice!".
+
+If I neglect to give it my name, it will greet me by saying "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](http://help.exercism.io/submitting-exercises.html).
+
+## 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 be not be reviewed by a person, but by rikki- the robot, who will offer an encouraging word.
+
+* * * *
+
+For installation and learning resources, refer to the
+[exercism help page](http://help.exercism.io/getting-started-with-racket.html).
+
+You can run the provided tests through DrRacket, or via the command line.
+
+To run the test through DrRacket, simply open the test file and click the 'Run' button in the upper right.
+
+To run the test from the command line, simply run the test from the exercise directory. For example, if the test suite is called `hello-world-test.rkt`, you can run the following command:
+
+```
+raco test hello-world-test.rkt
+```
+
+which will display the following:
+
+```
+raco test: (submod "hello-world-test.rkt" test)
+2 success(es) 0 failure(s) 0 error(s) 2 test(s) run
+0
+2 tests passed
+```
+
+## Source
+
+This is a program to introduce users to using Exercism [view source](http://en.wikipedia.org/wiki/%22Hello,_world!%22_program)

racket/hello-world/hello-world-test.rkt

@@ -0,0 +1,15 @@
+#lang racket
+
+(require "hello-world.rkt")
+
+(module+ test
+  (require rackunit rackunit/text-ui)
+
+  (define suite
+    (test-suite
+     "hello world tests"
+
+     (test-equal? "no arg returns Hello, World!" (hello) "Hello, World!")
+     (test-equal? "with arg returns Hello, arg!" (hello "exercism") "Hello, exercism!")))
+
+  (run-tests suite))

racket/hello-world/hello-world.rkt

@@ -0,0 +1,3 @@
+#lang racket
+
+(provide hello)