Skip to content

INDEX.md

Latest commit

 

History

History
378 lines (278 loc) · 9.61 KB

INDEX.md

File metadata and controls

378 lines (278 loc) · 9.61 KB

📋 Python Training - Complete File Index

Repository Files & Navigation

📁 Root Level Files

File Purpose Status
README.md Main overview and guide ✅ Updated
requirements.txt Python dependencies ✅ Created
.env.example API configuration template ✅ Created
QUICK_START.md 5-minute quickstart guide ✅ Created
COMPLETION_REPORT.md Full project summary ✅ Created
STATUS.md Achievement summary ✅ Created
INDEX.md This file - navigation guide ✅ Created

📚 Day-by-Day Breakdown

Day 1: Python Basics ✅

Focus: I/O, Variables, Strings

day01_basics/
├── 01_hello.py              (70 lines) - Print and input basics
├── 02_variables.py          (80 lines) - Variables and data types
├── 03_strings_fstrings.py   (100 lines) - Strings and f-strings
├── EXERCISES.md             - 5 warm-up exercises
├── SOLUTIONS.md             - Complete solutions
└── README.md                - Day 1 learning guide

Key Concepts: print(), input(), variables, int/float/str/bool, type conversion

Day 2: Logic & Functions ✅

Focus: Decision-making and Code Reuse

day02_logic_functions/
├── 01_conditionals.py       (110 lines) - If/elif/else, operators
├── 02_functions.py          (130 lines) - Function definition
├── EXERCISES.md             - 5 programming challenges
└── README.md                - Day 2 learning guide

Key Concepts: if/elif/else, ==, <, >, and, or, not, def, return, parameters

Day 3: Loops & Data Structures ✅

Focus: Repetition and Containers

day03_loops_structures/
└── 01_loops_lists_dicts.py  (100 lines) - Loops, lists, dicts, comprehension

Key Concepts: for, while, lists, tuples, dicts, list comprehension, enumerate

Day 4: Advanced Python ✅

Focus: Professional Features

day04_power_user/
└── 01_advanced_python.py    (120 lines) - Files, decorators, generators

Key Concepts: with, open(), # comprehensions, try/except, yield, @decorator

Day 5: Professional Workflow ✅

Focus: Professional Practices

day05_workflow_debugging/
└── 01_debugging_pep8.py     (100 lines) - Logging, testing, PEP 8

Key Concepts: logging, assert, PEP 8 style, git, unittest

Day 6: Systems Engineering ✅

Focus: Real Applications & Debugging

day06_systems_gpa/
├── gpa_buggy_v1.py          (75 lines)  - Has 5 intentional bugs
├── gpa_hardened_v2.py       (180 lines) - Professional implementation
├── TICKETS.md               - Bug descriptions (#701-705)
└── README.md                - Day 6 learning guide

Bugs to Fix:

  • #701: Wrong GPA calculation formula
  • #702: Missing file persistence
  • #703: Wrong data structure
  • #704: No validation
  • #705: Poor error messages

Day 7: Object-Oriented Programming ✅

Focus: Classes and Design Patterns

day07_refactor_oop/
├── 01_oop_advanced.py       (150 lines) - Classes, inheritance, OOP
├── EXERCISES.md             - 4 exercises + challenge
└── README.md                - Day 7 learning guide

Key Concepts: class, init, inheritance, super(), @property, @abstractmethod, ABC, polymorphism

Day 8: Agile Sprints ✅

Focus: Real-world Development & More Bugs

day08_agile_sprints_libs/
├── task_manager_buggy_v1.py (120 lines) - Has 5 more bugs
└── README.md                - Day 8 learning guide

Bugs to Fix:

  • #801: Tasks never load from file
  • #802: Completed count is wrong
  • #803: No validation
  • #804: Can't delete completed
  • #805: File format inconsistent

Day 9: Data Science ✅

Focus: Data Analysis

day09_data_viz_pandas/
└── 01_pandas_matplotlib.py  (100 lines) - Pandas, DataFrames, visualization

Key Concepts: DataFrame, Series, groupby(), plot(), read_csv(), describe()

Day 10: GUI Programming ✅

Focus: Desktop Applications

day10_gui_tkinter/
└── 01_tkinter_basics.py     (100 lines) - Tkinter widgets and layout

Key Concepts: Tk(), Label, Button, Entry, Text, Listbox, pack(), grid()

Day 11: Web Development ✅

Focus: Web Applications

day11_web_flask_ai/
└── 01_flask_webdev.py       (90 lines) - Flask routes, templates, forms

Key Concepts: Flask, @app.route, render_template, request, jsonify

Day 12: Advanced Libraries ✅

Focus: APIs and Automation

day12_advanced_libs/
└── 01_requests_apis_automation.py  (110 lines) - APIs, OpenAI, PyAutoGUI

Key Concepts: requests, openai.ChatCompletion, PyAutoGUI, dotenv, CSV, JSON, XML

Day 13: Data Analysis ✅

Focus: Complete Data Pipeline

day13_pandas_colab/
└── 01_data_analysis_pipeline.py  (130 lines) - Load → Clean → Analyze → Visualize

Key Concepts: Data cleaning, statistics, groupby(), visualization, correlation

Day 14: Machine Learning ✅

Focus: Predictive Models

day14_ml_logistic_regression/
└── 01_machine_learning_intro.py  (120 lines) - sklearn, train/test, evaluation

Key Concepts: LogisticRegression, train_test_split, accuracy, confusion_matrix, ROC curve

📞 Documentation Files

Setup & Configuration

  • docs/SETUP.md - 7-step installation guide with troubleshooting
  • requirements.txt - All 17+ dependencies with versions
  • .env.example - API key template (OpenAI, DeepSeek, etc.)

Learning Guides

  • day01_basics/README.md - Day 1 learning outcomes
  • day02_logic_functions/README.md - Day 2 guide
  • day06_systems_gpa/README.md - Day 6 with bug info
  • day07_refactor_oop/README.md - Day 7 OOP guide
  • day08_agile_sprints_libs/README.md - Day 8 agile guide

Exercises & Solutions

  • day01_basics/EXERCISES.md - 5 warm-up exercises
  • day01_basics/SOLUTIONS.md - Complete solutions
  • day02_logic_functions/EXERCISES.md - 5 function exercises
  • day07_refactor_oop/EXERCISES.md - 4 OOP exercises + challenge

Special Documentation

  • day06_systems_gpa/TICKETS.md - Bug #701-705 descriptions
  • COMPLETION_REPORT.md - Full project summary
  • QUICK_START.md - 5-minute quickstart
  • STATUS.md - Achievement metrics

🎯 How to Navigate This Repository

For Beginners

  1. Start with QUICK_START.md (5 min read)
  2. Follow docs/SETUP.md for installation
  3. Go to day01_basics and run 01_hello.py
  4. Read day01_basics/README.md
  5. Try day01_basics/EXERCISES.md
  6. Check answers in SOLUTIONS.md

For Learning Each Day

dayXX_topic/
├── README.md           ← Read first (overview)
├── 01_lesson.py        ← Run and study second
│   (or 02_lesson.py    (optional additional)
├── EXERCISES.md        ← Try exercises third
└── SOLUTIONS.md        ← Check answers last

For Debugging (Days 6 & 8)

1. Read dayXX/TICKETS.md (understand each bug)
2. Run dayXX/*buggy_v1.py (see the failures)
3. Fix each bug one by one
4. Compare with dayXX/*hardened_v2.py (learn)

For Configuration

1. Copy .env.example to .env
2. Edit with your API keys (optional)
3. Install: pip install -r requirements.txt
4. Follow docs/SETUP.md for detailed help

📊 Repository Statistics

Category Count
Total Days 14 ✅
Lesson Files (.py) 18
Documentation (.md) 12+
Total Lines of Code 3000+
Code Examples 100+
Exercises 40+
Solutions 2+ complete files
Bugs to Fix 10
Infrastructure Files 4

🚀 Quick Links

  • Start Learning: See day01_basics/01_hello.py
  • Setup Help: See docs/SETUP.md
  • Project Status: See STATUS.md
  • Quick Overview: See QUICK_START.md
  • Complete Report: See COMPLETION_REPORT.md
  • Dependencies: See requirements.txt

📝 File Naming Convention

Lesson Files

01_topic.py - Main lesson content 02_topic.py - (Optional) Additional content

Documentation

README.md - Day overview and learning guide EXERCISES.md - Programming challenges SOLUTIONS.md - Complete solutions TICKETS.md - Bug descriptions (Days 6 & 8 only)

Special Versions

*_buggy_v1.py - Intentional bugs for learning *_hardened_v2.py - Professional implementation

✨ Highlights

Most Comprehensive Content

  • Day 1: 3 lesson files + exercises + solutions
  • Day 6: Buggy + hardened versions + bug tickets
  • Day 7: 7 complete OOP examples + 4 exercises

Best for Learning Bugs

  • Day 6: GPA System with 5 tickets (#701-705)
  • Day 8: Task Manager with 5 tickets (#801-805)

Most Professional Code

  • day06_systems_gpa/gpa_hardened_v2.py - 180 lines, type hints, validation, logging
  • day07_refactor_oop/01_oop_advanced.py - 150 lines, 7 concepts explained

Most Practical

  • day01_basics/ - Real programs you'll write
  • day06_systems_gpa/ - Real app you'll debug

🎓 Learning Path

Beginner (Days 1-5)
    ↓
Systems Thinker (Days 6-8)
    ↓
Tool Master (Days 9-12)
    ↓
Data Scientist (Days 13-14)

Mix and match based on interests!

📖 How to Read This Index

  • For Setup: Bottom of this file, then docs/SETUP.md
  • For Learning: Start with day01_basics
  • For Navigation: Use table near top
  • For Completion: Check STATUS.md
  • For Help: Check README.md in each day

Created: All 14 days on one day! ✅ Status: Complete and ready to use Last Updated: Today License: MIT - Free to use and share

Start with Day 1: python day01_basics/01_hello.py 🚀