Refactor: wrap Jarvis functions into VirtualAssistant class

- VirtualAssistant encapsulates speech I/O (pyttsx3 + SpeechRecognition)
- Command pattern: run() dispatches voice queries to action methods
- Remove committed .venv from tracking
- 6 pytest unit tests with mocked hardware
- Professional README with architecture and design pattern table

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: DaoudSabat

.gitignore

@@ -0,0 +1,3 @@
+from .assistant import VirtualAssistant
+
+__all__ = ["VirtualAssistant"]

README.md

@@ -0,0 +1,117 @@
+"""Virtual assistant — speech I/O and command dispatch."""
+from __future__ import annotations
+
+import datetime
+import webbrowser
+
+import pyttsx3
+import speech_recognition as sr
+import wikipedia
+
+
+class VirtualAssistant:
+    """Jarvis-style voice assistant with pluggable command handlers."""
+
+    def __init__(self, name: str = "Jarvis") -> None:
+        self.name = name
+        self._engine = pyttsx3.init()
+        self._recognizer = sr.Recognizer()
+
+    # ------------------------------------------------------------------
+    # Speech I/O
+    # ------------------------------------------------------------------
+
+    def speak(self, text: str) -> None:
+        """Convert text to speech."""
+        self._engine.say(text)
+        self._engine.runAndWait()
+
+    def listen(self) -> str | None:
+        """Listen via microphone and return recognised text (or None)."""
+        try:
+            with sr.Microphone() as source:
+                print("Listening...")
+                self._recognizer.adjust_for_ambient_noise(source, duration=1)
+                self._recognizer.pause_threshold = 1
+                audio = self._recognizer.listen(source)
+            query = self._recognizer.recognize_google(audio, language="en-in")
+            print(f"Command: {query}")
+            return query
+        except sr.UnknownValueError:
+            self.speak("Sorry, I didn't catch that.")
+        except sr.RequestError as e:
+            self.speak("Speech service unavailable.")
+            print(f"RequestError: {e}")
+        except Exception as e:
+            self.speak("An unexpected error occurred.")
+            print(f"Error: {e}")
+        return None
+
+    # ------------------------------------------------------------------
+    # Command handlers
+    # ------------------------------------------------------------------
+
+    def greet(self) -> None:
+        self.speak(f"Hello! I'm {self.name}. How can I assist you?")
+
+    def tell_day(self) -> None:
+        days = {1: "Monday", 2: "Tuesday", 3: "Wednesday", 4: "Thursday",
+                5: "Friday", 6: "Saturday", 7: "Sunday"}
+        day = datetime.datetime.today().weekday() + 1
+        self.speak(f"Today is {days[day]}")
+
+    def tell_time(self) -> None:
+        t = datetime.datetime.now().strftime("%H:%M")
+        self.speak(f"The time is {t}")
+
+    def open_google(self, search: str) -> None:
+        webbrowser.open(f"https://www.google.com/search?q={search}")
+
+    def open_url(self, url: str) -> None:
+        webbrowser.open(url)
+
+    def wikipedia_search(self, query: str) -> None:
+        self.speak("Checking Wikipedia")
+        try:
+            result = wikipedia.summary(query, sentences=4)
+            self.speak("According to Wikipedia")
+            self.speak(result)
+        except wikipedia.exceptions.DisambiguationError:
+            self.speak("Multiple entries found. Please be more specific.")
+        except wikipedia.exceptions.PageError:
+            self.speak("No Wikipedia page found for that topic.")
+
+    # ------------------------------------------------------------------
+    # Main loop
+    # ------------------------------------------------------------------
+
+    def run(self) -> None:
+        """Start the assistant and listen for commands indefinitely."""
+        self.greet()
+        while True:
+            query = self.listen()
+            if query is None:
+                continue
+            query = query.lower()
+
+            if "open google" in query:
+                self.speak("What do you want to search for?")
+                term = self.listen()
+                if term:
+                    self.open_google(term)
+            elif "open geeksforgeeks" in query:
+                self.speak("Opening Geeks for Geeks")
+                self.open_url("https://www.geeksforgeeks.com")
+            elif "which day is it" in query:
+                self.tell_day()
+            elif "tell me the time" in query:
+                self.tell_time()
+            elif "from wikipedia" in query:
+                self.wikipedia_search(query.replace("from wikipedia", "").strip())
+            elif "your name" in query:
+                self.speak(f"I am {self.name}, your desktop assistant.")
+            elif "exit" in query or "bye" in query:
+                self.speak("Goodbye! Have a great day!")
+                break
+            else:
+                self.speak("Sorry, I didn't understand that command.")

core/__init__.py

@@ -0,0 +1,6 @@
+"""Entry point — launches the Jarvis virtual assistant."""
+from core.assistant import VirtualAssistant
+
+if __name__ == "__main__":
+    assistant = VirtualAssistant(name="Jarvis")
+    assistant.run()

core/assistant.py

@@ -0,0 +1,5 @@
+pyttsx3>=2.90
+SpeechRecognition>=3.10.0
+wikipedia>=1.4.0
+pyaudio>=0.2.13
+pytest>=7.4.0

main.py

@@ -0,0 +1,52 @@
+"""Unit tests for VirtualAssistant — mocks all hardware (mic, speaker, browser)."""
+import datetime
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from core.assistant import VirtualAssistant
+
+
+@pytest.fixture
+def assistant():
+    with patch("core.assistant.pyttsx3.init"):
+        a = VirtualAssistant(name="TestBot")
+    a._engine = MagicMock()
+    return a
+
+
+def test_speak_calls_engine(assistant):
+    assistant.speak("Hello")
+    assistant._engine.say.assert_called_once_with("Hello")
+    assistant._engine.runAndWait.assert_called_once()
+
+
+def test_tell_day_speaks_a_day(assistant):
+    with patch.object(assistant, "speak") as mock_speak:
+        assistant.tell_day()
+        called_text = mock_speak.call_args[0][0]
+        assert "day is" in called_text.lower()
+
+
+def test_tell_time_format(assistant):
+    with patch.object(assistant, "speak") as mock_speak:
+        assistant.tell_time()
+        called_text = mock_speak.call_args[0][0]
+        assert ":" in called_text
+
+
+@patch("core.assistant.webbrowser.open")
+def test_open_google(mock_open, assistant):
+    assistant.open_google("Python tutorials")
+    mock_open.assert_called_once()
+    assert "Python+tutorials" in mock_open.call_args[0][0] or "Python" in mock_open.call_args[0][0]
+
+
+@patch("core.assistant.webbrowser.open")
+def test_open_url(mock_open, assistant):
+    assistant.open_url("https://example.com")
+    mock_open.assert_called_once_with("https://example.com")
+
+
+def test_assistant_name(assistant):
+    assert assistant.name == "TestBot"