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

Стандартният формат при запазване с .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.PDFPDF експортирането не е в 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 и по-нови.

Виж също

 Български