Skip to content

DESCRIPTION.md

Latest commit

 

History

History
278 lines (217 loc) · 10.3 KB

DESCRIPTION.md

File metadata and controls

278 lines (217 loc) · 10.3 KB

🚀 Python Training - Comprehensive 14-Day Curriculum

English | العربية

📚 English Description

Overview

Python Training is a complete, production-ready curriculum designed to take learners from absolute beginners to proficient Python developers in 14 days. This project combines hands-on learning with real-world engineering practices.

What You Get

✅ 14 Complete Days of Training

  • Days 1-5: Python Fundamentals (I/O, variables, functions, loops)
  • Days 6-8: Systems Engineering & OOP (real apps, debugging, design patterns)
  • Days 9-12: Tools & Frameworks (data science, web dev, automation, APIs)
  • Days 13-14: Advanced topics (data pipelines, machine learning)

✅ Comprehensive Learning Materials

  • 18 Python lesson files with runnable examples
  • 40+ exercises with complete solutions
  • 100+ code examples across all topics
  • 3,000+ lines of professional code
  • 10 bugs to fix for hands-on debugging practice

✅ Professional Standards

  • Type hints throughout all code
  • Comprehensive docstrings and comments
  • PEP 8 compliant formatting
  • Proper error handling (try/except/finally)
  • Logging best practices
  • Real-world design patterns

✅ Special Learning Features

  • Bug-Driven Learning: Days 6 & 8 include intentional bugs to find and fix
  • Naive vs Hardened Code: Compare student code with professional implementations
  • Real Applications: Build GPA system, task manager, data pipelines
  • Agile Methodology: Learn sprint-based development

Quick Start

# 1. Clone the repository
git clone https://github.com/QusaiALBahri/python_training.git
cd python_training

# 2. Setup Python environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Start learning
cd day01_basics
python 01_hello.py

Curriculum Structure

Day 1:  Python Basics (print, input, variables, strings)
Day 2:  Logic & Functions (if/else, functions, parameters)
Day 3:  Loops & Data Structures (for, while, lists, dicts)
Day 4:  Advanced Python (files, decorators, generators)
Day 5:  Professional Workflow (logging, testing, PEP 8)
Day 6:  Systems Engineering (GPA app + 5 bugs #701-705)
Day 7:  OOP Advanced (classes, inheritance, polymorphism)
Day 8:  Agile Sprints (task manager + 5 bugs #801-805)
Day 9:  Data Science (Pandas, Matplotlib)
Day 10: GUI Programming (Tkinter)
Day 11: Web Development (Flask)
Day 12: Advanced Libraries (APIs, automation, OpenAI)
Day 13: Data Analysis (complete pipeline)
Day 14: Machine Learning (scikit-learn, predictions)

Key Features

For Each Day:

  • README.md - Learning outcomes and concepts
  • 01_lesson.py - Runnable examples
  • EXERCISES.md - Programming challenges
  • SOLUTIONS.md - Complete solutions with explanations

Infrastructure:

  • requirements.txt - All 17+ dependencies with versions
  • .env.example - API configuration template
  • docs/SETUP.md - 7-step installation guide
  • Full documentation at every level

Technologies Covered

Category Technologies
Data Pandas, NumPy, Matplotlib, Seaborn
Web Flask, Tkinter
ML Scikit-learn, logistic regression
APIs OpenAI, DeepSeek, Requests
Tools Logging, testing, Git, PEP 8

Learning Outcomes

After completing this curriculum, you will:

  • ✅ Write clean, professional Python code
  • ✅ Build complete applications (CLI, GUI, web, data analysis)
  • ✅ Debug real code and fix bugs systematically
  • ✅ Understand OOP and design patterns
  • ✅ Work with data and create visualizations
  • ✅ Integrate APIs and build web services
  • ✅ Create machine learning models
  • ✅ Follow professional engineering practices

Project Statistics

Metric Count
Total Days 14
Lesson Files 18
Documentation 12+
Total Code Lines 3,000+
Exercises 40+
Code Examples 100+
Bugs to Fix 10
Total Learning Hours 36-45

📚 الوصف بالعربية

نظرة عامة

برنامج تدريب بايثون هو منهج شامل وجاهز للإنتاج مصمم لأخذ المتعلمين من المبتدئين الكاملين إلى مطوري Python محترفين في 14 يوماً. يجمع هذا المشروع بين التعلم العملي وممارسات الهندسة الحقيقية.

ما ستحصل عليه

✅ 14 يوم تدريب كامل

  • الأيام 1-5: أساسيات بايثون (الإدخال/الإخراج، المتغيرات، الدوال، الحلقات)
  • الأيام 6-8: هندسة الأنظمة و OOP (تطبيقات حقيقية، تصحيح الأخطاء، أنماط التصميم)
  • الأيام 9-12: الأدوات والأطر (علم البيانات، تطوير الويب، الأتمتة، واجهات برمجية)
  • الأيام 13-14: موضوعات متقدمة (خطوط أنابيب البيانات، التعلم الآلي)

✅ مواد تعليمية شاملة

  • 18 ملف درس Python مع أمثلة قابلة للتشغيل
  • أكثر من 40 تمرينة مع حلول كاملة
  • أكثر من 100 مثال برمجي في جميع المواضيع
  • أكثر من 3,000 سطر من الكود الاحترافي
  • 10 أخطاء يجب إصلاحها لممارسة عملية لتصحيح الأخطاء

✅ معايير احترافية

  • تلميحات النوع في جميع الأكواد
  • docstrings وتعليقات شاملة
  • تنسيق متوافق مع PEP 8
  • معالجة أخطاء مناسبة (try/except/finally)
  • أفضل الممارسات في السجلات
  • أنماط تصميم من العالم الحقيقي

✅ ميزات التعلم الخاصة

  • التعلم القائم على الأخطاء: الأيام 6 و 8 تتضمن أخطاء متعمدة للعثور عليها وإصلاحها
  • كود ساذج مقابل قوي: قارن بين كودك والتطبيقات الاحترافية
  • تطبيقات حقيقية: بناء نظام GPA، مدير المهام، خطوط أنابيب البيانات
  • منهجية Agile: تعلم التطوير القائم على السباقات

البدء السريع

# 1. استنساخ المستودع
git clone https://github.com/QusaiALBahri/python_training.git
cd python_training

# 2. إعداد بيئة Python
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 3. تثبيت المتطلبات
pip install -r requirements.txt

# 4. ابدأ التعلم
cd day01_basics
python 01_hello.py

هيكل المنهج الدراسي

اليوم 1:  أساسيات Python (print, input, variables, strings)
اليوم 2:  المنطق والدوال (if/else, functions, parameters)
اليوم 3:  الحلقات وهياكل البيانات (for, while, lists, dicts)
اليوم 4:  Python المتقدم (files, decorators, generators)
اليوم 5:  سير العمل الاحترافي (logging, testing, PEP 8)
اليوم 6:  هندسة الأنظمة (تطبيق GPA + 5 أخطاء #701-705)
اليوم 7:  OOP متقدم (classes, inheritance, polymorphism)
اليوم 8:  سباقات Agile (مدير المهام + 5 أخطاء #801-805)
اليوم 9:  علم البيانات (Pandas, Matplotlib)
اليوم 10: برمجة الواجهات الرسومية (Tkinter)
اليوم 11: تطوير الويب (Flask)
اليوم 12: مكتبات متقدمة (APIs, automation, OpenAI)
اليوم 13: تحليل البيانات (خط أنابيب كامل)
اليوم 14: التعلم الآلي (scikit-learn, predictions)

الميزات الرئيسية

لكل يوم:

  • README.md - نتائج التعلم والمفاهيم
  • 01_lesson.py - أمثلة قابلة للتشغيل
  • EXERCISES.md - تحديات البرمجة
  • SOLUTIONS.md - حلول كاملة مع شروحات

البنية الأساسية:

  • requirements.txt - مواصفات المتطلبات مع الإصدارات
  • .env.example - نموذج تكوين واجهات برمجية
  • docs/SETUP.md - دليل التثبيت من 7 خطوات
  • توثيق كامل في كل مستوى

التقنيات المغطاة

الفئة التقنيات
البيانات Pandas, NumPy, Matplotlib, Seaborn
الويب Flask, Tkinter
التعلم الآلي Scikit-learn, logistic regression
واجهات برمجية OpenAI, DeepSeek, Requests
الأدوات Logging, testing, Git, PEP 8

نتائج التعلم

بعد إكمال هذا المنهج، ستتمكن من:

  • ✅ كتابة كود Python نظيف واحترافي
  • ✅ بناء تطبيقات كاملة (CLI, GUI, web, data analysis)
  • ✅ تصحيح الأخطاء بشكل منهجي
  • ✅ فهم OOP وأنماط التصميم
  • ✅ العمل مع البيانات وإنشاء رسوم بيانية
  • ✅ دمج واجهات برمجية وبناء خدمات ويب
  • ✅ إنشاء نماذج التعلم الآلي
  • ✅ اتباع ممارسات الهندسة الاحترافية

إحصائيات المشروع

المقياس العدد
إجمالي الأيام 14
ملفات الدروس 18
التوثيق 12+
إجمالي أسطر الكود 3,000+
التمارين 40+
أمثلة برمجية 100+
أخطاء يجب إصلاحها 10
إجمالي ساعات التعلم 36-45

🤝 Contributing | المساهمة

Found an issue? Have improvements? Contributions are welcome! عثرت على مشكلة؟ هل لديك تحسينات؟ المساهمات مرحب بها!

📜 License | الترخيص

MIT License - Free for educational and commercial use ترخيص MIT - مجاني للاستخدام التعليمي والتجاري

🎯 Quick Navigation | الملاحة السريعة

Resource الموارد
QUICK_START.md ابدأ في 5 دقائق
SETUP.md دليل التثبيت
INDEX.md فهرس الملفات
STATUS.md حالة المشروع

Happy Learning! | تعلم سعيد! 🚀