Python-RoadMap

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 16 Open GitHub ↗

A structured Python learning roadmap: 8 weeks of fundamentals + 4 stdlib-only projects. Daily commits · Quizzes · Exercises · Solutions.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1>Python RoadMap</h1>

<p>
    A complete beginner-to-intermediate Python learning roadmap.<br/>
    Daily lessons · Weekly projects · Exercises · Quizzes · Notebooks
  </p>

---

## 👋 About This Repository

A structured, beginner-friendly Python learning roadmap built with consistent commits over **9 weeks**:
**8 weeks of Python fundamentals (daily commits) + 1 week portfolio-quality project (weekly commit).**

It serves as both a personal revision reference and a free learning resource for anyone starting their Python journey.

**Created by:** Berke Arda Türk — CS Student | AI & Data Science @ Vizja University
**Goal:** Solid, job-ready Python fundamentals — followed by a hands-on project
**Commitment:** Weeks 1–8 — 7 commits/day (5 lesson files + 2 README updates) · Week 9 — portfolio project committed weekly · 9 weeks total

---

## 📊 Overall Progress

```
Week 01 — Python Basics             ██████████  7/7 days  ✅ Completed
Week 02 — Control Flow              ██████████  7/7 days  ✅ Completed
Week 03 — Functions                 ██████████  7/7 days  ✅ Completed
Week 04 — Data Structures           ██████████  7/7 days  ✅ Completed
Week 05 — OOP                       ██████████  7/7 days  ✅ Completed
Week 06 — File & Error Handling     ██████████  7/7 days  ✅ Completed
Week 07 — Modules & Packages        ██████████  7/7 days  ✅ Completed
Week 08 — Advanced Python           ██████████  7/7 days  ✅ Completed
Week 09 — Project: Task Manager     ██████████  7/7 days  ✅ Completed
```

> Updated weekly as progress is made. ⭐ Star the repo to follow along!

---

## 📚 Table of Contents

1. [Setup Guide for Absolute Beginners](#️-setup-guide-for-absolute-beginners)
2. [How to Use](#-how-to-use)
3. [How to Study Each Day](#-how-to-study-each-day)
4. [Curriculum](#️-curriculum)
5. [Final Projects](#-final-projects)
6. [Folder Structure](#-folder-structure)
7. [Requirements](#️-requirements)
8. [Contributing](#-contributing)
9. [License](#-license)

---

## 🛠️ Setup Guide for Absolute Beginners

> No prior programming experience needed. Every file starts from zero.

### Step 1 — Install Python

- Go to [python.org/downloads](https://www.python.org/downloads/)
- Download **Python 3.11 or higher**
- During installation, **CHECK "Add Python to PATH"** (don't skip this!)
- Verify the install:

```bash
python --version
# Expected: Python 3.11.x or higher
```

### Step 2 — Install VS Code

- Go to [code.visualstudio.com](https://code.visualstudio.com/)
- Install the **Python** extension by Microsoft (`Ctrl+Shift+X`)
- (Optional) Install the **Jupyter** extension for `.ipynb` support

### Step 3 — Install Git

- Go to [git-scm.com/downloads](https://git-scm.com/downloads)
- Verify:

```bash
git --version
```

### Step 4 — Clone the Repo & Install Dependencies

```bash
git clone https://github.com/BerkeArdaTurk21/Python-RoadMap.git
cd Python-RoadMap
pip install -r requirements.txt
```

### Step 5 — Open Your First Lesson

1. Open `Week-01_Python_Basics/Day-01/lesson.py` in VS Code
2. Read the comments — every line is explained
3. Run the file: `python lesson.py`
4. When ready, take the quiz: `python quiz.py`

---

## 🚀 How to Use

Once setup is done, every day follows the same pattern:

```bash
cd Week-01_Python_Basics/Day-01
python lesson.py        # read the lesson
python quiz.py          # 5-question interactive quiz
python exercises.py     # try the challenges yourself
python solutions.py     # then compare with the solutions
```

> 💡 Open `lesson.ipynb` in Jupyter or VS Code for an interactive notebook experience.

---

## 📖 How to Study Each Day

Follow this exact order for maximum learning:

**Step 1 — Read the Lesson**
Open `lesson.py` or `lesson.ipynb` and read it top to bottom.
Run the code and observe every output.
Make sure you understand every line before moving on.

**Step 2 — Take the Quiz**

```bash
python quiz.py
```

🎯 Goal: Score **5/5** before moving to the exercises.
If you score less than 5/5, go back to `lesson.py`, review, then retake.

**Step 3 — Solve the Exercises**
Open `exercises.py` and solve each challenge yourself.
Do **NOT** open `solutions.py` until you have tried your best.

**Step 4 — Check Your Solutions**
Open `solutions.py` to compare your approach.
Understanding **WHY** the solution works matters more than getting it right.

> 💡 Struggle is where real learning happens. Don't skip to solutions too fast.

---

## 🗺️ Curriculum

| Week | Topic                        | Level           | Days Done | Status         |
| ---- | ---------------------------- | --------------- | --------- | -------------- |
| 01   | Python Basics                | 🟢 Beginner     | 7/7       | ✅ Completed   |
| 02   | Control Flow                 | 🟢 Beginner     | 7/7       | ✅ Completed   |
| 03   | Functions                    | 🟢 Beginner     | 7/7       | ✅ Completed   |
| 04   | Data Structures              | 🟢 Beginner     | 7/7       | ✅ Completed   |
| 05   | OOP                          | 🟡 Intermediate | 7/7       | ✅ Completed   |
| 06   | File & Error Handling        | 🟡 Intermediate | 7/7       | ✅ Completed   |
| 07   | Modules & Packages           | 🟡 Intermediate | 7/7       | ✅ Completed   |
| 08   | Advanced Python              | 🟡 Intermediate | 7/7       | ✅ Completed   |
| 09   | Project 1 — Task Manager CLI | 🟠 Project      | 7/7       | ✅ Completed   |

---

## 🚧 Final Project

Week 9 is dedicated to building a **portfolio-quality, stdlib-only Python project**.
No external frameworks, no domain expertise required — just pure Python.

| #      | Project              | Command   | Highlights                                                                           |
| ------ | -------------------- | --------- | ------------------------------------------------------------------------------------- |
| **P1** | **Task Manager CLI** | `taskman` | argparse subcommands, JSON persistence, due dates, priorities, color output, pytest   |

---

## 📁 Folder Structure

```
Python-RoadMap/
├── README.md
├── requirements.txt
│
├── Week-01_Python_Basics/
│   ├── README.md
│   ├── Day-01/
│   │   ├── lesson.py        → Concept explanations with working examples
│   │   ├── lesson.ipynb     → Interactive notebook version
│   │   ├── quiz.py          → 5-question interactive quiz
│   │   ├── exercises.py     → Challenges (no solutions)
│   │   └── solutions.py     → Full solutions with explanations
│   ├── Day-02/ ... Day-06/  → Same structure
│   └── Day-07_Weekly_Review/
│       ├── weekly_quiz.py       → 10 MCQ + 5 code challenges
│       ├── weekly_quiz.ipynb
│       └── weekly_homework.py   → Mini project + full solution
│
├── Week-02_Control_Flow/     → if/elif, loops, break/continue, match/case
├── Week-03_Functions/        → def, args, lambda, scope, recursion
├── Week-04_Data_Structures/  → lists, tuples, dicts, sets, comprehensions, collections
├── Week-05_OOP/              → classes, inheritance, encapsulation, magic methods
├── Week-06_File_Error/       → file I/O, paths, try/except, custom exceptions
├── Week-07_Modules/          → imports & venv, os, sys & argparse, datetime, random, regex
├── Week-08_Advanced/         → decorators, iterators, generators, context managers, type hints, pytest
│
└── Week-09_Project_TaskMan/      → Project 1: Task Manager CLI (taskman)
```

---

## ⚙️ Requirements

```bash
pip install -r requirements.txt
```

| Library | Purpose                                   |
| ------- | ----------------------------------------- |
| jupyter | Interactive notebooks for lessons         |
| pytest  | Testing (introduced in Week 08, projects) |

> 🪶 **Lightweight by design** — the final project uses only the Python **standard library**.
> No NumPy, no Pandas, no Flask. Pure Python, end-to-end.

---

## 🤝 Contributing

This is primarily a personal learning repository, but contributions are welcome!

- Found a bug or typo? Open an **Issue**
- Want to improve an exercise? Submit a **Pull Request**
- Find it helpful? Leave a ⭐ — it means a lot!

---

## 📄 License

MIT License — free to use, share, and build upon with attribution.
See [LICENSE](LICENSE) for details.

---

<div align="center">
  <p>⭐ If this helped you, please star the repo!</p>
  <sub>Built with python and consistency by  <a href="https://github.com/BerkeArdaTurk21">Berke Arda Türk</a></sub>
</div>

Python-RoadMap

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README