Lines
18.96 %
Functions
6.16 %
Branches
100 %
use bonsaidb_client::{Client, RemoteDatabase};
#[cfg(feature = "password-hashing")]
use bonsaidb_core::connection::Authentication;
use bonsaidb_core::{
arc_bytes::serde::Bytes,
async_trait::async_trait,
connection::{
self, AccessPolicy, AsyncConnection, AsyncLowLevelConnection, AsyncStorageConnection,
HasSession, IdentityReference, QueryKey, Range, Session, Sort,
},
document::{DocumentId, Header, OwnedDocument},
schema::{
self, view::map::MappedSerializedValue, Collection, CollectionName, Nameable, Schema,
SchemaName, Schematic, ViewName,
transaction::{Executed, OperationResult, Transaction},
};
use bonsaidb_server::{Backend, CustomServer, NoBackend, ServerDatabase};
/// A local server or a server over a network connection.
pub enum AnyServerConnection<B: Backend> {
/// A local server.
Local(CustomServer<B>),
/// A server accessed with a [`Client`].
Networked(Client),
}
impl<B: Backend> HasSession for AnyServerConnection<B> {
fn session(&self) -> Option<&Session> {
match self {
Self::Local(server) => server.session(),
Self::Networked(client) => client.session(),
#[async_trait]
impl<B: Backend> AsyncStorageConnection for AnyServerConnection<B> {
type Database = AnyDatabase<B>;
type Authenticated = Self;
async fn admin(&self) -> Self::Database {
Self::Local(server) => AnyDatabase::Local(server.admin().await),
Self::Networked(client) => AnyDatabase::Networked(client.admin().await),
async fn database<DB: Schema>(
&self,
name: &str,
) -> Result<Self::Database, bonsaidb_core::Error> {
Self::Local(server) => server.database::<DB>(name).await.map(AnyDatabase::Local),
Self::Networked(client) => client
.database::<DB>(name)
.await
.map(AnyDatabase::Networked),
async fn create_database_with_schema(
schema: SchemaName,
only_if_needed: bool,
) -> Result<(), bonsaidb_core::Error> {
Self::Local(server) => {
server
.create_database_with_schema(name, schema, only_if_needed)
Self::Networked(client) => {
client
async fn delete_database(&self, name: &str) -> Result<(), bonsaidb_core::Error> {
Self::Local(server) => server.delete_database(name).await,
Self::Networked(client) => client.delete_database(name).await,
async fn list_databases(&self) -> Result<Vec<connection::Database>, bonsaidb_core::Error> {
Self::Local(server) => server.list_databases().await,
Self::Networked(client) => client.list_databases().await,
async fn list_available_schemas(&self) -> Result<Vec<SchemaName>, bonsaidb_core::Error> {
Self::Local(server) => server.list_available_schemas().await,
Self::Networked(client) => client.list_available_schemas().await,
async fn create_user(&self, username: &str) -> Result<u64, bonsaidb_core::Error> {
Self::Local(server) => server.create_user(username).await,
Self::Networked(client) => client.create_user(username).await,
async fn delete_user<'user, U: Nameable<'user, u64> + Send + Sync>(
user: U,
Self::Local(server) => server.delete_user(user).await,
Self::Networked(client) => client.delete_user(user).await,
async fn set_user_password<'user, U: Nameable<'user, u64> + Send + Sync>(
password: bonsaidb_core::connection::SensitiveString,
Self::Local(server) => server.set_user_password(user, password).await,
Self::Networked(client) => client.set_user_password(user, password).await,
async fn authenticate<'user, U: Nameable<'user, u64> + Send + Sync>(
authentication: Authentication,
) -> Result<Self::Authenticated, bonsaidb_core::Error> {
Self::Local(server) => server
.authenticate(user, authentication)
.map(Self::Local),
.map(Self::Networked),
async fn assume_identity(
identity: IdentityReference<'_>,
Self::Local(server) => server.assume_identity(identity).await.map(Self::Local),
Self::Networked(client) => client.assume_identity(identity).await.map(Self::Networked),
async fn add_permission_group_to_user<
'user,
'group,
U: Nameable<'user, u64> + Send + Sync,
G: Nameable<'group, u64> + Send + Sync,
>(
permission_group: G,
.add_permission_group_to_user(user, permission_group)
async fn remove_permission_group_from_user<
.remove_permission_group_from_user(user, permission_group)
async fn add_role_to_user<
'role,
R: Nameable<'role, u64> + Send + Sync,
role: R,
Self::Local(server) => server.add_role_to_user(user, role).await,
Self::Networked(client) => client.add_role_to_user(user, role).await,
async fn remove_role_from_user<
Self::Local(server) => server.remove_role_from_user(user, role).await,
Self::Networked(client) => client.remove_role_from_user(user, role).await,
/// A database connection that can be either from a local server or a server
/// over a network connection.
pub enum AnyDatabase<B: Backend = NoBackend> {
/// A local database.
Local(ServerDatabase<B>),
/// A networked database accessed with a [`Client`].
Networked(RemoteDatabase),
impl<B: Backend> HasSession for AnyDatabase<B> {
impl<B: Backend> AsyncConnection for AnyDatabase<B> {
type Storage = AnyServerConnection<B>;
fn storage(&self) -> Self::Storage {
Self::Local(server) => AnyServerConnection::Local(server.storage()),
Self::Networked(client) => AnyServerConnection::Networked(client.storage()),
async fn list_executed_transactions(
starting_id: Option<u64>,
result_limit: Option<u32>,
) -> Result<Vec<Executed>, bonsaidb_core::Error> {
.list_executed_transactions(starting_id, result_limit)
async fn last_transaction_id(&self) -> Result<Option<u64>, bonsaidb_core::Error> {
Self::Local(server) => server.last_transaction_id().await,
Self::Networked(client) => client.last_transaction_id().await,
async fn compact_collection<C: Collection>(&self) -> Result<(), bonsaidb_core::Error> {
Self::Local(server) => server.compact_collection::<C>().await,
Self::Networked(client) => client.compact_collection::<C>().await,
async fn compact(&self) -> Result<(), bonsaidb_core::Error> {
Self::Local(server) => server.compact().await,
Self::Networked(client) => client.compact().await,
async fn compact_key_value_store(&self) -> Result<(), bonsaidb_core::Error> {
Self::Local(server) => server.compact_key_value_store().await,
Self::Networked(client) => client.compact_key_value_store().await,
impl<B: Backend> AsyncLowLevelConnection for AnyDatabase<B> {
fn schematic(&self) -> &Schematic {
Self::Local(server) => server.schematic(),
Self::Networked(client) => client.schematic(),
async fn apply_transaction(
transaction: Transaction,
) -> Result<Vec<OperationResult>, bonsaidb_core::Error> {
Self::Local(server) => server.apply_transaction(transaction).await,
Self::Networked(client) => client.apply_transaction(transaction).await,
async fn get_from_collection(
id: DocumentId,
collection: &CollectionName,
) -> Result<Option<OwnedDocument>, bonsaidb_core::Error> {
Self::Local(server) => server.get_from_collection(id, collection).await,
Self::Networked(client) => client.get_from_collection(id, collection).await,
async fn list_from_collection(
ids: Range<DocumentId>,
order: Sort,
limit: Option<u32>,
) -> Result<Vec<OwnedDocument>, bonsaidb_core::Error> {
.list_from_collection(ids, order, limit, collection)
async fn list_headers_from_collection(
) -> Result<Vec<Header>, bonsaidb_core::Error> {
.list_headers_from_collection(ids, order, limit, collection)
async fn count_from_collection(
) -> Result<u64, bonsaidb_core::Error> {
Self::Local(server) => server.count_from_collection(ids, collection).await,
Self::Networked(client) => client.count_from_collection(ids, collection).await,
async fn get_multiple_from_collection(
ids: &[DocumentId],
Self::Local(server) => server.get_multiple_from_collection(ids, collection).await,
Self::Networked(client) => client.get_multiple_from_collection(ids, collection).await,
async fn compact_collection_by_name(
collection: CollectionName,
Self::Local(server) => server.compact_collection_by_name(collection).await,
Self::Networked(client) => client.compact_collection_by_name(collection).await,
async fn query_by_name(
view: &ViewName,
key: Option<QueryKey<Bytes>>,
access_policy: AccessPolicy,
) -> Result<Vec<schema::view::map::Serialized>, bonsaidb_core::Error> {
.query_by_name(view, key, order, limit, access_policy)
async fn query_by_name_with_docs(
) -> Result<schema::view::map::MappedSerializedDocuments, bonsaidb_core::Error> {
.query_by_name_with_docs(view, key, order, limit, access_policy)
async fn reduce_by_name(
) -> Result<Vec<u8>, bonsaidb_core::Error> {
Self::Local(server) => server.reduce_by_name(view, key, access_policy).await,
Self::Networked(client) => client.reduce_by_name(view, key, access_policy).await,
async fn reduce_grouped_by_name(
) -> Result<Vec<MappedSerializedValue>, bonsaidb_core::Error> {
.reduce_grouped_by_name(view, key, access_policy)
async fn delete_docs_by_name(
Self::Local(server) => server.delete_docs_by_name(view, key, access_policy).await,
Self::Networked(client) => client.delete_docs_by_name(view, key, access_policy).await,