Python Logging Project

یک پروژه کامل آموزشی برای یادگیری و پیاده‌سازی سیستم‌های لاگ‌گیری در پایتون

📋 فهرست مطالب

• معرفی
• ویژگی‌ها
• ساختار پروژه
• نصب و راه‌اندازی
• استفاده
• تمرین‌ها
• مشارکت
• پشتیبانی

🚀 معرفی

این پروژه یک مجموعه کامل از تمرین‌های لاگ‌گیری در پایتون است که مفاهیم مختلف از پایه تا پیشرفته را پوشش می‌دهد. این پروژه برای توسعه‌دهندگانی طراحی شده که می‌خواهند سیستم‌های لاگ‌گیری حرفه‌ای در برنامه‌های پایتون خود پیاده‌سازی کنند.

✨ ویژگی‌ها

• ✅ ۱۰ تمرین جامع لاگ‌گیری
• ✅ پشتیبانی از سطوح مختلف لاگ (DEBUG, INFO, WARNING, ERROR, CRITICAL)
• ✅ هندلرهای مختلف (فایل، کنسول، چرخشی)
• ✅ فرمت‌بندی سفارشی پیام‌ها
• ✅ مدیریت استثناها
• ✅ لاگ‌گیری زمینه‌ای
• ✅ پیکربندی با دیکشنری و فایل
• ✅ لاگ‌گیری در برنامه‌های چندماژولی
• ✅ تست عملکرد
• ✅ مستندات کامل

📁 ساختار پروژه

python-logging-project/
│
├── src/
│   ├── assignments/
│   │   ├── basic_logging.py
│   │   ├── handlers.py
│   │   ├── formatting.py
│   │   ├── rotating_files.py
│   │   ├── exceptions.py
│   │   ├── contextual.py
│   │   ├── dict_config.py
│   │   ├── multi_module/
│   │   │   ├── main.py
│   │   │   ├── module_a.py
│   │   │   └── module_b.py
│   │   ├── performance.py
│   │   └── advanced_config.py
│   └── utils/
│
├── configs/
│   └── logging.conf
│
├── tests/
│   ├── test_basic_logging.py
│   ├── test_handlers.py
│   └── test_performance.py
│
├── examples/
│   ├── basic_usage.py
│   ├── web_app_example.py
│   └── cli_app_example.py
│
├── logs/
│   └── .gitkeep
│
├── requirements.txt
├── setup.py
├── run_examples.py
└── README.md

🔧 نصب و راه‌اندازی

پیش‌نیازها

• Python 3.7+
• pip

نصب

git clone https://github.com/alipgm/python-logging-project.git
cd python-logging-project

python -m venv venv
source venv/bin/activate  # Linux/Mac
# یا
venv\Scripts\activate     # Windows

pip install -r requirements.txt

🎯 استفاده

اجرای تمام تمرین‌ها

python run_examples.py

اجرای تمرین‌های خاص

from src.assignments.basic_logging import basic_logger
from src.assignments.handlers import logger_with_handlers

basic_logger()
logger_with_handlers()

📚 تمرین‌ها

شماره	موضوع
تمرین ۱	لاگ‌گیری پایه
تمرین ۲	هندلرهای مختلف
تمرین ۳	فرمت‌بندی پیام‌ها
تمرین ۴	فایل‌های چرخشی
تمرین ۵	لاگ‌گیری استثناها
تمرین ۶	لاگ‌گیری زمینه‌ای
تمرین ۷	پیکربندی با دیکشنری
تمرین ۸	برنامه‌های چندماژولی
تمرین ۹	تست عملکرد
تمرین ۱۰	پیکربندی پیشرفته

🤝 مشارکت

۱. ریپو را Fork کنید
۲. یک برنچ بسازید:

git checkout -b feature/AmazingFeature

۳. تغییرات را Commit کنید:

git commit -m "Add some AmazingFeature"

۴. Pull Request بفرستید ✅

📞 پشتیبانی

• ایجاد Issue در گیت‌هاب
• ایمیل: moharamzadeh.ali1380@gmail.com

توسعه داده شده با ❤️ برای جامعه پایتون