🐍 My Python Learning Journey

From Basics to Advanced - A Complete Portfolio 🚀

Welcome to my Python learning portfolio! This repository documents my progressive journey from fundamental concepts to advanced real-world applications.

---

📊 Learning Progression Overview

🟢 Fundamentals → 🟡 Core Concepts → 🟠 Game Dev → 🔴 Advanced → 📘 Academics
     ↓                  ↓                ↓            ↓              ↓
  Basics            Algorithms       Logic Games   APIs & GUI    Coursework

---

🟢 Level 1: Fundamentals

Master the basics of Python programming

Project	Topics	Files
📖 Basic-Projects	Variables, loops, functions, conditionals	Number Guessing Game, Calculator, Bidding Game
✏️ Exercise	Problem-solving & coding patterns	Practice problems
🎮 Random_Games	Random module, user input, password generation	psswrdgen.py

What You'll Learn:

• Variables & data types
• Control flow (if/else, loops)
• Functions & logic
• User input handling

---

🟡 Level 2: Core Concepts

Build algorithms and logic-based projects

Project	Topics	Files
🔐 Cipher Encryption	String manipulation, Caesar cipher, algorithms	encript.py - Encrypt/Decrypt with animations
🎯 Hangman	Game logic, loops, lists, conditionals	hangman.py - Interactive word guessing game
🎰 Higher & Lower	Game mechanics, data structures, random selection	h&l.py - Guess who has more followers

What You'll Learn:

• String manipulation
• Algorithm design
• Game logic implementation
• Data structures (lists, dictionaries)
• Colorized terminal output

---

🟠 Level 3: Game Development

Create interactive games with complex logic

Project	Topics	Files
🃏 The Blackjack Capstone Game	OOP basics, game state management, scoring	capstonesef.py - Full card game with dealer AI
🎮 The Coffee Machine	State management, dictionaries, resource tracking	main.py - Virtual coffee machine simulator
🧠 The Quiz Game	OOP design, data loading, quiz mechanics	main.py - Quiz brain with scoring system

What You'll Learn:

• Object-Oriented Programming (Classes)
• State management
• Complex game logic
• Data loading & processing
• File organization patterns

---

🔴 Level 4: Advanced Projects

Real-world applications with APIs and GUIs

Project	Topics	Files
🎨 GUI-Project	Tkinter, event handling, graphics	turtlegui.py - Turtle graphics animations
🤖 Gemini-Model	API integration, AI models, chat systems	main.py - Google Gemini chatbot integration
📧 Resend	Email services, external libraries, API keys	main.py - Email sender with API
📊 Speedtest	Network testing, data visualization, threading	main.py - Real-time internet speed monitor with PDF reports

What You'll Learn:

• External APIs & authentication
• GUI development (Tkinter)
• Threading & async operations
• Data visualization (Matplotlib)
• PDF generation
• Production-ready code patterns

---

📘 College Coursework

Academic assignments & structured learning

Project	Topics
🎓 PythonClg	Formal CS concepts, assignments, comprehensive exercises

---

🛠️ Tech Stack

🐍 Language:        Python 3.x
📚 Core Libraries:  random, os, json, time, threading, string
🎨 GUI:             Tkinter, Turtle
📡 APIs:            Google Gemini, Resend, Speedtest
📊 Data:            Matplotlib, PDF generation
🎯 Utilities:       Colorama (terminal colors)

---

📈 Skills Progression

Level 1: Variables → Loops → Functions
   ↓
Level 2: Strings → Algorithms → Logic
   ↓
Level 3: OOP → Classes → Game Design
   ↓
Level 4: APIs → Threading → GUI → Production Code

---

🚀 Quick Start

# Clone repository
git clone https://github.com/mahi-8758/Python-DEv.git
cd Python-DEv

# Navigate to project
cd PROJECT_FOLDER_NAME

# Run the script
python script_name.py

Examples:

# Level 1: Play Number Guessing Game
cd "Basic-Projects/Number Guessing Game"
python main.py

# Level 2: Play Hangman
cd Hangman
python hangman.py

# Level 3: Play Blackjack
cd "The Blackjack Capstone Game"
python capstonesef.py

# Level 4: Speed Test Monitor
cd Speedtest
python main.py

---

🎯 Key Features by Level

🟢 Level 1 Highlights

• ✅ Simple number guessing
• ✅ Working calculator
• ✅ Interactive bidding system
• ✅ Random password generator

🟡 Level 2 Highlights

• ✅ Caesar cipher encryption/decryption
• ✅ Hangman word game with ASCII art
• ✅ Higher/Lower comparison game
• ✅ Colorized terminal output

🟠 Level 3 Highlights

• ✅ Full Blackjack game with dealer AI
• ✅ Coffee machine state simulator
• ✅ Quiz game with OOP design
• ✅ Score tracking system

🔴 Level 4 Highlights

• ✅ Real Google Gemini AI integration
• ✅ Send emails via Resend API
• ✅ Internet speed monitoring (real-time)
• ✅ PDF report generation
• ✅ GUI with Tkinter
• ✅ Data visualization
• ✅ Threading & async operations

---

📊 Project Statistics

Total Projects:     20+
Total Files:        50+
Code Lines:         5000+
Learning Duration:  Complete Python Journey

---

🎓 Learning Outcomes

By exploring this portfolio, you'll understand:

• Fundamentals: How Python works at its core
• Problem-Solving: Algorithm design & implementation
• OOP: Class design & inheritance
• Integration: Working with real APIs
• Automation: Building practical tools
• UI/UX: Creating user interfaces
• Professional Practices: Code organization & documentation

---

🔄 Development Workflow

Each project follows this pattern:

1. Understand the requirements
2. Plan the approach
3. Implement with clean code
4. Test with edge cases
5. Enhance with features/UI

---

👨‍💻 Author

Mahi Kumar

💬 Connect with me

Feel free to reach out for collaborations, questions, or just to say hi!

---

🎯 Current Focus

• ✅ Advanced Python patterns
• ✅ API integration & authentication
• ✅ GUI development
• ✅ Data visualization
• 🔄 Machine Learning fundamentals
• 🔄 Web development (Next Phase)

---

💡 Pro Tips

• Start from Level 1 if you're a beginner
• Each level builds on previous concepts
• Run projects locally to see them in action
• Modify code to understand how it works
• Use this as a reference for your own projects

---

✨ Happy Coding! Keep Learning! 💻✨

"The best way to learn is by doing" - Every developer ever

---

Made with ❤️ and 🐍 Python