Aspose.Cells FOSS
Python
Vývojářská příručka
Features

Export formátu tabulky pro Python

Aspose.Cells FOSS for Python provides straightforward export from Excel workbooks to every format the FOSS library supports. A single workbook.save() volání zpracovává celý výstupní řetězec — XLSX, CSV, TSV, Markdown nebo JSON — a zachovává hodnoty buněk a vzorce bez nutnosti Microsoft Office.

Instalace a nastavení 

pip install aspose-cells-foss

Importujte základní třídy:

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

Podporované výstupní formáty

FormátSaveFormat konstantaPoznámky
XLSXSaveFormat.XLSXVýchozí formát; zachovává styly, vzorce, grafy
CSVSaveFormat.CSVČárkou oddělené; ve výchozím nastavení pouze první list
TSVSaveFormat.TSVHodnoty oddělené tabulátorem
MarkdownSaveFormat.MARKDOWNGeneruje standardní tabulky v Markdownu
JSONSaveFormat.JSONStrukturovaná JSON reprezentace dat listu

Důležité: Aspose.Cells FOSS dělá ne podporovat export do PDF, HTML, PNG, TIFF, DOCX nebo PPTX. Tyto jsou k dispozici v komerční aspose-cells-python balíčku pouze.

Příklady použití

Uložit do XLSX

Výchozí formát při ukládání s .xlsx rozšíření:

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

Uložit do 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)

Uložit do Markdownu

Exportujte tabulková data jako Markdown tabulky — užitečné pro dokumentaci a generování 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")

Výstup je standardní Markdown tabulka:

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

Markdown s volbami

Použít MarkdownSaveOptions pro detailní kontrolu:

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 na řetězec (v paměti)

Vygenerujte Markdown řetězec bez zápisu na disk:

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)

Uložit do JSON

Exportovat data sešitu jako strukturovaný JSON pro API pipeline:

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)

Načíst CSV a uložit jako XLSX 

from aspose.cells_foss import Workbook, SaveFormat

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

Tipy a osvědčené postupy

Export Markdownu

  • Použít MarkdownHandler.save_markdown_to_string(wb) pro případy použití v paměti, jako jsou odpovědi API.

Export CSV

  • Export CSV ve výchozím nastavení zapisuje první list.
  • Speciální znaky (čárky, nové řádky) v hodnotách buněk jsou automaticky uzavřeny v uvozovkách.

Export JSON

  • Export JSON používá adresy buněk jako klíče. Vhodné pro výměnu dat; složité vzorce jsou uloženy jako jejich řetězcové výrazy.

Časté problémy a řešení

ProblémŘešení
ModuleNotFoundError: No module named 'aspose.cells_foss'Spustit pip install aspose-cells-foss a potvrďte, že je virtuální prostředí aktivní
AttributeError zapnuto SaveFormat.PDFExport PDF není v knihovně FOSS; použijte SaveFormat.MARKDOWN nebo SaveFormat.XLSX namísto toho
Prázdný výstup MarkdownUjistěte se, že alespoň jedna buňka v listu má hodnotu před uložením
Problémy s kódováním v MarkdownuPoužijte MarkdownHandler.save_markdown_to_string() pro výstup řetězce v paměti s úplnou kontrolou kódování

Často kladené otázky

Jaké výstupní formáty podporuje Aspose.Cells FOSS? XLSX, CSV, TSV, Markdown a JSON.

Mohu převést do PDF? Ne. Export do PDF vyžaduje komerční aspose-cells-python balíček. Aspose.Cells FOSS exportuje pouze do XLSX, CSV, TSV, Markdown a JSON.

Mohu načíst existující XLSX a znovu jej uložit jako Markdown? Ano. Workbook("existing.xlsx") načte soubor a workbook.save_as_markdown("output.md") exportuje jej.

Je podporován výstup Markdownu založený na streamu? Ano. Použijte MarkdownHandler.save_markdown_to_string(workbook) pro získání Markdownu jako řetězce Python bez jakéhokoli souborového I/O.

Jaké verze Python jsou podporovány? Python 3.7 a novější.

Viz také

 Čeština