Aspose.Cells FOSS for Python

Informacije o paketu


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


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

: Nema aspose.pydrawing modul u Aspose.Cells FOSS. Boje se izražavaju kao 8‑znamenkasti AARRGGBB heksadecimalni nizovi (npr., "FFFF0000" za neprozirnu crvenu).

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


`save(file_path)`		Spremi u datoteku; format se zaključuje iz ekstenzije
`save(file_path, save_format)`		Spremi s eksplicitnim SaveFormat-om
`save_as_csv(file_path, options=None)`		Spremi kao CSV
`save_as_markdown(file_path, options=None)`		Spremi kao Markdown tablice
`save_as_json(file_path, options=None)`		Spremi kao JSON
`load_csv(file_path, options=None)`		Učitaj CSV podatke u radnu knjigu
`add_worksheet(name=None)`		Dodaj novi radni list
`get_worksheet(index_or_name)`		Dohvati 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 knjigu lozinkom
`unprotect(password=None)`		Ukloni zaštitu radne knjige
`is_protected()`	bool	Provjeri je li radna knjiga zaštićena

Ključna svojstva


`name`	str	Naziv kartice radnog lista
`cells`		Sve ćelije u ovom radnom listu
`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


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


`font`		Postavke fonta za ovaj stil
`fill`		Postavke pozadinskog ispune

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


`name`	str		Naziv obitelji fonta
`size`	float	11	Veličina fonta u točkama
`color`	str	FF000000	8-digit AARRGGBB hex color string
`bold`	bool		Podebljani 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‑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
`include_worksheet_name`	bool		Treba li uključiti naziv lista kao naslov
`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.


`add_bar(top_row, left_col, bottom_row, right_col)`		Dodaj stupčasti (vertikalni) 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 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

	Izlazni format
`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

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

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