Aspose.Cells FOSS
Python
Guide du développeur
Features

Exportation de format de feuille de calcul pour Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() l’appel gère l’ensemble du pipeline de sortie — XLSX, CSV, TSV, Markdown ou JSON — en préservant les valeurs des cellules et les formules sans nécessiter Microsoft Office.

Installation et configuration 

pip install aspose-cells-foss

Importez les classes principales :

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

Formats de sortie pris en charge

FormatConstante SaveFormatNotes
XLSXSaveFormat.XLSXFormat par défaut ; préserve les styles, les formules, les graphiques
CSVSaveFormat.CSVSéparé par des virgules ; première feuille uniquement par défaut
TSVSaveFormat.TSVValeurs séparées par des tabulations
MarkdownSaveFormat.MARKDOWNGénère des tableaux Markdown standard
JSONSaveFormat.JSONReprésentation JSON structurée des données de la feuille

Important: Aspose.Cells FOSS fait pas prend en charge l’exportation vers PDF, HTML, PNG, TIFF, DOCX ou PPTX. Ceux-ci sont disponibles uniquement dans le paquet commercial aspose-cells-python paquet uniquement.

Exemples d’utilisation

Enregistrer en XLSX

Le format par défaut lors de l’enregistrement avec un .xlsx extension :

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

Enregistrer en 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)

Enregistrer en Markdown

Exportez des données tabulaires sous forme de tables Markdown — utile pour la documentation et la génération 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 sortie est une table Markdown standard :

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

Markdown avec options

Utilisez MarkdownSaveOptions pour un contrôle fin :

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 vers chaîne (en mémoire)

Générez une chaîne Markdown sans écrire sur le disque :

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)

Enregistrer en JSON

Exporter les données du classeur au format JSON structuré pour les pipelines 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)

Charger un CSV et enregistrer en XLSX 

from aspose.cells_foss import Workbook, SaveFormat

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

Conseils et bonnes pratiques

Exportation Markdown

  • Utilisez MarkdownHandler.save_markdown_to_string(wb) pour les cas d’utilisation en mémoire tels que les réponses d’API.

Exportation CSV

  • L’exportation CSV écrit la première feuille de calcul par défaut.
  • Les caractères spéciaux (virgules, sauts de ligne) dans les valeurs des cellules sont automatiquement entre guillemets.

Exportation JSON

  • L’exportation JSON utilise les adresses des cellules comme clés. Convient à l’échange de données ; les formules complexes sont stockées sous forme de leurs expressions sous forme de chaîne.

Problèmes courants et résolutions

ProblèmeRésolution
ModuleNotFoundError: No module named 'aspose.cells_foss'Exécuter pip install aspose-cells-foss et confirmez que l’environnement virtuel est actif
AttributeError sur SaveFormat.PDFL’export PDF n’est pas dans la bibliothèque FOSS ; utilisez SaveFormat.MARKDOWN ou SaveFormat.XLSX à la place
Sortie Markdown videAssurez-vous qu’au moins une cellule de la feuille possède une valeur avant d’enregistrer
Problèmes d’encodage dans MarkdownUtilisez MarkdownHandler.save_markdown_to_string() pour la sortie de chaîne en mémoire avec un contrôle complet de l’encodage

Foire aux questions

Quels formats de sortie Aspose.Cells FOSS prend-il en charge ? XLSX, CSV, TSV, Markdown et JSON.

Puis-je convertir en PDF ? Non. L’exportation en PDF nécessite le commercial aspose-cells-python package. Aspose.Cells FOSS exporte uniquement vers XLSX, CSV, TSV, Markdown et JSON.

Puis-je charger un XLSX existant et le réenregistrer en tant que Markdown ? Oui. Workbook("existing.xlsx") charge le fichier, et workbook.save_as_markdown("output.md") l’exporte.

La sortie Markdown basée sur le flux est‑elle prise en charge ? Oui. Utilisez MarkdownHandler.save_markdown_to_string(workbook) pour obtenir le Markdown sous forme d’une chaîne Python sans aucune entrée/sortie de fichier.

Quelles versions de Python sont prises en charge ? Python 3.7 et ultérieures.

Voir aussi

 Français