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.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 и позже.

См. также

 Русский