Aspose.Cells FOSS for Python

Informations sur le package


paquet PyPI	`aspose-cells-foss`
Python import	`from aspose.cells_foss import ...`
Examples	26.3.1
Examples	MIT
Python requirement	>= 3.7
Examples	`pycryptodome>=3.15.0`, `olefile>=0.46`

Examples

Examples	Examples
aspose.cells_foss	API de feuille de calcul principale : workbooks, worksheets, cells, styles, charts, format handlers

Examples: Il n’y a pas aspose.pydrawing module dans Aspose.Cells FOSS. Les couleurs sont exprimées sous forme de chaînes hexadécimales à 8 chiffres AARRGGBB (par ex., "FFFF0000" pour un rouge opaque).

aspose.cells_foss

Examples

Examples	Examples	Examples
`Workbook`	workbook	Point d’entrée pour créer, charger et enregistrer des fichiers de feuille de calcul
`Worksheet`	worksheet	Représente une feuille unique ; fournit l’accès aux cellules, graphiques et images
`Cells`	cellules	Collection de type dictionnaire de `Cell` objets à l’intérieur d’un `Worksheet`
`Cell`	cellule	Représente une cellule individuelle ; valeur, formule et style
`Style`	style	Mise en forme de la cellule : police, remplissage, bordures, alignement, format numérique, protection
`Font`	style	Propriétés de la police : nom, taille, couleur, gras, italique, souligné, barré
`Fill`	style	Remplissage d’arrière-plan : uni, dégradé ou motif
`NumberFormat`	style	Utilitaires intégrés de recherche de formats numériques
`SaveFormat`	classeur	Énumération des formats de sortie pris en charge (XLSX, CSV, MARKDOWN, JSON)
`Chart`	graphique	Représente un graphique intégré dans une feuille de calcul
`ChartType`	graphique	Énumération : LINE, BAR, PIE, AREA, STOCK, et plus
`NSeries`	graphique	Collection de séries de données sur un graphique
`ChartSeries`	graphique	Une seule série de données avec des valeurs, des catégories et des barres d’erreur
`ChartAxis`	graphique	Paramètres des axes : échelle, format, titre
`ChartView3D`	graphique	3D rotation and perspective settings
`ChartErrorBars`	graphique	Configuration des barres d’erreur pour une série
`DataValidation`	validation de données	Règle de validation unique sur une plage de cellules
`DataValidationCollection`	validation de données	Toutes les règles de validation pour une feuille de calcul
`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éthodes statiques pour l’import/export CSV
`CSVLoadOptions`	csv-handler	Options pour charger des fichiers CSV
`CSVSaveOptions`	csv-handler	Options d’enregistrement des fichiers CSV
`MarkdownHandler`	markdown-handler	Méthodes statiques pour l’exportation Markdown
`MarkdownSaveOptions`	markdown-handler	Options d’exportation Markdown
`JsonHandler`	json-handler	Méthodes statiques pour l’exportation JSON
`JsonSaveOptions`	json-handler	Options d’exportation JSON
`Shape`	forme	Dessiner une forme avec remplissage, ligne, texte et mise en forme de police
`ShapeCollection`	forme	Toutes les formes dans une feuille de calcul (`ws.shapes`)
`MsoDrawingType`	forme	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, etc.
`Table`	table	Table Excel (référence structurée) dans une feuille de calcul
`TableCollection`	table	Toutes les tables dans une feuille de calcul (`ws.list_objects`)
`TableColumn`	table	Définition de colonne dans une Table
`TableStyleInfo`	table	Paramètres de style visuel pour un tableau
`SparklineGroup`	sparkline	Groupe de graphiques sparkline partageant un style visuel
`SparklineGroupCollection`	sparkline	Tous les groupes sparkline (`ws.sparkline_groups`)
`Sparkline`	sparkline	Une seule cellule sparkline liée à une plage de données
`SparklineType`	sparkline	Enum : LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	saut de page	Sauts de page horizontaux manuels (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	saut de page	Sauts de page verticaux manuels (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	chiffrement	Paramètres de chiffrement AES-256/SHA-512 (recommandé)
`StandardEncryptionParameters`	chiffrement	Paramètres de chiffrement AES-128/SHA-1 hérités
`CipherAlgorithm`	chiffrement	Enum : AES_128, AES_192, AES_256
`HashAlgorithm`	chiffrement	Enum : SHA1, SHA256, SHA384, SHA512

Examples

Examples

Examples	Examples
`Workbook()`	Créer un nouveau classeur vide (format XLSX)
`Workbook(file_path: str)`	Charger un classeur à partir d’un chemin de fichier
`Workbook(file_path: str, password: str)`	Charger un classeur protégé par mot de passe

Propriétés clés

Examples	Examples	Examples
`worksheets`	liste	Accéder aux feuilles de calcul par indice : `workbook.worksheets[0]`

Méthodes clés

Examples	Examples	Examples
`save(file_path)`	Examples	Enregistrer dans un fichier ; le format est déduit de l’extension
`save(file_path, save_format)`	Examples	Enregistrer avec SaveFormat explicite
`save_as_csv(file_path, options=None)`	Examples	Enregistrer au format CSV
`save_as_markdown(file_path, options=None)`	Examples	Enregistrer au format tableaux Markdown
`save_as_json(file_path, options=None)`	Examples	Enregistrer au format JSON
`load_csv(file_path, options=None)`	Examples	Charger des données CSV dans le classeur
`add_worksheet(name=None)`	Examples	Ajouter une nouvelle feuille de calcul
`get_worksheet(index_or_name)`	Examples	Obtenir la feuille de calcul par index ou nom
`remove_worksheet(index_or_name)`	Examples	Supprimer une feuille de calcul
`copy_worksheet(index_or_name_or_ws)`	Examples	Copier une feuille de calcul existante
`protect(password=None, lock_structure=True)`	Examples	Protéger le classeur par mot de passe
`unprotect(password=None)`	Examples	Supprimer la protection du classeur
`is_protected()`	bool	Vérifier si le classeur est protégé

Examples

Propriétés clés

Examples	Examples	Examples
`name`	str	Nom de l’onglet de la feuille de calcul
`cells`	Examples	Toutes les cellules de cette feuille de calcul
`charts`	ChartCollection	Tous les graphiques de cette feuille de calcul

Examples

Cells prend en charge l’accès de type dictionnaire par chaîne d’adresse de cellule.

Modèles d’accès

# 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)`	Créer une cellule avec une valeur (int, float, str ou None)
`Cell(value, formula)`	Créer une cellule de formule (la valeur est généralement None)

Propriétés clés

Examples	Examples	Examples
`value`	Examples	Valeur de la cellule (str, int, float ou None)
`formula`	str	Chaîne de formule (p. ex., `"=SUM(A1:A5)"`)
`style`	Examples	Style de cellule (police, remplissage)

Examples

Examples	Examples	Examples
`font`	Examples	Paramètres de police pour ce style
`fill`	Examples	Paramètres de remplissage d’arrière-plan

Examples

Les couleurs sont exprimées sous forme de 8-digit AARRGGBB hex strings sans un # préfixe. Exemples : "FFFF0000" = rouge opaque, "FF0000FF" = bleu opaque, "FF000000" = noir.

Examples	Examples	Examples	Examples
`name`	str	Examples	Nom de la famille de polices
`size`	float	11	Taille de police en points
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool	Examples	Texte en gras
`italic`	bool	Examples	Texte en italique
`underline`	bool	Examples	Texte souligné
`strikethrough`	bool	Examples	Texte barré

Examples

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

Examples

Examples	Examples
`set_solid_fill(color)`	Arrière-plan plein; `color` est une chaîne hexadécimale AARRGGBB à 8 chiffres
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Remplissage à motif
`set_no_fill()`	Supprimer le remplissage d’arrière-plan

MarkdownHandler

Examples	Examples	Examples
`MarkdownHandler.save_markdown_to_string(workbook)`	str	Exporter le classeur vers une chaîne Markdown en mémoire

MarkdownSaveOptions

Examples	Examples	Examples	Examples
`default_alignment`	str	gauche	Alignement de colonne : gauche, droite ou centre
`include_worksheet_name`	bool	Examples	Indique s’il faut inclure le nom de la feuille comme titre
`header_level`	int	2	Niveau de titre Markdown (1-6)
`worksheet_index`	int	0	Indice de feuille à exporter ; -1 exporte toutes les feuilles

ChartCollection

Les graphiques sont ajoutés à l’aide de méthodes dédiées par type. Les indices de ligne et de colonne sont basés sur zéro.

Examples	Examples	Examples
`add_bar(top_row, left_col, bottom_row, right_col)`	Examples	Ajouter un graphique à colonnes (barres verticales)
`add_line(top_row, left_col, bottom_row, right_col)`	Examples	Ajouter un graphique en courbes
`add_pie(top_row, left_col, bottom_row, right_col)`	Examples	Ajouter un graphique circulaire

Examples

Examples	Examples	Examples
`title`	str	Titre du graphique sous forme de chaîne simple (pas `.title.text`)
`category_data`	str	Plage de cellules pour les libellés de catégorie de l’axe x
`n_series`	NSeries	Collection de séries de données
`show_legend`	bool	Afficher la légende
`legend_position`	str	Position de la légende : droite, bas, gauche ou haut

NSeries

Examples	Examples
`add(data_range, category_data=None, name=None)`	Ajouter une série de données nommée

Énumération SaveFormat

Examples	Format de sortie
`SaveFormat.XLSX`	Excel Open XML (par défaut)
`SaveFormat.CSV`	Valeurs séparées par des virgules
`SaveFormat.TSV`	Valeurs séparées par des tabulations
`SaveFormat.MARKDOWN`	Tableaux Markdown
`SaveFormat.JSON`	Données structurées JSON

Examples: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, et SaveFormat.PPTX sont pas disponibles dans Aspose.Cells FOSS. Ces formats nécessitent le commercial aspose-cells-python package.

Exemples de code

Créer, styliser et enregistrer un classeur

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

Exporter en Markdown en mémoire

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)

Créer un graphique linéaire

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

Ressources associées

Guide du développeur: Tutoriels pour toutes les fonctionnalités de base
Premiers pas / Installation: pip install et configuration
Base de connaissances: Guides pratiques orientés tâches
Vue d’ensemble du produit: Résumé des fonctionnalités et capacités
Dépôt GitHub
Blog : Présentation de Aspose.Cells FOSS: Aperçu de la bibliothèque et démarrage rapide