Aspose.Cells FOSS
Python
Посібник розробника
Features

Експорт формату електронних таблиць для Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() виклик обробляє повний конвеєр виводу — XLSX, CSV, TSV, Markdown або JSON — зберігаючи значення клітинок та формули без потреби у Microsoft Office.

Встановлення та налаштування 

pip install aspose-cells-foss

Імпортуйте основні класи:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

Підтримувані формати виводу

ФорматКонстанта SaveFormatПримітки
XLSXSaveFormat.XLSXФормат за замовчуванням; зберігає стилі, формули, діаграми
CSVSaveFormat.CSVРозділені комами; за замовчуванням лише перший лист
TSVSaveFormat.TSVЗначення, розділені табуляцією
MarkdownSaveFormat.MARKDOWNГенерує стандартні таблиці Markdown
JSONSaveFormat.JSONСтруктуроване представлення даних листа у форматі JSON

Важливо: Aspose.Cells FOSS робить не підтримує експорт у PDF, HTML, PNG, TIFF, DOCX або PPTX. Це доступно лише у комерційному aspose-cells-python пакеті лише.

Приклади використання

Зберегти у XLSX

Типовий формат при збереженні з a .xlsx розширення:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

Зберегти у CSV 

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

Зберегти у Markdown

Експортуйте табличні дані у вигляді таблиць Markdown — корисно для документації та генерації README:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

Вихід — стандартна таблиця Markdown:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

Markdown з параметрами

Використовуйте MarkdownSaveOptions для точного керування:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown у рядок (в пам’яті)

Створіть рядок Markdown без запису на диск:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

Зберегти у JSON

Експортуйте дані робочої книги у структурований JSON для конвеєрів API:

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95.5
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88.0

workbook.save("data.json", SaveFormat.JSON)

Завантажте CSV і збережіть як XLSX 

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

Поради та кращі практики

Експорт у Markdown

  • Використовуйте MarkdownHandler.save_markdown_to_string(wb) для випадків використання в пам’яті, таких як відповіді API.

Експорт у CSV

  • Експорт CSV за замовчуванням записує перший лист.
  • Спеціальні символи (коми, переноси рядків) у значеннях клітинок автоматично беруться в лапки.

Експорт у JSON

  • Експорт JSON використовує адреси клітинок як ключі. Підходить для обміну даними; складні формули зберігаються як їхні рядкові вирази.

Поширені проблеми та їх вирішення

ПроблемаВирішення
ModuleNotFoundError: No module named 'aspose.cells_foss'Запустити pip install aspose-cells-foss і підтвердьте, що віртуальне середовище активне
AttributeError увімкнено SaveFormat.PDFЕкспорт у PDF відсутній у бібліотеці FOSS; використайте SaveFormat.MARKDOWN або SaveFormat.XLSX замість
Порожній вивід MarkdownПереконайтеся, що хоча б одна клітинка у таблиці має значення перед збереженням
Проблеми кодування в MarkdownВикористовувати MarkdownHandler.save_markdown_to_string() для виведення рядка в пам’яті з повним контролем кодування

Поширені запитання

Які формати виводу підтримує Aspose.Cells FOSS? XLSX, CSV, TSV, Markdown, і JSON.

Чи можу я конвертувати у PDF? Ні. Експорт у PDF вимагає комерційного aspose-cells-python пакету. Aspose.Cells FOSS експортує лише у XLSX, CSV, TSV, Markdown, і JSON.

Чи можу я завантажити існуючий XLSX і зберегти його як Markdown? Так. Workbook("existing.xlsx") завантажує файл, і workbook.save_as_markdown("output.md") експортує його.

Чи підтримується потоковий вивід Markdown? Так. Використайте MarkdownHandler.save_markdown_to_string(workbook) для отримання Markdown як рядка Python без будь‑якого файлового вводу/виводу.

Які версії Python підтримуються? Python 3.7 і пізніше.

Див. також

 Українська