
umya-spreadsheet
XLSX/XLSM Dosyaları için Saf Rust Kütüphanesi
Sıfır dış bağımlılıkla XLSX/XLSM Elektronik Tabloları Okuyun, Yazın, Stil Verin ve Manipüle Edin.
umya-spreadsheet nedir?
umya-spreadsheet, XLSX ve XLSM formatlarındaki Excel çalışma sayfası dosyalarını okuma ve yazma için yüksek performanslı, saf Rust kütüphanesidir. Güvenlik ve verimlilik için tasarlanmış, güvensiz kod ve dış bağımlılıklardan kaçınır; bu da masaüstü uygulamaları, sunucu tarafı işlem ve WebAssembly ortamları için ideal kılar. Kütüphane, hücreler, satırlar, sütunlar, stiller, grafikler ve görüntülere erişim için temiz, Rust'ye özgü bir API sunar ve geliştiricilerin Microsoft Office veya COM etkileşimine ihtiyaç duymadan sağlam çalışma sayfası araçları oluşturmasını sağlar.
Tamamen tembel yükleme, şifre koruması ve zengin biçimlendirme desteğiyle, umya-spreadsheet performans ve kullanılabilirlik arasındaki boşluğu kapatır. CSV dışa aktarma, grafik oluşturma, görüntü gömme ve taşıma, kopyalama gibi aralık işlemlerini destekler. Proje aktif olarak sürdürülmekte, iyi belgelenmekte ve test edilmektedir; doğruluk ve modern Excel özellikleriyle uyumluluğa odaklanır. Geliştiriciler, Tauri veya Axo gibi çerçeveler kullanarak bunu CLI araçlarına, web arka uçlarına veya masaüstü uygulamalarına entegre edebilir.
umya-spreadsheet ile Başlarken
umya-spreadsheet'i kullanmaya başlamak için, `umya-spreadsheet = "3.1.1"` satırını Cargo.toml dosyanıza ekleyin. WebAssembly desteği için `js` özelliğini etkinleştirin. Kütüphane bağımlılıkları azdır ve hızlı bir şekilde derlenir. Kurulduktan sonra, `extern crate umya_spreadsheet;` ifadesiyle içe aktarın ve elektronik tabloları okumaya ya da yazmaya başlayın. Ayrıca örnekler, testler ve belgeler için umya-spreadsheet GitHub sayfasını inceleyebilirsiniz. Büyük dosyalar için tembel yüklemeyi destekler ve sağlam hata yönetimi sunar.
Cargo ile umya-spreadsheet'i Kur
[dependencies]
umya-spreadsheet = "3.1.1"
# WebAssembly support
umya-spreadsheet = { version = "3.1.1", features = ["js"] }
XLSX/XLSM Dosyalarını Oku ve Yaz
umya-spreadsheet, XLSX ve XLMS dosyalarını okuma ve yazma için sezgisel API'ler sağlar. Bir çalışma kitabını diskte yüklemek için `reader::xlsx::read()` kullanın veya boş bir tane oluşturmak için `new_file()` kullanın. Yazma da aynı derecede basittir: çalışma kitabı ve hedef yol ile `writer::xlsx::write()` çağırın. Kütüphane, büyük dosyalarda performansı artırmak için `lazy_read()` aracılığıyla tembel yüklemeyi destekler ve şifre korumalı yazma veya oluşturma sonrası şifre ayarlamaya izin verir. Tüm işlemler güvenlidir, mümkün olduğunda sıfır kopya yapılır ve harici ikili dosyalardan kaçınılır.
Rust ile bir XLSX Dosyasını Nasıl Okur ve Yazarız?
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ücre Erişimi ve Stil Manipülasyonu
Hücre değerlerine erişmek ve bunları değiştirmek basittir: okuma için `cell("A1")` veya `cell((1,1))` kullanın, yazma için ise `cell_mut()` kullanın. Stil yönetimi `style_mut()` aracılığıyla yapılır ve arka plan rengi, yazı tipi, kenarlıklar ve hizalama değişikliklerine izin verir. Kütüphane, mümkün olduğunda değişmezlik garantilerini korurken zengin bir stil özelliği seti sunar. Ayrıca biçimlendirilmiş değerleri alabilir, koşullu mantık uygulayabilir ve aralıklar boyunca stilleri toplu olarak güncelleyebilirsiniz. Bu, tutarlı biçimlendirme ile raporlar, gösterge panelleri veya veri dışa aktarımları oluşturmak için idealdir.
Rust ile Hücre Değerini ve Stilini Nasıl Değiştirebilirsiniz?
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);
Grafik ve Görsel Desteği
umua-spreadsheet, seri aralıkları ve işaretçiler tanımlanarak çizgi, çubuk ve alan grafikleri dahil olmak üzere grafik oluşturma ve düzenleme desteği sağlar. `Image` yapısını kullanarak görüntüleri doğrudan sayfalara gömebilir, etkinleştirilen özelliklere bağlı olarak PNG ve diğer formatları destekleyebilirsiniz. Grafikler ve görüntüler hücre koordinatları ve çizim katmanlarıyla sorunsuz bir şekilde bütünleşir, dinamik gösterge paneli oluşturmayı mümkün kılar. Bazı gelişmiş çizim özellikleri hâlâ gelişmekte olsa da, temel işlevsellik üretim için hazır ve genişletilebilir.
Rust ile Bir Çalışma Sayfasına Çizgi Grafiği Nasıl Eklenir?
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ık İşlemleri ve Şifre Koruması
Gelişmiş işlemleri, `move_range()` kullanarak aralıkları taşıma, kopyalama ve yeniden boyutlandırma gibi, dinamik veri yeniden düzenlemeyi mümkün kılar. Kütüphane ayrıca şifre korumalı çalışma kitaplarını destekler: `write_with_password()` ile dosyalar yazabilir veya `set_password()` aracılığıyla mevcut dosyalara şifre uygulayabilirsiniz. Bu özellikler, kurumsal veya uyumluluk hassasiyeti yüksek uygulamalarda güvenli veri yönetimi için kritiktir. Sıfır bağımlılık tasarımı ve WASM uyumluluğu ile birleştiğinde, umua-spreadsheet esneklik ve güvenliği bir arada sunar.
Rust ile Bir Aralığı Taşıma ve Dosyayı Şifreyle Koruma Nasıl Yapılır?
// 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();
