Introducción
Trabajar con las fichas de Excel programaticamente es un requisito común en el procesamiento de datos, la informativa y los flujos de trabajo de automatización. Células-foss Es una biblioteca de Python abierta que le permite crear, leer y modificar. .xlsx Libros de trabajo sin ninguna dependencia en Microsoft Excel u otras suites de oficina.
Liberado bajo el Licencia MIT, aspose-cells-foss proporciona una rica superficie API que cubre valores de células, fórmulas y estilos, gráficos, tablas, formas, imágenes, validación de datos, comentarios, hiperlinks, filtros automáticos y formatos condicionales. La biblioteca requiere Python 3.7 o superior y se instala con un solo formato pip El mando.
Este artículo recorre las capacidades de gestión de hojas de cálculo que aspose-cells-foss aporta a sus proyectos Python, con ejemplos de código funcionales basados en la API real.
Lo que está incluido
Valores de celdas y fórmulas
El Cell clase soporta integradores, flotantes, líneas y fórmulas. Puede definir un valor directamente a través de put_value() o atribuir una fórmula en la formula propiedad, el FormulaEvaluator Las clases pueden evaluar las fórmulas de forma programática.
from aspose.cells_foss import Workbook, Cell
wb = Workbook()
ws = wb.worksheets[0]
# Set different value types
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14159)
ws.cells["A3"] = Cell("Revenue Report")
# Set a formula
ws.cells["A4"] = Cell(None, "=SUM(A1:A2)")
# Check the stored values
print(ws.cells["A1"].value) # 42
print(ws.cells["A4"].formula) # =SUM(A1:A2)
Estilos y formato
El Style clase proporciona métodos para las rellenas, los límites, formatos de número y alineación. Aplique un estilo a cualquier célula con Cell.apply_style().
from aspose.cells_foss import Workbook, Cell, Style
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"] = Cell("Total")
ws.cells["B1"] = Cell(25000)
style = Style()
style.set_fill_color("FFD9E1F2")
style.set_border("bottom", "thin", "FF000000", 1)
style.set_number_format("#,##0.00")
ws.cells["B1"].apply_style(style)
wb.save("styled_report.xlsx")
Gráficos
El ChartCollection Ofertas de clases dedicadas add_line(), add_bar(), add_pie(), add_scatter(), y muchos otros métodos para insertar gráficos en una hoja de trabajo. Una vez creado, configure el Chart el título del objeto, la leyenda, los datos de categoría y las series.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
# Populate data
months = ["Jan", "Feb", "Mar", "Apr"]
sales = [120, 150, 180, 200]
for i, (m, s) in enumerate(zip(months, sales), 2):
ws.cells[f"A{i}"].value = m
ws.cells[f"B{i}"].value = s
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Sales"
# Create a line chart
chart = ws.charts.add_line(0, 4, 20, 12)
chart.title = "Monthly Sales"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Sales")
chart.show_legend = True
wb.save("sales_chart.xlsx")
Validación de datos
El DataValidation clase le permite aplicar listas de descenso, rango de números y reglas de validación personalizadas en ranga de células. type, operator, formula1, formula2, alert_style, error_title,y, error_message.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
# Add a dropdown validation
dv = ws.data_validations.add("B2:B100")
dv.type = 3 # List validation
dv.formula1 = '"Yes,No,Pending"'
dv.show_error_message = True
dv.error_title = "Invalid Entry"
dv.error_message = "Please select Yes, No, or Pending."
wb.save("validated.xlsx")
Auto-filtros y tablas
Se aplica el auto-filtrado con la AutoFilter clase por llamamiento set_range() y luego filtrar las columnas individuales. para datos estructurados, el TableCollection.add() El método crea tablas ListObject con estilos y filtros automáticos.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
# Populate header + data
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
for i, (n, s) in enumerate([("Alice", 92), ("Bob", 78), ("Carol", 95)], 2):
ws.cells[f"A{i}"].value = n
ws.cells[f"B{i}"].value = s
# Apply an auto-filter
ws.auto_filter.set_range(0, 0, 3, 1)
# Or create a structured table
table = ws.tables.add(0, 0, 3, 1, True, "ScoreTable")
wb.save("filtered_data.xlsx")
Protección de libros y hojas de cálculo
Proteger los libros de trabajo con Workbook.protect() y los trabajos individuales con Worksheet.protect().La API de protección soporta las permisiones granulares como permitir el formatación o la inserción de líneas mientras bloquean los borramientos.
from aspose.cells_foss import Workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Protected content"
# Protect the worksheet with a password
ws.protect("secret123", format_cells=True, insert_rows=True,
delete_columns=False, delete_rows=False)
# Protect the workbook structure
wb.protect("workbook_pass", lock_structure=True, lock_windows=False)
wb.save("protected.xlsx")
Inicio rápido
Instale el paquete desde PyPI:
pip install aspose-cells-foss>=26.3.1
Cree un libro de trabajo, rellene algunos datos y guárdelo:
from aspose.cells_foss import Workbook, Cell, Style
# Create a new workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Quarterly Report"
# Add headers with styling
header_style = Style()
header_style.set_fill_color("FF4472C4")
for col, label in enumerate(["Region", "Q1", "Q2", "Q3", "Q4"], 1):
cell_ref = f"{chr(64 + col)}1"
ws.cells[cell_ref] = Cell(label)
ws.cells[cell_ref].apply_style(header_style)
# Add data rows
data = [
("North", 12000, 15000, 13000, 16000),
("South", 9000, 11000, 10500, 12000),
("East", 14000, 13500, 15000, 17000),
]
for r, row in enumerate(data, 2):
for c, val in enumerate(row, 1):
ws.cells[f"{chr(64 + c)}{r}"].value = val
# Save as XLSX
wb.save("quarterly_report.xlsx")
# Also export to CSV
wb.save_as_csv("quarterly_report.csv")
Formatos apoyados
| Formato | Extensiones | Leer | Escribe |
|---|---|---|---|
| XLSX | .xlsx | Sí | Sí |
| CSV | .csv | Sí | Sí |
| TSV | .tsv | No | Sí |
| JSON | .json | No | Sí |
| Marcación | .md | No | Sí |
El SaveFormat Enum define estos formatos de salida: AUTO, XLSX, CSV, TSV, MARKDOWN,y, JSON.La biblioteca lee .xlsx Los archivos son nativos y pueden importar datos CSV a través de los Workbook.load_csv().
Open Source y Licenciación
El aspose-cells-foss se libera bajo el Licencia MIT, que permite un uso ilimitado en tanto proyectos comerciales como no comercial. el código fuente está disponible en GitHub.La biblioteca depende de pycryptodome (> = 3.15.0) y olefile (>= 0.46) para el soporte de cifrado.
Empezando a
Explore la documentación completa y el material de referencia para comenzar a desarrollar con aspose-cells-foss:
- Guía de desarrollador: doc.aspose.org/cells/python/ en el sitio web de la compañía
- Base de conocimientos: Título: Aspose.org / Células / Python
- El referente de API: reference.aspose.org/cells/python/ en el sitio web de la compañía
