1. Ürün:% s
  2.   E-tablo
  3.   Rust
  4.   calamine

calamine

 
 

Elektronik Tablolar için Saf Rust Kütüphanesi

Rust'ta Sıfır Kopya Serileştirme ile XLS, XLSX, XLSM, XLSB, ODS ve Daha Fazlasını Okuyun.

Calamine nedir?

calamine, Excel ve OpenDocument elektronik tablo dosyalarını okuma ve serileştirmeden çıkarma için yüksek performanslı, saf Rust kütüphanesidir. XLS, XLSX, XLSM, XLSB, ODS gibi formatları destekler ve hızlı, güvenli ve sıfır kopya veri çıkarımına odaklanır. Güvenilirlik ve minimum bağımlılık için tasarlanmış olan calamine, harici sistem kütüphanelerinden kaçınır ve yalnızca saf Rust uygulamalarına dayanır. API'si, geliştiricilerin hücre değerlerini verimli bir şekilde çıkarmasını, VBA projelerini yönetmesini ve karmaşık kurulum veya çalışma zamanı yükü olmadan formülleri ayrıştırmasını sağlar.

Kütüphane, performans kritik uygulamalarda üstünlük gösterir ve Python, C# ve Go alternatiflerine göre çok daha hızlı işleme sunar. Yerleşik Serde entegrasyonu sayesinde calamine, elektronik tablo verilerini Rust yapılarına sorunsuz bir şekilde eşleştirmeyi sağlar. Büyük dosyalar için tembel yüklemeyi, başlık satırı yapılandırmasını ve chrono tarih/saat desteği ve resim veri çıkarımı gibi isteğe bağlı özellikleri destekler. CLI araçları, web arka uçları veya gömülü sistemler geliştiriyor olun, calamine platformlar arasında sağlam, öngörülebilir performans sunar.

Previous Next

Calamine ile Başlarken

calamine'i kullanmaya başlamak için, onu Cargo aracılığıyla Rust projenize ekleyin. cargo add calamine komutunu doğrudan kullanarak kurabilir veya bağımlılığı Cargo.toml dosyanıza manuel olarak ekleyebilirsiniz. Kütüphane crates.io'da mevcuttur ve kaynak kodu calamine GitHub'da barındırılmaktadır. Gelişmiş kullanım için, tarih/saat desteği için chrono veya görüntü verisi çıkarma için picture gibi isteğe bağlı özellikleri etkinleştirin. Kütüphane, kararlı Rust üzerinde sorunsuz derlenir ve dış ikili dosya ya da sistem kütüphaneleri gerektirmez.

Cargo ile calamine'i kurun

cargo add calamine

Serde Tabanlı Elektronik Tablo Çözümlemesi

calamine, elektronik tablo verilerini doğrudan Rust yapılarına eşlemek için güçlü Serde entegrasyonu sağlar. RangeDeserializerBuilder kullanarak, geliştiriciler güçlü tipli veri modelleri tanımlayabilir ve satırları otomatik olarak yapılandırılmış kayıtlara serileştirebilir. Kütüphane, deserialize_as_f64_or_none ve deserialize_as_f64_or_string gibi yardımcı işlevler içerir ve karışık tipteki sütunları sorunsuz bir şekilde işler. Bu yaklaşım tip güvenliğini sağlar, tekrarlayan kodu azaltır ve veri yapıların derleme zamanında doğrulanmasını mümkün kılar. Özellikle güvenilirlik ve performansın kritik olduğu veri boru hatları, raporlama araçları ve ETL uygulamaları için faydalıdır.

Elektronik Tablo Satırlarını Rust Yapılarına Çözümle

use calamine::{deserialize_as_f64_or_none, open_workbook, RangeDeserializerBuilder, Reader, Xlsx};
use serde::Deserialize;

#[derive(Deserialize)]
struct Record {
    metric: String,
    #[serde(deserialize_with = "deserialize_as_f64_or_none")]
    value: Option,
}

let mut excel: Xlsx<_> = open_workbook("file.xlsx")?;
let range = excel.worksheet_range("Sheet1")?;
let iter = RangeDeserializerBuilder::with_headers(&["metric", "value"]).from_range(&range)?;
for result in iter {
    let record: Record = result?;
    println!("{:?}", record);
}

VBA Projesi ve Formül Çıkarma

calamine, Excel dosyalarından VBA proje modüllerinin ve formül tanımlarının çıkarılmasını sağlar. Geliştiriciler, modüllerden VBA kodunu alabilir, kırık referansları tespit edebilir ve tanımlı adları ve bunların formüllerini inceleyebilir. Bu yetenek, göç araçları, denetim yardımcı programları ve eski sistem analizleri için gereklidir. API, VBA meta verilerine yapılandırılmış erişim sunar ve hem basit hem de karmaşık çalışma kitabı içgörü senaryolarını destekler. Makroları güvenlik için analiz ediyor ya da eski Excel mantığını dönüştürüyor olun, calamine gizli çalışma kitabı içeriğine kesin, düşük seviyeli erişim sağlar.

VBA Kodunu ve Tanımlı Adları Çıkar

use calamine::{open_workbook_auto, Reader};

let mut workbook = open_workbook_auto("file.xlsx")?;
if let Ok(Some(vba)) = workbook.vba_project() {
    let module = vba.get_module("Module1").unwrap();
    println!("{}", module);
    for ref in vba.get_references() {
        if ref.is_missing() { println!("Broken: {}", ref.name); }
    }
}
for (name, formula) in workbook.defined_names() {
    println!("{}: {}", name, formula);
}

Tembel Yükleme ve Büyük Dosya İşleme

calamine, XLSX ve XLSB dosyaları için tembel yüklemeyi destekler, böylece tüm sayfalar bir kerede belleğe yüklenmeden büyük elektronik tabloların verimli bir şekilde işlenmesini sağlar. Başlık satırlarını yapılandırarak ve aralık tabanlı yineleme kullanarak, geliştiriciler bellek ayak izini en aza indirebilir ve verimliliği maksimize edebilir. Bu özellik, kaynakların sınırlı olduğu sunucusuz işlevler, CLI araçları ve gömülü dağıtımlar için özellikle değerlidir. Benchmark sonuçları, calamine'in openpyxl ve ClosedXML gibi alternatiflere kıyasla minimal bellek yüküyle 1M+ satırı okuduğunu gösteriyor ve bu da onu yüksek ölçekli veri alım hatları için ideal kılıyor.

Büyük Elektronik Tablo Dosyalarını Verimli Bir Şekilde İşle

use calamine::{open_workbook, Reader, Xlsx};

let mut excel: Xlsx<_> = open_workbook("large.xlsx")?;
let range = excel
    .worksheet_range("Sheet1")?
    .expect("Sheet not found");

for row in range.rows() {
    // Process row without loading entire file
    process_row(row);
}

Performans Optimizasyonu ve Kıyaslamalar

calamine olağanüstü performans sunar, 41 milyon hücreyi 25 saniyeden kısa sürede işler—Python, C# ve Go kütüphanelerine göre 9.4 kat daha hızlıdır. Sıfır kopya tasarımı ve minimal yığın tahsisleri CPU ve bellek kullanımını önemli ölçüde azaltır. 186 MB XLSX dosyası üzerindeki benchmarklar, calamine'in yalnızca 186 MB disk okuması kullandığını, excelize için ise 1.5 GB kullandığını gösterir. Kütüphanenin deterministik bellek davranışı ve düşük GC baskısı, gerçek zamanlı ve gecikmeye duyarlı uygulamalar için uygundur. Geliştiriciler, öngörülebilir kaynak kullanımı ve çeşitli iş yüklerinde tutarlı verimlilikten faydalanır.

 Türkçe