Feature/scan_logger

CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# 👥 Contribution Guide
+
+Welcome to the Hall of Fame! 🏆 
+
+Every line of code, every bug fix, every pixel of design — it all comes from people like **you**.  
+
+------------------------------------------------------------------------------------------
+**VisionMate** is more than just an AI project — it’s a growing community of learners, builders, and innovators 💡.
+
+🧠💻🎨🚀💬  
+From developers to designers to curious first-timers — we see you, we appreciate you, and we welcome you.
+
+-------------------------------------------------------------------------------------------
+
+
+## 🛠️ Contribution Areas
+
+You can contribute to:
+
+🎨Python – Core backend and computer vision
+🧠OpenCV – Image processing and recognition
+🗃️Flask / Django – Backend framework (to be finalized)
+📊React.js / Flutter – Frontend or app interface
+📊MySQL – Data storage
+📋Google Cloud Vision API – (future integration)
+📋Text-to-Speech / Speech-to-Text APIs – Accessibility tools
+
+
+-------------------------------------------------------------------------------------------
+
+## 🚀 Getting Started
+
+
+Follow these steps to contribute to the VisionMate project on your local machine:
+
+# 1. Fork the Repository
+By clicking on the Fork button of the repository, you get access to commit changes and push them in github.
+
+
+# 2. Clone the repository
+git clone https://github.com/kaushav07/VisionMate.git
+
+# 3. Navigate into the project directory
+cd VisionMate
+
+# 4. Install all the required dependencies
+pip install -r requirements.txt
+
+
+
+
+-------------------------------------------------------------------------------------------
+

scan_logger.py

@@ -0,0 +1,37 @@
+import datetime
+
+# Global list to store scan history
+scan_history = []
+
+# FUNCTION TO LOG SCAN ENTRY
+def log_scan(caption, user_command):
+    timestamp = datetime.datetime.now().strftime('%d-%m-%Y, %H:%M:%S')
+    entry = {
+        "timestamp": timestamp,       
+        "caption": caption,           
+        "user_command": user_command  
+    }
+    scan_history.append(entry)  # ✅ Ensures entry is saved
+    print("✅ Logged time and data")
+
+# FUNCTION TO SHOW ALL HISTORY
+def show_history():
+    if not scan_history:
+        print("\n📭 No scan history available.")
+        return
+
+    print("\n📜 Scan History:")
+    for i, entry in enumerate(scan_history, start=1):
+        print(f"\n🔹 Entry {i}")
+        print(f"   🕒 Time: {entry['timestamp']}")
+        print(f"   🖼️ Caption: {entry['caption']}")
+        print(f"   💬 User Command: {entry['user_command']}")
+
+# DEMO — RUN ONLY IF FILE IS MAIN
+if __name__ == "__main__":
+    log_scan("A man passing the main road", "Alert User")
+    log_scan("A family roaming in a busy market", "Describe the surroundings")
+    log_scan("Animal moving freely in the zoo", "Describe the surroundings")
+
+    show_history()
+