Terminal Game Famous Places and Countries Quiz

The link to Famous Places and Countries Quiz

The Famous Places and Countries game is an interactive educational quiz designed to help users learn about famous places and countries around the world and test their knowledge of them.

---

How to play:

1. Press the orange button - ‘Start the program’ and the terminal window will open.
2. We are greeted with a welcome speech.
3. .
4. After entering your username, you can start playing the game.
5. You have 10 questions.
6. And so we get the first question about the Most Famous Place in the World and we have to guess in which country it is located.
7. 
8. The game is to write the correct country where the Famous Place is located. You will receive a message from the game for your answer.
9. 
10. At the end of the game, you will receive statistics on your correct answers.
11. 

---

User Experience

First-Time User Experience

Users visiting the site for the first time are offered a simple and intuitive process for setting up their gaming preferences. Clear instructions and an easy-to-navigate interface ensure a seamless experience.

Returning User

Returning users

User Stories

• As a potential client, I want to understand the expertise of the developer in creating interactive and educational games.
• As a user interested in educational games, I want detailed information about each feature and how to use it.

---

Features

• Default user name: if the user has not entered his name, then we assign him Superuser.
• Interactive gameplay: Users can guess the names of various landmarks.
• Instant feedback: Users receive feedback on their answers.
• Global places: The game features a diverse set of landmarks from around the world.

---

Future improvements

• Leaderboard: Add a scoring system and leaderboard.
• Additional locations: Add more locations to increase the difficulty of the game.
• Hints: Add hints for each landmark.

---

Technologies Used

Languages:

• Python: used to anchor the project and direct all application behavior

• JavaScript: used to provide the start script needed to run the Code Institute mock terminal in the browser

• GIMP was used to make and resize images for the README file.

Frameworks/Libraries, Programmes and Tools:

Python modules/packages:

Standard library imports:

• random was used to implement pseudo-random number generation.
• os was used to clear the terminal before running the program.
• time was used to breack the terminal for short waiting.

Third-party imports:

• Colorama was used to add colors and styles to the project.

Other tools:

• VSCode was used as the main tool to write and edit code.
• Git was used for the version control of the website.
• GitHub was used to host the code of the website.
• Heroku CLI for deployment

---

Deployment

• The program was deployed to Heroku.

To deploy the project as an application that can be run locally:

Note:

1. This project requires you to have Python installed on your local PC:

• pip install python

1. You will also need pip installed to allow the installation of modules the application uses.

• pip install python3-pip

Create a local copy of the GitHub repository by following one of the two processes below:

• Download ZIP file:

  1. Go to the GitHub Repo page.
  2. Click the Code button and download the ZIP file containing the project.
  3. Extract the ZIP file to a location on your PC.

• Clone the repository:

  1. Open a folder on your computer with the terminal.
  2. Run the following command
  • git clone https://github.com/lazoriks/FamousPlaces_Country_QuizPP3.git

• Alternatively, if using Gitpod, you can click below to create your own workspace using this repository.

  

  1. Install Python module dependencies:

     1. Navigate to the folder madlib_with_python by executing the command:
     • cd FamousPlaces_Country_QuizPP3
     1. Run the command pip install -r requirements.txt
     • pip install -r requirements.txt

To deploy the project to Heroku so it can be run as a remote web application:

• Clone the repository:

  1. Open a folder on your computer with the terminal.
  2. Run the following command
  • git clone https://github.com/lazoriks/FamousPlaces_Country_QuizPP3.git

  1. Create your own GitHub repository to host the code.

  2. Run the command git remote set-url origin <Your GitHub Repo Path> to set the remote repository location to your repository.

  3. Push the files to your repository with the following command: git push

  4. Create a Heroku account if you don't already have one here Heroku.

  5. Create a new Heroku application on the following page here New Heroku App:

     • 

  6. Go to the Deploy tab:

     • 

  7. Link your GitHub account and connect the application to the repository you created.

     • 

  8. Go to the Settings tab:

     • 

  9. Click "Add buildpack":

     • 

  10. Add the Python and Node.js buildpacks in the following order:

      • 

  11. Click "Reveal Config Vars."

      • 

  12. Add 1 new Config Vars:

      • Key: PORT Value: 8000
      • This Config was provided by CODE INSTITUTE.

  13. Go back to the Deploy tab:

      • 

  14. Click "Deploy Branch":

      • 

      • Wait for the completion of the deployment.

      • 

  15. Click "Open app" to launch the application inside a web page.

      • 

---

Credits

Content and text

• Main information from Youtube video for example
• Many info Build a Quiz Application With Python

Media

• Open sites and sources of images and emblems
• Code institute for the deployment process
• Translated with www.DeepL.com/Translator and Grammarly for Windows

Acknowledgements

• Special thanks to Julia Konovalova for the call and conversation that helped me, after the first unsuccessful attempt, to find the strength in the first place and to understand my shortcomings in the project and complete it.
• Code Institute tutors and Slack community members for their support and help.

---

Happy coding!