Посібник розробника

Aspose.Cells FOSS for Python is a free, open-source library for programmatic spreadsheet processing. Whether you are building data pipelines, generating automated reports, exporting ML results to Excel, or converting workbooks to Markdown for documentation pipelines, Aspose.Cells FOSS provides a comprehensive API that covers every layer of spreadsheet manipulation without requiring Microsoft Office.

Ключові особливості

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

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

Стилізація та форматування клітинок

Застосовуйте детальне форматування до окремих клітинок. Керуйте сімейством шрифту, розміром, кольором, жирним, курсивом, підкресленням та перекресленням за допомогою Font класу. Встановлюйте заповнення фону за допомогою cell.style.fill.set_solid_fill("FFRRGGBB"). Кольори задаються 8‑символьними шістнадцятковими рядками AARRGGBB без a # префікс (наприклад,., "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 і використовувати його прозоро через the MarkItDown API.

Початок роботи

Встановити 

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")

Доступні посібники

Див. також

 Українська