firebird-wire

Driver síncrono e puramente em Rust para Firebird 5+, falando o protocolo nativo (wire protocol v19) diretamente sobre TCP — sem dependência do libfbclient.

use firebird_wire::{ConnectConfig, Connection};

fn main() -> firebird_wire::Result<()> {
    let cfg = ConnectConfig::new()
        .host("127.0.0.1").port(3050).database("employee")
        .user("SYSDBA").password("masterkey");

    let mut conn = Connection::connect(&cfg)?;
    let tx = conn.begin()?;

    let mut stmt = conn.prepare(&tx, "SELECT first_name FROM employee WHERE emp_no = ?")?;
    stmt.execute(&mut conn, &tx, &[2_i32.into()])?;
    if let Some(row) = stmt.fetch(&mut conn)? {
        println!("{:?}", row[0].as_str());
    }
    stmt.drop_statement(&mut conn)?;

    tx.commit(&mut conn)?;
    conn.close()?;
    Ok(())
}

Documentação

• COMECE-AQUI.md — introdução didática para o primeiro uso: conceitos básicos, primeiro programa completo e mapa “quero fazer X”.
• GUIA-DE-USO.md — guia completo de uso, com exemplos de conexão, query, execute, transações, batch, BLOBs, pool, charsets, wire-crypt e mais, além do checklist de recursos.
• PROTOCOL-NOTES.md — notas de engenharia reversa dos layouts do wire protocol.

Recursos

Autenticação SRP/Srp256, wire-crypt (ChaCha/ChaCha64/Arc4), transações, prepared statements com parâmetros, streaming de linhas, cursores roláveis, BLOBs (leitura/escrita), DML em lote (batch) incl. BLOBs, datas/horas civis, charsets (UTF-8/Latin-1/Win-1252) e pool de conexões. Veja o checklist completo.

Testes ao vivo

FB_HOST=127.0.0.1 FB_PORT=3050 FB_DB=employee FB_USER=SYSDBA \
  FB_PASSWORD=masterkey cargo test --test integration -- --test-threads=1