Compsci 6, Spring 2011, Hangman How-to

code directory

1. You will snarf some code. You will create a module named Hangman.py and write code in that module only.

2. Your program must consist of functions and function calls. There can be no global variables in your program.

3. Your program must be robust in the face of user errors, but don't worry too much about that.

4. The user should have the choice of deciding the length of the word and the number of misses allowed, but the program should be capable of having that information provided other than from the user, e.g., from a GUI or set as constants.

5. The sample output on the assignment writeup page should be generically followed in that the user should see a representation of the secret word with guesses filled in, the letters used so far, and so on.

We'll supply more guidelines in terms of function parameters and return types as part of the walkthroughs, and we'll include that information here as well.

Coding Guidelines

• Functions should be brief/short, ideally 10-20 lines, but that's a guideline, not a requirement.

• Functions that do more than one thing are candidates to be divided into function calls doing the more than one thing. A prime candidate is the play function, it will consist of picking letters, updating word-displays, determining if the game should continue, validating input, and so on. In principle, each of these will be a different function, though in practice that's often not possible.

• A function should minimize its side-effects. Changing one parameter and returning a value are ok. Changing multiple parameters and returning a value should be avoided, though sometimes this is ok too -- have a justification for the code you write.

• Use good function and parameter names.