filemanager 0.1.3

Unified file abstraction for local and cloud files with caching options and support for multiple formats.
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

#[cfg(feature = "cloud")]
mod cloud;
#[cfg(not(feature = "cloud"))]
mod no_cloud;

#[cfg(feature = "cloud")]
pub(crate) use cloud::CloudObject;
#[cfg(not(feature = "cloud"))]
pub use no_cloud::CloudObject;

/// Errors that can occur when working with cloud stores.
#[non_exhaustive]
#[derive(Debug, thiserror::Error)]
pub enum CloudError {
    #[error(transparent)]
    ThirdParty(#[from] Box<dyn std::error::Error + Send + Sync>),
    #[error("{0}")]
    Authentication(String),
    #[error("unsupported cloud URL: {0}")]
    NotACloudUri(String),
    #[error("cloud functionality requires the 'cloud' feature")]
    FeatureNotEnabled,
}

/// Maps a URL scheme to a cloud storage provider. This is the single source of
/// truth — `CLOUD_SCHEMES` is kept in sync with the variants below.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub(crate) enum CloudProvider {
    S3,
    Azure,
    Gcs,
}