📚 Python Interactive Textbook

A book-themed, interactive, production-ready Streamlit application for learning Python from A to Z.

---

✨ Overview

The Python Interactive Textbook isn’t just another learning platform—it’s a living book. Each chapter unfolds like the turning of a page, blending readable theory, hands-on coding, and knowledge checks into one seamless experience. Learners don’t just read Python—they experience it.

This app is designed to feel like a digital textbook: parchment-like pages, progress bookmarks, elegant fonts, and interactive code editors. Whether you’re a beginner writing your first print("Hello, World!") or an advanced learner exploring OOP, this book-like app guides you step by step.

---

🌟 Features

• 📖 Book-Style Chapters – A to Z Python topics, each presented like a page in a textbook.
• 💻 Interactive Code Execution – Modify and run Python examples directly inside the book.
• 🎯 Quizzes & Knowledge Checks – Each chapter ends with short quizzes to reinforce learning.
• 📊 Progress Tracking – Automatically bookmark your journey and visualize completion.
• 🔒 Chapter Unlocking System – Learn in order, unlocking new chapters as you complete quizzes.
• 📝 Beautiful Typography & Layout – Styled like a classic book with modern elegance.
• 🏅 Achievements & Statistics – Track your quiz scores, time spent, and code executions.

---

📂 Project Structure

python-interactive-textbook/
├── app.py              # Main Streamlit application
├── requirements.txt    # Dependencies
├── README.md           # Project documentation (you’re here)
└── assets/             # Fonts, styles, images (optional)

---

🚀 Getting Started

1️⃣ Clone the repository

git clone https://github.com/yourusername/python-interactive-textbook.git
cd python-interactive-textbook

2️⃣ Install dependencies

pip install -r requirements.txt

3️⃣ Run the app

streamlit run app.py

The book will open in your browser 📖✨.

---

🏛️ App Flow

1. Cover Page → Welcome screen with a start button.

2. Table of Contents → Bookmarked chapters with completion status.

3. Chapter Pages → Each includes:

   • Theory (styled paragraphs)
   • Code example (read-only)
   • Interactive coding space
   • Mini quiz (MCQs)
   • Navigation buttons (prev/next/home)

4. Progress Sidebar → Stats, completed chapters, session time.

---

📖 Sample Chapters

• Chapter 1: Python Introduction – History, syntax, first program.
• Chapter 2: Variables & Data Types – Strings, ints, floats, booleans.
• Chapter 3: Operators & Expressions – Arithmetic, comparisons, string ops.
• Chapter 4: Lists & Collections – Indexing, slicing, mutability.
• Chapter 5: Control Flow – if, elif, else, truthy/falsy values.

And more—eventually building up to functions, OOP, file handling, decorators, advanced Python, and projects.

---

🎨 Design Philosophy

The app blends classic book aesthetics with modern interactivity:

• Parchment-inspired backgrounds 🎨
• Serif fonts for chapter text, monospace for code ✍️
• Progress markers that feel like bookmarks 🔖
• Smooth animations for page-like transitions 📜

---

📜 License

MIT License © 2025

You are free to use, modify, and distribute this project with attribution.

---

💡 Inspiration

"Learning Python should feel like reading a storybook, where each chapter brings new adventures in code."