Word Whizz is a fun and educational word guessing game, similar to the "Hangman" game, whereby the computer picks a word, and challenges the guesser to guess it. The computer gives the guesser the length of the word, in which the location of the possible letters are denoted with underscores, and the guesser must try to guess the word one letter at a time. If the guesser guesses a correct letter, the computer reveals all occurrences of that letter to the guesser. The guesser must guess the word with less than 6 incorrect guess attempts to win the game. The computer wins if the guesser runs out of guess attempts.

Points are awarded for guessing letters correctly, even if the player loses, in order to encourage the player to continue guessing and learn new words. Fewer points are deducted if the guesser gueses incorrectly. A bar at the bottom of the page shows the proportion of guesses remaining. The player can adjust the difficulty level on a scale of 1-10 to receive more or less challenging words.

• Technology Stack
• Dependencies
• Game Rules
• Game Guidelines
• Features
• Features
• Design Decisions
• Setup
• Version 2.0
• About the Developer

• Python3
• Flask
• Jinja2
• SQLAlchemy
• JavaScript (AJAX, JSON, jQuery)
• HTML/CSS
• Bootstrap

• API: LinkedIn's Word API

• The computer will pick a secret dictionary word at the beginning of the game
• The computer deducts one attempt each time a guessed letter is not in the word
• The computer wins the game if the guesser picks 6 letters that are not in the word, and the guesser loses
• The guesser wins the game if they guess all letters in the word, and guess less than 6 letters that are not in the word

• The guesser can adjust difficulty level on a scale from 1-10, with 10 providing the most difficult words.
• The computer sets difficulty level at 3 when the player logs in, but when the player adjusts difficulty level, it is maintained throughout the session.
• The computer awards points for each correctly guessed letter.
• The computer awards more points at higher word difficulty levels.
• The computer will still award points if the player loses the game, but does not award points if the player does not finish the game.

• The user can sign up or log in to play the game

• The user is shown an empty word, and must guess the letters in the word per the rules states above

• The user can try to guess the full word at the expense of losing one attempt

• The user can reset the game, and change difficulty level

• The user can view their own score and word history, and view the leaderboard to see the ranks of all of the players

1. Clone the repository to a local directory
2. After activating the virtual environment:
   • pip3 install requirements.txt
3. Create the database:
   • createdb scoresdb
4. Run the server:

• python server.py
• localhost:5000 in the browser window

5. Check tests by running the following:
   • python3 test_server.py
   • python3 test_game.py

Coming soon!

• The computer shows the score dynamically while user is playing the game.
• The computer gives a hint to the player by providing the word's dictionary definition.
• At the end of every game, the computer will display the word's definition to the player.
• The player can create a profile, and adjust the default difficulty level in the profile.
• The player can adjust minimum and maximum length of the word.
• The player will not be able to receive the same word more than once.

Jessica is a software engineer and former clinical dietitian based out of San Francisco.