about summary refs log tree commit diff
path: root/tvix/castore/src
diff options
context:
space:
mode:
authorFlorian Klink <flokli@flokli.de>2024-03-19T10·54+0200
committerclbot <clbot@tvl.fyi>2024-03-20T12·17+0000
commit591edf0d5b5e4910f0a4688028348e423d723253 (patch)
treefc9bb5f1fcd94bb59ecf026d0e67c5718873a4e5 /tvix/castore/src
parent65b8359ff3ce1bed882f2d773fe137b673531801 (diff)
docs(tvix/castore/directory): update docstring for get_recursive r/7748
The rust trait was missing to document the order of the elements in the
stream. Document that, and also the reasoning behind this.

Change-Id: I27ef0b2020082783fc41c2015233175e2b8e716d
Reviewed-on: https://cl.tvl.fyi/c/depot/+/11203
Reviewed-by: raitobezarius <tvl@lahfa.xyz>
Autosubmit: flokli <flokli@flokli.de>
Tested-by: BuildkiteCI
Diffstat (limited to 'tvix/castore/src')
-rw-r--r--tvix/castore/src/directoryservice/mod.rs5
1 files changed, 4 insertions, 1 deletions
diff --git a/tvix/castore/src/directoryservice/mod.rs b/tvix/castore/src/directoryservice/mod.rs
index 8a10121d6d88..ca8e60e87304 100644
--- a/tvix/castore/src/directoryservice/mod.rs
+++ b/tvix/castore/src/directoryservice/mod.rs
@@ -44,7 +44,10 @@ pub trait DirectoryService: Send + Sync {
     /// Rust doesn't support this as a generic in traits yet. This is the same thing that
     /// [async_trait] generates, but for streams instead of futures.
     ///
-    /// The individual Directory messages *must* be valid.
+    /// The individually returned Directory messages *must* be valid.
+    /// Directories are sent in an order from the root to the leaves, so that
+    /// the receiving side can validate each message to be a connected to the root
+    /// that has initially been requested.
     fn get_recursive(
         &self,
         root_directory_digest: &B3Digest,