Merge branch 'main' into issue#844-Refactor-project.js

Author: Abhishek-Satyarum

.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

CONTRIBUTING.md

@@ -449,17 +449,17 @@ Once you feel comfortable, you can gradually try `level:intermediate`, `level:ad
 
 ## 🧪 Writing Tests
 
-To maintain code quality and ensure zero external dependencies, we use the standard library's `unittest` framework.
+To maintain code quality, the repository uses `pytest` for its automated test suite.
 
 1. **Test Directory**: All tests must be placed in the `tests/` directory at the root of the project.
 2. **File Naming**: Name your test file starting with `test_` (e.g., `test_armstrong.py`).
-3. **No External Modules**: Do not use external libraries like `pytest`. Stick strictly to `unittest`.
+3. **Test Runner**: Use `pytest` so local checks match the GitHub Actions workflow.
 4. **Mocking Inputs**: For CLI projects, use `subprocess` to provide input via `stdin`, or import helper methods directly.
 
 ### Running Tests Locally
 To run all tests and verify your changes:
 ```bash
-python -m unittest discover -s tests -v
+python -m pytest tests/ -v
 ```
 To run a syntax check across all files (similar to our CI):
 ```bash

README.md

@@ -6,7 +6,7 @@
 
 ### _Learn Python by Building Fun, Interactive Games & Tools!_
 
-[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![Python Version](https://img.shields.io/badge/python-3.10--3.12-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
 <p align="center">
@@ -80,14 +80,24 @@ python-mini-project/
 
 ### Prerequisites
 
-- Python 3.10 or higher
+- Python 3.10, 3.11, or 3.12
 - Git (for cloning the repository)
 - pip (Python package manager)
 
+### Encoding Note
+
+This repository uses UTF-8 for documentation, issue templates, and project metadata. If emoji or box-drawing characters appear as mojibake in a Windows terminal, switch the terminal to UTF-8 before viewing or running the files.
+
 ### Installation Steps
 
 #### 1. Clone the Repository
 
+<div align="right">
+
+<button class="copy-btn" data-copy="clone-command">📋 Copy</button>
+
+</div>
+
 ```bash
 git clone https://github.com/steam-bell-92/python-mini-project.git
 cd python-mini-project
@@ -97,6 +107,12 @@ cd python-mini-project
 
 For Linux/macOS:
 
+<div align="right">
+
+<button class="copy-btn" data-copy="linux-venv">📋 Copy</button>
+
+</div>
+
 ```bash
 python3 -m venv venv
 source venv/bin/activate
@@ -118,11 +134,19 @@ venv\Scripts\Activate.ps1
 
 #### 3. Install Dependencies
 
+<div align="right">
+
+<button class="copy-btn" data-copy="install-command">📋 Copy</button>
+
+</div>
+
 ```bash
 pip install --upgrade pip
 pip install -r requirements.txt
 ```
 
+The dependency set is tested on Python 3.10 through 3.12. Newer Python releases may not have compatible wheels for every pinned dependency yet.
+
 ### Running Command-Line Projects
 
 Each Python project in `games/`, `math/`, and `utilities/` folders can be run independently.
@@ -161,6 +185,12 @@ The web app requires Node.js and npm:
 
 #### Steps to Run Web App
 
+<div align="right">
+
+<button class="copy-btn" data-copy="web-command">📋 Copy</button>
+
+</div>
+
 ```bash
 cd web-app
 npm install
@@ -173,14 +203,20 @@ The app will open at `http://localhost:3000` (or your configured port).
 
 To verify that the projects work correctly, run the test suite:
 
+<div align="right">
+
+<button class="copy-btn" data-copy="pytest-command">📋 Copy</button>
+
+</div>
+
 ```bash
 pytest tests/ -v
 ```
 
 For specific test file:
 
 ```bash
-pytest tests/test_armstrong.py -v
+pytest tests/test_smoke.py -v
 ```
 
 ### Development Workflow

games/2048-Game/2048-Game.py

@@ -75,9 +75,17 @@ def __init__(self, root):
         )
         self.restart_button.grid(pady=5)
 
+        self.reset_high_score_button = tk.Button(
+            root,
+            text="Reset High Score",
+            font=("Arial", 12, "bold"),
+            command=self.reset_high_score
+        )
+        self.reset_high_score_button.grid(pady=5)
+
         self.instruction_label = tk.Label(
             root,
-            text="🎮 Controls: ← ↑ → ↓ | Merge same numbers | Goal: 2048 🎯",
+            text="🎮 Controls: WASD / ← ↑ → ↓ | Merge same numbers | Goal: 2048 🎯",
             font=("Arial", 10),
             fg="#6a635b",
         )
@@ -87,6 +95,8 @@ def __init__(self, root):
         self.board = [[0] * GRID_SIZE for _ in range(GRID_SIZE)]
 
         self.game_over_label = None
+        self.win_label = None
+        self.game_won = False
 
         self.create_grid()
         self.start_new_game()
@@ -107,6 +117,18 @@ def save_high_score(self):
         except OSError as e:
             print(f"Warning: Could not save high score: {e}")
 
+    def reset_high_score(self):
+        """Reset the high score to 0 and clear the saved high score file."""
+        self.high_score = 0
+        try:
+            if HIGH_SCORE_PATH.exists():
+                HIGH_SCORE_PATH.unlink()
+        except OSError as e:
+            print(f"Warning: Could not delete high score file: {e}")
+        self.score_label.configure(
+            text=f"Score: {self.score}    High Score: {self.high_score}"
+        )
+
     def create_grid(self):
         for row in range(GRID_SIZE):
             row_cells = []
@@ -146,6 +168,7 @@ def start_new_game(self):
         self.board = [[0] * GRID_SIZE for _ in range(GRID_SIZE)]
         self.score = 0
         self.moves_left = TOTAL_MOVES
+        self.game_won = False
 
         self.add_new_tile()
         self.add_new_tile()
@@ -261,44 +284,58 @@ def check_game_over(self):
 
         return True
 
-    def handle_keypress(self, event):
-        key = event.keysym
-        moved = False
-
-        if key == "Left":
-            moved = self.move_left()
+    def check_win(self):
+        return any(2048 in row for row in self.board)
 
-        elif key == "Right":
-            moved = self.move_right()
-
-        elif key == "Up":
-            moved = self.move_up()
-
-        elif key == "Down":
-            moved = self.move_down()
-
-        else:
+    def handle_keypress(self, event):
+        key = event.keysym.lower() if len(event.keysym) == 1 else event.keysym
+        move_map = {
+            "Left": self.move_left,  "a": self.move_left,
+            "Right": self.move_right, "d": self.move_right,
+            "Up": self.move_up,      "w": self.move_up,
+            "Down": self.move_down,  "s": self.move_down,
+        }
+        if key not in move_map:
             return
-        
-        
+
+        moved = move_map[key]()
 
         if moved:
             self.add_new_tile()
-            self.moves_left -=1
+            self.moves_left -= 1
 
             if self.score > self.high_score:
                 self.high_score = self.score
                 self.save_high_score()
 
             self.update_grid()
 
-        # FIXED BUG:
-        # Game over is now checked even when no movement happens
-        if self.check_game_over():
-            self.game_over()
-        if self.moves_left<=0:
+            if not self.game_won and self.check_win():
+                self.you_win()
+                return
+
+        # Check for game over even if no movement happens
+        if self.check_game_over() or self.moves_left <= 0:
             self.game_over()
 
+    def you_win(self):
+
+        if self.game_won:
+            return
+
+        self.game_won = True
+
+        self.root.unbind("<Key>")
+
+        self.win_label = tk.Label(
+            self.root,
+            text="🎉 YOU WIN! 🎉",
+            font=("Arial", 24, "bold"),
+            fg="green"
+        )
+
+        self.win_label.grid(pady=10)
+
     def game_over(self):
 
         # Prevent duplicate labels
@@ -324,6 +361,11 @@ def restart_game(self):
             self.game_over_label.destroy()
             self.game_over_label = None
 
+        # Remove old win label
+        if self.win_label is not None:
+            self.win_label.destroy()
+            self.win_label = None
+
         self.start_new_game()
 
         # Re-enable keyboard controls
@@ -335,5 +377,6 @@ def main():
     game = Game2048(root)
     root.mainloop()
 
+
 if __name__ == "__main__":
     main()