Struct SegmentPath 

pub struct SegmentPath { /* private fields */ }

Identifies a segment within the storage layer.

Encapsulates namespace, shard ID, and segment file name for portable path construction across different storage backends (local filesystem, S3, etc.).

Tenant Isolation

Every segment path is scoped to a NamespaceId, providing defense-in-depth tenant isolation at the storage layer. Even if Cedar authorization policies are misconfigured, the directory/object-key prefix prevents cross-tenant data access.

Implementations

impl SegmentPath

pub fn new( namespace: NamespaceId, shard_id: ShardId, segment_name: impl Into<String>, ) -> Result<Self>

Create a new segment path scoped to a namespace.

Returns InvalidPath if segment_name contains path separators (/, \), parent-directory components (..), or is empty — preventing path-traversal attacks.

pub fn namespace(&self) -> &NamespaceId

Returns the namespace (tenant) ID.

pub fn shard_id(&self) -> ShardId

Returns the shard ID.

pub fn segment_name(&self) -> &str

Returns the segment filename.

pub fn to_fs_path(&self, data_dir: &Path) -> PathBuf

Resolve to a filesystem path relative to a data directory.

Layout: {data_dir}/ns_{namespace}/shard_{shard_id}/{segment_name}

Trait Implementations

impl Clone for SegmentPath

fn clone(&self) -> SegmentPath

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SegmentPath

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for SegmentPath

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for SegmentPath

impl Hash for SegmentPath

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SegmentPath

fn eq(&self, other: &SegmentPath) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SegmentPath