{"id":28907641,"url":"https://github.com/teditae/us-states-guessing-game","last_synced_at":"2026-04-22T23:35:56.805Z","repository":{"id":300058590,"uuid":"1003129192","full_name":"TediTae/us-states-guessing-game","owner":"TediTae","description":"A Python game built with Turtle and Pandas where the player guesses the names of U.S. states and sees them appear on a U.S. map. A fun way to learn geography while coding!","archived":false,"fork":false,"pushed_at":"2025-06-19T16:39:15.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-19T17:42:50.548Z","etag":null,"topics":["data-visualization","geography-game","pandas","python","turtle"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TediTae.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-06-16T17:06:11.000Z","updated_at":"2025-06-19T16:39:18.000Z","dependencies_parsed_at":"2025-06-19T17:43:29.167Z","dependency_job_id":"1da315b1-c081-4a81-a648-894b64678c20","html_url":"https://github.com/TediTae/us-states-guessing-game","commit_stats":null,"previous_names":["teditae/us-states-guessing-game"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/TediTae/us-states-guessing-game","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TediTae%2Fus-states-guessing-game","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TediTae%2Fus-states-guessing-game/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TediTae%2Fus-states-guessing-game/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TediTae%2Fus-states-guessing-game/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TediTae","download_url":"https://codeload.github.com/TediTae/us-states-guessing-game/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TediTae%2Fus-states-guessing-game/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261153584,"owners_count":23116915,"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":["data-visualization","geography-game","pandas","python","turtle"],"created_at":"2025-06-21T16:04:46.628Z","updated_at":"2026-04-22T23:35:56.797Z","avatar_url":"https://github.com/TediTae.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# U.S. States Guessing Game 🗺️\n\n## Description\nThis is an interactive game built with Python's Turtle graphics and Pandas, where the goal is to correctly guess all 50 U.S. states.\nEach correct guess displays the state name on a blank U.S. map.\nThe game continues until all states are guessed or the player exits.\n\n## Features\n- Graphical interface using Turtle\n- Text input dialog for guesses\n- Dynamically displays correct guesses on the map\n- Saves missing states to a `.csv` file for learning\n- Case-insensitive guessing with `.title()` formatting\n\n## How It Works\n1. A blank U.S. map is loaded using a `.gif` image.\n2. User is prompted to guess a state name.\n3. If the guess is correct, the state name is shown on the map.\n4. The game ends when all 50 states are guessed or the user types `Exit`.\n5. When exited early, the game saves a list of missing states to `states_to_learn.csv`.\n\n## Requirements\n- Python 3.x  \n- `pandas` library  \n- `turtle` (built-in with Python)  \n- A `50_states.csv` file containing columns: `state`, `x`, `y`  \n- A `blank_states_img.gif` image file\n\n## Installation\n1. Clone this repository\n2. Make sure you have the following files in the project directory:\n   - blank_states_img.gif\n   - 50_states.csv\n3. Run the Python script:\n   - main.py\n\n## Technologies Used\n- Python 3\n- Turtle Graphics\n- Pandas\n- CSV File Handling\n\n## License\n- This project is open source and available under the MIT License.\n\n## Contact\n- tolgayilmaz1377@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteditae%2Fus-states-guessing-game","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteditae%2Fus-states-guessing-game","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteditae%2Fus-states-guessing-game/lists"}