Aspose.Cells FOSS
Python
Ghid pentru dezvoltatori
Features

Export de format de foaie de calcul pentru Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() apelul gestionează întregul flux de ieșire — XLSX, CSV, TSV, Markdown sau JSON — păstrând valorile celulelor și formulele fără a necesita Microsoft Office.

Instalare și configurare 

pip install aspose-cells-foss

Importă clasele de bază:

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

Formate de ieșire suportate

FormatConstantă SaveFormatObservații
XLSXSaveFormat.XLSXFormatul implicit; păstrează stilurile, formulele, graficele
CSVSaveFormat.CSVSeparat prin virgulă; implicit doar primul sheet
TSVSaveFormat.TSVValori separate prin tab
MarkdownSaveFormat.MARKDOWNGenerează tabele Markdown standard
JSONSaveFormat.JSONReprezentare JSON structurată a datelor sheet

Important: Aspose.Cells FOSS face nu nu suportă exportul în PDF, HTML, PNG, TIFF, DOCX sau PPTX. Acestea sunt disponibile în pachetul comercial aspose-cells-python doar.

Exemple de utilizare

Salvează în XLSX

Formatul implicit când se salvează cu un .xlsx extensie:

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

Salvează în 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)

Salvează în Markdown

Exportă date tabelare ca tabele Markdown — util pentru documentație și generarea 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")

Ieșirea este un tabel Markdown standard:

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

Markdown cu opțiuni

Folosiţi MarkdownSaveOptions pentru control detaliat:

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 în șir (în memorie)

Generează un șir Markdown fără a scrie pe disc:

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)

Salvează în JSON

Exportă datele din registru de lucru ca JSON structurat pentru conducte 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)

Încarcă un CSV și Salvează ca XLSX 

from aspose.cells_foss import Workbook, SaveFormat

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

Sfaturi și cele mai bune practici

Export Markdown

  • Folosiţi MarkdownHandler.save_markdown_to_string(wb) pentru cazuri de utilizare în memorie, cum ar fi răspunsurile API.

Export CSV

  • Exportul CSV scrie implicit prima foaie de lucru.
  • Caracterele speciale (virgule, linii noi) din valorile celulelor sunt citate automat.

Export JSON

  • Exportul JSON folosește adresele celulelor ca chei. Potrivit pentru schimbul de date; formulele complexe sunt stocate ca expresiile lor sub formă de șiruri.

Probleme comune și rezolvări

ProblemăRezoluție
ModuleNotFoundError: No module named 'aspose.cells_foss'Rulează pip install aspose-cells-foss și confirmă că mediul virtual este activ
AttributeError pe SaveFormat.PDFExportul PDF nu se află în biblioteca FOSS; folosește SaveFormat.MARKDOWN sau SaveFormat.XLSX în schimb
Ieșire Markdown goalăAsigură-te că cel puțin o celulă din foaie conține o valoare înainte de a salva
Probleme de codare în MarkdownFolosește MarkdownHandler.save_markdown_to_string() pentru ieșire de șir în memorie cu control complet al codificării

Întrebări frecvente

Ce formate de ieșire suportă Aspose.Cells FOSS? XLSX, CSV, TSV, Markdown și JSON.

Pot converti în PDF? Nu. Exportul în PDF necesită pachetul comercial aspose-cells-python . Aspose.Cells FOSS exportă doar în XLSX, CSV, TSV, Markdown și JSON.

Pot încărca un XLSX existent și să-l salvez din nou ca Markdown? Da. Workbook("existing.xlsx") încarcă fișierul și workbook.save_as_markdown("output.md") îl exportă.

Este suportată ieșirea Markdown bazată pe flux? Da. Folosește MarkdownHandler.save_markdown_to_string(workbook) pentru a obține Markdown-ul ca un șir Python fără niciun I/O de fișier.

Ce versiuni Python sunt suportate? Python 3.7 și ulterior.

Vezi și

 Română