5 unstable releases
new 0.3.2 | Mar 10, 2025 |
---|---|
0.3.1 | Mar 9, 2025 |
0.2.0 | Jan 18, 2025 |
0.1.1 | Dec 23, 2024 |
0.1.0 | Dec 12, 2024 |
#684 in Database interfaces
47KB
172 lines
parsql
Deneyimsel SQL yardımcısı
Ne İşe Yarar?
Parsql, SQL sorgularınızı doğrudan Rust struct'ları üzerinden yönetmenize olanak tanıyan bir kütüphanedir. Temel amacı, veritabanı işlemlerini daha güvenli ve daha az kod ile gerçekleştirmenizi sağlamaktır. Bu kütüphane ile:
- Struct tanımları üzerinden otomatik SQL sorguları oluşturabilirsiniz
- Veritabanı parametrelerini güvenli bir şekilde yönetebilirsiniz
- Generic CRUD işlemlerini (ekleme, okuma, güncelleme, silme) kolayca yapabilirsiniz
- Dinamik SQL oluşturabilir ve karmaşık sorgular çalıştırabilirsiniz
Parsql standart bir ORM değildir. Daha çok, SQL yazımını ve kullanımını basitleştirmeye odaklanır.
Desteklenen Veritabanları
Parsql aşağıdaki veritabanı sistemlerini desteklemektedir:
- SQLite (senkron):
parsql-sqlite
paketi - PostgreSQL (senkron):
parsql-postgres
paketi - Tokio PostgreSQL (asenkron):
parsql-tokio-postgres
paketi
Küfe'nin Yüklenmesi
Uygulamanıza küfeyi yüklerken hangi veritabanı ile çalışacağınızı 'feature' olarak belirtmeniz gerekiyor. Cargo.toml dosyanıza paketi şu şekilde ekleyebilirsiniz:
SQLite için
parsql = { version = "0.3.0", features = ["sqlite"] }
PostgreSQL için
parsql = { version = "0.3.0", features = ["postgres"] }
Tokio PostgreSQL için
parsql = { version = "0.3.0", features = ["tokio-postgres"] }
Deadpool PostgreSQL bağlantı havuzu için
parsql = { version = "0.3.0", features = ["deadpool-postgres"] }
Temel Özellikler
Procedural Makrolar
Parsql, veritabanı işlemlerini kolaylaştırmak için çeşitli procedural makrolar sunar:
#[derive(Queryable)]
- Okuma (select) işlemleri için#[derive(Insertable)]
- Ekleme işlemleri için#[derive(Updateable)]
- Güncelleme işlemleri için#[derive(FromRow)]
- Veritabanı sonuçlarını nesnelere dönüştürmek için
Öznitelikler
Sorgularınızı özelleştirmek için çeşitli öznitelikler kullanabilirsiniz:
#[table("tablo_adi")]
- Tablo adını belirtmek için#[where_clause("id = $")]
- WHERE koşulunu belirtmek için#[select("alan1, alan2")]
- SELECT ifadesini özelleştirmek için#[update("alan1, alan2")]
- UPDATE ifadesini özelleştirmek için#[join("LEFT JOIN tablo2 ON tablo1.id = tablo2.fk_id")]
- JOIN ifadeleri için#[group_by("alan1")]
- GROUP BY ifadesi için#[order_by("alan1 DESC")]
- ORDER BY ifadesi için#[having("COUNT(*) > 5")]
- HAVING ifadesi için
SQL İzleme
Geliştirme sırasında oluşturulan SQL sorgularını izlemek için:
PARSQL_TRACE=1 cargo run
Basit Kullanım Örneği
// Bir kayıt almak için
#[derive(Queryable, FromRow, SqlParams, Debug)]
#[table("users")]
#[where_clause("id = $")]
pub struct GetUser {
pub id: i64,
pub name: String,
pub email: String,
}
// SQLite için kullanım
let get_user = GetUser::new(1);
let user = get(&conn, get_user);
// Tokio-Postgres için kullanım
let get_user = GetUser::new(1);
let user = get(&client, get_user).await;
Detaylı Dökümantasyon
Her veritabanı adaptörü için daha detaylı bilgi ve örnekler, ilgili alt paketlerin README dosyalarında bulunmaktadır:
GitHub'daki örnekler klasöründe her veritabanı tipi için kapsamlı örnek projeler bulabilirsiniz.
0.3.0 Sürümündeki Değişiklikler
join
,group_by
,order_by
vehaving
öznitelikleri eklendiPARSQL_TRACE
çevre değişkeni desteği eklendi- Öznitelik isimleri güncellendi (
table_name
→table
,update_clause
→update
,select_clause
→select
) SqlQuery
trait'i eklendi ve trait yapısı sadeleştirildi- Temel trait'ler
parsql-core
crate'inde toplandı
Dependencies
~2–16MB
~211K SLoC