Add db seeding script for jwt protected route testing (#12)

* Moved script tests to tests/scripts/.
* Refactored test_create_books.py to use with blocks for mocks, fixing a mock leak that caused KeyError in other tests.
* Removed runpy test and helper to resolve mock leak.
* Added TDD failing test for seed_users() and supporting files:
- scripts/test_data/sample_user_data.json
- scripts/seed_user.py 
* Added skip-if-existing-user logic to seed_users().
* Implemented seed_users(); all TDD tests now pass.\
* Added tests for main() covering happy path and failure modes → 100% coverage.
* Refactored script execution into main(); fixed pylint issues.
* Updated script to use absolute path based on script location.
* Updated Makefile with seed-users command.
* Updated README.md to document seed_users().

Co-authored-by: Copilot <[email protected]>

Author: codesungrape

Makefile

@@ -10,7 +10,7 @@ PIP = $(VENV_DIR)/bin/pip
 .DEFAULT_GOAL := help
 
 # Phony Targets 
-.PHONY: run clean test help lint db-seed db-clean db-setup
+.PHONY: run clean test help lint db-seed db-clean db-setup seed-users
 
 # ==============================================================================
 # CORE COMMANDS - For everyday development
@@ -30,6 +30,7 @@ help: ## Show help
 	@echo "  make db-setup     Reset the database to a clean, seeded state. (Runs db-clean then db-seed)"
 	@echo "  make db-seed   Populate the database with initial data."
 	@echo "  make db-clean  Delete all book data from the database."
+	@echo "  make seed-users  Populate the database with initial user data."
 
 install: $(PIP)
 
@@ -86,3 +87,8 @@ db-seed: install
 db-clean: install
 	@echo "--> ⚠️  Deleting all books from the database..."
 	PATH=$(VENV_DIR)/bin:$$PATH PYTHONPATH=. $(PYTHON) -m scripts.delete_books
+
+
+seed-users: install
+	@echo "--- Seeding the database with user data ---"
+	PATH=$(VENV_DIR)/bin:$$PATH PYTHONPATH=. $(PYTHON) -m scripts.seed_users

README.md

@@ -80,8 +80,9 @@ To use the API, you first need to populate the database with some initial data.
 | Command        | Description                                                                 |
 |----------------|-----------------------------------------------------------------------------|
 | `make db-setup`| **(Recommended)** Resets the database. Runs `db-clean` and then `db-seed`. |
-| `make db-seed` | Populates the database with the contents of `scripts/books.json`.           |
+| `make db-seed` | Populates the database with the contents of `scripts/test_data/books.json`.           |
 | `make db-clean`| Deletes all documents from the 'books' collection. Useful for starting fresh. |
+| `make seed-users`| *** THIS IS WIP right now: The user data is required for the JWT authentication system. ***  Populates the database with initial user data for authentication from `scripts/test_data/sample_user_data.json`. |
 
 To perform a full database reset, run:
 ```bash

scripts/seed_users.py

@@ -0,0 +1,85 @@
+"""Seeding user_data script"""
+
+import os
+import json
+
+import bcrypt
+
+from app import create_app
+from app.extensions import mongo
+
+
+def seed_users(users_to_seed: list) -> str:
+    """
+    Processes a list of user data, hashes their passwords,
+    and inserts them into the database. Skips existing users.
+
+    This function MUST be run within an active Flask application context.
+
+    Args:
+        users_to_seed: A list of dicts, each with 'email' and 'password'.
+
+    Returns:
+        A string summarizing the result.
+    """
+    count = 0
+
+    for user_data in users_to_seed:
+        email = user_data["email"]
+
+        # Check if data already exists
+        if mongo.db.users.find_one({"email": email}):
+            print(f"Skipping existing user: {email}")
+            continue
+
+        # hash the password
+        hashed_password = bcrypt.hashpw(
+            user_data["password"].encode("utf-8"), bcrypt.gensalt()
+        )
+
+        # insert to new user
+        mongo.db.users.insert_one(
+            {"email": email, "password_hash": hashed_password.decode("utf-8")}
+        )
+        count += 1
+        print(f"Created user: {email}")
+
+    return f"Successfully seeded {count} users"
+
+
+def main():
+    """
+    Main execution function to run the seeding process.
+    handles app context, data loading, and calls the core seeding logic.
+    """
+    # Create the DEVELOPMENT app when run from the command line
+    app = create_app()
+    with app.app_context():
+
+        # 1. Get the directory where THIS script (seed_users.py) lives.
+        script_dir = os.path.dirname(__file__)
+
+        # 2. Build the full, absolute path to the JSON file.
+        user_data_path = os.path.join(script_dir, "test_data/sample_user_data.json")
+
+        try:
+            # You can define your default users here or import from another file
+            with open(user_data_path, "r", encoding="utf-8") as user_file:
+                default_users = json.load(user_file)
+
+            print("--- Starting user seeding ---")
+
+            message = seed_users(default_users)
+            print(f"--- {message} ---")
+            print("--- Seeding complete ---")
+
+        except FileNotFoundError:
+            print(f"Error: Data file not found at '{user_data_path}'.")
+        except json.JSONDecodeError:
+            print(
+                f"Error: Could not decode JSON from '{user_data_path}'. Check for syntax errors."
+            )
+
+
+if __name__ == "__main__":
+    main()

scripts/test_data/sample_user_data.json

@@ -0,0 +1,5 @@
+[
+    {"email": "[email protected]", "password": "AdminPassword123"},
+    {"email": "[email protected]", "password": "UserPassword456"},
+    {"email": "[email protected]", "password": "DAYSend1991"}
+]