ساخت اسکریپت مدیریت تقویم با پایتون: اتوماسیون و اسکریپت‌نویسی

تقویم‌ها ابزارهای ضروری برای سازماندهی و مدیریت زمان هستند. در دنیای دیجیتال، مدیریت تقویم اغلب از طریق نرم‌افزارهای پیچیده و رابط‌های کاربری گرافیکی انجام می‌شود. با این حال، با استفاده از پایتون و کتابخانه‌های مناسب، می‌توان اسکریپت‌هایی قدرتمند برای اتوماسیون وظایف مرتبط با تقویم ایجاد کرد. این مقاله به بررسی نحوه ساخت یک اسکریپت پایتون برای مدیریت تقویم می‌پردازد، با تمرکز بر اتوماسیون و اسکریپت‌نویسی.

پیش‌نیازها

برای دنبال کردن این آموزش، به موارد زیر نیاز دارید:

• نصب پایتون (نسخه 3.6 یا بالاتر توصیه می‌شود)
• آشنایی با مفاهیم پایه‌ای برنامه‌نویسی پایتون (متغیرها، حلقه‌ها، توابع، و غیره)
• نصب کتابخانه datetime (این کتابخانه به طور پیش‌فرض در پایتون وجود دارد)
• نصب کتابخانه icalendar (برای کار با فرمت iCalendar) – نصب از طریق pip install icalendar

مقدمه‌ای بر فرمت iCalendar

فرمت iCalendar (که اغلب با پسوند .ics شناخته می‌شود) یک استاندارد باز برای ذخیره اطلاعات تقویم است. این فرمت به شما امکان می‌دهد رویدادها، قرار ملاقات‌ها، وظایف و سایر اطلاعات مرتبط با زمان را به صورت متنی ذخیره کنید. icalendar یک کتابخانه پایتون است که به شما کمک می‌کند تا فایل‌های iCalendar را بخوانید، ایجاد کنید و ویرایش کنید.

ساخت یک تقویم ساده با استفاده از datetime

ابتدا، یک تقویم ساده را با استفاده از کتابخانه datetime ایجاد می‌کنیم. این تقویم به ما امکان می‌دهد تاریخ‌ها را نمایش دهیم و رویدادها را به صورت دستی اضافه کنیم.

import datetime

def print_calendar(year, month):
    """
    تقویم یک ماه خاص را چاپ می‌کند.
    """
    print(f"   {month}/{year}")
    print("---------------------------")
    print(" یک دو سه چهار پنج شنبه جمعه")

    first_day = datetime.date(year, month, 1).weekday()

    for day in range(1, 32):
        try:
            date = datetime.date(year, month, day)
            if date.weekday() == first_day:
                print(f"{day:2}", end=" ")
            else:
                print("   ", end=" ")
            first_day = (first_day + 1) % 7
        except ValueError:
            pass  # روزی که در ماه وجود ندارد را نادیده بگیر
    print("n")

# مثال استفاده
print_calendar(2024, 1)
print_calendar(2024, 2)

این کد یک تابع به نام print_calendar تعریف می‌کند که سال و ماه را به عنوان ورودی می‌گیرد و تقویم آن ماه را در کنسول چاپ می‌کند. تابع ابتدا روز اول ماه را تعیین می‌کند و سپس روزهای ماه را به ترتیب چاپ می‌کند.

اضافه کردن رویدادها به تقویم

اکنون، بیایید به تقویم خود قابلیت اضافه کردن رویدادها را اضافه کنیم. برای این کار، می‌توانیم از یک دیکشنری برای ذخیره رویدادها استفاده کنیم. کلید دیکشنری تاریخ رویداد و مقدار آن توضیحات رویداد خواهد بود.

import datetime

def print_calendar_with_events(year, month, events):
    """
    تقویم یک ماه خاص را با رویدادها چاپ می‌کند.
    """
    print(f"   {month}/{year}")
    print("---------------------------")
    print(" یک دو سه چهار پنج شنبه جمعه")

    first_day = datetime.date(year, month, 1).weekday()

    for day in range(1, 32):
        try:
            date = datetime.date(year, month, day)
            if date.weekday() == first_day:
                event_description = events.get(date, "")
                if event_description:
                    print(f"{day:2}* ", end=" ") # * نشان‌دهنده وجود رویداد است
                else:
                    print(f"{day:2} ", end=" ")
            else:
                print("   ", end=" ")
            first_day = (first_day + 1) % 7
        except ValueError:
            pass  # روزی که در ماه وجود ندارد را نادیده بگیر
    print("n")

# مثال استفاده
events = {
    datetime.date(2024, 1, 15): "جلسه پروژه",
    datetime.date(2024, 1, 22): "ارائه گزارش",
    datetime.date(2024, 2, 5): "قرار ملاقات با مشتری"
}

print_calendar_with_events(2024, 1, events)
print_calendar_with_events(2024, 2, events)

در این کد، تابع print_calendar_with_events یک دیکشنری به نام events را به عنوان ورودی می‌گیرد. این دیکشنری حاوی رویدادهای تقویم است. تابع بررسی می‌کند که آیا برای هر روز رویدادی وجود دارد یا خیر. اگر رویدادی وجود داشته باشد، یک ستاره (*) در کنار روز چاپ می‌کند.

کار با فرمت iCalendar

برای کار با فایل‌های iCalendar، از کتابخانه icalendar استفاده می‌کنیم. این کتابخانه به ما امکان می‌دهد فایل‌های iCalendar را بخوانیم، ایجاد کنیم و ویرایش کنیم.

from icalendar import Calendar, Event
from datetime import datetime, timedelta

def create_icalendar_event(summary, start_time, end_time, description=""):
    """
    یک رویداد iCalendar ایجاد می‌کند.
    """
    cal = Calendar()
    event = Event()
    event.add('summary', summary)
    event.add('dtstart', start_time)
    event.add('dtend', end_time)
    event.add('description', description)
    cal.add_component(event)
    return cal

def save_icalendar(cal, filename):
    """
    یک تقویم iCalendar را در یک فایل ذخیره می‌کند.
    """
    with open(filename, 'wb') as f:
        f.write(cal.to_ical())

# مثال استفاده
start_time = datetime(2024, 1, 20, 10, 0, 0)
end_time = datetime(2024, 1, 20, 12, 0, 0)

event = create_icalendar_event("جلسه برنامه‌ریزی", start_time, end_time, "بررسی پیشرفت پروژه")
calendar = create_icalendar_event("تقویم شخصی", datetime(2024,1,1), datetime(2024,1,31))
calendar.add_component(event)

save_icalendar(calendar, 'my_calendar.ics')

این کد دو تابع تعریف می‌کند: create_icalendar_event و save_icalendar. تابع create_icalendar_event یک رویداد iCalendar ایجاد می‌کند و تابع save_icalendar تقویم iCalendar را در یک فایل ذخیره می‌کند. در مثال، یک رویداد با عنوان “جلسه برنامه‌ریزی” ایجاد می‌شود و در فایل my_calendar.ics ذخیره می‌شود.

اتوماسیون وظایف تقویم

با استفاده از این اسکریپت‌ها، می‌توان وظایف مختلف مرتبط با تقویم را به صورت خودکار انجام داد. به عنوان مثال، می‌توان یک اسکریپت ایجاد کرد که به طور خودکار رویدادها را از یک فایل iCalendar بخواند و آن‌ها را در یک پایگاه داده ذخیره کند. یا می‌توان یک اسکریپت ایجاد کرد که به طور خودکار یادآوری‌هایی برای رویدادهای آینده ارسال کند.

نتیجه‌گیری

در این مقاله، نحوه ساخت یک اسکریپت پایتون برای مدیریت تقویم را بررسی کردیم. با استفاده از کتابخانه‌های datetime و icalendar، می‌توان اسکریپت‌هایی قدرتمند برای اتوماسیون وظایف مرتبط با تقویم ایجاد کرد. این اسکریپت‌ها می‌توانند به شما کمک کنند تا زمان خود را بهتر مدیریت کنید و بهره‌وری خود را افزایش دهید.