Merge branch 'main' into fix/overlapping-sidebar

Author: anujsharma8d

README.md

@@ -90,6 +90,141 @@ python-mini-project/
 └── requirements.txt
 ```
 
+## 🚀 Getting Started
+
+### Prerequisites
+
+- Python 3.10 or higher
+- Git (for cloning the repository)
+- pip (Python package manager)
+
+### Installation Steps
+
+#### 1. Clone the Repository
+
+```bash
+git clone https://github.com/steam-bell-92/python-mini-project.git
+cd python-mini-project
+```
+
+#### 2. Create a Virtual Environment
+
+For Linux/macOS:
+```bash
+python3 -m venv venv
+source venv/bin/activate
+```
+
+For Windows (Command Prompt):
+```bash
+python -m venv venv
+venv\Scripts\activate
+```
+
+For Windows (PowerShell):
+```bash
+python -m venv venv
+venv\Scripts\Activate.ps1
+```
+
+#### 3. Install Dependencies
+
+```bash
+pip install --upgrade pip
+pip install -r requirements.txt
+```
+
+### Running Command-Line Projects
+
+Each Python project in `games/`, `math/`, and `utilities/` folders can be run independently.
+
+#### Example: Running a Game
+
+```bash
+cd games/Snake-Game
+python Snake-Game.py
+```
+
+#### Example: Running a Math Project
+
+```bash
+cd math/Fibonacci-Series
+python Fibonacci-Series.py
+```
+
+#### Example: Running a Utility
+
+```bash
+cd utilities/Text-to-Morse
+python Text-to-Morse.py
+```
+
+### Running the Web App
+
+The web application provides a browser-based interface for all projects.
+
+#### Prerequisites for Web App
+
+The web app requires Node.js and npm:
+- Download from https://nodejs.org/ (v16 or higher recommended)
+- Verify installation: `node --version && npm --version`
+
+#### Steps to Run Web App
+
+```bash
+cd web-app
+npm install
+npm start
+```
+
+The app will open at `http://localhost:3000` (or your configured port).
+
+### Running Tests
+
+To verify that the projects work correctly, run the test suite:
+
+```bash
+pytest tests/ -v
+```
+
+For specific test file:
+```bash
+pytest tests/test_armstrong.py -v
+```
+
+### Development Workflow
+
+#### Creating a New Project
+
+1. Choose appropriate directory: `games/`, `math/`, or `utilities/`
+2. Create a new folder with your project name (use PascalCase)
+3. Add your `.py` file with the same name as the folder
+4. Include a `README.md` in your project folder with usage instructions
+5. Add tests in `tests/` directory with prefix `test_`
+
+#### Code Guidelines
+
+- Follow PEP 8 style guide
+- Write docstrings for functions and classes
+- Add unit tests for your code
+- Test your project before submitting a PR
+
+#### Virtual Environment Reminder
+
+Always activate your virtual environment before working:
+```bash
+# Linux/macOS
+source venv/bin/activate
+
+# Windows
+venv\Scripts\activate
+```
+
+Deactivate when done:
+```bash
+deactivate
+```
+
 ## 🧩 What’s Inside
 
 - Games for quick interactive fun
@@ -608,20 +743,26 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@advikdivekar</b></sub>
       </a>
     </td>
+    <td align="center" width="120">
+      <a href="https://github.com/anshul23102">
+        <img src="https://github.com/anshul23102.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="anshul23102" /><br />
+        <sub><b>@anshul23102</b></sub>
+      </a>
+    </td>
     <td align="center" width="120">
       <a href="https://github.com/anujsharma8d">
         <img src="https://github.com/anujsharma8d.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="anujsharma8d" /><br />
         <sub><b>@anujsharma8d</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/artic2702">
         <img src="https://github.com/artic2702.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="artic2702" /><br />
         <sub><b>@artic2702</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/ash-heinz">
         <img src="https://github.com/ash-heinz.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="ash-heinz" /><br />
@@ -652,14 +793,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@basantnema31</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/bhavyapandiya29">
         <img src="https://github.com/bhavyapandiya29.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="bhavyapandiya29" /><br />
         <sub><b>@bhavyapandiya29</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/codewithakshyaaa">
         <img src="https://github.com/codewithakshyaaa.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="codewithakshyaaa" /><br />
@@ -690,14 +831,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@dikshajha13</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/gatiksolanki13-netizen">
         <img src="https://github.com/gatiksolanki13-netizen.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="gatiksolanki13-netizen" /><br />
         <sub><b>@gatiksolanki13-netizen</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/iamprasoon2006-cell">
         <img src="https://github.com/iamprasoon2006-cell.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="iamprasoon2006-cell" /><br />
@@ -728,14 +869,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@jyotish6699</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/knoxiboy">
         <img src="https://github.com/knoxiboy.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="knoxiboy" /><br />
         <sub><b>@knoxiboy</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/kumudasrip">
         <img src="https://github.com/kumudasrip.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="kumudasrip" /><br />
@@ -766,14 +907,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@mrinmoyChakraborty-mrinox</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/n1o5">
         <img src="https://github.com/n1o5.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="n1o5" /><br />
         <sub><b>@n1o5</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/nene-hana">
         <img src="https://github.com/nene-hana.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="nene-hana" /><br />
@@ -804,14 +945,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@palak-paliwal11</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/parasmani-dev">
         <img src="https://github.com/parasmani-dev.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="parasmani-dev" /><br />
         <sub><b>@parasmani-dev</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/parulpaliwal01">
         <img src="https://github.com/parulpaliwal01.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="parulpaliwal01" /><br />
@@ -842,14 +983,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@r-sushanth08</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/rashiaggarwal06">
         <img src="https://github.com/rashiaggarwal06.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="rashiaggarwal06" /><br />
         <sub><b>@rashiaggarwal06</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/rishit537">
         <img src="https://github.com/rishit537.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="rishit537" /><br />
@@ -880,14 +1021,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@sanzzzz-g</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/shaktipy">
         <img src="https://github.com/shaktipy.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="shaktipy" /><br />
         <sub><b>@shaktipy</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/shimonenator">
         <img src="https://github.com/shimonenator.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="shimonenator" /><br />
@@ -918,14 +1059,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@snehacodes-2906</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/snehanair-486">
         <img src="https://github.com/snehanair-486.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="snehanair-486" /><br />
         <sub><b>@snehanair-486</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/steam-bell-92">
         <img src="https://github.com/steam-bell-92.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="steam-bell-92" /><br />
@@ -956,14 +1097,14 @@ These standalone Python project files do not have a browser counterpart yet and
         <sub><b>@unknown-tech-ui</b></sub>
       </a>
     </td>
+  </tr>
+  <tr>
     <td align="center" width="120">
       <a href="https://github.com/vedansht2211">
         <img src="https://github.com/vedansht2211.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="vedansht2211" /><br />
         <sub><b>@vedansht2211</b></sub>
       </a>
     </td>
-  </tr>
-  <tr>
     <td align="center" width="120">
       <a href="https://github.com/vedika76">
         <img src="https://github.com/vedika76.png?size=100" width="100" height="100" style="border-radius:50%; border:2px solid #555;" alt="vedika76" /><br />
@@ -989,7 +1130,6 @@ These standalone Python project files do not have a browser counterpart yet and
       </a>
     </td>
     <td width="120"></td>
-    <td width="120"></td>
   </tr>
 </table>
 <!-- CONTRIBUTORS_END -->

games/Flipping-Toss/Flipping-Toss.py

@@ -16,12 +16,14 @@ def main():
 
         if choice == "y":
             num = random.randint(1, 2)
-            # User prediction
-            prediction = input("Predict the result (H/T): ").lower().strip()
+            
+            # Sub-loop for validating user prediction without resetting the game loop
+            while True:
+                prediction = input("Predict the result (H/T): ").lower().strip()
 
-            if prediction not in ["h", "t"]:
+                if prediction in ["h", "t"]:
+                    break
                 print("❌ Invalid prediction!! Please enter 'H' or 'T'.\n")
-                continue
 
             print("🪙 Flipping...")
             time.sleep(2)
@@ -67,4 +69,4 @@ def main():
 
 
 if __name__ == '__main__':
-    main()
+    main()