{"id":20557041,"url":"https://github.com/sharpvik/hangman","last_synced_at":"2025-07-19T15:39:40.839Z","repository":{"id":114206033,"uuid":"124949365","full_name":"sharpvik/hangman","owner":"sharpvik","description":"Hangman console game","archived":false,"fork":false,"pushed_at":"2018-04-28T06:16:38.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-06T06:48:32.586Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sharpvik.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-12T20:45:54.000Z","updated_at":"2018-05-08T03:53:33.000Z","dependencies_parsed_at":"2023-06-15T23:00:17.729Z","dependency_job_id":null,"html_url":"https://github.com/sharpvik/hangman","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sharpvik/hangman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpvik%2Fhangman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpvik%2Fhangman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpvik%2Fhangman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpvik%2Fhangman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sharpvik","download_url":"https://codeload.github.com/sharpvik/hangman/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sharpvik%2Fhangman/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265957975,"owners_count":23855360,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T03:34:25.968Z","updated_at":"2025-07-19T15:39:40.781Z","avatar_url":"https://github.com/sharpvik.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hangman Game\nThis is a simple Hangman game done in Python. \n\n## What's new\nIn the latest commit, letter **validation fixed**. The game will now reject any symbols other than letters and a dash \"-\" because it is used is some English words like \"good-bye\".\n\n## How to run\n1. To run this game you need to make sure you have **Python** installed on your machine. Except for that - it's really easy.\n2. **Download** this directory as a **ZIP file** by pressing the big green button *Clone or Download* -\u003e *Download ZIP*.\n3. **Unzip** the folder.\n4. As soon as you have the *hangman-master* folder unzipped, you need to **launch** *hangman.py*. You can do this using various methods (like CMD *for Windows*, Terminal *for MacOS*, Standard Python IDLE to open the file + F5 to run it *works on every platform*). \n5. Depending on your *Python installation settings* you can use commands like `python hangman.py` or `hangman.py` to launch the file in your console terminal. Be sure to change the path in your terminal to that of the *hangman-master* folder.\n\n*Windows* CMD terminal should look like this:\n```\nPS C:\\path\\to\\the\\folder\\hangman-master\u003e\n```\n*MacOS* or *Linux* terminal should look like this:\n```\njohn@doe:~ path/to/the/folder/hangman-master$\n```\n[*Windows* CMD Terminal Tutorial - YouTube](https://www.youtube.com/watch?v=MBBWVgE0ewk)\n\n[*MacOS* Terminal Tutorial - YouTube](https://www.youtube.com/watch?v=F1kAm_2d0yo)\n\n[*Linux* Terminal Tutorial - YouTube](https://www.youtube.com/watch?v=oxuRxtrO2Ag)\n\n\u003e To open *Windows CMD* window in this specific folder, you can open the folder, make sure none of the files are highlighted, **left SHIFT + right MOUSE click** hovering over some free space in the folder -\u003e *Open PowerShell window here* or *Open command window here*.\n6. **Enjoy!**\n\n## How to play\nThe game is fairly simple: algorithm randomly chooses a noun from the file called *words.txt* and your goal is to **guess** what this word is letter by letter.\nWhen you launch the file, you'd see something like this in your console:\n\n```\nWelcome to the HANGMAN game!\nNote: if you run this program on MacOS, input letters in 'speech marks' while guessing.\n\nWord: ********\nHealths: 10\nUsed letters:\nGuess a letter: \n``` \n\nGuess some letter and input it, then press *ENTER*. If your letter is present in the word - algorithm will change some of the stars to show you the position(s) of the letter in the word:\n\n```\nGuess a letter: m\n\nWord: *mm*****\nHealths: 10\nUsed letters: m\nGuess a letter: \n```\n\nIf you guessed wrong - one health point will be taken away from you:\n\n```\nGuess a letter: a\n\nWord: *mm*****\nHealths: 9\nUsed letters: m, a\nGuess a letter:\n```\n\nContinue until you figure it out or run out of health points. At the end you will receive a message according to your result. They look like this:\n\n```\nCongratulations! You won! The word was IMMUNITY.\n```\n```\nWell... It was a nice try anyways. The word was IMMUNITY.\n```\n\n## Progress\nIf you ever want to check your progress - open the *log.txt* file. There you can find all the information about your previous runs (won or lost, how long did it take, what was the word):\n\n```\nWON in 34 seconds for the word IMMUNITY\nLOST in 41 seconds for the word INTELLIGENCE\n```\n\n## Exit\nAfter each round the game will provide you with two choices: press *ENTER* to play again or input *Q* (doesn't matter upper- or lowercase) to exit.\n\n## Play yourself and share with friends!\nI would be flattered if you'd **share** this game with some of your friends and/or **collaborate** here in GitHub.\n\n## Contact\nFor any personal or business enquiries:\n- Email: *sharp.vik@gmail.com*\n- [Twitter](https://twitter.com/sharp_vik)\n- [VK](https://vk.com/perigrinus)\n- [Instagram](https://www.instagram.com/viktooooor) ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharpvik%2Fhangman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsharpvik%2Fhangman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsharpvik%2Fhangman/lists"}