Aspose.Cells FOSS for Python

Informacije o paketu


PyPI paket	`aspose-cells-foss`
Python import	`from aspose.cells_foss import ...`
	26.3.1
	MIT
Python zahtev	>= 3.7
	`pycryptodome>=3.15.0`, `olefile>=0.46`


aspose.cells_foss	Osnovni API za proračunske tablice: radne sveske, radni listovi, ćelije, stilovi, grafikoni, rukovaoci formatima

: Nema aspose.pydrawing modul u Aspose.Cells FOSS. Boje se izražavaju kao 8‑cifrene AARRGGBB heksadecimalne niske (npr., "FFFF0000" za neprovidnu crvenu).

aspose.cells_foss


`Workbook`	radna sveska	Ulazna tačka za kreiranje, učitavanje i čuvanje spreadsheet datoteka
`Worksheet`	radni list	Predstavlja pojedinačni list; omogućava pristup ćelijama, grafikonima i slikama
`Cells`	ćelije	Kolekcija slična rečniku od `Cell` objekata unutar `Worksheet`
`Cell`	ćelija	Predstavlja pojedinačnu ćeliju; vrednost, formula i stil
`Style`	stil	Formatiranje ćelije: font, popunjavanje, ivice, poravnanje, format broja, zaštita
`Font`	stil	Svojstva fonta: ime, veličina, boja, podebljano, kurziv, podvučeno, precrtano
`Fill`	stil	Pozadinsko popunjavanje: jednobojno, gradijent ili šablon
`NumberFormat`	stil	Ugrađeni alati za pretragu formata brojeva
`SaveFormat`	radna sveska	Enumeracija podržanih izlaznih formata (XLSX, CSV, MARKDOWN, JSON)
`Chart`	grafik	Predstavlja grafik ugrađen u radni list
`ChartType`	grafik	Enum: LINE, BAR, PIE, AREA, STOCK, i još više
`NSeries`	grafik	Kolekcija serija podataka na chart
`ChartSeries`	chart	Jedna serija podataka sa vrednostima, kategorijama i error bars
`ChartAxis`	chart	Podešavanja ose: skala, format, naslov
`ChartView3D`	chart	3D rotation and perspective settings
`ChartErrorBars`	chart	Konfiguracija error bar za seriju
`DataValidation`	data-validation	Jedinstveno pravilo validacije na opsegu ćelija
`DataValidationCollection`	data-validation	Sva pravila validacije za radni list
`DataValidationType`	data-validation	Enum: WHOLE_NUMBER, DECIMAL, LIST, DATE, TIME, TEXT_LENGTH, CUSTOM
`DataValidationOperator`	data-validation	Enum: BETWEEN, EQUAL, GREATER_THAN, itd.
`DataValidationAlertStyle`	validacija podataka	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 čuvanje CSV datoteka
`MarkdownHandler`	markdown-handler	Statičke metode za izvoz Markdown-a
`MarkdownSaveOptions`	markdown-handler	Opcije za izvoz Markdown-a
`JsonHandler`	json-handler	Statičke metode za izvoz JSON-a
`JsonSaveOptions`	json-handler	Opcije za izvoz JSON-a
`Shape`	oblik	Crtanje oblika sa popunjavanjem, linijom, tekstom i formatiranjem fonta
`ShapeCollection`	oblik	Svi oblici u radnom listu (`ws.shapes`)
`MsoDrawingType`	oblik	Enum: RECTANGLE, OVAL, TEXT_BOX, ARROW, itd.
`Table`	tabela	Excel tabela (struktuisana referenca) u radnom listu
`TableCollection`	tabela	Sve tabele u radnom listu (`ws.list_objects`)
`TableColumn`	tabela	Definicija kolone u tabeli
`TableStyleInfo`	tabela	Podešavanja vizuelnog stila za tabelu
`SparklineGroup`	sparkline	Grupa sparkline grafikona koji dele vizuelni stil
`SparklineGroupCollection`	sparkline	Sve sparkline grupe (`ws.sparkline_groups`)
`Sparkline`	sparkline	Jedna sparkline ćelija povezana sa opsegom podataka
`SparklineType`	sparkline	Enum: LINE, COLUMN, WIN_LOSS
`HorizontalPageBreakCollection`	prelom stranice	Ručni horizontalni prelom stranice (`ws.horizontal_page_breaks`)
`VerticalPageBreakCollection`	prelom stranice	Ručni vertikalni prekidi stranice (`ws.vertical_page_breaks`)
`AgileEncryptionParameters`	šifrovanje	AES-256/SHA-512 parametri šifrovanja (preporučeno)
`StandardEncryptionParameters`	šifrovanje	Legacy AES-128/SHA-1 parametri šifrovanja
`CipherAlgorithm`	šifrovanje	Enum: AES_128, AES_192, AES_256
`HashAlgorithm`	enkripcija	Enum: SHA1, SHA256, SHA384, SHA512


`Workbook()`	Kreirajte novu praznu radnu svesku (XLSX format)
`Workbook(file_path: str)`	Učitaj radnu svesku iz putanje fajla
`Workbook(file_path: str, password: str)`	Učitaj radnu svesku zaštićenu lozinkom

Ključna svojstva


`worksheets`	lista	Pristup radnim listovima po indeksu: `workbook.worksheets[0]`

Ključne metode


`save(file_path)`		Sačuvaj u fajl; format se zaključuje iz ekstenzije
`save(file_path, save_format)`		Sačuvaj sa eksplicitnim SaveFormat-om
`save_as_csv(file_path, options=None)`		Sačuvaj kao CSV
`save_as_markdown(file_path, options=None)`		Sačuvaj kao Markdown tabele
`save_as_json(file_path, options=None)`		Sačuvaj kao JSON
`load_csv(file_path, options=None)`		Učitaj CSV podatke u radnu svesku
`add_worksheet(name=None)`		Dodaj novi radni list
`get_worksheet(index_or_name)`		Dobij radni list po indeksu ili imenu
`remove_worksheet(index_or_name)`		Ukloni radni list
`copy_worksheet(index_or_name_or_ws)`		Kopiraj postojeći radni list
`protect(password=None, lock_structure=True)`		Zaštiti radnu svesku lozinkom
`unprotect(password=None)`		Ukloni zaštitu radne sveske
`is_protected()`	bool	Proveri da li je radna sveska zaštićena

Ključna svojstva


`name`	str	Naziv kartice radnog lista
`cells`		Sva ćelije u ovom radnom listu
`charts`	ChartCollection	Svi grafikoni u ovom radnom listu

Cells podržava pristup u stilu rečnika pomoću stringa adrese ćelije.

Obrasci 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)`	Kreirajte ćeliju sa vrednošću (int, float, str ili None)
`Cell(value, formula)`	Kreirajte formulu ćeliju (vrednost je obično None)

Ključna svojstva


`value`		Vrednost ćelije (str, int, float ili None)
`formula`	str	String formule (npr., `"=SUM(A1:A5)"`)
`style`		Stil ćelije (font, fill)


`font`		Podešavanja fonta za ovaj stil
`fill`		Podešavanja popunjavanja pozadine

Boje se izražavaju kao 8-digit AARRGGBB hex strings bez # prefiksa. Primeri: "FFFF0000" = neprovidna crvena, "FF0000FF" = neprovidna plava, "FF000000" = crna.


`name`	str		Naziv porodice fonta
`size`	float	11	Veličina fonta u tačkama
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool		Podebljan tekst
`italic`	bool		Kurzivni tekst
`underline`	bool		Podvučeni tekst
`strikethrough`	bool		Precrtani tekst

Font(name="Calibri", size=11, color="FF000000",
     bold=False, italic=False, underline=False, strikethrough=False)


`set_solid_fill(color)`	Jednobojna pozadina; `color` je 8‑cifrena AARRGGBB heksadecimalna niska
`set_pattern_fill(pattern_type, fg_color, bg_color)`	Uzorak popunjavanja
`set_no_fill()`	Ukloni popunjavanje pozadine

MarkdownHandler


`MarkdownHandler.save_markdown_to_string(workbook)`	str	Izvezi radnu svesku u Markdown string u memoriji

MarkdownSaveOptions


`default_alignment`	str	levo	Poravnanje kolone: levo, desno ili centar
`include_worksheet_name`	bool		Da li uključiti ime lista kao naslov
`header_level`	int	2	Nivo Markdown naslova (1-6)
`worksheet_index`	int	0	Indeks lista za izvoz; -1 izvozi sve listove

ChartCollection

Grafikoni se dodaju pomoću posvećenih metoda po tipu. Indeksi redova i kolona su nulto‑bazirani.


`add_bar(top_row, left_col, bottom_row, right_col)`		Dodaj kolonski (vertikalni stub) grafikon
`add_line(top_row, left_col, bottom_row, right_col)`		Dodaj linijski grafikon
`add_pie(top_row, left_col, bottom_row, right_col)`		Dodaj tortni grafikon


`title`	str	Naslov grafikona kao običan string (ne `.title.text`)
`category_data`	str	Opseg ćelija za oznake kategorija na x‑osi
`n_series`	NSeries	Kolekcija serija podataka
`show_legend`	bool	Da li prikazati legendu
`legend_position`	str	Pozicija legende: desno, dole, levo ili gore

NSeries


`add(data_range, category_data=None, name=None)`	Dodaj imenovanu seriju podataka

Enumeracija SaveFormat

	Format izlaza
`SaveFormat.XLSX`	Excel Open XML (podrazumevano)
`SaveFormat.CSV`	Vrednosti odvojene zarezom
`SaveFormat.TSV`	Vrednosti odvojene tabulatorom
`SaveFormat.MARKDOWN`	Markdown tabele
`SaveFormat.JSON`	JSON‑strukturirani podaci

: SaveFormat.PDF, SaveFormat.HTML, SaveFormat.PNG, SaveFormat.TIFF, SaveFormat.DOCX, i SaveFormat.PPTX su nije dostupno u Aspose.Cells FOSS. Ovi formati zahtevaju komercijalni aspose-cells-python paket.

Primeri koda

Kreirajte, stilizujte i sačuvajte radnu svesku

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

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

Napravite 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: Tutorijali za sve osnovne funkcije
Početak / Instalacija: pip instalacija i podešavanje
Baza znanja: Vodiči usmereni na zadatke
Pregled proizvoda: Sažetak funkcija i mogućnosti
GitHub repozitorijum
Blog: Predstavljanje Aspose.Cells FOSS: Pregled biblioteke i brzi početak