Guia del desenvolupador

Aspose.Cells FOSS for Python és una biblioteca gratuïta i de codi obert per al processament programàtic de fulls de càlcul. Tant si esteu construint cadenes de dades, generant informes automàtics, exportant resultats de ML a Excel, o convertint llibres de treball a Markdown per a cadenes de documentació, Aspose.Cells FOSS proporciona una API integral que cobreix cada capa de manipulació de fulls de càlcul sense requerir Microsoft Office.

Característiques clau

Operacions de llibre de treball i full de càlcul

Creeu nous llibres de treball des de zero o obriu fitxers XLSX o CSV existents. Navegueu per la jerarquia Workbook → Worksheets → Cells → Cell amb una API neta i Pythonica. Afegiu, reanomeu i elimineu fulls de càlcul utilitzant workbook.add_worksheet(name) i workbook.remove_worksheet(index_or_name). Accediu a cel·les individuals per adreça (ws.cells["A1"]), establiu valors directament i itereu sobre intervals poblats.

Estil i format de cel·les

Aplica format granular a cel·les individuals. Controla la família de fonts, la mida, el color, negreta, cursiva, subratllat i ratllat mitjançant la classe Font. Estableix emplenaments de fons amb cell.style.fill.set_solid_fill("FFRRGGBB"). Els colors s’expressen com a cadenes hexadecimals de 8 caràcters AARRGGBB sense el prefix # (per exemple, "FFFF0000" per a vermell opac).

Creació i visualització de gràfics

Afegeix gràfics de columnes, línies, barres i pastís a les fulles de càlcul mitjançant mètodes dedicats com ws.charts.add_bar(top_row, left_col, bottom_row, right_col) i ws.charts.add_line(...). Estableix el títol del gràfic com una cadena (chart.title = "My Chart"), configura les dades de categoria a nivell de gràfic (chart.category_data = "A2:A6") i afegeix sèries amb nom (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Suport de fórmules

Introduïu fórmules compatibles amb Excel establint cell.formula = "=SUM(A1:A5)" o construint un Cell(None, "=SUM(A1:A5)") i assignant-lo a la col·lecció de cel·les.

Exportació Multi-Format

Exporta llibres de treball a XLSX, CSV, TSV, Markdown i JSON mitjançant una única crida workbook.save(path). Utilitza les constants SaveFormat per a un control explícit: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Utilitza MarkdownSaveOptions per a una sortida Markdown de gran precisió (alineació, nivell de capçalera, índex del full de càlcul). Utilitza MarkdownHandler.save_markdown_to_string(wb) per a la generació de Markdown en memòria. Consulta Export Format Examples per a codi llest per usar i Export Troubleshooting per a consells i FAQ.

Nota: Aspose.Cells FOSS exporta a XLSX, CSV, TSV, Markdown i JSON. L’exportació a PDF, HTML, PNG, TIFF, DOCX i PPTX no forma part de la biblioteca FOSS.

Ecosistema de complements

El paquet opcional markitdown-aspose-cells-plugin s’integra amb la biblioteca MarkItDown de Microsoft per afegir suport de lectura d’XLSX. Instal·leu-lo amb pip install markitdown-aspose-cells-plugin i utilitzeu-lo de manera transparent via l’API MarkItDown.

Començar

Instal·lar 

pip install aspose-cells-foss

Hola món 

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

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

Crea un gràfic de columnes 

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

Estil de cel·les 

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

Guies disponibles

Vegeu també

 Català