چگونه با Aspose.Cells FOSS برای Python شروع کنیم

aspose-cells-foss برای Python یک کتابخانه رایگان و مجوز MIT برای ایجاد، خواندن و… تبدیل فایل های صفحه نمایش – هیچ Microsoft Office مورد نیاز، هیچ افزونه های بومی، خالص Python از PyPI.

راهنمای گام به گام

مرحله اول: نصب بسته بندی

نصب از پپ با پیت:

pip install aspose-cells-foss>=26.3.1

نصب را بررسی کنید:

from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")

مرحله دوم: کلاس های مورد نیاز واردات

from aspose.cells_foss import Workbook, SaveFormat

مرحله 3: ایجاد یک کتاب کار و نوشتن داده ها

استفاده از Workbook() برای ایجاد یک کتاب جدید اضافه کنید یک دفترچه کار با add_worksheet(),پس از آن دسترسی به شبکه سلولی خود از طریق cells مالکیت و استفاده از آن Cells.cell(row, col) برای دریافت یک Cell.ارزش ها را با Cell.put_value():

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook()
ws = wb.add_worksheet("Sales")

cells = ws.cells
cells.cell(1, 1).put_value("Product")
cells.cell(1, 2).put_value("Revenue")
cells.cell(2, 1).put_value("Widget A")
cells.cell(2, 2).put_value(12500)
cells.cell(3, 1).put_value("Widget B")
cells.cell(3, 2).put_value(8750)

wb.save("sales.xlsx", SaveFormat.XLSX)
print("sales.xlsx written.")

مرحله چهارم: کتاب را دوباره بخوانید.

یک فایل موجود را با عبور از مسیر فایل به Workbook(file_path).استفاده از get_worksheet() با نام یا شاخص، سپس ارزش های سلولی را از طریق value املاک :

from aspose.cells_foss import Workbook

wb = Workbook("sales.xlsx")
ws = wb.get_worksheet(0)
cells = ws.cells

print(f"A1: {cells.cell(1, 1).value}")
print(f"B2: {cells.cell(2, 2).value}")

مرحله 3: ذخیره به فرمت هدف

Workbook.save() پشتیبانی از چندین فرمت از طریق SaveFormat.استفاده از SaveFormat.CSV برای تولید ناخالص و SaveFormat.MARKDOWN برای برچسب های مارک:

from aspose.cells_foss import Workbook, SaveFormat

wb = Workbook("sales.xlsx")
wb.save("sales.csv", SaveFormat.CSV)
wb.save("sales.md", SaveFormat.MARKDOWN)
print("CSV and Markdown exports written.")

مشکلات رایج و راه‌حل‌ها

ModuleNotFoundError: No module named 'aspose' نصب بسته در محیط مجازی فعال: pip install aspose-cells-foss. تأیید با pip show aspose-cells-foss.

FileNotFoundError هنگام بارگذاری کتاب کار استفاده از pathlib.Path راه های حمل و نقل را ایجاد کنید: Workbook(str(Path("data") / "file.xlsx")).

بازگشت ارزش سلولی None بعد از خواندن سلول خالی یا خارج از محدوده است.استفاده از Cell.is_empty() قبل از خواندن چک کنید value.

خروجی CSV فقط شامل صفحه اول است. save() با SaveFormat.CSV فقط کارگاه فعال را وارد می کند.استفاده از set_active_worksheet() برای انتخاب صفحه ای که می خواهید قبل از صرفه جویی وارد کنید.

فایل XLSX توسط Excel باز نمی شود. اطمینان حاصل کنید که شما عبور می کنید SaveFormat.XLSX بدون آن، فرمول از فایلهای پیاده روی: اگر مسیر در حال حرکت نیست، .xlsx ممکن است محصول تمدید شده معتبر نباشد.

سوالات متداول

آیا اپلیکیشن های مایکروسافت نیاز به Microsoft Office دارند؟?

کتابخانه فایل های صفحه را به صورت خالص در Python بدون هیچ گونه وابستگی به Microsoft Office، COM Automation یا Windows API می خواند و می نویسد.

کدام نسخه های Python پشتیبانی می شوند؟?

Python 3.7 یا بالاتر. این بسته در ویندوز، macOS، لینوکس و داکر کار می کند.

آیا کتابخانه برای استفاده تجاری رایگان است؟?

بله، تحت مجوز MIT منتشر می شود.شما می توانید آن را برای هر هدف از جمله برنامه های تجاری استفاده کنید، ویرایش و توزیع مجدد.

چگونه می توانم بر روی تمام سلول ها در یک صفحه ای تثبیت کنم؟?

استفاده از Cells.iter_rows() برای ردیابی خط به خط:

from aspose.cells_foss import Workbook

wb = Workbook("data.xlsx")
ws = wb.get_worksheet(0)
for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
    print(row)

چه فرمت هایی را می توانم ذخیره کنم؟?

SaveFormat پشتیبانی XLSX, CSV, TSV, MARKDOWN,و JSON.استفاده از SaveFormat.from_extension(file_path) برای تشخیص فرمت به طور خودکار از یک مسیر فایل.