Aspose.Cells FOSS for Python

Información del paquete


paquete PyPI	`aspose-cells-foss`
importación Python	`from aspose.cells_foss import ...`
Examples	26.3.1
Examples	MIT
requerimiento Python	>= 3.7
Examples	`pycryptodome>=3.15.0`, `olefile>=0.46`

Examples

Examples	Examples
aspose.cells_foss	API central de hojas de cálculo: libros de trabajo, hojas de cálculo, celdas, estilos, gráficos, controladores de formato

Examples: No hay aspose.pydrawing módulo en Aspose.Cells FOSS. Los colores se expresan como cadenas hexadecimales de 8 dígitos AARRGGBB (p. ej., "FFFF0000" para rojo opaco).

aspose.cells_foss

Examples

Examples	Examples	Examples
`Workbook`	libro de trabajo	Punto de entrada para crear, cargar y guardar archivos de hojas de cálculo
`Worksheet`	hoja de cálculo	Representa una hoja única; proporciona acceso a celdas, gráficos e imágenes
`Cells`	celdas	Colección similar a un diccionario de `Cell` objetos dentro de un `Worksheet`
`Cell`	celda	Representa una celda individual; valor, fórmula y estilo
`Style`	estilo	Formato de celda: fuente, relleno, bordes, alineación, formato numérico, protección
`Font`	estilo	Propiedades de la fuente: nombre, tamaño, color, negrita, cursiva, subrayado, tachado
`Fill`	estilo	Relleno de fondo: sólido, degradado o patrón
`NumberFormat`	estilo	Utilidades integradas de búsqueda de formatos numéricos
`SaveFormat`	libro de trabajo	Enumeración de formatos de salida compatibles (XLSX, CSV, MARKDOWN, JSON)
`Chart`	gráfico	Representa un gráfico incrustado en una hoja de cálculo
`ChartType`	gráfico	Enum: LINE, BAR, PIE, AREA, STOCK y más
`NSeries`	gráfico	Colección de series de datos en un gráfico
`ChartSeries`	gráfico	Una sola serie de datos con valores, categorías y barras de error
`ChartAxis`	gráfico	Configuración del eje: escala, formato, título
`ChartView3D`	gráfico	3D rotation and perspective settings
`ChartErrorBars`	gráfico	Configuración de barras de error para una serie
`DataValidation`	data-validation	Una única regla de validación en un rango de celdas
`DataValidationCollection`	data-validation	Todas las reglas de validación para una hoja de cálculo
`DataValidationType`	data-validation	Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
`DataValidationOperator`	data-validation	Enum: BETWEEN, EQUAL, GREATER_THAN, etc.
`DataValidationAlertStyle`	data-validation	Enum: STOP, WARNING, INFORMATION
`CSVHandler`	csv-handler	Métodos estáticos para importación/exportación de CSV
`CSVLoadOptions`	csv-handler	Opciones para cargar archivos CSV
`CSVSaveOptions`	csv-handler	Opciones para guardar archivos CSV
`MarkdownHandler`	markdown-handler	Métodos estáticos para la exportación de Markdown
`MarkdownSaveOptions`	markdown-handler	Opciones para la exportación de Markdown
`JsonHandler`	json-handler	Métodos estáticos para la exportación de JSON
`JsonSaveOptions`	json-handler	Opciones para la exportación de JSON
`Shape`	forma	Dibujando forma con relleno, línea, texto y formato de fuente
`ShapeCollection`	forma	Todas las formas en una hoja de cálculo (`ws.shapes`)
`MsoDrawingType`	forma	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, etc.
`Table`	tabla	Tabla de Excel (referencia estructurada) en una hoja de cálculo
`TableCollection`	tabla	Todas las tablas en una hoja de cálculo (`ws.list_objects`)
`TableColumn`	tabla	Definición de columna dentro de una tabla
`TableStyleInfo`	tabla	Configuración de estilo visual para una tabla
`SparklineGroup`	sparkline	Grupo de gráficos sparkline que comparten un estilo visual
`SparklineGroupCollection`	sparkline	Todos los grupos sparkline (`ws.sparkline_groups`)
`Sparkline`	sparkline	Una única celda sparkline vinculada a un rango de datos
`SparklineType`	sparkline	Enum: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	page-break	Saltos de página horizontales manuales (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	salto de página	Saltos de página verticales manuales (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	cifrado	Parámetros de cifrado AES-256/SHA-512 (recomendado)
`StandardEncryptionParameters`	cifrado	Parámetros de cifrado heredados AES-128/SHA-1
`CipherAlgorithm`	cifrado	Enum: AES_128, AES_192, AES_256
`HashAlgorithm`	cifrado	Enum: SHA1, SHA256, SHA384, SHA512

Examples

Examples

Examples	Examples
`Workbook()`	Crear un nuevo libro de trabajo vacío (formato XLSX)
`Workbook(file_path: str)`	Cargar un libro de trabajo desde una ruta de archivo
`Workbook(file_path: str, password: str)`	Cargar un libro de trabajo protegido con contraseña

Propiedades clave

Examples	Examples	Examples
`worksheets`	lista	Acceder a las hojas de cálculo por índice: `workbook.worksheets[0]`

Métodos clave

Examples	Examples	Examples
`save(file_path)`	Examples	Guardar en un archivo; formato inferido de la extensión
`save(file_path, save_format)`	Examples	Guardar con SaveFormat explícito
`save_as_csv(file_path, options=None)`	Examples	Guardar como CSV
`save_as_markdown(file_path, options=None)`	Examples	Guardar como tablas Markdown
`save_as_json(file_path, options=None)`	Examples	Guardar como JSON
`load_csv(file_path, options=None)`	Examples	Cargar datos CSV en el libro de trabajo
`add_worksheet(name=None)`	Examples	Agregar una nueva hoja de cálculo
`get_worksheet(index_or_name)`	Examples	Obtener hoja de cálculo por índice o nombre
`remove_worksheet(index_or_name)`	Examples	Eliminar una hoja de cálculo
`copy_worksheet(index_or_name_or_ws)`	Examples	Copiar una hoja de cálculo existente
`protect(password=None, lock_structure=True)`	Examples	Proteger con contraseña el libro de trabajo
`unprotect(password=None)`	Examples	Eliminar la protección del libro de trabajo
`is_protected()`	bool	Verificar si el libro de trabajo está protegido

Examples

Propiedades clave

Examples	Examples	Examples
`name`	str	Nombre de la pestaña de la hoja de cálculo
`cells`	Examples	Todas las celdas de esta hoja de cálculo
`charts`	ChartCollection	Todos los gráficos de esta hoja de cálculo

Examples

Cells admite acceso estilo diccionario mediante una cadena de dirección de celda.

Patrones de acceso

# Read a cell value
value = ws.cells["A1"].value

# Set a cell value directly
ws.cells["A1"].value = "Hello"

# Assign a Cell object
from aspose.cells_foss import Cell
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14)
ws.cells["A3"] = Cell("Hello World")
ws.cells["A4"] = Cell(None, "=SUM(A1:A3)")   # formula cell

Examples

Examples

Examples	Examples
`Cell(value=None)`	Crea una celda con un valor (int, float, str o None)
`Cell(value, formula)`	Crea una celda de fórmula (el valor suele ser None)

Propiedades clave

Examples	Examples	Examples
`value`	Examples	Valor de la celda (str, int, float o None)
`formula`	str	Cadena de fórmula (p. ej., `"=SUM(A1:A5)"`)
`style`	Examples	Estilo de celda (fuente, relleno)

Examples

Examples	Examples	Examples
`font`	Examples	Configuración de fuente para este estilo
`fill`	Examples	Configuración de relleno de fondo

Examples

Los colores se expresan como 8-digit AARRGGBB hex strings sin un # prefijo. Ejemplos: "FFFF0000" = rojo opaco, "FF0000FF" = azul opaco, "FF000000" = negro.

Examples	Examples	Examples	Examples
`name`	str	Examples	Nombre de la familia tipográfica
`size`	float	11	Tamaño de fuente en puntos
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	Examples	Texto en negrita
`italic`	bool	Examples	Texto en cursiva
`underline`	bool	Examples	Texto subrayado
`strikethrough`	bool	Examples	Texto tachado

Examples

Font(name="Calibri", size=11, color="FF000000",
     bold=False, italic=False, underline=False, strikethrough=False)

Examples

Examples	Examples
`set_solid_fill(color)`	Fondo sólido; `color` es una cadena hexadecimal de 8 dígitos AARRGGBB
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Relleno con patrón
`set_no_fill()`	Eliminar relleno de fondo

MarkdownHandler

Examples	Examples	Examples
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Exportar el libro de trabajo a una cadena Markdown en memoria

MarkdownSaveOptions

Examples	Examples	Examples	Examples
`default_alignment`	str	izquierda	Alineación de columna: izquierda, derecha o centrado
`include_worksheet_name`	bool	Examples	Indica si se debe incluir el nombre de la hoja como encabezado
`header_level`	int	2	Nivel de encabezado Markdown (1-6)
`worksheet_index`	int	0	Índice de hoja a exportar; -1 exporta todas las hojas

ChartCollection

Los gráficos se añaden usando métodos dedicados por tipo. Los índices de fila y columna son basados en cero.

Examples	Examples	Examples
`add_bar(top_row, left_col, bottom_row, right_col)`	Examples	Agregar un gráfico de columnas (barras verticales)
`add_line(top_row, left_col, bottom_row, right_col)`	Examples	Agregar un gráfico de líneas
`add_pie(top_row, left_col, bottom_row, right_col)`	Examples	Agregar un gráfico circular

Examples

Examples	Examples	Examples
`title`	str	Título del gráfico como una cadena simple (no `.title.text`)
`category_data`	str	Rango de celdas para las etiquetas de categoría del eje x
`n_series`	NSeries	Colección de series de datos
`show_legend`	bool	Si se muestra la leyenda
`legend_position`	str	Posición de la leyenda: derecha, inferior, izquierda o superior

NSeries

Examples	Examples
`add(data_range, category_data=None, name=None)`	Agregar una serie de datos con nombre

Enumeración SaveFormat

Examples	Formato de salida
`SaveFormat.XLSX`	Excel Open XML (predeterminado)
`SaveFormat.CSV`	Valores separados por comas
`SaveFormat.TSV`	Valores separados por tabulaciones
`SaveFormat.MARKDOWN`	Tablas Markdown
`SaveFormat.JSON`	Datos estructurados en JSON

Examples: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, y SaveFormat.PPTX son no disponible en Aspose.Cells FOSS. Estos formatos requieren el comercial aspose-cells-python paquete.

Ejemplos de código

Crear, dar estilo y guardar un libro de trabajo

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

ws.cells["A1"].value = "Revenue Report"
ws.cells["A2"].value = 125000

ws.cells["A1"].style.font.bold = True
ws.cells["A1"].style.font.size = 14
ws.cells["A1"].style.font.color = "FF1E64C8"   # Blue (AARRGGBB, no #)

wb.save("report.xlsx")

Exportar a Markdown en memoria

from aspose.cells_foss import Workbook, Cell, MarkdownHandler

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
ws.cells["A2"].value = "Alice"
ws.cells["B2"].value = 95

md = MarkdownHandler.save_markdown_to_string(wb)
print(md)

Crear un gráfico de líneas

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

for i, (m, v) in enumerate([("Jan", 50), ("Feb", 80), ("Mar", 120)], start=2):
    ws.cells[f"A{i}"].value = m
    ws.cells[f"B{i}"].value = v

chart = ws.charts.add_line(5, 0, 18, 7)
chart.title = "Monthly Trend"
chart.category_data = "A2:A4"
chart.n_series.add("B2:B4", category_data="A2:A4", name="Sales")

wb.save("trend.xlsx")

Recursos relacionados

Guía del desarrollador: Tutoriales para todas las funciones principales
Primeros pasos / Instalación: pip install y configuración
Base de conocimientos: Guías prácticas orientadas a tareas
Resumen del producto: Resumen de características y capacidades
Repositorio de GitHub
Blog: Presentando Aspose.Cells FOSS: Visión general de la biblioteca y guía rápida