python_learning_assistant.py

#!/usr/bin/env python3
"""
Python Learning Assistant for C# Developers
Based on: https://github.com/robch/python-for-csharp-devs

This interactive tool helps you navigate through 25 Python lessons designed
specifically for C# developers.
"""

import os
import json
from datetime import datetime
import urllib.request
import urllib.error
from rich.console import Console
from rich.markdown import Markdown

# Lesson structure from the repository
LESSONS = [
    {
        "number": 1,
        "title": "Python Installation and Setup",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-1.md",
        "duration": "10 min",
        "topics": [
            "Install Python on your machine",
            "Set up a Python development environment",
            "Learn how to run Python scripts and interact with the Python interpreter"
        ]
    },
    {
        "number": 2,
        "title": "Basic Syntax and Indentation",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-2.md",
        "duration": "10 min",
        "topics": [
            "Understand Python's significant use of indentation for block structuring",
            "Learn about statement terminators, comment syntax, and variable naming conventions",
            "Explore Python's dynamic typing system"
        ]
    },
    {
        "number": 3,
        "title": "Data Types and Variables",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-3.md",
        "duration": "10 min",
        "topics": [
            "Learn about common data types like numbers, strings, lists, tuples, and dictionaries"
        ]
    },
    {
        "number": 4,
        "title": "Control Flow",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-4.md",
        "duration": "10 min",
        "topics": [
            "Understand Python's control flow statements: if-else, for loops, and while loops",
            "Compare them to their C# counterparts"
        ]
    },
    {
        "number": 5,
        "title": "Functions",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-5.md",
        "duration": "10 min",
        "topics": [
            "Learn how to define and call functions in Python",
            "Explore function arguments and return values"
        ]
    },
    {
        "number": 6,
        "title": "File I/O",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-6.md",
        "duration": "10 min",
        "topics": [
            "Read and write files using Python's file handling methods",
            "Compare with C#'s file I/O"
        ]
    },
    {
        "number": 7,
        "title": "List Comprehensions",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-7.md",
        "duration": "10 min",
        "topics": [
            "Discover a powerful feature unique to Python for concise list operations"
        ]
    },
    {
        "number": 8,
        "title": "Dictionaries",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-8.md",
        "duration": "10 min",
        "topics": [
            "Understand Python dictionaries and their usage",
            "Compare with C#'s dictionary or hash table data structure"
        ]
    },
    {
        "number": 9,
        "title": "Modules and Packages",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-9.md",
        "duration": "10 min",
        "topics": [
            "Learn how to organize code into modules and packages in Python"
        ]
    },
    {
        "number": 10,
        "title": "Classes and Objects",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-10.md",
        "duration": "10 min",
        "topics": [
            "Introduce classes and objects in Python",
            "Compare with C#'s class-based approach"
        ]
    },
    {
        "number": 11,
        "title": "Exception Handling",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-11.md",
        "duration": "10 min",
        "topics": [
            "Explore Python's exception handling mechanism"
        ]
    },
    {
        "number": 12,
        "title": "Lambda Functions",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-12.md",
        "duration": "10 min",
        "topics": [
            "Understand anonymous functions using lambda expressions"
        ]
    },
    {
        "number": 13,
        "title": "Slicing and Indexing",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-13.md",
        "duration": "10 min",
        "topics": [
            "Learn about slicing and indexing in Python lists"
        ]
    },
    {
        "number": 14,
        "title": "Generators",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-14.md",
        "duration": "10 min",
        "topics": [
            "Introduce Python generators for lazy evaluation of sequences"
        ]
    },
    {
        "number": 15,
        "title": "Standard Library Overview",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-15.md",
        "duration": "10 min",
        "topics": [
            "Familiarize yourself with the extensive Python standard library"
        ]
    },
    {
        "number": 16,
        "title": "Third-Party Libraries and pip",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-16.md",
        "duration": "10 min",
        "topics": [
            "Learn how to install and use third-party libraries with pip",
            "Understand the importance of virtual environments and how to create them"
        ]
    },
    {
        "number": 17,
        "title": "Pythonic Code and Idioms",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-17.md",
        "duration": "10 min",
        "topics": [
            "Discover Python-specific coding styles and idioms"
        ]
    },
    {
        "number": 18,
        "title": "Common Pitfalls",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-18.md",
        "duration": "10 min",
        "topics": [
            "Highlight common pitfalls and errors when transitioning from C# to Python"
        ]
    },
    {
        "number": 19,
        "title": "Practice Projects",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-19.md",
        "duration": "10 min",
        "topics": [
            "Start working on small projects to apply your knowledge and enhance your skills"
        ]
    },
    {
        "number": 20,
        "title": "Multi-Threading Basics",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-20.md",
        "duration": "10 min",
        "topics": [
            "Introduce the concept of multi-threading and its benefits",
            "Learn how to create and manage threads in Python using the threading module",
            "Discuss the Global Interpreter Lock (GIL) and its impact on multi-threading in Python"
        ]
    },
    {
        "number": 21,
        "title": "Thread Pools and Executors",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-21.md",
        "duration": "10 min",
        "topics": [
            "Learn about thread pools and how to use the concurrent.futures module"
        ]
    },
    {
        "number": 22,
        "title": "Synchronization and Thread Safety",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-22.md",
        "duration": "10 min",
        "topics": [
            "Understand the challenges of concurrent access in multi-threaded programs",
            "Learn about thread synchronization techniques like locks, semaphores, and mutexes",
            "Discuss thread safety and potential issues when sharing data between threads"
        ]
    },
    {
        "number": 23,
        "title": "Asynchronous Programming with Async/Await",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-23.md",
        "duration": "10 min",
        "topics": [
            "Introduce asynchronous programming and its advantages in I/O-bound tasks",
            "Learn how to use async and await keywords to define and await asynchronous functions",
            "Compare synchronous and asynchronous approaches for I/O-bound operations"
        ]
    },
    {
        "number": 24,
        "title": "Combining Threads and Async in Python",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-24.md",
        "duration": "10 min",
        "topics": [
            "Explore scenarios where multi-threading and asynchronous programming can be combined effectively",
            "Discuss best practices and potential challenges when using both techniques together",
            "Demonstrate an example of combining threads and async in a Python application"
        ]
    },
    {
        "number": 25,
        "title": "Performance Considerations with Threads and Async",
        "url": "https://github.com/robch/python-for-csharp-devs/blob/main/learn-python-in-half-day-lesson-25.md",
        "duration": "10 min",
        "topics": [
            "Compare the performance characteristics of multi-threading and asynchronous programming",
            "Discuss the trade-offs between the two approaches in different scenarios",
            "Explore tools and techniques to profile and optimize threaded and async code"
        ]
    }
]

PROGRESS_FILE = os.path.expanduser("~/.python_learning_progress.json")


class LearningAssistant:
    def __init__(self):
        self.progress = self.load_progress()
        self.console = Console()
        self.content_cache = {}  # Cache fetched markdown content
    
    def load_progress(self):
        """Load learning progress from file"""
        if os.path.exists(PROGRESS_FILE):
            with open(PROGRESS_FILE, 'r') as f:
                return json.load(f)
        return {
            "current_lesson": 1,
            "completed_lessons": [],
            "notes": {},
            "start_date": datetime.now().isoformat()
        }
    
    def save_progress(self):
        """Save learning progress to file"""
        with open(PROGRESS_FILE, 'w') as f:
            json.dump(self.progress, f, indent=2)

    def fetch_lesson_content(self, lesson_url):
        """Fetch markdown content from GitHub"""
        # Check cache first
        if lesson_url in self.content_cache:
            return self.content_cache[lesson_url]

        try:
            # Convert GitHub blob URL to raw URL
            raw_url = lesson_url.replace(
                "github.com",
                "raw.githubusercontent.com"
            ).replace("/blob/", "/")

            # Fetch content
            with urllib.request.urlopen(raw_url, timeout=10) as response:
                content = response.read().decode('utf-8')
                self.content_cache[lesson_url] = content
                return content
        except urllib.error.URLError as e:
            return f"❌ Error fetching lesson content: {e}\n\nYou can view it online at:\n{lesson_url}"
        except Exception as e:
            return f"❌ Unexpected error: {e}\n\nYou can view it online at:\n{lesson_url}"
    
    def show_dashboard(self):
        """Display learning dashboard"""
        completed = len(self.progress["completed_lessons"])
        total = len(LESSONS)
        progress_pct = (completed / total) * 100
        
        print("\n" + "="*60)
        print("🐍 PYTHON LEARNING DASHBOARD (for C# Developers)")
        print("="*60)
        print(f"Progress: {completed}/{total} lessons ({progress_pct:.1f}%)")
        print(f"Current Lesson: {self.progress['current_lesson']}")
        
        if completed > 0:
            print(f"Completed: {', '.join(map(str, sorted(self.progress['completed_lessons'])))}")
        
        print("="*60 + "\n")
    
    def show_lesson(self, lesson_num, show_content=True):
        """Display lesson details"""
        if lesson_num < 1 or lesson_num > len(LESSONS):
            print(f"❌ Invalid lesson number. Choose between 1 and {len(LESSONS)}")
            return

        lesson = LESSONS[lesson_num - 1]
        is_completed = lesson_num in self.progress["completed_lessons"]

        # Print lesson header
        print("\n" + "="*60)
        print(f"📚 Lesson {lesson['number']}: {lesson['title']}")
        print("="*60)
        print(f"Duration: {lesson['duration']}")
        print(f"Status: {'✅ Completed' if is_completed else '⏳ Not Started'}")
        print(f"\nTopics:")
        for topic in lesson['topics']:
            print(f"  • {topic}")

        # Show notes if available
        if str(lesson_num) in self.progress.get("notes", {}):
            print(f"\n📝 Your Notes:\n{self.progress['notes'][str(lesson_num)]}")

        print("\n" + "="*60)

        # Fetch and display content if requested
        if show_content:
            print(f"📖 Fetching lesson content from GitHub...")
            content = self.fetch_lesson_content(lesson['url'])

            print("\n" + "-"*60 + "\n")

            # Render markdown using rich
            md = Markdown(content)
            self.console.print(md)

            print("\n" + "-"*60)
        else:
            print(f"\n🔗 Lesson URL:\n{lesson['url']}")

        print("="*60 + "\n")
    
    def mark_complete(self, lesson_num):
        """Mark a lesson as complete"""
        if lesson_num not in self.progress["completed_lessons"]:
            self.progress["completed_lessons"].append(lesson_num)
            self.progress["completed_lessons"].sort()
            
            # Auto-advance to next lesson
            if lesson_num == self.progress["current_lesson"] and lesson_num < len(LESSONS):
                self.progress["current_lesson"] = lesson_num + 1
            
            self.save_progress()
            print(f"✅ Lesson {lesson_num} marked as complete!")
            
            if lesson_num < len(LESSONS):
                print(f"📚 Next up: Lesson {lesson_num + 1} - {LESSONS[lesson_num]['title']}")
            else:
                print("🎉 Congratulations! You've completed all lessons!")
        else:
            print(f"ℹ️  Lesson {lesson_num} was already marked as complete.")
    
    def add_note(self, lesson_num, note):
        """Add a note for a specific lesson"""
        if "notes" not in self.progress:
            self.progress["notes"] = {}
        
        self.progress["notes"][str(lesson_num)] = note
        self.save_progress()
        print(f"📝 Note added to Lesson {lesson_num}")
    
    def list_all_lessons(self):
        """List all available lessons"""
        print("\n" + "="*60)
        print("📋 ALL LESSONS")
        print("="*60)
        for lesson in LESSONS:
            status = "✅" if lesson['number'] in self.progress["completed_lessons"] else "⏳"
            current = "👉" if lesson['number'] == self.progress['current_lesson'] else "  "
            print(f"{current} {status} Lesson {lesson['number']:2d}: {lesson['title']}")
        print("="*60 + "\n")
    
    def show_help(self):
        """Display help menu"""
        print("\n" + "="*60)
        print("📖 AVAILABLE COMMANDS")
        print("="*60)
        print("  dashboard           - Show your learning progress")
        print("  list                - List all lessons")
        print("  lesson <number>     - View lesson with full content")
        print("  current             - View current lesson with content")
        print("  next                - Move to next lesson")
        print("  complete <number>   - Mark lesson as complete")
        print("  note <number> <text>- Add a note to a lesson")
        print("  reset               - Reset all progress")
        print("  help                - Show this help menu")
        print("  quit / exit         - Exit the assistant")
        print("="*60)
        print("\nNote: Lesson content is fetched from GitHub and")
        print("displayed inline with rich formatting.")
        print("="*60 + "\n")
    
    def reset_progress(self):
        """Reset all learning progress"""
        confirm = input("⚠️  Are you sure you want to reset all progress? (yes/no): ")
        if confirm.lower() == 'yes':
            self.progress = {
                "current_lesson": 1,
                "completed_lessons": [],
                "notes": {},
                "start_date": datetime.now().isoformat()
            }
            self.save_progress()
            print("✅ Progress reset successfully!")
        else:
            print("❌ Reset cancelled.")
    
    def run(self):
        """Main interactive loop"""
        print("\n🐍 Welcome to Python Learning Assistant for C# Developers!")
        print("Based on: https://github.com/robch/python-for-csharp-devs")
        print("Type 'help' for available commands\n")
        
        self.show_dashboard()
        
        while True:
            try:
                cmd = input("📚 > ").strip().lower()
                
                if not cmd:
                    continue
                
                parts = cmd.split(maxsplit=1)
                command = parts[0]
                
                if command in ['quit', 'exit']:
                    print("👋 Happy coding! Keep learning Python!")
                    break
                
                elif command == 'help':
                    self.show_help()
                
                elif command == 'dashboard':
                    self.show_dashboard()
                
                elif command == 'list':
                    self.list_all_lessons()
                
                elif command == 'current':
                    self.show_lesson(self.progress['current_lesson'])
                
                elif command == 'next':
                    if self.progress['current_lesson'] < len(LESSONS):
                        self.progress['current_lesson'] += 1
                        self.save_progress()
                        self.show_lesson(self.progress['current_lesson'])
                    else:
                        print("🎉 You're already on the last lesson!")
                
                elif command == 'lesson':
                    if len(parts) < 2:
                        print("❌ Usage: lesson <number>")
                    else:
                        try:
                            lesson_num = int(parts[1])
                            self.show_lesson(lesson_num)
                        except ValueError:
                            print("❌ Please provide a valid lesson number")
                
                elif command == 'complete':
                    if len(parts) < 2:
                        print("❌ Usage: complete <number>")
                    else:
                        try:
                            lesson_num = int(parts[1])
                            self.mark_complete(lesson_num)
                        except ValueError:
                            print("❌ Please provide a valid lesson number")
                
                elif command == 'note':
                    if len(parts) < 2:
                        print("❌ Usage: note <lesson_number> <your note text>")
                    else:
                        try:
                            note_parts = parts[1].split(maxsplit=1)
                            lesson_num = int(note_parts[0])
                            note_text = note_parts[1] if len(note_parts) > 1 else ""
                            self.add_note(lesson_num, note_text)
                        except (ValueError, IndexError):
                            print("❌ Usage: note <lesson_number> <your note text>")
                
                elif command == 'reset':
                    self.reset_progress()
                
                else:
                    print(f"❌ Unknown command: {command}")
                    print("Type 'help' for available commands")
            
            except KeyboardInterrupt:
                print("\n👋 Happy coding! Keep learning Python!")
                break
            except Exception as e:
                print(f"❌ Error: {e}")


if __name__ == "__main__":
    assistant = LearningAssistant()
    assistant.run()