about summary refs log blame commit diff
path: root/tvix/store/src/pathinfoservice/mod.rs
blob: 2483909a119013683229b2f44771e6335d5f4b38 (plain) (tree)
1
2
3
4
5
6
7
         




                          
                                        





                                                                               

                                                                              



                                                                                
 



                                                                                             
 
mod grpc;
mod memory;
mod sled;

use crate::{proto, Error};

pub use self::grpc::GRPCPathInfoService;
pub use self::memory::MemoryPathInfoService;
pub use self::sled::SledPathInfoService;

/// The base trait all PathInfo services need to implement.
/// This is a simple get and put of [proto::Directory], returning their digest.
pub trait PathInfoService {
    /// Retrieve a PathInfo message by the output digest.
    fn get(&self, digest: [u8; 20]) -> Result<Option<proto::PathInfo>, Error>;

    /// Store a PathInfo message. Implementations MUST call validate and reject
    /// invalid messages.
    fn put(&self, path_info: proto::PathInfo) -> Result<proto::PathInfo, Error>;

    /// Return the nar size and nar sha256 digest for a given root node.
    /// This can be used to calculate NAR-based output paths,
    /// and implementations are encouraged to cache it.
    fn calculate_nar(&self, root_node: &proto::node::Node) -> Result<(u64, [u8; 32]), Error>;
}