Expand description
Raw modules provide raw APIs that used by underlying services
§Notes
- Only developers who want to develop new services or layers need to access raw APIs.
- Raw APIs should only be accessed via
opendal::raw::Xxxx
, any public API should never expose raw API directly. - Raw APIs are far less stable than public API, please don’t rely on them whenever possible.
Modules§
- adapters
- Providing adapters and its implementations.
- oio
oio
provides OpenDAL’s raw traits and types that opendal returns as output.- tests
tests
- Utilities for opendal testing.
Structs§
- Accessor
Info - Info for the accessor. Users can use this struct to retrieve information about the underlying backend.
- Atomic
Content Length - AtomicContentLength is a wrapper of AtomicU64 that used to store content length.
- Bytes
Content Range - BytesContentRange is the content range of bytes.
- Bytes
Range - BytesRange(offset, size) carries a range of content.
- Concurrent
Tasks - ConcurrentTasks is used to execute tasks concurrently.
- Config
Deserializer - ConfigDeserializer is used to deserialize given configs from
HashMap<String, String>
. - Form
Data Part - FormDataPart is a builder for multipart/form-data part.
- Http
Body - The streaming body that OpenDAL’s HttpClient returned.
- Http
Client - A HTTP client instance for OpenDAL’s services.
- Mixed
Part - MixedPart is a builder for multipart/mixed part.
- Multipart
- Multipart is a builder for multipart/form-data.
- OpCopy
- Args for
copy
operation. - OpCreate
Dir - Args for
create
operation. - OpDelete
- Args for
delete
operation. - OpDeleter
- Args for
delete
operation. - OpList
- Args for
list
operation. - OpPresign
- Args for
presign
operation. - OpRead
- Args for
read
operation. - OpReader
- Args for reader operation.
- OpRename
- Args for
rename
operation. - OpStat
- Args for
stat
operation. - OpWrite
- Args for
write
operation. - OpWriter
- Args for
writer
operation. - Path
Cacher internal-path-cache
- PathCacher is a cache for path query.
- Presigned
Request - PresignedRequest is a presigned request return by
presign
. - Query
Pairs Writer - QueryPairsWriter is used to write query pairs to a url.
- Related
Part - RelatedPart is a builder for multipart/related part.
- RpCopy
- Reply for
copy
operation. - RpCreate
Dir - Reply for
create_dir
operation - RpDelete
- Reply for
delete
operation - RpList
- Reply for
list
operation. - RpPresign
- Reply for
presign
operation. - RpRead
- Reply for
read
operation. - RpRename
- Reply for
rename
operation. - RpStat
- Reply for
stat
operation. - RpWrite
- Reply for
write
operation.
Enums§
- Four
Ways - FourWays is used to implement traits that based on four ways.
- Operation
- Operation is the name of the operation that is being performed.
- Presign
Operation - Presign operation used for presign.
- Three
Ways - ThreeWays is used to implement traits that based on three ways.
- TwoWays
- TwoWays is used to implement traits that based on two ways.
Constants§
- VERSION
- VERSION is the compiled version of OpenDAL.
Traits§
- Access
- Underlying trait of all backends for implementers.
- Access
Dyn AccessDyn
is the dyn version ofAccess
make it possible to use asBox<dyn AccessDyn>
.- Http
Fetch - HttpFetch is the trait to fetch a request in async way. User should implement this trait to provide their own http client.
- Layer
- Layer is used to intercept the operations on the underlying storage.
- Layered
Access - LayeredAccess is layered accessor that forward all not implemented method to inner.
- Maybe
Send - MaybeSend is a marker to determine whether a type is
Send
or not. We use this trait to wrap theSend
requirement for wasm32 target. - Part
- Part is a trait for multipart part.
- Path
Query internal-path-cache
- The trait required for path cacher.
Functions§
- build_
abs_ path - build_abs_path will build an absolute path with root.
- build_
header_ value - Build header value from given string.
- build_
rel_ path - build_rel_path will build a relative path towards root.
- build_
rooted_ abs_ path - build_rooted_abs_path will build an absolute path with root.
- format_
authorization_ by_ basic - format authorization header by basic auth.
- format_
authorization_ by_ bearer - format authorization header by bearer token.
- format_
content_ md5 - format content md5 header by given input.
- format_
datetime_ into_ http_ date - format datetime into http date, this format is required by: https://httpwg.org/specs/rfc9110.html#field.if-modified-since
- get_
basename - Get basename from path.
- get_
parent - Get parent from path.
- new_
http_ uri_ invalid_ error - Parse http uri invalid error in to opendal::Error.
- new_
json_ deserialize_ error - Parse json deserialize error into opendal::Error.
- new_
json_ serialize_ error - Parse json serialize error into opendal::Error.
- new_
request_ build_ error - Create a new error happened during building request.
- new_
request_ credential_ error - Create a new error happened during signing request.
- new_
request_ sign_ error - Create a new error happened during signing request.
- new_
std_ io_ error - Parse std io error into opendal::Error.
- new_
task_ join_ error internal-tokio-rt
- Parse tokio error into opendal::Error.
- new_
xml_ deserialize_ error - Parse xml deserialize error into opendal::Error.
- normalize_
path - Make sure all operation are constructed by normalized path:
- normalize_
root - Make sure root is normalized to style like
/abc/def/
. - parse_
content_ disposition - Parse Content-Disposition for header map
- parse_
content_ encoding - Parse content encoding from header map.
- parse_
content_ length - Parse content length from header map.
- parse_
content_ md5 - Parse content md5 from header map.
- parse_
content_ range - Parse content range from header map.
- parse_
content_ type - Parse content type from header map.
- parse_
datetime_ from_ from_ timestamp - parse datetime from given timestamp
- parse_
datetime_ from_ from_ timestamp_ millis - parse datetime from given timestamp_millis
- parse_
datetime_ from_ rfc2822 - Parse datetime from rfc2822.
- parse_
datetime_ from_ rfc3339 - Parse datetime from rfc3339.
- parse_
etag - Parse etag from header map.
- parse_
header_ to_ str - Parse header value to string according to name.
- parse_
into_ metadata - parse_into_metadata will parse standards http headers into Metadata.
- parse_
last_ modified - Parse last modified from header map.
- parse_
location - Parse redirect location from header map
- parse_
multipart_ boundary - Parse multipart boundary from header map.
- parse_
prefixed_ headers - Parse prefixed headers and return a map with the prefix of each header removed.
- percent_
decode_ path - percent_decode_path will do percent decoding for http decode path.
- percent_
encode_ path - percent_encode_path will do percent encoding for http encode path.
- validate_
path - Validate given path is match with given EntryMode.
- with_
error_ response_ context - Add response context to error.
Type Aliases§
- Accessor
- Accessor is the type erased accessor with
Arc<dyn Accessor>
. - Boxed
Future - BoxedFuture is the type alias of [
futures::future::BoxFuture
]. - Boxed
Static Future - BoxedStaticFuture is the type alias of [
futures::future::BoxFuture
]. - Http
Fetcher - HttpFetcher is a type erased
HttpFetch
.