manas_storage 0.1.0

This crate provides traits and implementations for a `SolidStorage`, and `SolidStorageService`, (a solid-protocol compatible http service over a storage).
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

//! I define traits to define solid compliant storage services.
//!

use std::sync::Arc;

use dyn_problem::Problem;
use futures::future::BoxFuture;
use manas_http::service::namespaced::NamespacedHttpService;
use tower::Service;

use crate::SolidStorage;

pub mod cors;
pub mod impl_;
pub mod method;

/// A trait for solid compliant storage services.
pub trait SolidStorageService:
    NamespacedHttpService<hyper::Body, hyper::Body> + StorageInitializer
{
    /// Type of the storage, this service serves.
    type Storage: SolidStorage;

    /// Get storage of this service.
    fn storage(&self) -> &Arc<Self::Storage>;
}

/// A [`SolidStorageServiceFactory`] resolves storage service for each storage.
pub trait SolidStorageServiceFactory: Clone + Send + Sync + Unpin + 'static {
    /// Type of storage
    type Storage: SolidStorage;

    /// Type of storage service
    type Service: SolidStorageService<Storage = Self::Storage>;

    /// Get a new service for given storage.
    fn new_service(&self, storage: Arc<Self::Storage>) -> Self::Service;
}

/// A contract trait for storage initializer.
///
/// Service must ensure storage root is existing and represented.
/// Service must be idempotent.
/// It should return Ok(false), if it is already initialized.
pub trait StorageInitializer:
    Service<(), Response = bool, Error = Problem, Future = BoxFuture<'static, Result<bool, Problem>>>
{
}

impl<S> StorageInitializer for S where
    S: Service<
        (),
        Response = bool,
        Error = Problem,
        Future = BoxFuture<'static, Result<bool, Problem>>,
    >
{
}