Руководство разработчика

Aspose.Cells FOSS for Python — бесплатная, открытая библиотека для программной обработки электронных таблиц. Независимо от того, создаёте ли вы конвейеры данных, генерируете автоматические отчёты, экспортируете результаты ML в Excel или конвертируете книги в Markdown для конвейеров документации, Aspose.Cells FOSS предоставляет всесторонний API, охватывающий каждый уровень манипуляций с таблицами без необходимости Microsoft Office.

Ключевые особенности

Операции с рабочими книгами и листами

Создавайте новые рабочие книги с нуля или открывайте существующие файлы XLSX или CSV.
Перемещайтесь по иерархии Workbook → Worksheets → Cells → Cell с чистым, питоничным API.
Добавляйте, переименовывайте и удаляйте листы с помощью workbook.add_worksheet(name) и workbook.remove_worksheet(index_or_name).
Получайте доступ к отдельным ячейкам по адресу (ws.cells["A1"]), задавайте значения напрямую и перебирайте заполненные диапазоны.

Оформление и форматирование ячеек

Применяйте детальное форматирование к отдельным ячейкам. Управляйте семейством шрифта, размером, цветом, полужирным, курсивом, подчеркиванием и зачеркиванием с помощью класса Font. Устанавливайте заливку фона с помощью cell.style.fill.set_solid_fill("FFRRGGBB"). Цвета задаются 8‑символьными шестнадцатеричными строками AARRGGBB без префикса # (например, "FFFF0000" для непрозрачного красного).

Создание и визуализация диаграмм

Добавляйте столбчатые, линейные, гистограммы и круговые диаграммы в листы с помощью специализированных методов, таких как ws.charts.add_bar(top_row, left_col, bottom_row, right_col) и ws.charts.add_line(...). Устанавливайте заголовок диаграммы как строку (chart.title = "My Chart"), настраивайте данные категорий на уровне диаграммы (chart.category_data = "A2:A6") и добавляйте именованные серии (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Поддержка формул

Введите формулы, совместимые с Excel, задав cell.formula = "=SUM(A1:A5)" или создав Cell(None, "=SUM(A1:A5)") и присвоив её коллекции ячеек.

Экспорт в нескольких форматах

Экспортируйте рабочие книги в XLSX, CSV, TSV, Markdown и JSON, используя один вызов workbook.save(path).
Используйте константы SaveFormat для явного управления: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON.
Используйте MarkdownSaveOptions для детального вывода Markdown (выравнивание, уровень заголовка, индекс листа).
Используйте MarkdownHandler.save_markdown_to_string(wb) для генерации Markdown в памяти.

Примечание: Aspose.Cells FOSS экспортирует в XLSX, CSV, TSV, Markdown и JSON. Экспорт в PDF, HTML, PNG, TIFF, DOCX и PPTX не входит в состав библиотеки FOSS.

Экосистема плагинов

Опциональный пакет markitdown-aspose-cells-plugin интегрируется с библиотекой Microsoft MarkItDown, чтобы добавить поддержку чтения XLSX. Установите его с помощью pip install markitdown-aspose-cells-plugin и используйте прозрачно через API MarkItDown.

Начало работы

Установить 

pip install aspose-cells-foss

Привет мир 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Hello, Aspose.Cells FOSS!"
ws.cells["A2"].value = 42
workbook.save("hello.xlsx")

Экспорт в Markdown 

from aspose.cells_foss import Workbook, Cell

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
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 88

workbook.save_as_markdown("results.md")

Создать столбчатую диаграмму 

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

data = [("Q1", 50), ("Q2", 100), ("Q3", 170), ("Q4", 300)]
for i, (label, value) in enumerate(data):
    ws.cells[f"A{i+2}"].value = label
    ws.cells[f"B{i+2}"].value = value

chart = ws.charts.add_bar(6, 0, 20, 8)
chart.title = "Quarterly Revenue"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

workbook.save("chart.xlsx")

Стиль ячеек 

from aspose.cells_foss import Workbook, Cell, Font

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"] = Cell("Revenue Report")

cell = ws.cells["A1"]
cell.style.font.bold = True
cell.style.font.size = 14
cell.style.font.color = "FFFFFFFF"   # White text (AARRGGBB, no #)
cell.style.fill.set_solid_fill("FF1E64C8")  # Blue background

workbook.save("styled.xlsx")

Доступные руководства

  • Spreadsheet Format Export — Экспортировать книги между XLSX, CSV, TSV, Markdown и JSON.
  • Formula Calculation — Вводить и вычислять совместимые с Excel формулы программно.
  • Spreadsheet Operations — Создание книг, манипуляция ячейками, операции с диапазонами и стилизация.
  • Getting Started — Установка, системные требования и ваша первая книга.

См. также

  • API Reference: Полная документация классов и методов для aspose.cells_foss
  • Knowledge Base: Практические руководства (диаграммы, экспорт в Markdown, стилизация, загрузка)
  • Product Overview: Сводка функций и возможностей
  • Blog: Introducing Aspose.Cells FOSS: Обзор библиотеки и быстрое начало
 Русский