bsql-core 0.8.0

Runtime support for bsql — compile-time safe SQL for Rust
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

#![forbid(unsafe_code)]

//! Runtime support for bsql.
//!
//! This crate provides the types that `bsql::query!` generated code depends on:
//! error types, connection pool, and the executor trait.
//!
//! You should not depend on this crate directly — use [`bsql`] instead.

/// Re-export `postgres_types` so generated code (pg_enum) can reference it
/// via `::bsql_core::pg_types::*` without requiring users to add
/// `postgres-types` as a direct dependency.
pub use postgres_types as pg_types;

pub mod error;
pub mod executor;
pub mod listener;
pub mod pool;
pub(crate) mod singleflight;
pub mod stream;
pub mod transaction;
pub mod types;

/// Re-exports from `tokio-postgres` and `postgres-types` used by generated code.
/// This avoids requiring users to add `tokio-postgres` to their dependencies.
pub mod pg {
    pub use postgres_types::ToSql;
    pub use tokio_postgres::Row;
}

/// Re-export `futures_core::Stream` so consumers can use `QueryStream`
/// without adding `futures-core` as a direct dependency.
pub use futures_core::Stream;

pub use error::{BsqlError, BsqlResult};
pub use executor::Executor;
pub use listener::{Listener, Notification};
pub use pool::{Pool, PoolBuilder, PoolConnection, PoolStatus};
pub use stream::QueryStream;
pub use transaction::Transaction;

/// Hash a string using rapidhash. Used by singleflight, statement naming,
/// and offline cache keys. Not part of the public API.
#[doc(hidden)]
pub fn rapid_hash_str(s: &str) -> u64 {
    use std::hash::{Hash, Hasher};
    let mut hasher = rapidhash::quality::RapidHasher::default();
    s.hash(&mut hasher);
    hasher.finish()
}