chore(release): v1.0.0 - initial working version of LeetCode status checker bot

Author: Rajat069

.gitignore

@@ -0,0 +1,13 @@
+.env
+.zip
+users.json
+__pycache__/
+*.pyc
+.vscode/
+.env.local
+.env.*.local
+.DS_Store
+.idea/
+*.iml
+logs/
+*.log

main.py

@@ -0,0 +1,89 @@
+import schedule
+import time
+import sys
+import threading
+import itertools
+from src.core_logic import run_check
+from src.config import validate_config
+from tqdm import tqdm
+import time
+from rich.console import Console
+from rich.panel import Panel
+from rich import print as rprint
+
+spinner_running = True
+spinner_cycle = itertools.cycle(['-', '\\', '|', '/'])
+
+def spinner_thread():
+    """A simple thread to show a spinning cursor in the console."""
+    while spinner_running:
+        sys.stdout.write(next(spinner_cycle) + '\r')
+        sys.stdout.flush()
+        time.sleep(0.1)
+    sys.stdout.write(' \r')
+    sys.stdout.flush()
+
+def schedule_jobs():
+    """Sets up the scheduled times for the submission check."""
+    # Note: These times are UTC, which is standard for servers.
+    utc_times = ["03:30", "06:30", "13:30", "17:30"]
+    print(f"⏰ Scheduling jobs at the following UTC times: {', '.join(utc_times)}")
+    for t in utc_times:
+        schedule.every().day.at(t).do(run_check)
+
+def main():
+    """Main function to start the bot."""
+    global spinner_running
+    console = Console()
+    
+    # startup banner
+    console.print(Panel.fit(
+        "[bold yellow]LeetCode Reminder Bot[/bold yellow]\n\n"
+        "[blue]     Version 1.0[/blue]",
+        title="🤖 Welcome",
+        border_style="green",
+        padding=(1, 5)
+    ))
+    #loading animation
+    with tqdm(total=100, 
+                desc="Initializing system",
+                colour='cyan',
+                ncols=75,
+                bar_format='{desc}: {percentage:3.0f}%|{bar}| {n_fmt}/{total_fmt}') as pbar:
+            for i in range(10):
+                time.sleep(0.1)
+                pbar.update(10)
+
+    if not validate_config():
+        sys.exit(1) # Exit if secrets aren't set
+
+    # Run one check immediately on startup
+    try:
+        run_check()
+    except Exception as e:
+        print(f"\nAn error occurred during the initial run: {e}")
+
+    schedule_jobs()
+    print("\n  Scheduler is now running. Waiting for the next scheduled time...")
+    print("   (Running as a service. Press Ctrl+C to exit if running locally.)")
+
+    t = threading.Thread(target=spinner_thread)
+    t.start()
+
+    try:
+        while True:
+            schedule.run_pending()
+            time.sleep(1)
+    except KeyboardInterrupt:
+        print("\n")
+        rprint(Panel.fit(
+            "[bold yellow]Shutting down the bot[/bold yellow]\n",
+            title=" Goodbye! :(",
+            border_style="cyan",
+            padding=(1, 4)
+        ))
+        spinner_running = False
+        t.join()
+
+if __name__ == "__main__":
+    main()

src/config.py

@@ -0,0 +1,85 @@
+import os
+import json
+from dotenv import load_dotenv
+
+# Load environment variables from a .env file if it exists
+# This is great for local development.
+# On VM, we will set these variables directly.
+load_dotenv()
+
+# --- Load Environment Variables ---
+SMTP_USER = os.getenv("SMTP_USER")
+SMTP_PASSWORD = os.getenv("GMAIL_APP_PASSWORD")
+
+
+SMTP_SERVER = os.getenv("SMTP_SERVER", "smtp.gmail.com")
+SMTP_PORT = int(os.getenv("SMTP_PORT", 587))
+LEETCODE_API_URL = os.getenv("LEETCODE_API_URL", "https://leetcode.com/graphql")
+
+# --- Static Config (App-level constants) ---
+QUOTES = [
+    "Keep pushing! You’re closer than you think 💪",
+    "Consistency beats motivation every time ⚡",
+    "Another problem solved — another step ahead 🚀",
+    "Your hard work today is your success tomorrow 💫",
+    "One problem a day keeps the bugs away 🧠"
+]
+
+# --- GraphQL Queries ---
+QUERY_DAILY_QUESTION = """
+query questionOfToday {
+  activeDailyCodingChallengeQuestion {
+    date
+    link
+    question {
+      title
+      titleSlug
+      difficulty
+      hints
+      topicTags{
+        name
+      }
+    }
+  }
+}
+"""
+
+QUERY_RECENT_SUBMISSIONS = """
+query recentAcSubmissions($username: String!, $limit: Int!) {
+  recentAcSubmissionList(username: $username, limit: $limit) {
+    titleSlug
+    timestamp
+  }
+}
+"""
+
+# --- Helper Functions ---
+
+def load_users():
+    """Loads the user list from users.json."""
+    users_filepath = 'users.json' # place users.json in the root
+    if not os.path.exists(users_filepath):
+        # local testing
+        users_filepath = os.path.join(os.path.dirname(__file__), '..', 'users.json')
+
+    try:
+        with open(users_filepath, 'r') as f:
+            return json.load(f)
+    except FileNotFoundError:
+        print(" users.json file not found at {users_filepath}.")
+        return []
+    except json.JSONDecodeError:
+        print(f" Error: {users_filepath} is not valid JSON.")
+        return []
+
+def validate_config():
+    """Checks if essential secrets are loaded."""
+    if not SMTP_USER or not SMTP_PASSWORD:
+        print(" FATAL ERROR: SMTP_USER or GMAIL_APP_PASSWORD is not set.")
+        print("  Please set these environment variables before running.")
+        print("  If running locally, check your .env file.")
+        return False
+    
+    print("Configuration and secrets loaded successfully.")
+    return True
+

src/core_logic.py

@@ -0,0 +1,59 @@
+import random
+from datetime import datetime, timedelta
+from . import config
+from . import leetcode_api
+from halo import Halo
+from . import email_service
+
+def run_check():
+    """Main logic to check submissions for each user and send emails."""
+    ist_now = datetime.utcnow() + timedelta(hours=5, minutes=30)
+    print(f"\n[{ist_now.strftime('%Y-%m-%d %H:%M:%S')} IST] Starting submission check...")
+
+    daily_slug, question_link = leetcode_api.get_daily_question()
+    if not daily_slug:
+        print("Aborting check since daily question could not be fetched.")
+        return
+    
+    print(f"Today's POTD is '{daily_slug}'")
+    today = ist_now.date()
+    
+    users = config.load_users()
+    if not users:
+        print("No users loaded from users.json. Exiting check.")
+        return
+
+    for user in users:
+        username, email = user["username"], user["email"]
+        print(f"\n🔍 Checking user: {username}")
+        
+        #submissions = leetcode_api.get_recent_submissions(username)
+        with Halo(text='Fetching submissions...', spinner='star2', color='cyan') as spinner:
+            submissions = leetcode_api.get_recent_submissions(username)
+            spinner.succeed('Submissions fetched successfully!')
+
+        solved_today = any(
+            sub["titleSlug"] == daily_slug and
+            (datetime.fromtimestamp(int(sub["timestamp"])) + timedelta(hours=5, minutes=30)).date() == today
+            for sub in submissions
+        )
+
+        if solved_today:
+            print(f"[ {username} ] has already solved the daily problem.")
+            quote = random.choice(config.QUOTES)
+            html = email_service.build_html_email(username, daily_slug, question_link, True, quote)
+            subject = f"Awesome! You solved today’s LeetCode challenge!"
+        else:
+            print(f" [ {username} ]has not solved the daily problem yet. Sending reminder.")
+            html = email_service.build_html_email(username, daily_slug, question_link, False)
+            subject = f"⏳ Reminder: Solve Today’s LeetCode Problem!"
+
+        
+        with Halo(text='Sending mail..', spinner='bouncingBar', color='yellow') as spinner:
+            try:
+                email_service.send_email(email, subject, html)
+                spinner.succeed(f"Mail sent successfully! to user {username}")
+            except Exception as e:
+                spinner.fail(f'Failed to send mail: {e}')
+
+    print("\n--- Check complete ---")