nfs-rs 0.5.0

An asynchronous, pure Rust client library for NFSv3 and NFSv4.1
Documentation
// Copyright 2025 NetApp Inc. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// SPDX-License-Identifier: Apache-2.0

use super::{
    Mount, READDIR3args, READDIR3resok, Result, bytes_to_string, entry3, nfs_fh3, paged_dir_stream,
};
use bytes::Bytes;
use futures::stream::Stream;

#[derive(Debug)]
pub struct ReaddirEntry {
    pub fileid: u64,
    pub file_name: String,
}

impl From<ReaddirEntry> for crate::mount::ReaddirEntry {
    fn from(entry: ReaddirEntry) -> Self {
        Self {
            fileid: entry.fileid,
            file_name: entry.file_name,
        }
    }
}

#[allow(unused)]
impl Mount {
    pub async fn readdir_path(
        &self,
        dir_path: &str,
    ) -> Result<impl Stream<Item = Result<ReaddirEntry>> + '_ + use<'_>> {
        let fh = self.lookup_path(dir_path).await?.fh;
        Ok(self.readdir(fh).await)
    }

    pub async fn readdir(&self, dir_fh: Bytes) -> impl Stream<Item = Result<ReaddirEntry>> + '_ {
        paged_dir_stream!(
            self,
            dir_fh,
            readdir_at,
            |entry: Box<entry3>| ReaddirEntry {
                fileid: entry.fileid.0,
                file_name: bytes_to_string(entry.name.0),
            },
            "readdir page received"
        )
    }

    pub async fn readdir_at(
        &self,
        dir_fh: Bytes,
        cookie: u64,
        cookieverf: [u8; 8],
    ) -> Result<READDIR3resok> {
        let args = READDIR3args {
            dir: nfs_fh3 { data: dir_fh },
            cookie,
            cookieverf,
            count: self.maxcount,
        };
        self._readdir(args).await
    }
}