Uvod u članak

Rad s Excelovim preglednicama programski je uobičajen zahtjev pri obradi podataka, izvješćivanju i automatizaciji radnih tokova. Aspos-Cells-Foss je Python biblioteka otvorenog koda koja vam omogućuje kreiranje, čitanje i izmjenu. .xlsx radne sveske bez ikakve ovisnosti o Microsoft Excel-u ili drugim Office suite-ima.

Oslobođen u skladu s člankom MIT-ova licenca, aspose-cells-foss pruža bogatu API površinu koja pokriva vrijednosti stanica, formule, stiliranje, grafikone, tabele, oblike, slike, potvrđivanje podataka, komentare, hiperlinkove, automatske filtere i uvjetno oblikovanje. Biblioteka zahtijeva Python 3.7 ili viši i instalira se s jednim programom za podizanje informacija na računalo. pip -Naravno.

Ovaj post vodi kroz mogućnosti upravljanja preglednikom koje aspose-cells-foss donosi vašim Python projektovima, s radnim primjerima koda utemeljenim na stvarnom API.

Što je uključeno u to?

Vrijednosti ćelija i formule

U skladu s člankom 1. Cell class podržava cijele brojeve, plutače, nizove i formule. možete postaviti vrijednost direktno putem put_value() ili dodijeliti niz formula na formula imovina. FormulaEvaluator klasa može programski procijeniti formule.

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)

Stirenje i oblikovanje

U skladu s člankom 1. Style class pruža metode za ispunjavanje, granicu, formate brojeva i poravnanje. Primjenite stil na bilo koju ćeliju 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")

Grafički prikaz

U skladu s člankom 1. ChartCollection klasa ponude posvećene add_line(), add_bar(), add_pie(), add_scatter(), i mnoge druge metode za ubacivanje grafikona u radni list. Chart U ovom slučaju, podrazumijeva se da je predmet u skladu s člankom 7. stavkom 1. točkom (a) i/ili odjeljku 2.

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

Provedba podataka

U skladu s člankom 1. DataValidation class omogućuje vam da primjenjujete spuštanje popunjenih lista, brojeve opsega i prilagođene pravila potvrde na ćelijama. svojstva uključuju: type, operator, formula1, formula2, alert_style, error_title, i 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")

Automatski filteri i tabele

Primjenite automatsko filtriranje s AutoFilter razredom pozivajući se na: set_range() Za strukturirane podatke, naziv “Structured Data” označava datoteke koje su se u skladu s člankom 1. TableCollection.add() metoda kreira ListObject tabele s stilovima i automatskim filtri.

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

Zaštita radnih sveski i radnog lista

Zaštititi radne sveske s: Workbook.protect() i pojedinačne radne liste s: Worksheet.protect().API za zaštitu podržava granularna ovlaštenja kao što su omogućivanje formatiranja ili ubacivanja redova dok se blokiraju brisanja.

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

Brzi početak

Instaliraj paket iz PyPI:

pip install aspose-cells-foss>=26.3.1

Stvorite radnu svesku, popunite neke podatke i sačuvajte ih:

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

Podržani formati

Format:Proračunska sredstvaČitaj.Pišite.
XLSX.xlsx- Da, u redu.- Da, u redu.
CSV.csv- Da, u redu.- Da, u redu.
TSV.tsvNe, ne mogu.- Da, u redu.
JSON.jsonNe, ne mogu.- Da, u redu.
Iznos za odbitak.mdNe, ne mogu.- Da, u redu.

U skladu s člankom 1. SaveFormat enum definira ove izlazne formate: AUTO, XLSX, CSV, TSV, MARKDOWN, i JSON.U knjižnici piše: .xlsx datoteke u prirodni način i može uvoziti CSV podatke putem Workbook.load_csv().

Otvoreni izvor i licenciranje

Aspos-Cells-Foss se oslobađa pod uvjetom da je u stanju MIT-ova licenca, koji omogućuje neograničenu upotrebu u komercijalnim i nekomercijalnih projektima. GitHub.Biblioteka ovisi o tome. pycryptodome (u slučaju da je to moguće) olefile (Npr. u slučaju prijenosa ili upotrebe).

Početak

Proučite potpunu dokumentaciju i referentni materijal kako biste započeli s izgradnjom sa aspos-cells-foss: