loonfs-objectstore 0.2.0

The LoonFS object-store boundary: contract, key layout, and providers.
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

//! The LoonFS object-store boundary.
//!
//! LoonFS assumes only the narrow provider contract the format spec names —
//! create-if-absent, compare-and-swap, read-after-write visibility, prefix
//! listing — and this crate owns that boundary: the [`ObjectStore`] trait,
//! provider adapters for S3, Cloudflare R2, Google Cloud Storage, Azure Blob
//! Storage, and the local filesystem, the durable key layout in [`keys`] and
//! [`layout`], and the contract probe in [`probe`] that proves a configured
//! store honours that contract — the same checks the conformance suite runs
//! against real providers.

#![warn(missing_docs)]

pub mod abs;
mod attempts;
mod configured;
pub mod gcs;
mod immutable_write;
pub mod keys;
mod keyspace;
pub mod layout;
pub mod local_fs_store;
pub mod metrics;
pub mod object_store;
pub mod presign;
pub mod probe;
mod provider_object_store;
mod retry;
pub mod s3_compatible;
mod secret;
mod store_config;
mod store_io_runtime;
#[cfg(test)]
mod test_support;
pub mod timing;
mod transfer_timeouts;

pub use configured::{ConfiguredObjectStore, ConfiguredObjectStoreKind};
pub use immutable_write::ImmutableWriteError;
pub use object_store::ObjectStoreError as Error;
pub use object_store::{
    ByteRange, ByteStream, MultipartCompletion, MultipartPart, ObjectBody, ObjectMetadata,
    ObjectStore, ObjectStoreError, PutMode, Result, SharedObjectStore, StoredObjectChecksum,
};
pub use probe::{run_store_contract_probe, StoreProbeCheck, StoreProbeOutcome, StoreProbeReport};
pub use provider_object_store::{
    ProviderObjectStore, ProviderObjectStoreConfig, PROVIDER_ATTEMPT_TIMEOUT,
    PROVIDER_CONNECT_TIMEOUT, PROVIDER_MULTIPART_PART_BYTES, PROVIDER_MULTIPART_PART_WINDOW,
    PROVIDER_MULTIPART_THRESHOLD_BYTES, PROVIDER_OPERATION_DEADLINE, PROVIDER_STREAMED_PART_WINDOW,
    PROVIDER_TRANSFER_ATTEMPT_TIMEOUT,
};
pub use secret::SecretString;
pub use store_config::{
    StoreConfig, StoreConfigError, ACCESS_KEY_ID_ENV, SECRET_ACCESS_KEY_ENV, SESSION_TOKEN_ENV,
};