rsfbclient 0.28.0

Binds to official firebird client lib
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//!
//! Rust Firebird Client
//!
//! Example of the Services API: server version and a verbose
//! backup/restore round trip through the service manager — the same
//! channel gbak uses.
//!
//! Needs the native client (linking or dynamic_loading feature); the
//! pure-rust wire implementation cannot reach the service manager.
//!
//! All paths below are SERVER paths: the backup file is created on the
//! server, by the server, no matter where this program runs.
//!

#![allow(unused_variables, unused_mut)]

fn main() {
    #[cfg(any(feature = "linking", feature = "dynamic_loading"))]
    example::run().unwrap();

    #[cfg(not(any(feature = "linking", feature = "dynamic_loading")))]
    println!(
        "The Services API needs the native client (enable the linking or dynamic_loading feature)"
    );
}

#[cfg(any(feature = "linking", feature = "dynamic_loading"))]
mod example {
    use rsfbclient::services::{ServiceManager, SvcBackupOptions, SvcRestoreOptions};
    use rsfbclient::FbError;

    pub fn run() -> Result<(), FbError> {
        #[cfg(feature = "linking")]
        let mut svc = ServiceManager::builder()
            .host("localhost")
            .user("SYSDBA")
            .pass("masterkey")
            .attach()?;

        #[cfg(all(feature = "dynamic_loading", not(feature = "linking")))]
        let mut svc = ServiceManager::builder()
            .host("localhost")
            .user("SYSDBA")
            .pass("masterkey")
            .with_dyn_load("./fbclient.lib")
            .attach()?;

        println!("server version: {}", svc.server_version()?);

        // Verbose backup: the gbak log streams through the closure
        // while the backup runs on the server.
        println!("backing up examples.fdb:");
        svc.backup_with_output(
            "examples.fdb",
            "examples.fbk",
            SvcBackupOptions::default(),
            |line| println!("  {}", line),
        )?;

        // Restore to a new database, quietly.
        let opts = SvcRestoreOptions {
            replace: true,
            ..SvcRestoreOptions::default()
        };
        svc.restore("examples.fbk", "examples_restored.fdb", opts)?;
        println!("restored examples.fbk -> examples_restored.fdb");

        Ok(())
    }
}