For this program you may work with one partner (you may not work in groups larger than two).

If you work with a partner:

• both you and your partner's names should appear in the comment at the top of your solution file.
• since you are starting with your solution to lab 6, it is okay for you and your partner to share lab 6 solutions, and obviously your lab 7 code, but you should not share any other code from previous lab assignments.
• only one of you or your partner should submit your joint solution using handin21

The best way to work with a partner is to work together in the lab on all parts of the program together. You can work together on a copy of the code in one partner's cs21/labs/07 subdirectory and then email the file as an attachment to the other partner so that he/she can save a copy of your joint solution in his/her cs21/labs/07/ subdirectory too.

Run update21, if you haven't already, to create the cs21/labs/07. Then cd into your cs21/labs/07 directory and create the python programs for lab 7 in this directory (handin21 looks for your lab 7 assignments in your cs21/labs/07 directory):

$ cd cs21/labs/07
$ pwd
  /home/your_user_name/cs21/labs/07

With the lab07 directory is a file, phrasefile.txt, that contains a set of phrases that your program will use as input. You can, of course, add to this file or come up with your own files to use for testing.

Copying your lab06 files over as a starting point:

Next, copy over your solutions from your lab06 directory into your lab07 directory, and move your guessconsonant.py to a file named wheeloffortune.py that you will use as the solution file for lab 7:

$ cd ~/cs21/labs/07
$ cp ../06/* .
$ mv guessconsonant.py wheeloffortune.py

Open, wheeloffortune.py in vim and copy into it your PrintMenu and GetMenuOption functions from your getmenuoption.py file. One way to do this is to:

1. open wheeloffortune.py in vim
2. go to the bottom of the file, to the line right before the call to main(), and in command mode enter the command:

   :r getmenuoption.py
   

   to read in the contents of the file getmenuoption.py at the current position of the cursor. Then edit wheeloffortune.py to remove all parts of getmenuoption.py except PrintMenu and GetMenuOption functions. Also, make sure that there is a single call to main() at the very end of your file.

Your programs are graded on both correctness and style. Please review the comments regarding programming style on the main page.

You are going to implement a single player version of the Wheel of Fortune TV game show. If you have never seen the show, here is some information on how it is played on TV. The rules for the single player game that we will implement are similar to, but slightly different from, the multi-player game on TV.

The single player rules:

Wheel of Fortune is a phrase guessing game where the player can guess letters in the phrase at each turn. At each turn, your program should:

• display the phrase with the letters guessed so far filled in. Use '_' characters for letters in the phrase that the player has not yet guessed, and display non-letter characters (like spaces and punctuation) in their appropriate positions in the phrase. For example if the phrase is "Hi jo, how are you?" your program will display the following before the user has correctly guessed any letters in the phrase:

  PHRASE:  _ _   _ _ ,  _ _ _   _ _ _   _ _ _ ?
  

  If the user guesses the letter h, then in the next turn you will display:

  PHRASE:  H _   _ _ ,  h _ _   _ _ _   _ _ _ ?
  

• display the current amount of earnings
• display a menu of actions that the player can choose from.
• read in the user's choice and perform the appropriate actions for that choice. Some actions can result in the game ending.

The player takes multiple turns until either they win by guessing the puzzle or they lose by spinning BANKRUPT or by giving an incorrect guess for the complete phrase. For each turn the player can choose one of four options:

1. SPIN THE WHEEL
   If the player decides to spin, two possibilities can occur:
   • they spin a dollar amount (a random amount between $50 and $1,000 in 50 dollar increments):
     the player can now guess a consonant in the phrase. If the consonant is in the phrase, then to the player's total earnings is added the dollar amount from the spin times the number of occurrences of the letter in the phrase. For example, if the user spins $100 and guesses 't', and there are 3 t's in the phrase, the user gets $300 added to their earnings.
     The part of the phrase guessed so far is updated for the next round, to show the correctly-guessed letter.
   • they spin BANKRUPT: the player loses all their earnings and loses the game.
2. BUY A VOWEL: vowels cost $250 of a player's earnings. Subtract 250 from the player's total earnings (total earnings cannot be negative, so buying a vowel may not always be an option the player can choose), and the player enters a vowel. If the vowel is in the puzzle it is filled in. A vowel only costs $250 no matter how many times it appears in the phrase.
3. GUESS THE PUZZLE:
   If the player guess correctly, they win the total earnings. If the player guesses incorrectly, they lose the game and earn nothing
4. QUIT THE GAME: and forfeit all earnings

When the game is over, your program should:

• print out whether or not the player won
• print out their total earnings
• print out the phrase used during the game

You may want to start by looking at some of the sample output below to get an idea of what your program needs to do.

Then spend some time applying top-down-design to break the program up into parts that you can then code.

High-level first step of applying top-down-design:

1. Print out the introduction to the player
2. Get a random phrase from an input file of phrases
3. Play the game
4. Output the results: won or lost, amount won if won, and phrase

Each of these steps should probably be a separate function that is called from main.

Next, iteratively refine steps (2) and (3) above, breaking them into sub-steps, and the sub-steps into sub-steps and so on until you have functionality that you can start testing. The PlayGame function, in particular should make calls to several other functions that implement pieces of the larger playing a game functionality. You already wrote some of the functions in lab 6, and you should use those functions and add new ones to this solution. As a point of reference, my solution has 15 different functions. Your solution doesn't need to have exactly 15, but if it only has 5, that is an indication that you have not broken down PlayGame into enough steps, where some of the medium-level sub-steps correspond to separate functions that are called in PlayGame.

Incrementally implement and test functions. Just like you did in lab 6, add some calls from main (or from PlayGame) to functions you write just to test them for correctness. Once you are satisfied that they work, then you can remove these test calls.

You can add just the shell of functions to test program control flow, and then fill in their implementation later. For example, I could implement just the following code, and run and test my program to see if I'm calling functions correctly:

def main():
  Intro()
  w = GetRandomPhrase()
  amt_won = PlayGame(w)
  if(amt_won == -1):
    print "You lost!!"
  else:
  print "You won $", amt_won

#######################
def Intro():
  print "The game rules"

#######################
def GetRandomPhrase():
  print "in GetRandomPhrase"
  return "hello there"
#######################
def PlayGame(phrase):
  print "in PlayGame phrase = ", phrase
  return -1
#######################
main()

Next, I could start really implementing parts of these functions, maybe adding other function shells that they call to test incrementally.

As you implement and test incrementally, make sure that you keep in mind specific things that your program needs to do and refer back to the sample output if you are unsure about certain cases.

Here is a list of specific things your program must do:

• Choose a random phrase from the phrase file.
• Play the Game (Implement the control structure of the interaction (display game state, looping for each guess, detecting the end of the game, and so forth).
  1. Display the phrase part where already correctly-guessed letters are filled in in their correct locations in the phrase, and unguessed letters' positions are filled in with underscore characters.
     Hint: use a list of characters (strings of length 1) to keep track of the parts of the puzzle guessed so far. There will be one list element for every character in the phrase string. Each element is either an alphabetic character for letters guessed so far, or underscore character for letters not yet guessed, or a space or punctuation character for non-alphabetic characters in the phrase. Because strings are immutable, it is easier to use a list of characters and then just update the list entries from a string "_" to a string "A" or "a" if the user guesses the letter A, for example. You will have to think about how to construct the starting point list from the input phrase.
  2. Present the user with a menu of options: (1) Spin, (2) Buy Vowel, (3) Solve Puzzle, or (4) Quit. Then read in and correctly execute the user's choice.
  3. Display the user's current dollar amount in winnings as a result of his/her choice.
• Randomly choose a spin value, one of: BANKRUPT, $50, $100, $150, ..., $950, or $1000.
• Keep track of the partially guessed answer, which begins as a list of underscores in place of the alphabetic characters in the phrase, and is updated as correct letters are guessed (see sample run below).
• Accept guessed letters in either lower or upper case.
• Keep track of the letters guessed so far. If the user accidently chooses the same letter again, give him/her another chance to guess a new letter.
• Give the user the option to quit before guessing the phrase. If a user quits early, he/she gets to keep none of his/her earnings from that game.
• In the one player game, if the player spins BANKRUPT she loses the game.

Here is some sample output from different runs of a working program: Sample Output.

Notice the different ways in which a game can end, and how different types of errors are handled (including bad input values, not allowing the player to "buy a vowel" after s/he has already bought all of them, and not allowing a player with under $250 in earnings to buy a vowel).

These are NOT part of the regular assignment. Only attempt these after you have successfully completed the full regular assignment; an incorrect lab 7 assignment with extensions will receive a lower grade then a complete lab 7 assignment with no extensions.

Here are some ideas for extensions to lab 7 as an extra challenge: lab 7 extensions

Once you are satisfied with your programs, hand them in by typing handin21 at the unix prompt. You may run handin21 as many times as you like, and only the most recent submission will be recorded. This is useful if you realize after handing in some programs that you'd like to make a few more changes to them.

Home Page
Last Modified: Wed 22 Oct 2014 03:15:15 PM EDT