A practical, example-driven Python repository designed to help you learn Python from fundamentals to advanced concepts through clear, runnable code.

Each file is self-contained and focuses on a single concept, making the repository suitable for structured learning, revision, or reference.

If you like this project, please hit the ⭐ Star button and follow me on GitHub @blshaer!

• Overview
• Topics Covered
• Getting Started
• Prerequisites
• File Structure
• Learning Path
• Projects

This repository contains a complete Python tutorial designed for both beginners and experienced developers looking to refresh their knowledge. Each topic is organized in separate folders with practical, runnable examples.

Key Features:

• ✅ Self-contained files — Each file can be run independently
• ✅ Comprehensive comments — Detailed explanations for every concept
• ✅ Practical examples — Real-world use cases and patterns
• ✅ Progressive difficulty — From basics to advanced topics

Follow these steps to clone the repository and set it up in your local editor:

1. Clone the repository Open your terminal and run:

   git clone https://github.com/blshaer/python-by-example.git
   cd python-by-example

2. Set up a Virtual Environment (Recommended) It's best practice to keep your projects isolated. Run these commands:

   python -m venv venv
   # On Windows:
   .\venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate

3. Install Dependencies Install the necessary tools for testing and formatting:

   pip install -r requirements.txt

4. Open in your code editor We recommend Visual Studio Code. Open the project directly:

   code .

5. Explore and Run Navigate to any example, like 01_basics, and run the file:

   cd 01_basics
   python 01_print.py

6. Read the comments — Detailed explanations are provided inline for every concept!

7. Try the Tests — Go to the new testing module to see how professional code is verified:

   pytest 11_testing/01_test_basics.py

# Check your Python version
python --version

Each Python file follows a consistent structure:

"""
================================================================================
File: filename.py
Topic: Topic Name
================================================================================

Description of what the file covers...

Key Concepts:
- Concept 1
- Concept 2
- ...

================================================================================
"""

# -----------------------------------------------------------------------------
# Section 1: Basic Example
# -----------------------------------------------------------------------------
# ... code with inline comments ...

# -----------------------------------------------------------------------------
# Section 2: Advanced Example
# -----------------------------------------------------------------------------
# ... more code ...

 Recommended Flow:
Beginner     →  01_basics → 02_control_flow → 03_loops
Intermediate →  04_data_structures → 05_functions → 06_modules
Advanced     →  07_error_handling → 08_oop → 09_advanced
Professional →  10_best_practices → 11_testing

Put your skills to the test! Each project includes a challenge description (README.md) so you can try building it yourself before looking at the solution.

💡 Tip: Read the project README.md first and try to build it on your own before looking at solution.py!

Use this checklist to track your learning progress:

• 01. Basics — Print, Comments, Variables, Data Types
• 02. Control Flow — If/Else, Elif, Match/Case
• 03. Loops — For, While, Break/Continue
• 04. Data Structures — Lists, Tuples, Sets, Dictionaries
• 05. Functions — Basics, Arguments, Returns, Lambda
• 06. Modules & Packages — Imports, Custom Modules
• 07. Error Handling — Try/Except, Custom Exceptions
• 08. OOP — Classes, Init, Inheritance, Polymorphism
• 09. Advanced Python — Comprehensions, Generators, Decorators
• 10. Best Practices — PEP8, Type Hints, Virtual Environments
• 11. Testing — Unit Tests, Pytest, Assertions

• Project 01 — Number Guessing Game (Beginner)
• Project 02 — Expense Tracker (Intermediate)
• Project 03 — Library Management System (Advanced)
• Project 04 — Real-time Weather CLI (Professional)

Happy Learning!

Made with ❤️ by Baraa