
umya-spreadsheet
XLSX/XLSM Faylları üçün Saf Rust Kitabxanası
XLSX/XLSM Cədvəllərini Oxuyun, Yazın, Üslublandırın və Sıfır Xarici Asılılıqla İdarə Edin.
umya-spreadsheet nədir?
umya-spreadsheet yüksək performanslı, saf Rust kitabxanasıdır, XLSX və XLSM formatlarında Excel cədvəl fayllarını oxumaq və yazmaq üçün. Təhlükəsizlik və səmərəlilik üçün dizayn edilmiş, təhlükəli koddan və xarici asılılıqlardan uzaq durur, bu da onu masaüstü tətbiqləri, server tərəfi emalı və WebAssembly mühitləri üçün ideal edir. Kitabxana hüceyrələr, sətirlər, sütunlar, stillər, qrafiklər və şəkillərə çıxış üçün təmiz, idiomatik Rust API‑si təqdim edir, inkişafçılara Microsoft Office və ya COM interopuna ehtiyac duymadan güclü cədvəl alətləri yaratmağa imkan verir.
Tam gecikməli yükləmə, parol qoruması və zəngin formatlama dəstəyi ilə, umya-spreadsheet performans və istifadə rahatlığı arasındakı boşluğu aradan qaldırır. CSV ixracı, qrafik yaradılması, şəkil yerləşdirilməsi və aralığı köçürmə və nüsxələmə kimi əməliyyatları dəstəkləyir. Layihə aktiv şəkildə saxlanılır, yaxşı sənədləşdirilib və test edilmişdir, düzgünlük və müasir Excel xüsusiyyətləri ilə uyğunluğa yönəldilmişdir. İnkişafçılar onu Tauri və ya Axo kimi çərçivələrdən istifadə edərək CLI alətləri, veb arxa planları və ya masaüstü tətbiqlərə inteqrasiya edə bilərlər.
umya-spreadsheet ilə Başlamaq
umya-spreadsheet-dən istifadə etməyə başlamaq üçün, onu `umya-spreadsheet = "3.1.1"` ilə Cargo.toml faylınıza əlavə edin. WebAssembly dəstəyi üçün `js` xüsusiyyətini aktivləşdirin. Kitabxana asılılıqları azdır və sürətlə tərtib olunur. Quraşdırıldıqdan sonra `extern crate umya_spreadsheet;` vasitəsilə idxal edin və cədvəlləri oxumağa və ya yazmağa başlayın. Həmçinin nümunələr, testlər və sənədləşdirmə üçün umya-spreadsheet GitHub səhifəsini araşdıra bilərsiniz. Böyük fayllar üçün tənbəl yükləməni dəstəkləyir və güclü səhv idarəetməsi təklif edir.
umya-spreadsheet-i Cargo vasitəsilə quraşdırın
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
XLSX/XLSM Fayllarını Oxumaq və Yazmaq
umya-spreadsheet, XLSX və XLMS fayllarını oxumaq və yazmaq üçün intuitiv API-lər təqdim edir. Diskdən iş dəftərini yükləmək üçün `reader::xlsx::read()` istifadə edin, ya da boş bir iş dəftəri yaratmaq üçün `new_file()` istifadə edin. Yazma da eyni dərəcədə sadədir: `writer::xlsx::write()` funksiyasını iş dəftəri və hədəf yol ilə çağırın. Kitabxana, böyük fayllarda performansı artırmaq üçün `lazy_read()` vasitəsilə tənbəl yükləməni dəstəkləyir və şifrə ilə qorunan yazma və ya yaradıldıqdan sonra şifrələrin təyin edilməsinə imkan verir. Bütün əməliyyatlar təhlükəsizdir, mümkün olduğu halda sıfır nüsxə (zero-copy) edilir və xarici icra fayllarından qaçınılır.
Rust vasitəsilə XLSX Faylını Necə Oxumaq və Yazmaq olar?
use std::path::Path;
// Read file
let path = Path::new("./input.xlsx");
let mut book = umya_spreadsheet::reader::xlsx::read(path).unwrap();
// Write file
let out_path = Path::new("./output.xlsx");
umya_spreadsheet::writer::xlsx::write(&book, out_path).unwrap();
Hüceyrə Girişi və Stil Manipulyasiyası
Hüceyrə dəyərlərinə daxil olmaq və onları dəyişdirmək sadədir: oxumaq üçün `cell("A1")` və ya `cell((1,1))` istifadə edin, yazmaq üçün isə `cell_mut()` istifadə edin. Stil idarəetməsi `style_mut()` vasitəsilə həyata keçirilir və fon rəngi, şrift, kənarlar və hizalama dəyişikliklərinə imkan verir. Kitabxana, mümkün olduğu qədər dəyişməzlik (immutability) zəmanətini saxlayaraq zəngin stil xüsusiyyətləri dəsti təqdim edir. Həmçinin formatlanmış dəyərləri əldə edə, şərti məntiq tətbiq edə və aralıqlarda stiləri toplu olaraq yeniləyə bilərsiniz. Bu, hesabatlar, idarəetmə paneli və ya davamlı formatlama ilə məlumat ixracı yaratmaq üçün ideal edir.
Rust vasitəsilə Hüceyrə Dəyərini və Stilini Necə Dəyişdirmək?
let mut book = umya_spreadsheet::new_file();
book.sheet_by_name_mut("Sheet1")
.unwrap()
.cell_mut("A1")
.set_value("Hello, Rust!");
let mut style = book.sheet_by_name_mut("Sheet1")
.unwrap()
.style_mut("A1");
style.set_background_color(umya_spreadsheet::Color::COLOR_RED);
Qrafiklər və Şəkil Dəstəyi
umya-spreadsheet, seriya diapazonları və markerləri təyin edərək xətt, sütun və sahə diaqramları daxil olmaqla diaqramların yaradılması və redaktəsini dəstəkləyir. `Image` strukturu vasitəsilə şəkilləri birbaşa cədvəllərə əlavə etmək mümkündür, PNG və digər formatlar aktivləşdirilmiş xüsusiyyətlərdən asılı olaraq dəstəklənir. Diaqramlar və şəkillər hüceyrə koordinatları və çəkiliş qatları ilə problemsiz inteqrasiya olunur, dinamik idarə paneli yaradılmasını təmin edir. Bəzi qabaqcıl çəkiliş xüsusiyyətləri hələ inkişaf mərhələsində olsa da, əsas funksionallıq istehsal üçün hazırdır və genişləndirilə bilər.
Rust vasitəsilə Cədvələ Xətti Qrafik Necə Əlavə Etmək?
let mut book = umya_spreadsheet::new_file();
let mut from_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
from_marker.set_coordinate("C1");
let mut to_marker = umya_spreadsheet::structs::drawing::spreadsheet::MarkerType::default();
to_marker.set_coordinate("D11");
let series = vec!["Sheet1!$A$1:$A$10", "Sheet1!$B$1:$B$10"];
let mut chart = umya_spreadsheet::structs::Chart::default();
chart.new_chart(
umya_spreadsheet::structs::ChartType::LineChart,
from_marker,
to_marker,
series,
);
book.sheet_by_name_mut("Sheet1")
.unwrap()
.add_chart(chart);
Aralıq Əməliyyatları və Şifrə Qoruması
range`ləri `move_range()` ilə köçürmək, nüsxələmək və ölçülərini dəyişdirmək kimi qabaqcıl əməliyyatları həyata keçirin, dinamik məlumat yenidən təşkilini təmin edin. Kitabxana həmçinin şifrə ilə qorunan iş dəftərlərinə dəstək verir: `write_with_password()` ilə faylları yazın və ya `set_password()` vasitəsilə mövcud fayllara şifrə təyin edin. Bu xüsusiyyətlər müəssisə və ya uyğunluq‑həssas tətbiqlərdə təhlükəsiz məlumat idarəçiliyi üçün vacibdir. Sıfır asılılıq dizaynı və WASM uyğunluğu ilə birləşərək, umya-spreadsheet həm elastikliyi, həm də təhlükəsizliyi təmin edir.
Rust vasitəsilə Aralığı Necə Köçürmək və Faylı Parolla Qorumaq?
// Move range
let range = "A1:A3";
book.sheet_by_name_mut("Sheet1")
.unwrap()
.move_range(range, &10, &2);
// Password protection
umya_spreadsheet::writer::xlsx::write_with_password(
&book,
Path::new("./protected.xlsx"),
"mypassword",
).unwrap();
