Guía del desarrollador

Aspose.Cells FOSS for Python es una biblioteca gratuita y de código abierto para el procesamiento programático de hojas de cálculo. Ya sea que esté construyendo canalizaciones de datos, generando informes automatizados, exportando resultados de ML a Excel o convirtiendo libros de trabajo a Markdown para canalizaciones de documentación, Aspose.Cells FOSS proporciona una API integral que cubre cada capa de manipulación de hojas de cálculo sin requerir Microsoft Office.

Características clave

Operaciones de Libro de Trabajo y Hoja de Cálculo

Cree nuevos libros de trabajo desde cero o abra archivos XLSX o CSV existentes. Navegue por la jerarquía Workbook → Worksheets → Cells → Cell con una API limpia y Pythonic. Añada, renombre y elimine hojas de cálculo usando workbook.add_worksheet(name) y workbook.remove_worksheet(index_or_name). Acceda a celdas individuales por dirección (ws.cells["A1"]), establezca valores directamente y recorra rangos poblados.

Estilizado y Formateo de Celdas

Aplicar formato granular a celdas individuales. Controlar la familia de fuentes, tamaño, color, negrita, cursiva, subrayado y tachado mediante la clase Font. Establecer rellenos de fondo usando cell.style.fill.set_solid_fill("FFRRGGBB"). Los colores se expresan como cadenas hexadecimales de 8 caracteres AARRGGBB sin un prefijo # (p. ej., "FFFF0000" para rojo opaco).

Creación y visualización de gráficos

Agregue gráficos de columnas, líneas, barras y sectores a las hojas de cálculo utilizando métodos dedicados como ws.charts.add_bar(top_row, left_col, bottom_row, right_col) y ws.charts.add_line(...).
Establezca el título del gráfico como una cadena (chart.title = "My Chart"), configure los datos de categoría a nivel de gráfico (chart.category_data = "A2:A6") y agregue series con nombre (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Soporte de fórmulas

Ingrese fórmulas compatibles con Excel configurando cell.formula = "=SUM(A1:A5)" o construyendo un Cell(None, "=SUM(A1:A5)") y asignándolo a la colección de celdas.

Exportación multiformato

Exporte libros de trabajo a XLSX, CSV, TSV, Markdown y JSON usando una única llamada workbook.save(path). Use las constantes SaveFormat para un control explícito: SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Use MarkdownSaveOptions para una salida de Markdown de gran detalle (alineación, nivel de encabezado, índice de hoja). Use MarkdownHandler.save_markdown_to_string(wb) para la generación de Markdown en memoria. Consulte Ejemplos de formato de exportación para código listo para usar y Solución de problemas de exportación para consejos y preguntas frecuentes.

Nota: Aspose.Cells FOSS exporta a XLSX, CSV, TSV, Markdown y JSON. La exportación a PDF, HTML, PNG, TIFF, DOCX y PPTX no forma parte de la biblioteca FOSS.

Ecosistema de complementos

El paquete opcional markitdown-aspose-cells-plugin se integra con la biblioteca MarkItDown de Microsoft para añadir soporte de lectura de XLSX. Instálalo con pip install markitdown-aspose-cells-plugin y utilízalo de forma transparente a través de la API MarkItDown.

Primeros pasos

Instalar 

pip install aspose-cells-foss

Hola Mundo 

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

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

Crear un gráfico de columnas 

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

Estilo de celdas 

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

Guías disponibles

Ver también

 Español