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

Aspose.Cells FOSS for Python е безплатна, с отворен код библиотека за програмен процесинг на електронни таблици. Независимо дали създавате данни потоци, генерирате автоматизирани отчети, експортирате резултати от машинно обучение в Excel или конвертирате работни книги в Markdown за процеси на документиране, Aspose.Cells FOSS предоставя обширен API, който обхваща всеки слой на манипулация на електронни таблици без необходимост от 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 шестнадесетични низове без префикс # (например "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 в паметта. Вижте Export Format Examples за готов код и Export Troubleshooting за съвети и ЧЗВ.

Забележка: Aspose.Cells FOSS експортира в XLSX, CSV, TSV, Markdown и JSON. Експортирането в PDF, HTML, PNG, TIFF, DOCX и PPTX не е част от FOSS библиотеката.

Екосистема на плъгините

Опционалният markitdown-aspose-cells-plugin пакет се интегрира с библиотеката MarkItDown на Microsoft, за да добави поддръжка за четене на 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")

Налични ръководства

Вижте също

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