{"id":24792725,"url":"https://github.com/misaghmomenib/number-guessing-game-go","last_synced_at":"2025-09-07T20:47:29.149Z","repository":{"id":269751716,"uuid":"908315807","full_name":"MisaghMomeniB/Number-Guessing-Game-Go","owner":"MisaghMomeniB","description":"A Fun and Engaging Number Guessing Game Built With Go. Challenge Yourself or Others to Guess the Correct Number Within a Set Range, With Feedback Provided After Each Guess to Guide You Towards the Solution.","archived":false,"fork":false,"pushed_at":"2025-06-13T20:10:06.000Z","size":14,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-22T10:47:50.163Z","etag":null,"topics":["git","golang","number-guessing-game","open-source"],"latest_commit_sha":null,"homepage":"","language":"Go","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/MisaghMomeniB.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":"2024-12-25T17:56:52.000Z","updated_at":"2025-06-13T20:10:10.000Z","dependencies_parsed_at":"2025-01-29T20:54:45.657Z","dependency_job_id":"6d6598bc-5a68-448a-8806-a122d9b6a57f","html_url":"https://github.com/MisaghMomeniB/Number-Guessing-Game-Go","commit_stats":null,"previous_names":["misaghmomenib/number-guessing-game-go"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MisaghMomeniB/Number-Guessing-Game-Go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FNumber-Guessing-Game-Go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FNumber-Guessing-Game-Go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FNumber-Guessing-Game-Go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FNumber-Guessing-Game-Go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MisaghMomeniB","download_url":"https://codeload.github.com/MisaghMomeniB/Number-Guessing-Game-Go/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MisaghMomeniB%2FNumber-Guessing-Game-Go/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274094912,"owners_count":25221430,"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","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["git","golang","number-guessing-game","open-source"],"created_at":"2025-01-29T20:54:39.961Z","updated_at":"2025-09-07T20:47:29.119Z","avatar_url":"https://github.com/MisaghMomeniB.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎯 Number Guessing Game (Go)\n\nA fun and interactive **CLI number‑guessing game** written in Go. A classic project to practice Go basics, randomization, input handling, and simple game design—all in your terminal.\n\n---\n\n## 📋 Table of Contents\n\n1. [Overview](#overview)  \n2. [Features](#features)  \n3. [Tech Stack \u0026 Requirements](#tech-stack--requirements)  \n4. [Installation \u0026 Build](#installation--build)  \n5. [Usage Examples](#usage-examples)  \n6. [Code Structure](#code-structure)  \n7. [Extendability Ideas](#extendability-ideas)  \n8. [Contributing](#contributing)  \n9. [License](#license)\n\n---\n\n## 💡 Overview\n\nThis terminal-based game picks a random number and challenges you to guess it with feedback after each try. It demonstrates Go fundamentals like package structure, random number generation, input/output routines, and loop control—perfect for beginners and educators.\n\n---\n\n## ✅ Features\n\n- 🎲 Random number generation between 1 and 100  \n- 🔁 Loop for continuous guessing until correct  \n- 📊 Feedback hints: \"too high\" or \"too low\"  \n- 📈 Counter for tracking attempts  \n- 👋 Replay option after a win\n\n---\n\n## 🛠️ Tech Stack \u0026 Requirements\n\n- Go **1.18+** with module support  \n- Uses only Go standard libraries (`fmt`, `bufio`, `os`, `math/rand`, `time`)\n\n---\n\n## ⚙️ Installation \u0026 Build\n\nClone and build:\n\n```bash\ngit clone https://github.com/MisaghMomeniB/Number-Guessing-Game-Go.git\ncd Number-Guessing-Game-Go\ngo build -o guess-game main.go\n````\n\nAlternatively, run directly:\n\n```bash\ngo run main.go\n```\n\n---\n\n## 🚀 Usage Examples\n\nRun the game:\n\n```bash\n./guess-game\n```\n\nSample session:\n\n```\nWelcome to Number Guessing Game!\nI'm thinking of a number between 1 and 100.\nEnter your guess:\n\u003e 50\nToo high!\nAttempts: 1\n\u003e 37\nToo low!\nAttempts: 2\n...\n\u003e 42\n🎉 You guessed it in 7 attempts!\nPlay again? (y/n):\n```\n\n---\n\n## 📁 Code Structure\n\n```\nNumber-Guessing-Game-Go/\n└── main.go         # Game logic and I/O loop\n```\n\n* Generates a random target (`rand.Intn(100) + 1`)\n* Reads input using `bufio.Reader` and parses integers\n* Provides feedback and keeps guessing until correct\n* Prompts to play again or exit\n\n---\n\n## 💡 Extendability Ideas\n\n* 🌟 Add **difficulty levels** (e.g., easy: 1–10, hard: 1–1000)\n* ⏱️ Add **timer** to track playtime\n* 🗃️ Maintain **high-scores** or best performance logs\n* 🎨 Add **ASCII art** or colorized output\n* 📦 Package as a module with flags (e.g., `--max=500`)\n\n---\n\n## 🤝 Contributing\n\nContributions welcome! Suggestions include:\n\n1. Fork the repo\n2. Create a `feature/...` branch\n3. Write clean, commented code\n4. Submit a Pull Request with changes\n\n---\n\n## 📄 License\n\nReleased under the **MIT License** — see `LICENSE` file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisaghmomenib%2Fnumber-guessing-game-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmisaghmomenib%2Fnumber-guessing-game-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmisaghmomenib%2Fnumber-guessing-game-go/lists"}