Comment commencer avec FOSS pour Python
aspose-cells-foss Python est une bibliothèque libre et sous licence MIT pour la création, la lecture et l’utilisation de la langue. Conversion de fichiers de feuille de calcul – pas besoin de Microsoft Office, pas d’extensions natives, pur Python à partir de Pypi.
Guide étape par étape
Étape 1 : Installer le package
Installer à partir de PyPI avec pip :
pip install aspose-cells-foss>=26.3.1Vérifiez l’installation :
from aspose.cells_foss import Workbook
print("aspose-cells-foss is ready.")Étape 2 : Importation des classes requises
from aspose.cells_foss import Workbook, SaveFormatÉtape 3 : Créer un classeur et écrire des données
Utilisez Workbook() pour créer un nouveau classeur. Ajouter une feuille de calcul avec add_worksheet(),Alors accéder à son réseau cellulaire via le cells Propriété et usage Cells.cell(row, col) Pour obtenir une Cell.Définir des valeurs avec Cell.put_value():
from aspose.cells_foss import Workbook, SaveFormat
wb = Workbook()
ws = wb.add_worksheet("Sales")
cells = ws.cells
cells.cell(1, 1).put_value("Product")
cells.cell(1, 2).put_value("Revenue")
cells.cell(2, 1).put_value("Widget A")
cells.cell(2, 2).put_value(12500)
cells.cell(3, 1).put_value("Widget B")
cells.cell(3, 2).put_value(8750)
wb.save("sales.xlsx", SaveFormat.XLSX)
print("sales.xlsx written.")Étape 4 : Lire le livre de travail
Télécharger un fichier existant en passant le chemin du fichie vers Workbook(file_path).Utilisez get_worksheet() index ou nom, puis lire les valeurs de cellules via le value Propriété :
from aspose.cells_foss import Workbook
wb = Workbook("sales.xlsx")
ws = wb.get_worksheet(0)
cells = ws.cells
print(f"A1: {cells.cell(1, 1).value}")
print(f"B2: {cells.cell(2, 2).value}")Étape 3 : Enregistrez au format cible
Workbook.save() Soutient plusieurs formats via SaveFormat.Utilisez SaveFormat.CSV pour production séparée et SaveFormat.MARKDOWN Pour les tables de Markdown :
from aspose.cells_foss import Workbook, SaveFormat
wb = Workbook("sales.xlsx")
wb.save("sales.csv", SaveFormat.CSV)
wb.save("sales.md", SaveFormat.MARKDOWN)
print("CSV and Markdown exports written.")Problèmes courants et solutions
ModuleNotFoundError: No module named 'aspose' Installez le package dans l’environnement virtuel actif : pip install aspose-cells-foss. Confirmez avec pip show aspose-cells-foss.
FileNotFoundError Lorsque vous chargez un livre de travail Utilisez pathlib.Path Pour construire des pistes portables : Workbook(str(Path("data") / "file.xlsx")).
Retour de la valeur cellulaire None Après lecture La cellule est vide ou hors de portée. Utilisez Cell.is_empty() Vérifier avant de lire value.
La sortie CSV contient uniquement la première feuille de calcul save() avec SaveFormat.CSV Exporter uniquement la feuille de calcul active. Utilisez set_active_worksheet() Sélectionnez la feuille que vous souhaitez exporter avant d’enregistrer.
Le fichier XSX n’est pas ouvert par Excel Assurez-vous de passer SaveFormat.XLSX sans le format, il est déduit de la extension du fichier ; si le chemin n’a pas de .xlsx La sortie peut ne pas être valide.
Questions fréquentes
Le logiciel de gestion des cellules-foss nécessite-t-il Microsoft Office ?
La bibliothèque lit et écrit des fichiers de feuilles de calcul nativement en Python pur sans aucune dépendance à Microsoft Office, l’automatisation COM ou les API Windows.
Quelles versions de Python sont prises en charge ?
Python 3.7 ou version ultérieure. Le package s’exécute sur les conteneurs Windows, macOS, Linux et Docker.
La bibliothèque est-elle gratuite pour un usage commercial ?
Oui. Il est publié sous la licence MIT. Vous pouvez l’utiliser, modifier et redistribuer à tout usage, y compris des applications commerciales.
Comment puis-je répéter toutes les cellules d’une feuille?
Utilisez Cells.iter_rows() Pour faire un tour de row :
from aspose.cells_foss import Workbook
wb = Workbook("data.xlsx")
ws = wb.get_worksheet(0)
for row in ws.cells.iter_rows(0, None, 0, None, values_only=True):
print(row)Dans quels formats puis-je enregistrer ?
SaveFormat soutiens XLSX, CSV, TSV, MARKDOWN,et JSON.Utilisez SaveFormat.from_extension(file_path) pour détecter automatiquement le format à partir d’un chemin de fichier.