Extend file metadata

Combined change from two PRs
- #13
- #15

Author: peasee

README.md

@@ -91,6 +91,7 @@ Apache Iceberg is an active open-source project, governed under the Apache Softw
   at [Slack #rust channel](https://join.slack.com/t/apache-iceberg/shared_invite/zt-1zbov3k6e-KtJfoaxp97YfX6dPz1Bk7A).
 
 The Apache Iceberg community is built on the principles described in the [Apache Way](https://www.apache.org/theapacheway/index.html) and all who engage with the community are expected to be respectful, open, come with the best interests of the community in mind, and abide by the Apache Foundation [Code of Conduct](https://www.apache.org/foundation/policies/conduct.html).
+
 ## Users
 
 - [Databend](https://github.com/datafuselabs/databend/): An open-source cloud data warehouse that serves as a cost-effective alternative to Snowflake.

crates/iceberg/src/io/file_io.rs

@@ -21,7 +21,7 @@ use std::ops::Range;
 use std::sync::Arc;
 
 use bytes::Bytes;
-use opendal::Operator;
+use opendal::{EntryMode, Lister, Operator};
 use url::Url;
 
 use super::storage::Storage;
@@ -166,6 +166,16 @@ impl FileIO {
             relative_path_pos,
         })
     }
+
+    /// Returns a `Operator::lister` for the given path.
+    ///
+    /// # Errors
+    ///
+    /// If the operator fails to create a lister for the given path or `FileIO`
+    pub async fn lister(&self, path: impl AsRef<str>) -> Result<Lister> {
+        let (op, root_uri) = self.inner.create_operator(&path)?;
+        Ok(op.lister(root_uri).await?)
+    }
 }
 
 /// Container for storing type-safe extensions used to configure underlying FileIO behavior.
@@ -287,6 +297,8 @@ impl FileIOBuilder {
 pub struct FileMetadata {
     /// The size of the file.
     pub size: u64,
+    /// The file mode.
+    pub mode: EntryMode,
 }
 
 /// Trait for reading file.
@@ -337,6 +349,7 @@ impl InputFile {
 
         Ok(FileMetadata {
             size: meta.content_length(),
+            mode: meta.mode(),
         })
     }