کار با فایل‌های Excel در پایتون با OpenPyXL

OpenPyXL یک کتابخانه قدرتمند در پایتون برای کار با فایل‌های Excel است. این کتابخانه به شما امکان می‌دهد تا فایل‌های .xlsx و .xlsm را خوانده، ویرایش یا ایجاد کنید. در این مقاله، به بررسی نحوه استفاده از OpenPyXL در پروژه‌های پایتون می‌پردازیم.

نصب OpenPyXL

قبل از استفاده از OpenPyXL، باید آن را نصب کنید. با استفاده از pip می‌توانید آن را نصب کنید:

pip install openpyxl

این دستور باعث نصب کتابخانه OpenPyXL در محیط پایتون شما می‌شود.

وارد کردن کتابخانه

برای استفاده از OpenPyXL، باید آن را در کد خود وارد کنید:

from openpyxl import Workbook, load_workbook

در اینجا ما دو کلاس مهم را وارد می‌کنیم: Workbook برای ایجاد فایل جدید و load_workbook برای باز کردن یک فایل موجود.

ایجاد یک فایل Excel جدید

برای ایجاد یک فایل Excel جدید، می‌توانید از کلاس Workbook استفاده کنید:

wb = Workbook()
ws = wb.active
ws['A1'] = 'سلام'
ws['B1'] = 'دُنیا'

wb.save('example.xlsx')

در این کد، یک کاربرگ جدید ایجاد می‌شود و دو مقدار در سلول‌های A1 و B1 ذخیره می‌شوند. سپس فایل به نام example.xlsx ذخیره می‌شود.

باز کردن یک فایل Excel موجود

برای باز کردن یک فایل Excel موجود، از load_workbook استفاده می‌کنیم:

wb = load_workbook('example.xlsx')
ws = wb.active
print(ws['A1'].value)

این کد یک فایل Excel را باز کرده و مقدار سلول A1 را چاپ می‌کند.

دسترسی به سلول‌ها

دسترسی به سلول‌ها در OpenPyXL به دو روش انجام می‌شود:

• با استفاده از شماره‌گذاری افقی و عمودی (A1, B2 و غیره)
• با استفاده از شماره‌گذاری شده‌ی سلول‌ها

مثال:

cell = ws['A1']
print(cell.value)

# یا
cell = ws.cell(row=1, column=1)
print(cell.value)

در این کد، دو روش مختلف برای دسترسی به سلول A1 نشان داده شده است. در روش اول با استفاده از شماره‌گذاری معمولی، و در روش دوم با استفاده از تابع cell که با شماره‌های ردیف و ستون تعیین می‌شود.

نوشتن داده‌ها

برای نوشتن داده‌ها در یک فایل Excel، می‌توانید به سلول‌ها مقدار دهید:

ws['A1'] = 'نام'
ws['B1'] = 'سن'
ws['A2'] = 'علی'
ws['B2'] = 25

در این مثال، داده‌های یک فرد در سلول‌های A1 تا B2 ذخیره شده‌اند.

نوشتن داده‌ها به صورت آرایه

برای نوشتن داده‌های زیاد، می‌توانید از لیست‌ها استفاده کنید:

data = [
    ['نام', 'سن'],
    ['علی', 25],
    ['رضا', 30],
    ['مریم', 28]
]

for row in data:
    ws.append(row)

wb.save('people.xlsx')

این کد داده‌ها را در قالب یک لیست اضافه می‌کند و فایل را ذخیره می‌کند. تابع append هر عنصر را به عنوان یک ردیف جدید در فایل قرار می‌دهد.

خواندن داده‌ها

برای خواندن داده‌ها از یک فایل Excel، می‌توانید از حلقه‌های تو در تو استفاده کنید:

for row in ws.iter_rows(min_row=1, max_row=5, min_col=1, max_col=2):
    for cell in row:
        print(cell.value, end=' ')
    print()

در این کد، داده‌های سلول‌های 1 تا 5 در ردیف‌ها و 1 تا 2 در ستون‌ها خوانده شده و چاپ می‌شوند.

ویرایش فایل Excel

برای ویرایش یک فایل Excel موجود، ابتدا آن را باز کرده و سپس داده‌ها را تغییر می‌دهید:

wb = load_workbook('example.xlsx')
ws = wb.active

ws['C1'] = 'شهر'
ws['C2'] = 'تهران'

wb.save('example.xlsx')

در این کد، یک سلول جدید در ستون C اضافه شده و مقدار “تهران” در سلول C2 ذخیره شده است.

بررسی وجود یک فایل

برای اطمینان از وجود یک فایل قبل از باز کردن، می‌توانید از try-except استفاده کنید:

try:
    wb = load_workbook('example.xlsx')
    print("فایل با موفقیت باز شد.")
except FileNotFoundError:
    print("فایل پیدا نشد.")

در این کد، چک می‌شود که آیا فایل وجود دارد یا خیر. اگر فایل وجود نداشته باشد، خطای FileNotFoundError رخ می‌دهد.

پایداری و بهترین شیوه‌ها

برای استفاده بهتر از OpenPyXL، باید به چند نکته توجه کنید:

• همیشه فایل‌ها را با استفاده از try-except مدیریت کنید.
• در صورت نیاز، از حلقه‌های تو در تو برای خواندن داده‌ها استفاده کنید.
• برای ذخیره‌سازی فایل‌های بزرگ، از تابع save به صورت منظم استفاده کنید.

مقایسه OpenPyXL با دیگر کتابخانه‌ها

نکات مهم در استفاده از OpenPyXL

• برای کار با فایل‌های بزرگ، ممکن است عملکرد کند باشد.
• مطمئن شوید که فایل‌ها در حالت غیرفعال هستند قبل از دسترسی به آن‌ها.
• در صورت خرابی فایل، می‌توانید از گزینه‌های BackUp استفاده کنید.

کار با فرمت‌های مخصوص Excel

OpenPyXL به صورت پیش‌فرض فایل‌های .xlsx و .xlsm را پشتیبانی می‌کند. برای کار با فرمت‌های دیگر، باید از کتابخانه‌های دیگر استفاده کنید.

پروژه نمونه: ذخیره اطلاعات کاربران

در این بخش، یک پروژه ساده برای ذخیره‌سازی اطلاعات کاربران از طریق OpenPyXL نشان می‌دهیم:

from openpyxl import Workbook

def save_user_data(name, age):
    wb = Workbook()
    ws = wb.active
    ws['A1'] = 'نام'
    ws['B1'] = 'سن'
    ws.append([name, age])
    wb.save('users.xlsx')

save_user_data('علی', 25)

این کد یک فایل Excel جدید ایجاد می‌کند و اطلاعات کاربر را ذخیره می‌کند.

نتیجه‌گیری

OpenPyXL یک کتابخانه بسیار قدرتمند برای کار با فایل‌های Excel در پایتون است. با استفاده از آن، می‌توانید فایل‌ها را خوانده و ویرایش کنید، داده‌ها را به صورت ساده و سریع ذخیره کنید و پروژه‌های متنوعی را انجام دهید.

لطفاً از کمبود ها و مشکلات این محتوا برای ما بنویسید

ارسال