Úvodní článek

Programatická práce s Excelovými tabulkami je běžným požadavkem při zpracování dat, podávání zpráv a automatizaci pracovních postupů. Aspose-cells-foss je otevřená knihovna Python, která vám umožňuje vytvářet, číst a upravovat. .xlsx pracovní knihy bez jakékoli závislosti na Microsoft Excel nebo jiných kancelářských balíčcích.

Uvolněné podle čl. Licence MIT, aspose-cells-foss poskytuje bohaté API povrch pokrývající hodnoty buněk, vzorce, stylování, grafy, tabulky, tvary, obrázky, ověřování dat, komentáře, hypertextové odkazy, automatické filtry a podmíněné formátování. Knihovna vyžaduje Python 3.7 nebo vyšší a instaluje se jediným programem s funkcí PHP 7.0 (Python 4.0) pip - Přikazuji.

Tento příspěvek prochází funkcemi správy tabulky, které aspose-cells-foss přináší do vašich Pythonových projektů s pracovními příklady kódu založenými na skutečném API.

Co se v ní nachází?

Hodnoty a vzorce buněk

Úřad pro bezpečnost a ochranu zdraví Cell třída podporuje celá čísla, plovoucí řetězce a vzorce. Můžete nastavit hodnotu přímo prostřednictvím put_value() nebo přidělit řetězce vzorce k formula Vlastnictví. FormulaEvaluator třída může programově vyhodnocovat vzorce.

from aspose.cells_foss import Workbook, Cell

wb = Workbook()
ws = wb.worksheets[0]

# Set different value types
ws.cells["A1"] = Cell(42)
ws.cells["A2"] = Cell(3.14159)
ws.cells["A3"] = Cell("Revenue Report")

# Set a formula
ws.cells["A4"] = Cell(None, "=SUM(A1:A2)")

# Check the stored values
print(ws.cells["A1"].value)    # 42
print(ws.cells["A4"].formula)  # =SUM(A1:A2)

Stylování a formátování

Úřad pro bezpečnost a ochranu zdraví Style třída poskytuje metody pro vyplnění, hranice, formáty čísel a vyrovnání. Aplikujte styl na jakoukoli buňku s Cell.apply_style().

from aspose.cells_foss import Workbook, Cell, Style

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"] = Cell("Total")
ws.cells["B1"] = Cell(25000)

style = Style()
style.set_fill_color("FFD9E1F2")
style.set_border("bottom", "thin", "FF000000", 1)
style.set_number_format("#,##0.00")
ws.cells["B1"].apply_style(style)

wb.save("styled_report.xlsx")

Grafy

Úřad pro bezpečnost a ochranu zdraví ChartCollection třídní nabídky věnované add_line(), add_bar(), add_pie(), add_scatter(), a mnoho dalších metod pro vkládání grafů do pracovního listu. Chart název objektu, legenda, údaje o kategorii a řada.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

# Populate data
months = ["Jan", "Feb", "Mar", "Apr"]
sales = [120, 150, 180, 200]
for i, (m, s) in enumerate(zip(months, sales), 2):
    ws.cells[f"A{i}"].value = m
    ws.cells[f"B{i}"].value = s
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Sales"

# Create a line chart
chart = ws.charts.add_line(0, 4, 20, 12)
chart.title = "Monthly Sales"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Sales")
chart.show_legend = True

wb.save("sales_chart.xlsx")

Ověřování údajů

Úřad pro bezpečnost a ochranu zdraví DataValidation třída umožňuje vynucovat výběrové seznamy, rozsahy čísel a vlastní ověřovací pravidla na rozsah buňek. Vlastnosti zahrnují: type, operator, formula1, formula2, alert_style, error_title,a) error_message.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

# Add a dropdown validation
dv = ws.data_validations.add("B2:B100")
dv.type = 3       # List validation
dv.formula1 = '"Yes,No,Pending"'
dv.show_error_message = True
dv.error_title = "Invalid Entry"
dv.error_message = "Please select Yes, No, or Pending."

wb.save("validated.xlsx")

Automatické filtry a tabulky

Použijte automatické filtrování s AutoFilter třídu voláním set_range() Pro strukturované údaje se zobrazí databáze. TableCollection.add() metoda vytváří tabulky ListObject se styly a automatickými filtry.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]

# Populate header + data
ws.cells["A1"].value = "Name"
ws.cells["B1"].value = "Score"
for i, (n, s) in enumerate([("Alice", 92), ("Bob", 78), ("Carol", 95)], 2):
    ws.cells[f"A{i}"].value = n
    ws.cells[f"B{i}"].value = s

# Apply an auto-filter
ws.auto_filter.set_range(0, 0, 3, 1)

# Or create a structured table
table = ws.tables.add(0, 0, 3, 1, True, "ScoreTable")

wb.save("filtered_data.xlsx")

Ochrana pracovních knih a listů práce

Ochrana pracovních učebnic pomocí: Workbook.protect() a jednotlivé pracovní listy s Worksheet.protect().API ochrany podporuje granulární oprávnění, jako je umožňování formátování nebo vkládání řad a blokování smazávání.

from aspose.cells_foss import Workbook

wb = Workbook()
ws = wb.worksheets[0]
ws.cells["A1"].value = "Protected content"

# Protect the worksheet with a password
ws.protect("secret123", format_cells=True, insert_rows=True,
           delete_columns=False, delete_rows=False)

# Protect the workbook structure
wb.protect("workbook_pass", lock_structure=True, lock_windows=False)
wb.save("protected.xlsx")

Rychlý start

Instalace balíčku z PyPI:

pip install aspose-cells-foss>=26.3.1

Vytvořte si pracovní knihu, vyplňte některé údaje a ukládejte je:

from aspose.cells_foss import Workbook, Cell, Style

# Create a new workbook
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Quarterly Report"

# Add headers with styling
header_style = Style()
header_style.set_fill_color("FF4472C4")
for col, label in enumerate(["Region", "Q1", "Q2", "Q3", "Q4"], 1):
    cell_ref = f"{chr(64 + col)}1"
    ws.cells[cell_ref] = Cell(label)
    ws.cells[cell_ref].apply_style(header_style)

# Add data rows
data = [
    ("North", 12000, 15000, 13000, 16000),
    ("South", 9000, 11000, 10500, 12000),
    ("East", 14000, 13500, 15000, 17000),
]
for r, row in enumerate(data, 2):
    for c, val in enumerate(row, 1):
        ws.cells[f"{chr(64 + c)}{r}"].value = val

# Save as XLSX
wb.save("quarterly_report.xlsx")

# Also export to CSV
wb.save_as_csv("quarterly_report.csv")

Podporované formáty

FormátRozšířeníČtěte.Píšeš.
XLSX.xlsxAno , ano .Ano , ano .
CSV.csvAno , ano .Ano , ano .
TSV.tsvNe, ne.Ano , ano .
JSON.jsonNe, ne.Ano , ano .
Zpětné odbavení.mdNe, ne.Ano , ano .

Úřad pro bezpečnost a ochranu zdraví SaveFormat enum definuje tyto výstupní formáty: AUTO, XLSX, CSV, TSV, MARKDOWN,a) JSON.Knihovna čte: .xlsx soubory nativně a může importovat data CSV prostřednictvím Workbook.load_csv().

Open Source & Licence

Aspose-cells-foss se uvolňuje pod tlakem, který je v Licence MIT, který umožňuje neomezené použití v komerčních i nekomerčních projektech. Zdrojový kód je k dispozici na: http://www.cvm-shop.com/source_code GitHub.Knihovna závisí na tom , že se objeví . pycryptodome (>= 3,15,0) a olefile (>= 0,46) pro podporu šifrování.

Jak začít?

Prozkoumejte kompletní dokumentaci a referenční materiál, abyste mohli začít s budováním pomocí aspose-cells-foss: