83 lines
3.0 KiB
Markdown
83 lines
3.0 KiB
Markdown
# 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 learning resources and help with installation, refer to the
|
||
[Exercism help page][].
|
||
|
||
To run the tests provided, you will need to install [Leiningen][].
|
||
|
||
To install Leiningen on Mac OS X using [Homebrew][], run the following command:
|
||
|
||
brew install leiningen
|
||
|
||
For help installing on Linux, Windows or without Homebrew see:
|
||
[Leiningen installation][].
|
||
|
||
[Exercism help page]: http://exercism.io/languages/clojure
|
||
[Leiningen]: http://leiningen.org
|
||
[Homebrew]: http://brew.sh
|
||
[Leiningen installation]: https://github.com/technomancy/leiningen#installation
|
||
|
||
In an exercise directory, create a `src` directory and a file therein to hold
|
||
your solution. The name of the file should be the exercise name with dashes `-`
|
||
replaced by underscores `_`. For example, if the exercise is called
|
||
`hello-world`, name the solution file `hello_world.clj`.
|
||
|
||
Your resulting file tree should look something like this:
|
||
|
||
/path/to/hello-world
|
||
├── project.clj
|
||
├── src
|
||
│ └── hello_world.clj
|
||
└── test
|
||
└── hello_world_test.clj
|
||
|
||
|
||
To run the tests, navigate to the exercise directory and run the following
|
||
command:
|
||
|
||
lein test
|
||
|
||
## Source
|
||
|
||
This is a program to introduce users to using Exercism [view source](http://en.wikipedia.org/wiki/%22Hello,_world!%22_program)
|