Aspose.Cells FOSS for Python
Informacije o paketu
| PyPI paket | aspose-cells-foss |
| Python uvoz | from aspose.cells_foss import ... |
| Python zahtjev | >= 3.7 |
| ————————————— | —————————————————————————————————————– | | aspose.cells_foss | Osnovni API za proračunske tablice: radne knjige, radni listovi, ćelije, stilovi, grafikoni, upravljači formatima |
aspose.cells_foss
| ——————————- | ————————————- | ——————————————————————————- |
| Workbook | radna knjiga | Ulazna točka za stvaranje, učitavanje i spremanje datoteka proračunskih tablica |
| Worksheet | radni list | Predstavlja pojedinačni list; omogućuje pristup ćelijama, grafikonima i slikama |
| Cells | ćelije | Kolekcija slična rječniku Cell objekata unutar Worksheet |
| Cell | ćelija | Predstavlja pojedinu ćeliju; vrijednost, formula i stil |
| Style | stil | Oblikovanje ćelije: font, ispun, rubovi, poravnanje, format broja, zaštita |
| Font | stil | Svojstva fonta: ime, veličina, boja, podebljano, kurziv, podcrtano, precrtano |
| Fill | stil | Pozadinsko popunjavanje: jednobojno, gradijent ili uzorak |
| NumberFormat | stil | Ugrađeni alati za pretraživanje formata brojeva |
| SaveFormat | radna knjiga | Enumeracija podržanih izlaznih formata (XLSX, CSV, MARKDOWN, JSON) |
| Chart | grafik | Predstavlja grafikon umetnut u radni list |
| ChartType | grafik | Enum: LINE, BAR, PIE, AREA, STOCK i više |
| NSeries | grafik | Kolekcija serija podataka na grafikonu |
| ChartSeries | grafik | Jedna serija podataka s vrijednostima, kategorijama i trakom pogreške |
| ChartAxis | grafik | Postavke osi: skala, format, naslov |
| ChartView3D | grafikon | 3D rotation and perspective settings |
| ChartErrorBars | grafikon | Konfiguracija trake pogreške za seriju |
| DataValidation | data-validation | Jedinstveno pravilo provjere na rasponu ćelija |
| DataValidationCollection | data-validation | Sva pravila provjere za radni list |
| 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 | Statičke metode za CSV uvoz/izvoz |
| CSVLoadOptions | csv-handler | Opcije za učitavanje CSV datoteka |
| CSVSaveOptions | csv-handler | Opcije za spremanje CSV datoteka |
| MarkdownHandler | markdown-handler | Statičke metode za izvoz Markdowna |
| MarkdownSaveOptions | markdown-handler | Opcije za izvoz Markdowna |
| JsonHandler | json-handler | Statičke metode za izvoz JSON-a |
| JsonSaveOptions | json-handler | Opcije za izvoz JSON-a |
| Shape | oblik | Crtanje oblika s ispunom, linijom, tekstom i formatiranjem fonta |
| ShapeCollection | oblik | Svi oblici u radnom listu (ws.shapes) |
| MsoDrawingType | oblik | Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, itd. |
| Table | tablica | Excel tablica (strukturalna referenca) u radnom listu |
| TableCollection | tablica | Sve tablice u radnom listu (ws.list_objects) |
| TableColumn | tablica | Definicija stupca unutar tablice |
| TableStyleInfo | tablica | Postavke vizualnog stila za tablicu |
| SparklineGroup | sparkline | Grupa sparkline grafikona koji dijele vizualni stil |
| SparklineGroupCollection | sparkline | Sve sparkline grupe (ws.sparkline_groups) |
| Sparkline | sparkline | Jedna sparkline ćelija povezana s rasponom podataka |
| SparklineType | sparkline | Enum: LINE, COLUMN, WIN_LOSS |
| HorizontalPageBreakCollection | page-break | Ručno vodoravne prekide stranice (ws.horizontal_page_breaks) |
| VerticalPageBreakCollection | page-break | Ručno okomite prekide stranice (ws.vertical_page_breaks) |
| AgileEncryptionParameters | šifriranje | AES-256/SHA-512 parametri šifriranja (preporučeno) |
| StandardEncryptionParameters | šifriranje | Naslijeđeni parametri šifriranja AES-128/SHA-1 |
| CipherAlgorithm | šifriranje | Enum: AES_128, AES_192, AES_256 |
| HashAlgorithm | šifriranje | Enum: SHA1, SHA256, SHA384, SHA512 |
| —————————————– | ——————————————— |
| Workbook() | Stvori novu praznu radnu knjigu (XLSX format) |
| Workbook(file_path: str) | Učitaj radnu knjigu iz putanje datoteke |
| Workbook(file_path: str, password: str) | Učitaj radnu knjigu zaštićenu lozinkom |
Ključna svojstva
| ————————- | ————————- | ————————————————————– |
| worksheets | popis | Pristupi radnim listovima po indeksu: workbook.worksheets[0] |
Ključne metode
| ——————————————— | ————————- | —————————————————– |
| is_protected() | bool | Provjeri je li radna knjiga zaštićena |
Ključna svojstva
| ————————- | ————————- | ——————————— |
| name | str | Naziv kartice radnog lista |
| charts | ChartCollection | Svi grafikoni u ovom radnom listu |
Cells podržava pristup u stilu rječnika pomoću stringa adrese ćelije.
Uzorci pristupa
# 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| ————————- | —————————————————— |
| Cell(value=None) | Stvori ćeliju s vrijednošću (int, float, str ili None) |
| Cell(value, formula) | Stvori ćeliju formule (vrijednost je obično None) |
Ključna svojstva
| ————————- | ————————- | ——————————————– |
| formula | str | String formule (npr., "=SUM(A1:A5)") |
| ————————- | ————————- | ————————— |
Boje se izražavaju kao 8-digit AARRGGBB hex strings bez # prefiksa. Primjeri: "FFFF0000" = neprozirna crvena, "FF0000FF" = neprozirna plava, "FF000000" crna.
| ————————- | ————————- | ————————- | ——————————— |
| size | float | 11 | Veličina fonta u točkama |
| color | str | FF000000 | 8-digit AARRGGBB hex color string |
Font(name="Calibri", size=11, color="FF000000",
bold=False, italic=False, underline=False, strikethrough=False)| —————————————————- | ————————————————————————- |
| set_solid_fill(color) | Jednobojna pozadina; color je 8‑znamenkasti AARRGGBB heksadecimalni niz |
| set_pattern_fill(pattern_type, fg_color, bg_color) | Ispuna uzorka |
| set_no_fill() | Ukloni popunjavanje pozadine |
MarkdownHandler
| ————————————————— | ————————- | ——————————————— |
| MarkdownHandler.save_markdown_to_string(workbook) | str | Izvezi radnu knjigu u Markdown niz u memoriji |
MarkdownSaveOptions
| ————————- | ————————- | ————————- | ——————————————– |
| default_alignment | str | lijevo | Poravnanje stupca: lijevo, desno ili sredina |
| header_level | int | 2 | Razina naslova u Markdownu (1-6) |
| worksheet_index | int | 0 | Indeks lista za izvoz; -1 izvozi sve listove |
ChartCollection
Grafikoni se dodaju pomoću posebnih metoda po tipu. Indeksi redaka i stupaca su bazirano na nuli.
| —————————————————- | ————————- | ————————————- |
| ————————- | ————————- | ————————————————– |
| title | str | Naslov grafikona kao običan niz (ne .title.text) |
| category_data | str | Raspon ćelija za oznake kategorija na x-osi |
| n_series | NSeries | Kolekcija serija podataka |
| show_legend | bool | Treba li prikazati legendu |
| legend_position | str | Pozicija legende: desno, dolje, lijevo ili gore |
NSeries
| ———————————————— | ——————————- |
| add(data_range, category_data=None, name=None) | Dodaj imenovanu seriju podataka |
Enumeracija SaveFormat
| ————————- | ——————————– |
| SaveFormat.XLSX | Excel Open XML (zadano) |
| SaveFormat.CSV | Vrijednosti odvojene zarezom |
| SaveFormat.TSV | Vrijednosti odvojene tabulatorom |
| SaveFormat.MARKDOWN | Markdown tablice |
| SaveFormat.JSON | JSON strukturirani podaci |
Primjeri koda
Stvori, oblikuj i spremi radnu knjigu
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")Izvezi u Markdown u memoriji
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)Izradi linijski grafikon
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")Povezani resursi
- Vodič za programere: Vodiči za sve osnovne značajke
- Početak / Instalacija: pip instalacija i postavljanje
- Baza znanja:Vodiči usmjereni na zadatke
- Pregled proizvoda: Sažetak značajki i mogućnosti
- GitHub repozitorij
- Blog: Predstavljamo Aspose.Cells FOSS: Pregled biblioteke i brzi početak