Aspose.Cells FOSS
Python
Guía del desarrollador
Features

Exportación de formato de hoja de cálculo para Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() la llamada maneja la canalización completa de salida — XLSX, CSV, TSV, Markdown o JSON — preservando los valores de celda y las fórmulas sin requerir Microsoft Office.

Instalación y configuración 

pip install aspose-cells-foss

Importa las clases principales:

from aspose.cells_foss import Workbook, SaveFormat, Cell
from aspose.cells_foss import MarkdownHandler, MarkdownSaveOptions
from aspose.cells_foss import CSVSaveOptions

Formatos de salida compatibles

FormatoConstante SaveFormatNotas
XLSXSaveFormat.XLSXFormato predeterminado; preserva estilos, fórmulas, gráficos
CSVSaveFormat.CSVSeparado por comas; solo la primera hoja por defecto
TSVSaveFormat.TSVValores separados por tabulaciones
MarkdownSaveFormat.MARKDOWNGenera tablas Markdown estándar
JSONSaveFormat.JSONRepresentación JSON estructurada de los datos de la hoja

Importante:Aspose.Cells FOSS hace no soporta exportación a PDF, HTML, PNG, TIFF, DOCX o PPTX. Estos están disponibles en el comercial aspose-cells-python paquete únicamente.

Ejemplos de Uso

Guardar como XLSX

El formato predeterminado al guardar con un .xlsx extensión:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"
ws.cells["A2"].value = "Widget A"
ws.cells["B2"].value = 12500
ws.cells["A3"].value = "Widget B"
ws.cells["B3"].value = 8750

workbook.save("report.xlsx")

Guardar como CSV 

from aspose.cells_foss import Workbook, Cell, SaveFormat

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save("data.csv", SaveFormat.CSV)

Guardar como Markdown

Exporta datos tabulares como tablas Markdown — útil para documentación y generación de README:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "First name"
ws.cells["B1"].value = "Age"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 30
ws.cells["A3"].value = "Bob"
ws.cells["B3"].value = 25

workbook.save_as_markdown("data.md")

La salida es una tabla Markdown estándar:

| First name | Age |
|---|---|
| Alice | 30 |
| Bob | 25 |

Markdown con opciones

Usar MarkdownSaveOptions para un control granular:

from aspose.cells_foss import Workbook, Cell, MarkdownSaveOptions

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "City"
ws.cells["B1"].value = "Population"
ws.cells["A2"].value = "London"
ws.cells["B2"].value = 9000000

options = MarkdownSaveOptions()

workbook.save_as_markdown("cities.md", options)

Markdown a cadena (en memoria)

Genera una cadena Markdown sin escribir en disco:

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

workbook = Workbook()
ws = workbook.worksheets[0]
ws.cells["A1"].value = "Key"
ws.cells["B1"].value = "Value"
ws.cells["A2"].value = "version"
ws.cells["B2"].value = "26.3.0"

md_string = MarkdownHandler.save_markdown_to_string(workbook)
print(md_string)

Guardar como JSON

Exporta los datos del libro de trabajo como JSON estructurado para canalizaciones API:

from aspose.cells_foss import Workbook, Cell, SaveFormat

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

workbook.save("data.json", SaveFormat.JSON)

Cargar un CSV y Guardar como XLSX 

from aspose.cells_foss import Workbook, SaveFormat

workbook = Workbook()
workbook.load_csv("input.csv")
workbook.save("output.xlsx", SaveFormat.XLSX)

Consejos y mejores prácticas

Exportación Markdown

  • Usar MarkdownHandler.save_markdown_to_string(wb) para casos de uso en memoria, como respuestas de API.

Exportación CSV

  • La exportación CSV escribe la primera hoja de cálculo por defecto.
  • Los caracteres especiales (comas, saltos de línea) en los valores de celda se citan automáticamente.

Exportación JSON

  • La exportación JSON usa direcciones de celda como claves. Adecuada para intercambio de datos; las fórmulas complejas se almacenan como sus expresiones de cadena.

Problemas comunes y soluciones

ProblemaResolución
ModuleNotFoundError: No module named 'aspose.cells_foss'Ejecutar pip install aspose-cells-foss y confirma que el entorno virtual está activo
AttributeError en SaveFormat.PDFLa exportación a PDF no está en la biblioteca FOSS; usa SaveFormat.MARKDOWN o SaveFormat.XLSX en su lugar
Salida Markdown vacíaAsegúrate de que al menos una celda en la hoja tenga un valor antes de guardar
Problemas de codificación en MarkdownUsa MarkdownHandler.save_markdown_to_string() para salida de cadena en memoria con control total de codificación

Preguntas frecuentes

¿Qué formatos de salida admite Aspose.Cells FOSS? XLSX, CSV, TSV, Markdown y JSON.

¿Puedo convertir a PDF? No. La exportación a PDF requiere la versión comercial aspose-cells-python paquete. Aspose.Cells FOSS solo exporta a XLSX, CSV, TSV, Markdown y JSON.

¿Puedo cargar un XLSX existente y volver a guardarlo como Markdown? Sí. Workbook("existing.xlsx") carga el archivo, y workbook.save_as_markdown("output.md") lo exporta.

¿Se admite la salida de Markdown basada en streams? Sí. Use MarkdownHandler.save_markdown_to_string(workbook) para obtener el Markdown como una cadena Python sin ninguna operación de file I/O.

¿Qué versiones de Python son compatibles? Python 3.7 y posteriores.

Ver también

 Español