Guide du développeur

Aspose.Cells FOSS for Python est une bibliothèque gratuite et open source pour le traitement programmatique des feuilles de calcul. Que vous construisiez des pipelines de données, génériez des rapports automatisés, exportiez des résultats de ML vers Excel, ou convertissiez des classeurs en Markdown pour les pipelines de documentation, Aspose.Cells FOSS fournit une API complète qui couvre chaque couche de manipulation des feuilles de calcul sans nécessiter Microsoft Office.

Fonctionnalités clés

Opérations de classeur et de feuille de calcul

Créez de nouveaux classeurs à partir de zéro ou ouvrez des fichiers XLSX ou CSV existants. Naviguez dans la hiérarchie Workbook → Worksheets → Cells → Cell avec une API propre et Pythonique. Ajoutez, renommez et supprimez des feuilles de calcul à l’aide de workbook.add_worksheet(name) et workbook.remove_worksheet(index_or_name). Accédez aux cellules individuelles par adresse (ws.cells["A1"]), définissez les valeurs directement et parcourez les plages remplies.

Mise en forme et style des cellules

Appliquez un formatage granulaire aux cellules individuelles. Contrôlez la famille de police, la taille, la couleur, le gras, l’italique, le soulignement et le barré via la classe Font. Définissez les remplissages d’arrière-plan à l’aide de cell.style.fill.set_solid_fill("FFRRGGBB"). Les couleurs sont exprimées sous forme de chaînes hexadécimales de 8 caractères AARRGGBB sans préfixe # (par exemple, "FFFF0000" pour un rouge opaque).

Création et visualisation de graphiques

Ajoutez des graphiques en colonnes, en lignes, en barres et circulaires aux feuilles de calcul en utilisant des méthodes dédiées telles que ws.charts.add_bar(top_row, left_col, bottom_row, right_col) et ws.charts.add_line(...). Définissez le titre du graphique comme une chaîne (chart.title = "My Chart"), configurez les données de catégorie au niveau du graphique (chart.category_data = "A2:A6") et ajoutez des séries nommées (chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")).

Prise en charge des formules

Entrez des formules compatibles Excel en définissant cell.formula = "=SUM(A1:A5)" ou en construisant un Cell(None, "=SUM(A1:A5)") et en l’assignant à la collection de cellules.

Exportation multi-format

Exportez les classeurs vers XLSX, CSV, TSV, Markdown et JSON à l’aide d’un seul appel workbook.save(path). Utilisez les constantes SaveFormat pour un contrôle explicite : SaveFormat.XLSX, SaveFormat.CSV, SaveFormat.TSV, SaveFormat.MARKDOWN, SaveFormat.JSON. Utilisez MarkdownSaveOptions pour une sortie Markdown granulaire (alignement, niveau d’en‑tête, index de feuille). Utilisez MarkdownHandler.save_markdown_to_string(wb) pour la génération Markdown en mémoire. Voir Exemples de formats d’exportation pour du code prêt à l’emploi et Dépannage d’exportation pour des astuces et FAQ.

Note : Aspose.Cells FOSS exporte vers XLSX, CSV, TSV, Markdown et JSON. L’exportation PDF, HTML, PNG, TIFF, DOCX et PPTX ne fait pas partie de la bibliothèque FOSS.

Écosystème de plugins

Le package optionnel markitdown-aspose-cells-plugin s’intègre à la bibliothèque MarkItDown de Microsoft pour ajouter la prise en charge de la lecture XLSX. Installez‑le avec pip install markitdown-aspose-cells-plugin et utilisez‑le de manière transparente via l’API MarkItDown.

Premiers pas

Installer 

pip install aspose-cells-foss

Bonjour le monde 

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

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

Créer un graphique à colonnes 

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

Style des cellules 

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

Guides disponibles

  • Spreadsheet Format Export — Exportez des classeurs entre XLSX, CSV, TSV, Markdown et JSON.
  • Formula Calculation — Saisissez et évaluez des formules compatibles Excel de manière programmatique.
  • Spreadsheet Operations — Création de classeurs, manipulation de cellules, opérations sur les plages et mise en forme.
  • Getting Started — Installation, exigences système et votre premier classeur.

Voir aussi

 Français