quilt-rs 0.34.0

Rust library for accessing Quilt data packages.
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

//! Common hash trait for all checksum implementations
use std::future::Future;

use multihash::Multihash;
use tokio::io::AsyncRead;

use crate::object_hash::error::Error;

/// This trait ensures all hash types provide consistent access to the underlying multihash
pub trait Hash {
    /// Get the inner multihash
    fn multihash(&self) -> &Multihash<256>;

    /// Get the algorithm code
    fn algorithm(&self) -> u64 {
        self.multihash().code()
    }

    /// Get the digest bytes
    fn digest(&self) -> &[u8] {
        self.multihash().digest()
    }

    /// Calculate hash from an async reader of `length` bytes.
    ///
    /// `length` is required by chunked algorithms to derive multipart chunk
    /// boundaries; algorithms that hash the whole stream ignore it. The caller
    /// supplies the length (e.g. from file metadata) since a reader does not
    /// carry one.
    fn from_reader<R: AsyncRead + Unpin + Send>(
        reader: R,
        length: u64,
    ) -> impl Future<Output = Result<Self, Error>> + Send
    where
        Self: Sized;
}